@aswless_854771076/ai_short_studio_cli 0.1.53 → 0.1.55

package/README.md

@@ -49,7 +49,7 @@ CLI 只把 refresh token 保存到系统钥匙串。短期 access token 会写
 
 CLI 不提供分集删除或任务人工复核提交；这两类需要确认生产资产或保留范围的操作继续在网页端完成。
 
-`config get` 返回管理员发布的全局模型与个人默认值，不返回供应商密钥。Comfly 和 RunningHub 的凭据、服务地址与工作流均由服务端维护；CLI 预检只检查默认模型及能力选项。`config set` 会拒绝写入任何供应商或模型目录。
+`config get` 返回管理员发布的全局模型与个人默认值，不返回供应商密钥。已保存的默认模型失效时，服务端会改用同类型的首个已启用模型，并用实时选项的第一项补齐该模型缺失的能力默认值。Comfly 和 RunningHub 的凭据、服务地址与工作流均由服务端维护；CLI 预检只检查默认模型及能力选项。`config set` 会拒绝写入任何供应商或模型目录。
 
 ```bash
 ai-short-studio canvas edge add --project <projectId> --from <sourceNodeId>:<sourceHandle> --to <targetNodeId>:<targetHandle> --json

package/dist/domain/vvicat-api.js

@@ -336,6 +336,7 @@ export class VvicatApi {
         }
     }
     config() {
+        // 读取时服务端会修复已失效的默认模型并补齐必需的能力默认值。
         return this.client.request('/api/user/api-config?redactSecrets=1');
     }
     updateConfig(input) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aswless_854771076/ai_short_studio_cli",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "description": "VVICAT 无限画布项目命令行工具",
   "license": "MIT",
   "private": false,

package/skills/using-vvicat-ai-short-studio-cli/SKILL.md

@@ -18,7 +18,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
 创建项目或修改任何资源前，按顺序执行：
 
 1. 运行 `ai-short-studio preflight --json`。它通过 API base URL 检查连通性和 CLI 最新稳定版，未配置地址时使用测试环境 `https://ai-short-studio.vvicat.dev`，默认发现更新就更新当前全局包；`restartRequired` 为真时必须重跑。连不上时提醒用户检查 `--base-url`、`VVICAT_BASE_URL`、profile 或默认测试环境，不猜其他地址。
-2. 未登录且已有账号时执行 `ai-short-studio auth login --google` 或邮箱登录；没有账号且用户明确要求注册时，先核对 profile 的 `baseUrl` 确实指向目标环境，再使用 `auth signup --email <email> --password-stdin`。CLI 会从服务端取得 Supabase 公共配置，并把同域的 `/{locale}/auth/callback` 显式设为注册确认回调。注册返回 `confirmationRequired: true` 时，等待用户完成邮件验证后再登录。登录后重跑 preflight。`ready` 为 false 时，把缺失的默认模型和能力选项一次性告知用户；供应商与模型目录问题交由管理员处理。
+2. 未登录且已有账号时执行 `ai-short-studio auth login --google` 或邮箱登录；没有账号且用户明确要求注册时，先核对 profile 的 `baseUrl` 确实指向目标环境，再使用 `auth signup --email <email> --password-stdin`。CLI 会从服务端取得 Supabase 公共配置，并把同域的 `/{locale}/auth/callback` 显式设为注册确认回调。注册返回 `confirmationRequired: true` 时，等待用户完成邮件验证后再登录。登录后重跑 preflight。`ready` 为 false 且缺失项仅为 `capabilityDefaults.<modelKey>.<field>` 时，不先反馈用户：立即运行 `config get`，确认模型已启用且该字段存在非空实时 `*Options`，优先复用目标项目对应的有效设置，其次使用服务端返回的模型默认值，否则使用实时 options 第一项；将全部可确定缺项合并为一次 `config set --file` 写入当前账户，随后 `config get` 回读并重跑 preflight。无权写入、回读不一致或仍为 `ready=false` 时才报告。缺少默认模型、模型不可用、没有合法 options 或涉及供应商与模型目录时不得猜测，交由用户或管理员处理。
 3. 运行账户级只读命令 `ai-short-studio config get --json`，取得账户默认模型及管理员已发布的全局模型。创建项目至少要求已配置 `defaultModels.analysisModel`；缺失时 `project create` 会在发送创建请求前停止，需先由用户在设置中心完成配置。供应商、密钥和模型目录只能由管理员维护；`config set` 只维护个人默认模型及其能力默认值和工作流并发，不得写入 `providers` 或 `models`。
    Comfly 和 RunningHub 同样从全局目录选择；其凭据、服务地址和工作流映射由管理员或服务端维护，CLI 不要求也不接受用户配置供应商连接。
 4. 运行 `ai-short-studio canvas node types --json`，按实时 `inputSchema`、`outputSchema`、`configSchema` 和 `defaultConfig` 确定能力与必填项。
