@aswless_854771076/ai_short_studio_cli 0.1.59 → 0.1.60

package/package.json

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

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

@@ -28,12 +28,13 @@ 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`；用户未指定分镜类型时推荐 `storyboardImageType: grid`（分镜板/宫格分镜），不再默认推荐 `storyboard`（故事版）。`visualBible` 按返回的 `schema` 构造，不得硬编码枚举或结构。模型既可写为项目覆盖，也可由用户明确确认继承账户默认，但必须列明最终生效且当前可用的具体模型。缺失、冲突或继承结果不明确时先一次性询问。
+1. 运行 `canvas settings get --project <projectId> --json`，向用户展示项目名称与用途，并逐项确认以下设置的项目覆盖值 `currentValue`、继承后的 `effectiveValue`、建议值和来源 `source`：`aspectRatio`、`artStyle`、`visualBible`、`storyboardImageType`、`analysisModel`、`imageModel`、`imageResolution`、`imageQuality`、`editModel`、`videoModel`、`videoPromptType`、`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`。
 5. 用户确认后，用一次 `canvas settings set --file <settings.json>` 或 stdin 原子写入所有变更。标准创作门禁必须把最近一次 `settings get` 返回的 `version` 填入请求的 `expectedVersion`，并统一使用这种批量模式；`--field/--value` 只适合已确认无并发写入的交互式便利操作。画风 ID 必须从 `artStyle.options` 选择并解析实时 `option.value`，示例中的 `$ART_STYLE_ID` 不是固定值。`null` 或空字符串表示清除项目覆盖并恢复账户/系统继承。设置 `artStyle` 会保存其当前关联的 `visualBible` 项目快照；画风库之后的修改不反向更新项目，同一请求显式传入 `visualBible` 时以显式值为准。
 6. 写入后立即再次执行 `canvas settings get`，比较所有目标字段的 `currentValue`、`effectiveValue` 和 `source`。只有结果符合用户确认且所需模型明确可用，才可创建或执行创作节点。409 冲突时重新读取、展示变化并取得确认，携带新 `expectedVersion` 重试；不得盲目覆盖。所有者和管理员可写，协作者只读；写入、回读或权限校验失败时停在配置阶段，不触发任何付费任务。
+7. 最终生效的 `videoModel.effectiveValue` 为 `comfly::minimax-h3` 或 `runninghub::minimax-h3-reference-to-video` 时，必须在同一次 `settings set --file` 中显式写入 `videoPromptType: "h3"`；非 H3 模型的提示词类型按用户确认值写入或保留，不得擅自覆盖手动选择。运行既有 `storyboard-video-prompt` 前检查节点原始 `config.promptType`：仅有效的节点 `h3` / `seedance` 值会优先于项目值；H3 项目中的旧 `seedance` 必须用一次 `canvas node update-many` 的 `unset: ["promptType"]` 清除，非法值虽不会覆盖项目值，也应一并清除，再回读确认节点继承项目 `h3`。模型、项目提示词类型或有效节点覆盖任一不一致时不得执行视频提示词或视频生成节点。
 
 ## 剧本创作与审计联动
 

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

@@ -85,11 +85,14 @@ ai-short-studio canvas settings set --project "$PROJECT_ID" --file settings.json
     "imageResolution": "2K",
     "imageQuality": "high",
     "videoResolution": "1080p",
-    "videoModel": null
+    "videoModel": "runninghub::minimax-h3-reference-to-video",
+    "videoPromptType": "h3"
   }
 }
 ```
 
+最终生效的 `videoModel.effectiveValue` 为 `comfly::minimax-h3` 或 `runninghub::minimax-h3-reference-to-video` 时，必须和 `videoPromptType: "h3"` 在同一次批量设置中写入；非 H3 模型按用户确认值写入或保留提示词类型。运行既有 `storyboard-video-prompt` 前读取节点原始 config；仅有效的节点 `h3` / `seedance` 值优先于项目设置。H3 项目中的 `seedance` 必须清除；非法值不会覆盖项目值，但也应清除。用一次 `canvas node update-many` 提交 `{ "updates": [{ "nodeId": "<id>", "unset": ["promptType"] }] }` 并回读确认。任一模型、项目类型或有效节点覆盖不一致时不得执行视频提示词或视频生成节点。
+
 `null` 或空字符串会清除项目覆盖并恢复账户默认或系统默认继承。设置 `artStyle` 时，服务端会把画风当前关联的 `visualBible` 保存为项目快照；画风库后续修改不会反向更新既有项目。同一请求显式提供 `visualBible` 时，显式值覆盖画风快照。
 
 所有者和管理员可执行 `settings set`，协作者只能执行 `settings get`。批量写入是原子的；建议携带最近一次读取的 `expectedVersion`，遇到 409 后重新运行 `settings get`、核对变化并取得确认，再携带新版本重试，不得盲目覆盖。Pexels 配置仍由 `project provider get|set|test` 管理，不属于 canvas settings。
@@ -199,7 +202,7 @@ ai-short-studio config set --file <config.json> --json
 
 先执行 `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` 为准。用户未指定分镜类型时推荐 `storyboardImageType: grid`（分镜板/宫格分镜），不推荐 `storyboard`（故事版）。模型可项目覆盖，也可由用户明确确认继承账户默认，但必须明确最终生效且可用的具体模型。`storyboardGridSize` 仅在异常回退时确认。同一阶段的多个画布写操作默认合并到一次 `canvas apply`，批量不可用或合法批量请求仍因批量粒度失败时才回退单条 node/edge 命令。
+取得配置后，向用户展示项目名称/用途，并逐项确认 `aspectRatio`、`artStyle`、`visualBible`、`storyboardImageType`、`analysisModel`、`imageModel`、`imageResolution`、`imageQuality`、`editModel`、`videoModel`、`videoPromptType`、`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` 自动修复只补预检缺失的能力默认值，不能替代项目 settings；项目 `description`、节点 `prompt`/`config` 和低层 `canvas apply` 同样不能替代。