@@ -28,7 +28,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
 
 ## 项目配置门禁
 
-1. 运行 `canvas settings get --project <projectId> --json`，向用户展示项目名称与用途，并逐项确认以下设置的项目覆盖值 `currentValue`、继承后的 `effectiveValue`、建议值和来源 `source`：`aspectRatio`、`artStyle`、`visualBible`、`storyboardImageType`、`analysisModel`、`imageModel`、`imageResolution`、`imageQuality`、`editModel`、`videoModel`、`videoResolution`、`audioModel`。画风、画幅、分镜、模型及分辨率/质量候选必须读取服务端实时 `options`；`visualBible` 按返回的 `schema` 构造，不得硬编码枚举或结构。模型既可写为项目覆盖，也可由用户明确确认继承账户默认，但必须列明最终生效且当前可用的具体模型。缺失、冲突或继承结果不明确时先一次性询问。
+1. 运行 `canvas settings get --project <projectId> --json`，向用户展示项目名称与用途，并逐项确认以下设置的项目覆盖值 `currentValue`、继承后的 `effectiveValue`、建议值和来源 `source`：`aspectRatio`、`artStyle`、`visualBible`、`storyboardImageType`、`analysisModel`、`imageModel`、`imageResolution`、`imageQuality`、`editModel`、`videoModel`、`videoResolution`、`audioModel`。画风、画幅、分镜、模型及分辨率/质量候选必须读取服务端实时 `options`；用户未指定分镜类型时推荐 `storyboardImageType: grid`（分镜板/宫格分镜），不再默认推荐 `storyboard`（故事版）。`visualBible` 按返回的 `schema` 构造，不得硬编码枚举或结构。模型既可写为项目覆盖，也可由用户明确确认继承账户默认，但必须列明最终生效且当前可用的具体模型。缺失、冲突或继承结果不明确时先一次性询问。
 2. 必须展示并确认 `storyboardGridSize` 的项目覆盖值、继承后的默认分镜格数和来源；系统默认值为 6 格。`storyboard-image` 的实时 schema 已提供节点级 `gridSize`，正常流程应逐镜配置；连接旧版本服务且 schema 未暴露该字段时，禁止虚假写入，并回退到用户确认的项目格数。
 3. 优先在项目配置中确认 `imageResolution`、`imageQuality` 和 `videoResolution`，让未单独设置的图片、图片编辑和视频节点统一继承。候选值只从 `canvas settings get` 对应字段的实时 `options` 选择；节点确需不同参数时，才按节点当前模型 `capabilities` 的 `resolutionOptions`、`qualityOptions` 写入 `resolution`、`quality` 覆盖。模型未声明选项时不得臆造字段值。
 4. 新项目按初始化顺序确认名称和用途、创建项目并取得项目、画布与 settings；既有项目开始创作前也必须完成本门禁，名称或用途需要更新时只用 `project update` 修改用户确认的项目字段。用途可记录在项目描述中，但描述不构成画布 settings。不得用账户级 `config set`、项目 `description` 或节点 `prompt`/`config` 代替 `canvas settings set`。
@@ -63,7 +63,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
 4. 按实时节点 schema，把已确认的剧本节点，以及每个人物、场景、道具等相关素材节点，逐项连接到 `storyboard-breakdown` 对应输入 handle（通常为 `script`、`characters`、`locations`、`props`）。执行前重新读取画布和连线，确认本次故事涉及的素材节点无遗漏；即使服务端把素材输入标为可选，标准创作流程也不得省略。任一对应连线缺失时禁止拆解，先补线；素材范围不清楚时先询问用户。全部门禁满足后才执行并等待。成功后刷新画布，读取服务端自动创建的 `storyboard-shot` 和 `storyboard-image`，不得重复手工创建，并通过“分镜素材连线门禁”。
 
    用户明确要求专业 Markdown 剧本拆镜测试时，给 `storyboard-breakdown` 显式配置 `storyboardPipelineVersion: 2`、`sourceFormat: screenplay-markdown.v1`、目标集的 `targetLanguage: en|ar`、`platform: TikTok` 和 `aspectRatio: 9:16`，且只能连接一条剧本。该模式只验收分镜文本和镜头资产：声音只记录音色设定，不执行 `voice-design`；不执行 TTS、图片、音频或视频节点。任务成功后确认来源与逐字校验通过且没有新增 IMAGE/AUDIO/VIDEO 版本；任务失败时确认没有新增分镜版本或镜头。
-5. 生成分镜图前，必须先通过“分镜素材连线门禁”。再用 `canvas asset get/list` 取得人物、场景、道具等已选版本，必要时下载，并把实际图片或可访问预览展示给用户；只提供资产 ID、文件路径或文字说明不算展示。用户明确确认素材与选版后，读取 `storyboard-image` 的实时 `configSchema`，用户未指定画幅且 schema 支持时将 `aspectRatio: 16:9` 显式写入节点，再分析每个镜头的动作阶段、运镜变化、多人调度和连续性难度，选择 schema 允许的最小够用格数：简单镜头建议 4 格，常规镜头使用默认 6 格，复杂镜头建议 9 格，16/25 格只用于用户明确需要的长动作或高密度关键帧。向用户展示逐镜建议并确认后，将各自 `gridSize` 写入对应节点；旧服务 schema 未暴露字段时不得虚假写入，应说明限制并回退到项目有效值，`gridSize` 未另行确认时为 6 格。连续叙事优先建议 `imageLayout: storyboard`，同时说明 `grid` 与 `single` 可选，最终由用户确认布局、镜头范围、参考资产、模型与费用范围。未展示、未确认或连线门禁未通过时禁止生成分镜图。
+5. 生成分镜图前，必须先通过“分镜素材连线门禁”。再用 `canvas asset get/list` 取得人物、场景、道具等已选版本，必要时下载，并把实际图片或可访问预览展示给用户；只提供资产 ID、文件路径或文字说明不算展示。用户明确确认素材与选版后，读取 `storyboard-image` 的实时 `configSchema`，用户未指定画幅且 schema 支持时将 `aspectRatio: 16:9` 显式写入节点，再分析每个镜头的动作阶段、运镜变化、多人调度和连续性难度，选择 schema 允许的最小够用格数：简单镜头建议 4 格，常规镜头使用默认 6 格，复杂镜头建议 9 格，16/25 格只用于用户明确需要的长动作或高密度关键帧。向用户展示逐镜建议并确认后，将各自 `gridSize` 写入对应节点；旧服务 schema 未暴露字段时不得虚假写入，应说明限制并回退到项目有效值，`gridSize` 未另行确认时为 6 格。用户未指定布局时推荐并使用 `imageLayout: grid`（分镜板/宫格分镜）；`storyboard`（故事版）与 `single` 仅在用户明确选择时使用。最终仍需确认镜头范围、参考资产、模型与费用范围。未展示、未确认或连线门禁未通过时禁止生成分镜图。
 6. 执行分镜图后按“生成后自我审计”检查真实产物，并展示给用户确认。新分镜直接读取 `independent` / `previous-tail`，但该字段只作为建议：服务端不自动创建尾帧节点或连线，也不阻止后镜独立生成。需要严格连续性时，在用户确认后显式执行 `--apply-ready`。之后复用自动创建的 `storyboard-video-prompt`，按实际布局重写视频提示词并确认后执行 `video-generate`。镜头建议时长按正常剧情节拍、口播和动作确定，首尾保留约 1–2 秒剪辑余量；不为命中全片总时长机械扩镜。执行时先读取当前模型的实时 `durationOptions`；只有实时选项仅为 5、10、15 秒时，才按目标时长向上取这三档。其他模型选用用户确认的实时合法时长，并保留原建议时长供剪辑裁切。未展示或未确认分镜图时禁止生成视频。
 7. 配置门禁固定用一次 `canvas settings set` 写入确认字段；通过门禁后的同阶段节点与连线变更优先合并为一次 `canvas apply`。只改节点 config、标题或坐标时，单节点使用 `canvas node update --set/--unset/--title/--x/--y`，多节点使用一次 `canvas node update-many`；不能借此编辑结构化 artifact。互不依赖的节点通过一次 `canvas node run` 重复传 `--node`，需要立即等待时加 `--wait`；已经取得多个任务 ID 时通过一次 `task wait` 重复传 `--task`，不用固定 sleep。批量不可用或按“核心原则”处理后仍失败时才回退专用单条命令。
 8. 每批图片、视频或音频生成完成后必须先通过“生成后自我审计”，才能报告成功、请求选版或进入下一付费阶段。在进入视频生成前，必须额外依次执行：(a)“镜头级素材审计”全量清单，核对 reference 集合覆盖镜中人物/场景/道具、无跨类型错边、成对资源引用正确版本、stale 清零、道具词扫 description 兜底、资源文字设定贯穿到 shot/image；(b)“上下镜连续性审计”，按时序逐对相邻镜核对人物位置、道具状态、光影色调、动势视线、景别节奏、叙事桥接，并给有动作连续关系的镜组互加 reference、给极端特写/物证镜补入必要的人物 reference；(c)“分镜逻辑审计”，对照叙事期望逐项扫掉关键词误命中、真假道具互串、跨段同名实体误连、黑场/空镜多余连线、多版本角色（成年/童年）误连、龙套角色引用主角资源等问题，输出逐镜审计表并精确删/加边直到 wired=plan；(d) 把图像模型的已知先验 bias（数字、具象动物、实体面具、中文字样等）列入视频阶段 prompt 的 negative 约束。交付前再次确认 selected version 与下载目录，记录项目、节点、任务和资产 ID、审计结论、失败项与未决项。临时项目在所有结束路径删除；既有项目绝不擅自删除。
@@ -246,7 +246,7 @@ RunningHub MiniMax H3 的实时 `aspectRatio` 只有 16:9、9:16，`resolution`
 - 注册环境通过 profile `baseUrl` 区分；Supabase Redirect URLs 应预先允许各环境，禁止为单次本地注册临时修改全局 Site URL。
 - `config get` 不返回全局 Provider 密钥；返回的模型已经过管理员发布和可用性校验，预检不得要求用户持有 Provider 密钥。
 - `project provider get` 只返回配置状态。`project provider set` 的 JSON 必须来自安全 stdin 或不入库的临时秘密文件，禁止把 Key 写进命令参数、仓库文件或会回显的 shell 历史。
-- 删除用户既有项目、覆盖完整画布或修改模型配置前，先明确目标和影响；没有授权就停在读取或生成变更计划。
+- 删除用户既有项目、覆盖完整画布或修改模型配置前，先明确目标和影响；没有授权就停在读取或生成变更计划。初始化检查中按实时 options 自动补齐缺失的当前账户 `capabilityDefaults` 已获本 Skill 授权，不属于需要再次询问的模型切换。
 - `canvas apply` 只用于节点、连线、删除、视口等低层图补丁，不能代替 `canvas settings set`。同阶段有多个图变更时优先一次批量提交；已有画布快照时必须传 `--canvas-id` 和 `--expected-version`，不让 CLI 再预读全图。批量失败按“核心原则”分类处理，不能通过逐条重试绕过权限、schema、业务门禁或付费确认。遇到 409 才重新读取、合并并确认后重试。项目配置遇到 409 时也必须重新读取和确认。
 - 编辑 `storyboard-shot` 必须使用 `canvas node edit-shot`。完整 JSON 可包含 `photographyPlan` 对象和 `actingNotes` 对象或数组；它们与其他镜头字段一起追加不可变版本、固定选版并把下游标记为 stale。命令不允许修改 `shotKey`、`shotIndex` 或来源身份；409 后重新读取镜头版本再确认，不能覆盖历史版本。
 - 编辑结构化生成资源必须使用 `canvas node edit-resource`，不得用 `canvas node update` 或 `canvas apply` 改写服务端 artifact。名称、资源键、ID 和所属关系等身份字段不可修改；缺少稳定 `operation/resourceKey/resourceType` 的旧节点保持只读。资源版本写入具有独立并发基线，409 后重新读取画布与当前选版并确认；兄弟资源节点不得被同步切版。
@@ -276,10 +276,12 @@ ai-short-studio task wait --task "$TASK_1" --task "$TASK_2" --concurrency 4 --js
 ## 常见错误
 
 - 节点类型写死：先读 `canvas node types`，服务端目录才是事实来源。
-- 配置不全仍继续：先做初始化检查；模型、项目或用户意图有缺口时先询问。
+- 配置不全仍继续：先做初始化检查；仅缺可确定的账户 `capabilityDefaults` 时自动补齐并验证，模型、项目或用户意图仍有缺口时再询问。
 - 把项目配置写到错误位置：画幅、画风、视觉圣经、故事版类型、模型、默认图片分辨率/质量和默认视频分辨率必须通过 `canvas settings set` 写入；`canvas apply`、账户级 `config set`、项目描述或节点 prompt/config 都不能替代。
 - 写完 settings 就创建节点：必须 `canvas settings get` 回读并确认 `currentValue`、`effectiveValue`、`source` 和最终模型；失败或冲突时停在配置阶段，不触发付费任务。
 - CLI 有更新仍用旧进程继续：更新后必须重跑 preflight。
+- 预检只缺账户能力默认值就停止反馈：先按初始化检查自动补齐可确定的 `capabilityDefaults`、回读并重跑 preflight；只有无法安全确定或写入失败时才报告。
+- 未指定分镜布局却推荐故事版：默认推荐 `grid` 分镜板；`storyboard` 只在用户明确选择时使用。
 - 注册成功就假定已登录：`confirmationRequired: true` 表示需要先完成邮件验证，再执行 `auth login`。
 - 自动创建的下游节点重复添加：任务完成后先刷新画布并复用真实节点 ID。
 - 多项画布写操作逐条执行：同一阶段可合并的节点、连线和删除应先用一次 `canvas apply`；只有批量入口不可用或合法批量请求仍因批量粒度失败时才回退单条命令，不能把权限、schema 或业务错误当作回退理由。

package/skills/using-vvicat-ai-short-studio-cli/references/commands.md

@@ -193,21 +193,21 @@ ai-short-studio config get --json
 ai-short-studio config set --file <config.json> --json
 ```
 
-`config set` 只接受 `defaultModels`、`capabilityDefaults`、`workflowConcurrency` 的部分对象；CLI 与服务端都会拒绝 `providers` 或 `models`。Provider 密钥和全局模型目录只能由管理员后台维护。标准创作启动只执行只读的 `config get` 来计算账户默认模型的继承结果；不得用账户级 `config set` 代替项目的 canvas settings。
+`config set` 只接受 `defaultModels`、`capabilityDefaults`、`workflowConcurrency` 的部分对象；CLI 与服务端都会拒绝 `providers` 或 `models`。Provider 密钥和全局模型目录只能由管理员后台维护。预检仅缺 `capabilityDefaults.<modelKey>.<field>` 时，先用 `config get` 核对实时 options，优先复用目标项目有效设置，其次使用服务端模型默认值，否则使用 options 第一项；合并写入后回读并重跑 preflight，不先把可自动修复项反馈给用户。账户级 `config set` 不得代替项目的 canvas settings。
 
 ## 标准创作命令顺序
 
-先只读执行 `preflight` → `config get` → `canvas node types` → `project list`。新项目随后按“确认名称/用途 → `project create` → `project get` + 一次 `canvas inspect` 聚合查询”继续，不要求创建前读取不存在的项目或画布；既有项目读取同样的已有资源。只有聚合结果缺少专用命令独有字段时才补充单项查询。
+先执行 `preflight`；若只缺可确定的账户能力默认值，立即用一次 `config set` 自动补齐、回读并重跑。通过后继续 `config get` → `canvas node types` → `project list`。新项目随后按“确认名称/用途 → `project create` → `project get` + 一次 `canvas inspect` 聚合查询”继续，不要求创建前读取不存在的项目或画布；既有项目读取同样的已有资源。只有聚合结果缺少专用命令独有字段时才补充单项查询。
 
-取得配置后，向用户展示项目名称/用途，并逐项确认 `aspectRatio`、`artStyle`、`visualBible`、`storyboardImageType`、`analysisModel`、`imageModel`、`imageResolution`、`imageQuality`、`editModel`、`videoModel`、`videoResolution`、`audioModel` 的 `currentValue`、`effectiveValue`、建议值与 `source`；候选值和视觉圣经结构分别以实时 `options` 与 `schema` 为准。模型可项目覆盖，也可由用户明确确认继承账户默认，但必须明确最终生效且可用的具体模型。`storyboardGridSize` 仅在异常回退时确认。同一阶段的多个画布写操作默认合并到一次 `canvas apply`，批量不可用或合法批量请求仍因批量粒度失败时才回退单条 node/edge 命令。
+取得配置后，向用户展示项目名称/用途，并逐项确认 `aspectRatio`、`artStyle`、`visualBible`、`storyboardImageType`、`analysisModel`、`imageModel`、`imageResolution`、`imageQuality`、`editModel`、`videoModel`、`videoResolution`、`audioModel` 的 `currentValue`、`effectiveValue`、建议值与 `source`；候选值和视觉圣经结构分别以实时 `options` 与 `schema` 为准。用户未指定分镜类型时推荐 `storyboardImageType: grid`（分镜板/宫格分镜），不推荐 `storyboard`（故事版）。模型可项目覆盖，也可由用户明确确认继承账户默认，但必须明确最终生效且可用的具体模型。`storyboardGridSize` 仅在异常回退时确认。同一阶段的多个画布写操作默认合并到一次 `canvas apply`，批量不可用或合法批量请求仍因批量粒度失败时才回退单条 node/edge 命令。
 
-项目名称和用途先由用户确认；新项目用 `project create` 保存，既有项目需要变更时仅用 `project update` 修改用户确认的项目字段。把确认的配置用一次 `canvas settings set` 原子写入并携带 `expectedVersion`，随后再次 `settings get` 回读。只有结果与确认一致且所需模型可用，才执行 node add/edge add/node run。写入、权限、冲突、回读或模型校验失败时停在配置阶段，不触发付费任务。账户级 `config set`、项目 `description`、节点 `prompt`/`config` 和低层 `canvas apply` 都不能替代项目 settings 命令。
+项目名称和用途先由用户确认；新项目用 `project create` 保存，既有项目需要变更时仅用 `project update` 修改用户确认的项目字段。把确认的配置用一次 `canvas settings set` 原子写入并携带 `expectedVersion`，随后再次 `settings get` 回读。只有结果与确认一致且所需模型可用，才执行 node add/edge add/node run。写入、权限、冲突、回读或模型校验失败时停在配置阶段，不触发付费任务。账户级 `config set` 自动修复只补预检缺失的能力默认值，不能替代项目 settings；项目 `description`、节点 `prompt`/`config` 和低层 `canvas apply` 同样不能替代。
 
 执行 `storyboard-breakdown` 前，必须先完成本次故事涉及的全部人物、场景、道具等素材节点：互不依赖的节点用一次 `canvas node run` 重复传 `--node`，需要同步等待时加 `--wait`；已有多个任务 ID 时用一次 `task wait` 重复传 `--task`。有上游依赖的节点按依赖顺序分批执行，不得为了等待单个任务而串行提交其他独立素材。全部任务成功后，用聚合查询或 `canvas asset get/list` 核对并在用户确认后设置 selected version。随后依据实时 schema 连接素材，并用一次 `canvas inspect` 核对无遗漏。任一素材任务未成功、selected version 为空或对应连线缺失时，都不得执行分镜拆解；素材范围不清楚时先询问用户。即使服务端 schema 把人物、场景或道具输入标为可选，标准创作流程也不能跳过本次故事实际涉及且已确认使用的素材。
 
 专业 Markdown 纯文本拆镜使用 `{"storyboardPipelineVersion":2,"sourceFormat":"screenplay-markdown.v1","targetLanguage":"en","platform":"TikTok","aspectRatio":"9:16"}`，阿语集把语言改为 `ar`。只连接一条剧本与该集实际涉及的文字资产。该模式不执行声音、TTS、图片、音频或视频生成；完成后用任务、画布和资产回读确认只新增分镜文本/镜头，失败时零分镜持久化。
 
-生成 `storyboard-image` 前，用 `canvas asset get/list` 取得素材 selected version，必要时通过 `canvas asset download` 下载，并向用户实际展示人物、场景、道具等预览；用户确认后才可执行。逐镜头根据需要独立呈现的动作、表情、主体关系、视角和空间调度状态选择最小够用的 `gridSize`，不得沿用统一格数或仅按时长推算；先用实时节点 schema 核对允许值，再向用户列出“镜号、复杂度依据、建议格数”，确认后逐个更新对应 `storyboard-image` 节点。生成视频前，同样取得并展示实际分镜图或可访问预览，确认分镜图和视频镜头范围后才可执行 `storyboard-video-prompt` / `video-generate`。仅输出资产 ID、URL、文件路径或成功状态不能代替展示；任一确认缺失时停止并询问。
+生成 `storyboard-image` 前，用 `canvas asset get/list` 取得素材 selected version，必要时通过 `canvas asset download` 下载，并向用户实际展示人物、场景、道具等预览；用户确认后才可执行。用户未指定布局时推荐并使用 `imageLayout: grid`（分镜板/宫格分镜），`storyboard`（故事版）与 `single` 仅在用户明确选择时使用。逐镜头根据需要独立呈现的动作、表情、主体关系、视角和空间调度状态选择最小够用的 `gridSize`，不得沿用统一格数或仅按时长推算；先用实时节点 schema 核对允许值，再向用户列出“镜号、复杂度依据、建议格数”，确认后逐个更新对应 `storyboard-image` 节点。生成视频前，同样取得并展示实际分镜图或可访问预览，确认分镜图和视频镜头范围后才可执行 `storyboard-video-prompt` / `video-generate`。仅输出资产 ID、URL、文件路径或成功状态不能代替展示；任一确认缺失时停止并询问。
 
 用户未指定画幅时，角色、道具、场景/背景、分镜图及其他视觉参考素材统一使用 `16:9`；实时 schema 支持 `aspectRatio` 时显式写入节点，避免继承项目中的其他画幅。视频时长以当前模型实时 `durationOptions` 为准。只有实时模型仅提供 5、10、15 秒时，才按镜头目标时长向上取这三档，并保留原目标时长供剪辑裁切；其他模型使用经用户确认的实时合法值。RunningHub MiniMax H3 暴露 5–15 秒的每个整数，支持不连任何媒体的纯文本生成，服务端会把 1–4 秒归一为 5 秒。参考音频仍不能作为唯一媒体输入；纯文本是零媒体，不是 audio-only。