@aswless_854771076/ai_short_studio_cli 0.1.157 → 0.1.158

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aswless_854771076/ai_short_studio_cli",
3
- "version": "0.1.157",
3
+ "version": "0.1.158",
4
4
  "description": "VVICAT 无限画布项目命令行工具",
5
5
  "license": "MIT",
6
6
  "private": false,
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: using-vvicat-ai-short-studio-cli
3
- description: Use when an agent needs to inspect or operate VVICAT infinite-canvas projects through the ai-short-studio CLI. Freeform JSON documents and workflow status are the canonical production interface; legacy fixed-node commands are read-only compatibility paths for existing projects.
3
+ description: Use when an agent needs to inspect or operate VVICAT infinite-canvas projects through the ai-short-studio CLI. Freeform JSON documents and workflow status are the canonical production interface; legacy fixed-node pipelines are read-only compatibility paths for existing projects.
4
4
  ---
5
5
 
6
6
  # 使用 VVICAT AI Short Studio CLI
@@ -30,9 +30,9 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
30
30
  | 原创短剧、小说改编、来源材料、市场灵感 | `references/short-drama/operations/short-drama-skill-index.md`、`references/short-drama/creation/analyze-drama-source.md`、`references/short-drama/creation/define-drama-brief.md` | 依次运行 `drama-source-analysis → drama-brief`;来源覆盖、改编边界或用户决定缺失时停在 `open_questions`,不写剧本 |
31
31
  | 故事设定、人物弧线、分集规划 | `references/short-drama/creation/design-drama-bible.md`、`references/short-drama/creation/outline-drama-series.md` | 先确认 Brief,再运行 `drama-bible → drama-outline`;未确认集数、时长或结局不得自动补齐 |
32
32
  | 单集剧本、来源片段转剧本、剧本润色 | `references/short-drama/creation/write-drama-episode.md`、`references/short-drama/review/review-drama-script.md`、`references/humanizer/humanizer.md`、`references/short-drama/creation/humanizer.md` | 已有专业剧本时先复用并审核,不得重复执行 `novel-to-script`;改编先保留原文事实和对白,再按官方 Humanizer 快照做自然化,短剧适配层只补充事实保留和表演边界;必须回到 `drama-script-review`,P0/P1 未清零不得进入导演阶段 |
33
+ | 导演手册、摄影与表演 | `references/short-drama/creation/write-drama-director-book.md`、`references/short-drama/director-composition.md` | 在资产生成和拆镜前完成 `drama-director-book`;构图、轴线和表演决定必须来自剧本事实,证据不足时降级构图,不补陈设或天气 |
33
34
  | 人物、场景、道具和资产版本 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/assets/` 下对应资产文档、`references/short-drama/assets/plan-drama-assets.md` | 运行资产分析后再生成;每批候选下载或读取真实预览并展示给用户,用户确认后才选版;缺证据、错版、stale 或身份歧义时标记 blocked,不用相似资产替代 |
34
- | 导演手册、摄影、表演、分镜和镜头变体 | `references/short-drama/creation/write-drama-director-book.md`、`references/short-drama/storyboard/build-drama-storyboard.md`、`references/short-drama/director-composition.md` | `drama-director-book → storyboard-breakdown → selected storyboard image type`;由 Agent 按镜头目标选择单图、时间故事版、镜头分镜板或专项板,读取构图受控词表,证据不足时降级构图,不补陈设或天气 |
35
- | 逐镜制作、跨镜连续性、previous-tail | `references/short-drama/storyboard/plan-drama-production.md`、`references/short-drama/storyboard/plan-shot-continuity.md` | 先生成 `drama-production-plan`,再生成 `drama-continuity-plan`;只有前镜已审核且选版时允许 previous-tail |
35
+ | 结构化分镜、分镜图、逐镜制作计划与跨镜连续性 | `references/short-drama/storyboard/build-drama-storyboard.md`、`references/short-drama/storyboard/plan-drama-production.md`、`references/short-drama/storyboard/plan-shot-continuity.md` | `storyboard-breakdown → drama-production-plan → drama-continuity-plan → selected storyboard image type`;由 Agent 按镜头目标选择单图、时间故事版、镜头分镜板或专项板,只生成已选择的板型;只有前镜已审核且选版时允许 previous-tail |
36
36
  | 视频提示词、H3、Seedance、原生音频 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/generation/write-drama-video-prompts.md`、`references/short-drama/prompt/h3-prompt-writing.md`、`references/short-drama/prompt/seedance-prompting.md`、`references/h3-video-delivery.md`、`references/short-drama/generation/design-drama-audio.md` | 默认由 Agent 生成并保存自由画布文档;先按通用规范确定类型与维度,再按实时 Provider schema 选择协议并审计后提交视频 |
37
37
  | 背景音乐、主题曲、纯音乐 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/generation/design-drama-audio.md` | 使用画布 `music-generate` 和实时音频模型目录;有自定义歌词时不得同时开启纯音乐;生成后试听并回读 AUDIO 资产版本 |
38
38
  | 去字幕、参考视频复刻、深度视频 | `references/short-drama/recreation/recreation-qa.md`、`references/short-drama/generation/transform-drama-media.md` | 使用 `recreation-subtitle-remove → recreation-depth-preprocess/depth-video → video-generate`;不得把参考板或字幕带入成片 |
@@ -41,28 +41,28 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
41
41
 
42
42
  自由画布短剧制作不要求预先搭建固定功能节点:Agent 先用 `canvas documents` 恢复分集,再按 `module-map.json` 选择模块;结果保存为 `canvas.<module>.v1` 版本并以 `--input` 记录来源,文档选版和审核证据作为阶段依据。
43
43
 
44
- 新项目禁止搭建上述固定功能节点链。每个阶段都必须由 Agent 在无限画布创建或更新 `text-resource` 自由画布文档,并通过 `canvas document save` 追加不可变版本;媒体节点只消费已审核的 自由画布文档和选定媒体版本。
44
+ 新项目禁止预搭旧版固定功能节点链(`screenplay-resource` 起始、`drama-*` 分析节点整条连好的流水线)。分析阶段每个产物都由 Agent 在无限画布创建或更新 `text-resource` 自由画布文档,并通过 `canvas document save` 追加不可变版本;媒体节点只消费已审核的自由画布文档和选定媒体版本。媒体生成节点和专业拆镜入口(`canvas node add storyboard-breakdown --source-format …`)仍是当前接口,由画布按文档物化或按需单独创建。
45
45
 
46
- 旧版固定节点命令仍保留用于读取和恢复历史项目,但不得作为新项目入口,也不得与 自由画布文档并行写入同一阶段。发现旧节点链时先用 `canvas documents` 和 `canvas workflow status` 建立 自由画布文档快照,再迁移受影响阶段;迁移完成后停止继续创建旧节点。
46
+ 旧版固定节点链仍保留用于读取和恢复历史项目,但不得作为新项目入口,也不得与 自由画布文档并行写入同一阶段。发现旧节点链时先用 `canvas documents` 和 `canvas workflow status` 建立 自由画布文档快照,再迁移受影响阶段;迁移完成后停止继续创建旧节点链。
47
47
  ## 核心原则
48
48
 
49
49
  生产环境认证优先使用 MemHub;CLI 通过浏览器 PKCE 登录或个人 API Key 访问,只有本地明确关闭 MemHub 时才使用 Supabase 兼容登录。
50
50
 
51
- 把 `ai-short-studio` 当作机器可读的远程控制接口。目标、素材含义、平台、语言、画幅、时长、风格、人物、场景、道具、模型、实时 schema、候选版本、付费范围或覆盖影响存在未知、缺失或矛盾时,合并询问最少必要问题;得到答复前只做只读检查。不得用示例值替用户作创作决定。短剧结构化节点的 `canvas node types` 结果包含 `structuredOutputSchema`;创建或运行前必须按该字段组织输出,不能从 `TEXT`/`SCRIPT` 字符串端口猜 JSON。节点 `prompt` 只能补充创作意图,服务端会把语言与最终结构合同追加在它之后,冲突时以后置合同为准。
51
+ 把 `ai-short-studio` 当作机器可读的远程控制接口。目标、素材含义、平台、语言、画幅、时长、风格、人物、场景、道具、模型、实时 schema、候选版本、付费范围或覆盖影响存在未知、缺失或矛盾时,合并询问最少必要问题;得到答复前只做只读检查。不得用示例值替用户作创作决定。节点 `prompt` 只能补充创作意图,服务端会把语言与最终结构合同追加在它之后,冲突时以后置合同为准。
52
52
 
53
53
  优先使用一次 `canvas inspect` 聚合查询。同阶段可合并的 settings、节点和连线分别使用 `canvas settings set --file`、`canvas apply`、`canvas node update-many`。生成链使用单个调度循环滚动提交,不用 `--wait` 把整批阶段串行化:节点一完成就刷新画布并立即提交它已就绪的下游节点。默认每类并发 4、总并发上限 16;同一节点同一输入指纹只允许一个在途任务,不并发启动多个相互竞争的调度器。409 重读并审阅差异;schema 和业务检查错误进入恢复链路,能修正的自主修正后继续。401/403、供应商余额等无法自主修正的问题报告准确原因,继续不依赖该节点的工作。
54
54
 
55
55
  ## 主流程
56
56
 
57
- 1. **预检与恢复**:运行 `preflight --json`;更新后重跑。再读取 `config get`、目标项目、`canvas documents` 和 `canvas workflow status`。只有历史项目需要新增媒体节点时才读取实时 `canvas node types`。`skill status --target codex` 非 current 时先询问再更新,禁止强制覆盖用户修改。
57
+ 1. **预检与实时节点目录门禁**:运行 `preflight --json`;更新后重跑。再读取 `config get`、目标项目、`canvas documents` 和 `canvas workflow status`,并在创建或配置任何节点前读取 `canvas node types --json`。config 只写实时 `configSchema.properties` 声明的键;`title`、坐标和连线身份属于节点属性(`canvas node add --title`、`canvas node update --title`),不写入 `config`,`music-generate` 的 `title` 只是 Suno 模型参数,不得复制到其他节点;服务端或调用方拒绝未知配置字段时,删除该字段并按实时 schema 重试,不猜字段名。结构化短剧节点的输出按 `structuredOutputSchema` 组织,不能从 `TEXT`/`SCRIPT` 端口猜 JSON。`skill status --target codex` 非 current 时先询问再更新,禁止强制覆盖用户修改。
58
58
  2. **项目语言门禁**:新建项目前必须从用户确认交付语言,并用 `project create --language <BCP47>` 写入;界面 `--locale` 不能代替内容语言。创建后回读 `project get` 与 `canvas settings get`,确认两者语言一致且不可修改。项目语言约束剧本、分镜、台词、配音、画面文字和字幕;验收须区分剧情内容与制作信息:项目语言允许正常外语穿插和规范英文摄影术语,不按字符种类判死;道具文字和剧情内界面遵循来源原文。存在实际语言合同冲突时停止并说明。
59
59
  3. **项目配置门禁**:项目初始化时必须向用户展示并确认创作配置,不得只采用账户默认值:交付语言、画幅、目标时长、画风、分镜板策略、分析/文本模型、图片模型及其厂商、视频模型及其厂商、视频提示词协议、音频/配乐模型及其厂商、声音一致性方式、分辨率、画质、候选数量、参考素材和预计请求范围。先读取 `canvas settings get`,展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options;确认 `imageResolution`、`imageQuality` 和 `videoResolution` 后,再按标准创作门禁用 `--file settings.json` 原子写入并携带 `expectedVersion`,回读一致前不得创建或运行付费节点。`$ART_STYLE_ID` 必须解析实时 `option.value`。节点确需不同参数时才按实时能力覆盖,并记录覆盖原因;`automation_mode` 只能省略已确认且未变化的重复询问,不能替用户确认模型/厂商或付费范围。
60
- 4. **自由画布文档和目标集**:先读取 `canvas workflow status`,按当前阶段和条件模块生成 JSON;使用 `canvas document save` 写入 `canvas.<module>.v1`,用 `--input` 固化上游选版。审核必须另存为 `canvas.review.v1` 并绑定被审核版本。无需先调用固定节点或生成模型,不要创建没有版本的文档空壳。已有自由画布文档直接复用;历史 `screenplay-resource` 或结构化资源先迁移成 自由画布文档,再继续流程。需要创作微短剧时,按需读取 `references/short-drama/`,再完整读取 [官方 Humanizer 快照](references/humanizer/humanizer.md)(来源见 [快照说明](references/humanizer/SOURCE.md))和 [短剧适配层](references/short-drama/creation/humanizer.md) 去除 AI 味;不得改动已经确认的剧情事实,润色后回到短剧 reference 复核。确认目标集数后,只生产该集实际需要的资产。
61
- 5. **资产门禁**:先完成人物、场景、道具及其派生版本。每批生成完成后必须用 `canvas asset download` 或等效预览能力取得真实候选,并在当前对话中展示候选缩略图/文件链接、资产 key、版本和用途;用户确认后才能写入 selected version。只在用户看过候选且确认后选版。执行资产—剧情匹配审计;缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
62
- 6. **拆镜和滚动生成**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建默认专业拆镜,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2`,不自动新增首帧节点。Agent 先读取每镜 `storyboard_strategy`,按制作目标选择单幅分镜图、时间故事版、镜头分镜板、专项板或 Blender;已选择一种板型时不得自动补生成另一种。只审核实际生成的板型,并让视频提示词只引用真实存在且已审核的分镜资产。用户的停止阶段优先于 [滚动异步调度](references/async-pipeline.md):仅分镜图任务完成实际选择的板型并通过审核后停止,不运行视频提示词和视频。允许视频时,已就绪镜头滚动提交,单镜失败不阻塞其他镜头。
63
- 7. **视频规划**:视频生成前依次完成素材连线、镜头逻辑和上下镜连续性审计。读取实时 `durationOptions`;只有选项恰为 5、10、15 秒时才按这三档向上取整。RunningHub MiniMax H3 支持纯文本和 0–9 张参考图、0–2 个参考视频、0–2 个参考音频,5–15 秒逐秒可选,1–4 秒归一为 5 秒;参考视频只传画面。画幅为 16:9 / 9:16,分辨率为 480p / 720p / 1K / 2K。
64
- 8. **H3 生成门禁**:`videoModel` 为 `comfly::minimax-h3` 或 `runninghub::minimax-h3-reference-to-video` 时,同次设置 `videoPromptType: "h3"`。仅有效的节点 `promptType` 可覆盖项目值;旧 `seedance` 覆盖必须清除并回读,否则不得执行视频生成或写入提示词。Agent 编写 H3 提示词时读取 `references/short-drama/prompt/h3-prompt-writing.md`;进入生成前必须读取 [H3 成片规则](references/h3-video-delivery.md)。
65
- 9. **逐镜后验**:每个视频镜头完成后实际看画面、听完整音轨,并完成视觉、音频、转场、字幕四项验收。任一 P0/P1 失败只修复并重跑受影响镜头;未通过不得进入成片剪辑。
60
+ 4. **创作链路与自由画布文档**:按 `canvas workflow status` 返回的 `currentStage` 依次生成来源分析 → 创作简报 → 故事设定 → 分集大纲 → 单集剧本 → Humanizer 自然化 → 剧本审校 → 导演手册 → 资产计划;每步用 `canvas document save` 写入 `canvas.<module>.v1`,用 `--input` 固化上游选版,审核必须另存为 `canvas.review.v1` 并绑定被审核版本。无需先调用固定节点或生成模型,不要创建没有版本的文档空壳。已有自由画布文档直接复用;历史 `screenplay-resource` 或结构化资源先迁移成 自由画布文档,再继续流程。需要创作微短剧时,按需读取 `references/short-drama/`,再完整读取 [官方 Humanizer 快照](references/humanizer/humanizer.md)(来源见 [快照说明](references/humanizer/SOURCE.md))和 [短剧适配层](references/short-drama/creation/humanizer.md) 去除 AI 味;不得改动已经确认的剧情事实,剧本审校 P0/P1 未清零不得进入导演与资产阶段,润色后回到短剧 reference 复核。确认目标集数后,只生产该集实际需要的资产。
61
+ 5. **资产门禁**:先完成人物、场景、道具及其派生版本。资产图分别用 `character-turnaround`、`location-image`(`locationImagePurpose: location-sheet`)、`prop-turnaround`,`prompt` 端口连接结构化设定节点;默认模板 `character_asset_sheet`、`scene_asset_sheet`、`prop_generate` 是参考正文,不得删除,也不得改用 `image-generate` 代替设定板。每批生成完成后必须用 `canvas asset download` 或等效预览能力取得真实候选,并在当前对话中展示候选缩略图/文件链接、资产 key、版本和用途;用户确认后才能写入 selected version。只在用户看过候选且确认后选版。执行资产—剧情匹配审计;缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
62
+ 6. **拆镜与制作计划**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建默认专业拆镜,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2`,不自动新增首帧节点。结构化分镜之后依次生成逐镜制作计划和跨镜连续性计划;只有前镜已审核且选版时才允许 previous-tail。视频提交前必须完成素材连线、镜头逻辑和上下镜连续性审计。
63
+ 7. **分镜图与逐镜审计**:Agent 先读取每镜 `storyboard_strategy`,按制作目标选择单幅分镜图、时间故事版、镜头分镜板、专项板或 Blender;已选择一种板型时不得自动补生成另一种。只审核实际生成的板型,并让视频提示词只引用真实存在且已审核的分镜资产。逐镜审计 P0/P1 未清零不得写入视频提示词或提交视频。用户的停止阶段优先于 [滚动异步调度](references/async-pipeline.md):仅分镜图任务完成实际选择的板型并通过审核后停止,不运行视频提示词和视频。
64
+ 8. **视频规划、提示词与 H3 生成门禁**:读取实时 `durationOptions`;只有选项恰为 5、10、15 秒时才按这三档向上取整。RunningHub MiniMax H3 支持纯文本和 0–9 张参考图、0–2 个参考视频、0–2 个参考音频,5–15 秒逐秒可选,1–4 秒归一为 5 秒;参考视频只传画面。画幅为 16:9 / 9:16,分辨率为 480p / 720p / 1K / 2K。`videoModel` 为 `comfly::minimax-h3` 或 `runninghub::minimax-h3-reference-to-video` 时,同次设置 `videoPromptType: "h3"`;仅有效的节点 `promptType` 可覆盖项目值,旧 `seedance` 覆盖必须清除并回读,否则不得执行视频生成或写入提示词。Agent 编写 H3 提示词时读取 `references/short-drama/prompt/h3-prompt-writing.md`,写入后回读提示词选版;进入生成前必须读取 [H3 成片规则](references/h3-video-delivery.md)。
65
+ 9. **视频滚动生成与逐镜后验**:允许视频时,已就绪镜头滚动提交,单镜失败不阻塞其他镜头。每个视频镜头完成后实际看画面、听完整音轨,并完成视觉、音频、转场、字幕四项验收。任一 P0/P1 失败只修复并重跑受影响镜头;未通过不得进入成片剪辑。
66
66
  10. **成片和交付**:剪辑只使用通过验收的 selected 版本,并完整执行 [剪辑与交付](references/editing-delivery.md)。默认对白/旁白字幕进入成片,人物与场景介绍仅在首次出现时显示短暂角标,同时输出独立 SRT/ASS。根据叙事动机选择硬切、动作切、J/L-cut、遮挡匹配或短淡化,不给所有镜头机械套淡入淡出。完成节奏裁切、声音平衡、画面统一、字幕和必要技术处理后,从头到尾观看成片并执行完整成片验收;未通过不得声称完成。原始视频按 `selectedOutputVersionId` 下载,字幕独立保存,`manifest` 记录镜号、节点、任务、资产、版本、时间线和文件名。
67
67
 
68
68
  ## 强制分流
@@ -22,7 +22,7 @@
22
22
  ai-short-studio canvas node diagnose "$NODE_ID" --project "$PROJECT_ID" --json
23
23
  ```
24
24
 
25
- 返回节点配置、实时输入端口、上游当前版本及正文、最近任务状态和 `recoveryActions`。它是只读检查,不是执行成功或创作质量证明。按实时节点 schema 修正配置,按精确 edge ID 修正接线;字段修改使用 `canvas node update --set` 或 `--config`,批量修改使用 `update-many` 的 `set/unset`,不要传被忽略的 `config` 包装。
25
+ 返回节点配置、实时输入端口、上游当前版本及正文、最近任务状态和 `recoveryActions`。它是只读检查,不是执行成功或创作质量证明。按实时节点 schema 修正配置,按精确 edge ID 修正接线;字段修改使用 `canvas node update --set` 或 `--config`,批量修改使用 `update-many` 的 `set/unset`,不要传被忽略的 `config` 包装。配置被拒绝(服务端或调用方提示未知字段,例如把节点标题 `title` 写进 `config`)时,删除该字段并按实时 `configSchema.properties` 修正后重试;节点标题用 `canvas node update --title`,换名猜字段或重复提交同一无效字段都不算修复。
26
26
 
27
27
  | 问题所在位置 | 恢复方法 |
28
28
  | --- | --- |
@@ -28,6 +28,17 @@
28
28
 
29
29
  ## 资产生产门禁
30
30
 
31
+ ### 默认资产模板与生成节点
32
+
33
+ 默认模板是 Agent 生成资产图的参考正文,随包保留,不因节点内置合同存在而删除:人物 `character_asset_sheet`、场景 `scene_asset_sheet`、道具 `prop_generate`、分镜板 `panel_grid_image` / `panel_storyboard_image`。生成时按下列对应关系落到真实节点,模板输出与端口连线共同决定实际正文;这些节点由画布按已选文档物化,也可按需单独创建,不属于被禁止的旧版固定功能节点链:
34
+
35
+ - **人物**:`character-resource → character-visual-design → character-turnaround`;`prompt` 端口接人物视觉方案,`reference` 只接该人物已选主形象。
36
+ - **场景**:`location-resource → location-image`;空间设定多视图用 `locationImagePurpose: location-sheet`,单幅无分格干净背景另建 `background-plate` 节点。
37
+ - **道具**:`prop-resource → prop-turnaround`;白底单道具、主视图加正/侧/背三视图由服务端合同追加。
38
+ - **分镜板**:`storyboard-grid-image`(时间故事版)、`storyboard-board-image`(镜头分镜板)、`storyboard-image`(其他已选择主类型);`prompt` 端口接结构化分镜。
39
+
40
+ 这些资产不得用 `image-generate` 生成:它是透明边界,只组合用户直填或连入的文本,不追加设定板或分镜板合同。每项资产使用独立节点和独立资产版本,`count` 的多结果不能拼图。模板变量必须由已选资产计划、已确认档案和完整画风对象填充,不保留占位符,不把临时 URL、节点标题或未选版素材写进正文。
41
+
31
42
  专业镜头的 `assetNodeRefs` 与 `visualAssetBindings` 共用镜头选版。通过下文专业增量修订流程,为每项设定来源绑定实际 `imageNodeId`,并把这些图片接到已选择板型的 `reference` 端口;不能按节点标题猜归属。每个绑定图片节点只能代表一个选定媒体,多候选需使用单项资源节点。服务端在付费板图前检查全部声明资产、上游真实设定边、选版与实际上送图片;提示词按实际数组编译身份和参考序号。修改绑定会使已选择板型及下游 stale;设定换版或文字投影变化同样使旧来源失效。所有已选择板型都审核通过仍要比较实际参考集合,差异不能由文字批准覆盖;引用覆盖不代表图像像素已符合设定。
32
43
 
33
44
  1. 只生产目标集实际出现的人物及形象版本、场景/子场景、关键道具及叙事版本。每项任务成功后展示真实预览,让用户确认并设置 selected version。
@@ -12,7 +12,7 @@ ai-short-studio canvas node types --json
12
12
 
13
13
  ## 自由画布文档(新项目唯一入口)
14
14
 
15
- 新项目不得通过固定功能节点编排短剧。先运行:
15
+ 新项目不得通过旧版固定功能节点链编排短剧;分析阶段产物走自由画布文档。先运行:
16
16
 
17
17
  ```bash
18
18
  ai-short-studio canvas documents --project <projectId> --json
@@ -23,7 +23,7 @@ ai-short-studio canvas workflow status --project <projectId> --json
23
23
 
24
24
  ## 历史节点兼容
25
25
 
26
- 下面的节点命令仅用于读取、审计和迁移历史项目,不得作为新项目的流程入口,也不得与 自由画布文档并行写入同一阶段。
26
+ 旧版固定功能节点链(`screenplay-resource` 起始、`drama-*` 分析节点整条预连的流水线)只用于读取、审计和迁移历史项目,不得作为新项目入口,也不得与自由画布文档并行写入同一阶段。节点命令本身是当前接口:媒体生成节点(`character-turnaround`、`location-image`、`prop-turnaround`、`storyboard-*`、`video-generate`)由画布按文档物化或按需单独创建,专业拆镜用 `canvas node add storyboard-breakdown --source-format …`;分析阶段产物仍以 `text-resource` 文档为准。
27
27
 
28
28
  ## 节点
29
29
 
@@ -41,6 +41,8 @@ ai-short-studio canvas node delete <nodeId> --project <projectId> --yes --json
41
41
 
42
42
  `update` 只改普通 config、标题和坐标;结构化 artifact 必须用 `edit-shot` / `edit-resource` 追加版本。身份字段不可修改。两类编辑对同节点、同基线、同载荷重复提交或当前选版已满足目标时幂等;画布冲突刷新当前选版后重试一次,资产版本竞争保留原基线重试一次,其他 409 直接停止核对。
43
43
 
44
+ 节点 config 只能写实时 `canvas node types --json` 中该 kind 的 `configSchema.properties` 键,并按其中的类型、枚举和默认值提交。`title`、`x`、`y`、端口和节点身份不是 config 字段:标题用 `canvas node add --title` 或 `canvas node update --title`。只有 `music-generate` 的 `title` 是该节点的 Suno 模型参数,不得复制到其他节点。服务端或调用方拒绝未知配置字段时,删除该字段并按实时 schema 重试,不猜字段名,也不用重复提交绕过校验。
45
+
44
46
  `--asset-id` 仅用于 `image`、`video`、`audio` 媒体节点,把已有资产的 selected 版本绑定为节点输出;CLI 会先按实时节点目录拒绝非媒体节点,资产类型仍由服务端校验。上传资产后先用 `canvas asset list` 或上传响应取得资产 ID,再创建媒体节点并连线。
45
47
 
46
48
  自由画布 JSON 产物保存到 `text-resource` 节点;每次保存追加版本,`--input` 记录上游节点当前资产选版。续写前先读状态,`ready: false` 时根据 `staleInputs` 重做受影响产物,不能沿用旧审核。
@@ -42,7 +42,7 @@
42
42
 
43
43
  ## 音乐生成节点
44
44
 
45
- 背景音乐、主题曲和纯音乐使用 `music-generate`,默认模型为 `starrouter::suno_music`。节点只接收可选的 `prompt` 文本输入,输出 AUDIO;在画布设置中通过 `musicModel` 继承项目音乐模型,节点 config 的 `model` 可以按实时目录覆盖。`prompt` 必须有实际内容,`title`、`tags`、`lyrics` 和 `makeInstrumental` 按实时 schema 提交;`lyrics` 与 `makeInstrumental: true` 互斥。不要用 `tts` 节点生成音乐,也不要把 `audioModel` 的 TTS 模型写到 `musicModel`。
45
+ 背景音乐、主题曲和纯音乐使用 `music-generate`,默认模型为 `starrouter::suno_music`。节点只接收可选的 `prompt` 文本输入,输出 AUDIO;在画布设置中通过 `musicModel` 继承项目音乐模型,节点 config 的 `model` 可以按实时目录覆盖。`prompt` 必须有实际内容,`title`、`tags`、`lyrics` 和 `makeInstrumental` 按实时 schema 提交;这里的 `title` 是 Suno 歌曲标题参数,其他节点不得把节点标题写进 config,标题一律用 `canvas node update --title`;`lyrics` 与 `makeInstrumental: true` 互斥。不要用 `tts` 节点生成音乐,也不要把 `audioModel` 的 TTS 模型写到 `musicModel`。
46
46
 
47
47
  创建后先回读节点类型、config 和 AUDIO 输出端口,再运行并等待任务。成功后回读 selected 版本,确认媒体类型为 `audio/*`、时长和文件非空并实际试听;任务失败或提交回执未知时先查任务,不自动重复发起付费请求。
48
48
 
@@ -6,7 +6,7 @@ description: 短剧全流程唯一入口。用于原创短剧的创建、恢复
6
6
 
7
7
  # 短剧制作主 Skill
8
8
 
9
- 本 Skill 是插件唯一入口。专业能力保存在 `references/` 模块中;不要凭模块名自行模仿,也不要一次性读取全部 reference。始终由无限画布的 `canvas workflow status`、项目文档版本和本目录 `module-map.json` 决定当前需要加载的最小模块集合。新项目不得创建固定功能节点。
9
+ 本 Skill 是插件唯一入口。专业能力保存在 `references/` 模块中;不要凭模块名自行模仿,也不要一次性读取全部 reference。始终由无限画布的 `canvas workflow status`、项目文档版本和本目录 `module-map.json` 决定当前需要加载的最小模块集合。新项目不得预搭旧版固定功能节点链。
10
10
 
11
11
  ## 固定控制循环
12
12
 
@@ -32,7 +32,7 @@ description: 短剧全流程唯一入口。用于原创短剧的创建、恢复
32
32
  | asset-analysis | `plan-drama-assets` → `generate-drama-art-style`,存在人物时增加 `generate-character-profiles` |
33
33
  | asset-generation | `manage-drama-assets`,缺少可复用资产时按需增加人物、场景、道具生成与生成服务模块 |
34
34
  | production-plan | 按条件加入 `design-fight-video`,再执行结构化分镜、制作计划与连续性模块 |
35
- | media-production | 原创项目按镜头选择分镜图类型、视频提示词、镜头审核、视频生成和任务监控;复杂调度按需增加 Blender 白模,按声音策略增加音频模块 |
35
+ | media-production | 原创项目按镜头生成已选择的分镜图类型并完成逐镜审计,再写视频提示词、生成视频和监控任务;复杂调度按需增加 Blender 白模,按声音策略增加音频模块 |
36
36
  | editing | `remotion-best-practices` → `edit-drama-timeline` |
37
37
  | delivery | `edit-deliver-drama` |
38
38
 
@@ -6,6 +6,6 @@
6
6
 
7
7
  出图前必须对人物档案执行 `assertCharacterReadyForVisuals`:未知年龄不得生成视觉资产;成年人物必须保留已批准的 `adult-charisma`、专属妆发、服装标识和全部记忆锚点;儿童只允许 `child-cuteness`,禁止成人妆容、成人化服装、性感姿态、身体曲线强调和性化镜头语言。魅力设计服从时代、职业、阶层、伤病和剧情状态,不能靠无据裸露或模板化网红脸替代人物设计。
8
8
 
9
- 对所有无依赖形象全量提交 `generate_image`;StarRouter 并发由画布任务门禁控制,其余请求排队;同一人物的派生造型只在基础形象选版后进入下一并发层。`prompt_document` 必须引用该人物所在的当前 `asset-plan`:`{kind:"asset-plan",episode_key,version_id,asset_key}`;实际 prompt 必须等于 `character_asset_sheet` 的已留痕输出。参考图仅传该人物已选主形象,避免串脸。提交前展示并确认模型、数量、尺寸、参考路径和制作计划,不计算具体价格。检查脸型、发型、体型、服装版本、时代与标志物;每个候选都保存为画布资产版本并写入相同制作文档引用。新生成候选禁止直接选版,必须先按 `review-drama-shots` 的人物专项合同通过保真预览与必要的局部裁切完整检查,再写入审核记录并原子审核和选版。审核绑定当前画风 ID 与内容哈希,并按用户选定媒介记录实际可见证据;不得固定使用真人写实标准。
9
+ 每个无依赖形象使用独立的 `character-turnaround` 节点(由画布按人物视觉方案物化,必要时再单独创建),`count` 只控制候选数,多结果不能拼图;同一人物的派生造型只在基础形象选版后进入下一并发层。节点 `prompt` 端口连接该人物的 `character-visual-design` 输出(`character-resource → character-visual-design → character-turnaround`),config 只写实时 schema 允许的 `count`、`aspectRatio` 和模型参数,不手写 `config.prompt` 冒充人物设定。节点正文由默认模板 `character_asset_sheet` 按当前 `asset-plan` 选版、已确认档案和完整项目画风对象编译,实际提交的 prompt 必须等于该模板输出;不得改成单张立绘,也不得改用 `image-generate` 代替,后者不追加角色设定板合同。`reference` 端口只连该人物已选主形象,避免串脸。提交前展示并确认模型、数量、尺寸、参考路径和制作计划,不计算具体价格。每个候选保存为画布资产版本;检查脸型、发型、体型、服装版本、时代与标志物。新生成候选禁止直接选版,必须先按 `review-drama-shots` 的人物专项合同通过保真预览与必要的局部裁切完整检查,再写入审核记录并原子审核和选版。审核绑定当前画风 ID 与内容哈希,并按用户选定媒介记录实际可见证据;不得固定使用真人写实标准。
10
10
 
11
11
  使用 StarRouter 时明确从以下枚举取值:`model=gpt-image-2`;`resolution ∈ {1K,2K,4K}`;`aspect_ratio ∈ {1:1,16:9,9:16,4:3,3:4}`;`quality ∈ {auto,low,medium,high}`;`background ∈ {auto,opaque,transparent}`;`moderation ∈ {auto,low}`;`output_format ∈ {png,jpeg,webp}`;`n=1..4`。人物资产默认 `background=opaque`;需要后期抠图时才确认 `transparent`。
@@ -6,6 +6,6 @@
6
6
 
7
7
  同一道具存在多个状态版本时,先生成并选定基础状态;后续状态必须把该选版作为身份参考,只改变版本证据明确要求的开合、破损、内容物或使用痕迹,并保持尺寸等级、结构、材质、纹样和独特锚点。基础状态缺少可用选版时不生成派生状态;不得用人物或手部充当尺度参照。
8
8
 
9
- 对同一依赖层的全部道具全量提交 `generate_image`;StarRouter 并发由画布任务门禁控制,其余请求排队;派生状态只在基础状态选版后进入下一并发层。生成白底居中、单道具资产图,传 `{kind:"asset-plan",episode_key,version_id,asset_key}`,并按登记模板编译完整项目画风对象;实际 prompt 必须等于 `prop_generate` 的已留痕输出。提交前展示并确认模型、数量、尺寸、参考路径和制作计划,不计算具体价格。保存为画布资产版本并写入相同制作文档引用;检查结构、数量、纹样、损伤状态以及 renderingContract 的媒介、材质和成像规则。新生成候选不得直接选版,必须写入审核记录,绑定当前画风 ID 与内容哈希后才可原子选版。
9
+ 同一依赖层的每个道具使用独立的 `prop-turnaround` 节点(由画布按道具设定物化,必要时再单独创建),`count` 只控制候选数;派生状态只在基础状态选版后进入下一并发层。节点 `prompt` 端口连接该道具的 `prop-resource` 输出,config 只写实时 schema 允许的 `count`、`aspectRatio` 和模型参数,不手写 `config.prompt` 冒充道具设定。节点正文由默认模板 `prop_generate` 按当前 `asset-plan` 选版和完整项目画风对象编译,实际提交的 prompt 必须等于该模板输出;服务端会追加白底、单道具、主视图加正/侧/背三视图的资产图合同,不得改用 `image-generate` 或重新手写背景与视图要求。提交前展示并确认模型、数量、尺寸、参考路径和制作计划,不计算具体价格。每个候选保存为画布资产版本;检查结构、数量、纹样、损伤状态以及 renderingContract 的媒介、材质和成像规则。新生成候选不得直接选版,必须写入审核记录,绑定当前画风 ID 与内容哈希后才可原子选版。
10
10
 
11
11
  StarRouter 图片枚举:`model=gpt-image-2`;`resolution ∈ {1K,2K,4K}`;`aspect_ratio ∈ {1:1,16:9,9:16,4:3,3:4}`;`quality ∈ {auto,low,medium,high}`;`background ∈ {auto,opaque,transparent}`;`moderation ∈ {auto,low}`;`output_format ∈ {png,jpeg,webp}`;`n=1..4`。
@@ -6,7 +6,7 @@
6
6
 
7
7
  `asset-plan` 中场景存在 `derived_from` 时,不得从零重画:先读取母场景当前 selected 本地图片,把它作为结构与材质参考,只生成版本证据明确要求的时段、天气、前景或陈设变化,并保持建筑骨架、出入口、固定锚点、尺度和磨损一致。母场景没有可用选版时将该变体保持 blocked,不用文字描述冒充视觉继承。
8
8
 
9
- 对同一依赖层的全部场景全量提交 `generate_image`;StarRouter 并发由画布任务门禁控制,其余请求排队;`derived_from` 场景只在母场景选版后进入下一并发层。调用时传 `{kind:"asset-plan",episode_key,version_id,asset_key}`,并按登记模板编译完整项目画风对象;实际 prompt 必须等于 `scene_asset_sheet` 的已留痕输出。提交前展示并确认模型、数量、尺寸、参考路径和制作计划,不计算具体价格。保存为画布资产版本并写入相同制作文档引用;检查父子空间、固定锚点、时代、建筑结构、光线方向以及当前 renderingContract 的媒介、材质和成像规则。新生成候选不得直接选版,必须写入审核记录,绑定当前画风 ID 与内容哈希后才可原子选版。
9
+ 同一依赖层的每个场景使用独立的 `location-image` 节点(由画布按场景设定物化,必要时再单独创建),`count` 只控制候选数;`derived_from` 场景只在母场景选版后进入下一并发层。空间设定多视图使用 `locationImagePurpose: location-sheet`;只有确实需要单幅无分格干净背景时才另建 `background-plate` 节点,不能在一次设定板生成里混用两种用途。节点 `prompt` 端口连接该场景的 `location-resource` 输出,config 只写实时 schema 允许的 `count`、`aspectRatio`、`locationImagePurpose` 和模型参数,不手写 `config.prompt` 冒充场景设定。节点正文由默认模板 `scene_asset_sheet` 按当前 `asset-plan` 选版和完整项目画风对象编译,实际提交的 prompt 必须等于该模板输出;不得改用 `image-generate` 退化成单张泛化背景,它不追加九视角空间设定板合同。提交前展示并确认模型、数量、尺寸、参考路径和制作计划,不计算具体价格。每个候选保存为画布资产版本;检查父子空间、固定锚点、时代、建筑结构、光线方向以及当前 renderingContract 的媒介、材质和成像规则。新生成候选不得直接选版,必须写入审核记录,绑定当前画风 ID 与内容哈希后才可原子选版。
10
10
 
11
11
  正式出图必须用 `scene_asset_sheet` 生成同一场景的九视角网格、平面布局、轴测图、色卡和关键材质样本;各视角共享同一空间结构。网格只是空间信息布局,不得把用户媒介偷换成概念原画、真人摄影、二维厚涂或三维游戏场景;以当前 renderingContract 为唯一媒介事实源。不得在调用处退化为单张泛化背景。
12
12
 
@@ -6,7 +6,7 @@
6
6
  - 标有“Codex 执行合同”的模板是细化合同:其中 `{name}` 是具名输入槽,不是让 Codex 猜测的自然语言变量。Codex 从 Skill 指定的 selected 项目文件组装同名值,缺少值时停止或保留未决,不虚构。
7
7
  - 合同中的“角色”描述只是专业职责边界,不建立第二个代理,也不把内容发给外部文本模型。
8
8
  - Codex 完成输出后,用登记模板渲染并保存合同快照、变量、解析后的合同和实际产物哈希。
9
- - `module-map.json` 的 `provider_prompts` 才是直接渲染后提交给图片模型的媒体提示词;Codex 按模板具名输入槽填值后,用 `canvas node write-video-prompt` 写入节点配置,再由画布生成节点提交,没有独立的本地渲染子命令。
9
+ - `module-map.json` 的 `provider_prompts` 才是直接渲染后提交给媒体模型的提示词;Codex 按模板具名输入槽填值后,图片与分镜板模板写入对应生成节点的正文或结构化输入端口,视频提示词用 `canvas node write-video-prompt` 写入 `storyboard-video-prompt` 节点,再由画布生成节点提交,没有独立的本地渲染子命令。
10
10
  - 一个模块有多个合同时,`module-map.json.completion_prompts` 指定能证明最终资产完成的合同;局部细化、修改和推荐合同只作辅助,不能单独通过阶段门禁。
11
11
 
12
12
  文本合同与媒体提示词都必须留在所属模块,避免一个全局长提示词同时承担分析、剧本、分镜和生成。阶段编排只加载当前 reference,所以 Codex 不需要一次理解全部模板。
@@ -1,11 +1,11 @@
1
1
  # 生成分镜图片
2
2
 
3
- 处理制作计划中的全部镜头,包括另有 Blender 白模的镜头。先读取每镜 `storyboard_strategy.primary_board_type`、`required_board_types` 和 `selection_basis`,只生成合同声明的板型;`selection_basis` 缺失、主类型不在 `required_board_types` 或证据不足时退回 production-plan,不得直接出图。视频镜头根据 required_board_types 生成实际选择的独立参考板:`board-epNNN-temporal-NNN` 使用 `panel_grid_image`,按时间顺序固定动作阶段与精确状态;`board-epNNN-shot-NNN` 使用 `panel_storyboard_image`,按叙事节拍固定景别、调度、轴线和构图。若 `required_board_types` 额外包含 `narrative`、`blocking`、`action`、`choreography`、`comprehensive` 或 `director-track`,使用画布图片节点支持的对应 `board-type` 参数生成独立主类型资产,并以 `board-epNNN-{type}-NNN` 登记;`previz-3d` 仍由 Blender 模块生成。所有已选择的视频板均使用 `image_strategy.panel_grid_size`,默认 6 格,Codex 可按不可合并的动作或叙事节拍选择 2–16 格;不得用同一图片或同一资产版本冒充不同板型。Blender 是按需追加的空间和运动预演,不替代已选择的分镜参考。
3
+ 处理制作计划中的全部镜头,包括另有 Blender 白模的镜头。先读取每镜 `storyboard_strategy.primary_board_type`、`required_board_types` 和 `selection_basis`,只生成合同声明的板型;`selection_basis` 缺失、主类型不在 `required_board_types` 或证据不足时退回 production-plan,不得直接出图。视频镜头根据 required_board_types 生成实际选择的独立参考板:`board-epNNN-temporal-NNN` 使用 `panel_grid_image`,按时间顺序固定动作阶段与精确状态;`board-epNNN-shot-NNN` 使用 `panel_storyboard_image`,按叙事节拍固定景别、调度、轴线和构图。若 `required_board_types` 额外包含 `narrative`、`blocking`、`action`、`choreography`、`comprehensive` 或 `director-track`,使用 `storyboard-image` 节点按该镜 `storyboard_strategy` 声明的主类型生成独立资产版本,并以 `board-epNNN-{type}-NNN` 登记;`previz-3d` 仍由 Blender 模块生成。所有已选择的视频板均使用 `image_strategy.panel_grid_size`,默认 6 格,Codex 可按不可合并的动作或叙事节拍选择 2–16 格;不得用同一图片或同一资产版本冒充不同板型。Blender 是按需追加的空间和运动预演,不替代已选择的分镜参考。
4
4
 
5
5
  分镜图提示词遵循 [通用提示词规范](../prompt/prompt-craft.md) 的结构与质量分级,并严格填充 [提示词索引](../prompt-skill-index.md) 的变量;`style` 必须传项目当前完整 `creative.art_style` 对象,按登记模板编译 renderingContract,不得只传画风名或一句风格短语。多格图根据计划中的 `panel_grid_size` 选择可读布局并同时提供 `grid_layout`,不得减少、留空、重复格子或把相邻镜头剧情画进当前镜头。宫格切单格后只允许用 `panel_grid_enhance` 保真高清化,不得重构图。
6
6
 
7
7
  分镜构图合同的 code 必须先编译成可见几何再出图:图片提示词只写主体位置、视线留白、前中后景、光源方向与剧内来源、遮挡、动作方向与镜尾状态,不罗列构图 code 或模式目录;拿不准 code 的画面结构、证据门槛或 ai_risks 防控时按需查阅 [导演构图模式参考](../director-composition.md)。evidence 需要 set_dressing/weather_atmosphere/action_blocking(含 `+` 复合证据,逐组件成立)时,set_dressing/weather_atmosphere 元素必须有原文或已选资产支撑,action_blocking 还可由已确认调度事实支撑,但调度事实不能替代天气/陈设证据;均无据的元素是阻塞性冲突:不调用出图,按模板把缺失证据写入 unresolved 并退回分镜,不得让模型自补雨、雪、雾、霓虹、镜面、烟尘、门窗廊柱、武器或多余人物。
8
8
 
9
- 整集所有门禁已通过的镜头只提交已选择板型对应的 `generate_image` 目标全量提交;请求统一使用 StarRouter 凭据,按画布任务门禁排队。两者都传 `{kind:"storyboard",episode_key,version_id,shot_number}`,但必须分别使用上述目标 key 和对应模板,实际 prompt 等于本阶段已留痕的 Provider 提示词输出。本地参考图统一放入 `reference_paths`;`reference_manifest` 与路径等长且逐项包含 `{type:"image",order,asset_key,version_id,role}`。参考资产的画风审核哈希必须与当前 renderingContract 一致;旧画风资产先失效重做,不让新提示词与旧媒介参考互相拉扯。提交前只展示模型、数量、尺寸、参考用途与制作计划,不计算具体价格。所有已生成板型分别完成对应审核并选版后,才进入视频提示词与生成。
9
+ 整集所有门禁已通过的镜头只提交已选择板型对应的画布生图节点:`temporal` 用 `storyboard-grid-image`(默认模板 `panel_grid_image`),`shot-board` 用 `storyboard-board-image`(默认模板 `panel_storyboard_image`),其余已选择主类型用 `storyboard-image`。`prompt` 端口连接本镜结构化分镜(及人物、场景、道具设定),`reference` 端口连接已选设定图与已选板型参考;config 只写实时 schema 允许的板型参数(`gridSize`、`count`、`aspectRatio`,`storyboard-image` 另有 `imageLayout`)和模型参数,实际值与制作计划不一致时先改计划,不靠改节点配置掩盖选择。实际 prompt 必须等于本阶段已留痕的 Provider 提示词输出;本列表不得改用 `image-generate`,它不追加分镜板合同。参考图只通过节点 `reference` 端口连接已选设定图和已选板型,由服务端按实际连线、节点选版与文件摘要复核,不手写参考清单或临时路径。参考资产的画风审核哈希必须与当前 renderingContract 一致;旧画风资产先失效重做,不让新提示词与旧媒介参考互相拉扯。提交前只展示模型、数量、尺寸、参考用途与制作计划,不计算具体价格。所有已生成板型分别完成对应审核并选版后,才进入视频提示词与生成。
10
10
 
11
11
  使用 StarRouter 时明确从以下枚举取值:`model=gpt-image-2`;`resolution ∈ {1K,2K,4K}`;`aspect_ratio ∈ {1:1,16:9,9:16,4:3,3:4}`;`quality ∈ {auto,low,medium,high}`;`background ∈ {auto,opaque,transparent}`;`moderation ∈ {auto,low}`;`output_format ∈ {png,jpeg,webp}`;`n=1..4`。
@@ -75,10 +75,11 @@
75
75
  | `voice-design` | `prompt` 描述音色;`previewText` 为试听文本 | `canvas node update` / `canvas apply`;试听后用户确认才绑定 |
76
76
  | `voice-clone` | 没有提示词字段;参考音频走 `audio` 端口,`prefix`、`targetModel`、`maxPromptAudioLength` 等在 config | 只连端口与 config;样本来源与截取区间必须先确认 |
77
77
  | `tts` | `text` 为正式台词;`voice` 走端口或 `voice` 字段,`instruction`、`rate`、`volume`、`pitch`、`format` 等按 schema | 同上;不用 `prompt` 顶替 `text`,不用 TTS 生成音乐 |
78
- | `music-generate` | `prompt`、`title`、`tags`、`lyrics`、`makeInstrumental` | 同上;`lyrics` 与 `makeInstrumental: true` 互斥 |
78
+ | `music-generate` | `prompt`、`title`、`tags`、`lyrics`、`makeInstrumental` | 同上;`title` 是该节点的 Suno 歌曲参数,其他节点标题走 `--title`;`lyrics` 与 `makeInstrumental: true` 互斥 |
79
79
  | `video-generate` | 自由画布写 `prompt`;短剧流程用 `write-video-prompt` 写 `h3`/`seedance` 正式文本;首尾帧、参考图/视频/音频走端口 | 不得用 `prompt` 覆盖模型语言和结构合同 |
80
80
 
81
81
  - 节点 `prompt` 只补充创作意图,服务端会追加语言与最终结构合同;冲突时以后置合同为准。不要把语言标签、引用语法或 JSON 结构塞进 `prompt` 去覆盖服务端。
82
+ - config 只写实时 `canvas node types` 中该 kind 的 `configSchema.properties` 键;`title`、坐标和端口不是 config 字段,节点标题用 `--title`。服务端或调用方提示某字段不是合法配置字段时,删除该字段后按实时 schema 重试,不猜字段名,也不用重复提交绕过校验。
82
83
  - 结构化资产和分镜节点的 `prompt` 端口只接受对应类型的输入:人物、场景、道具和分镜数据先由自由画布文档或结构化节点产出并选版,再连到节点;直接写一段自由文本不能代替结构化输入。
83
84
  - 图片和音频节点同样有实时模型能力:分辨率、时长、素材上限和输入端口以 `canvas node types` 为准。不要因为它们不是视频,就把九组视频维度原样粘贴进 `prompt`;按本节之前的模态裁剪选取必要维度。
84
85
  - 写入后回读节点 config 与连线,确认字段落在正确键上、参考素材仍连在端口上、模型与参数未被覆盖,再提交付费任务。只写 `prompt` 却让端口悬空,等同于没有引用素材。
@@ -2,7 +2,7 @@
2
2
 
3
3
  所有文件都是插件内置静态资产,不依赖外部提示词目录、数据库或业务系统。先读取 [Codex 原生合同说明](codex-contracts.md):文本类文件是 Codex 执行合同,不再作为 system prompt 发送给另一个 LLM;`module-map.json` 的 `provider_prompts` 才是直接提交媒体模型的模板。主 Skill 按 module ID 决定何时加载哪一份,Codex 每次只处理当前原子步骤。
4
4
 
5
- 花括号变量是具名输入槽。文本步骤完成后,用登记模板留存合同、变量和产物;媒体模板由 Codex 填值后写入画布节点(`canvas node write-video-prompt`),不存在本地渲染子命令。缺少变量或包含密钥字段时失败。
5
+ 花括号变量是具名输入槽。文本步骤完成后,用登记模板留存合同、变量和产物;媒体模板由 Codex 填值后写入画布节点(视频用 `canvas node write-video-prompt`,资产图与分镜板写入对应生成节点的正文或结构化输入端口)。这些默认模板是 Agent 生成媒体时的参考正文,随包保留,不因节点已内置设定板合同而删除或改写;节点追加的服务端合同只能在模板正文之后生效,不能替代模板。缺少变量或包含密钥字段时失败。
6
6
 
7
7
  | 原子产物 | 模块 | 模板 |
8
8
  |---|---|---|
@@ -6,7 +6,7 @@
6
6
 
7
7
  每镜已选择的分镜板生成候选后,先用图像查看能力逐张检查完整画面的保真预览;小字、面部、手部、道具或格间细节另做局部裁切检查,不得把生产原件直接上传,也不能只看界面缩略图、文件存在或生成状态。随后结合前后镜、结构化分镜、人物/场景/道具选版和项目画风做整集连续审计。每个已生成板型都必须写独立审核记录,`criteria` 严格按以下八项原顺序记录 `{criterion,status,observation}`:`空间关系与轴线`、`时间与动作连续性`、`物理与交互逻辑`、`光线与色彩连续性`、`人物身份与造型一致性`、`场景与道具一致性`、`构图与镜头语言`、`叙事覆盖与阅读顺序`。时间故事版重点核对动作阶段与状态变化,镜头分镜板重点核对景别、调度、轴线和叙事节拍;每个已选择的板型都需完整通过八项。任何一项 failed 都必须修订或重生成后复审,所有已选板型通过前不得制作正式视频。
8
8
 
9
- 分镜审计通过后、视频提示词编译前执行 `plan-shot-continuity`。审计观察必须足以支持人物位置、姿态、运动方向、持物、出入画边、轴线、机位侧和主光锚点;看不清或上下镜冲突的内容进入连续性计划 `unresolved`,不得用主观判断补齐。启用 previous-tail 的下一镜还要确认上一镜结束状态已稳定可读,并与同机位承接相容。
9
+ 顺序固定为 `storyboard-breakdown → drama-production-plan → drama-continuity-plan → 分镜板生成与逐镜审计`:`drama-shot-review` 的 `continuityPlan` 是入参,逐镜审计前必须已有与当前分镜和制作计划同版本的连续性计划。审计完成后再发现上下镜冲突时,追加新的连续性计划版本、重新审计受影响镜头,不改写旧版本,也不带缺失入参提交审计。审计观察必须足以支持人物位置、姿态、运动方向、持物、出入画边、轴线、机位侧和主光锚点;看不清或上下镜冲突的内容进入连续性计划 `unresolved`,不得用主观判断补齐。启用 previous-tail 的下一镜还要确认上一镜结束状态已稳定可读,并与同机位承接相容。
10
10
 
11
11
  `storyboard_strategy.mode=blender` 的镜头还要完整观看白模分镜,并核对实际选择的静态分镜板;未选择的板型不产生额外审核门禁。审核记录必须以 `asset_sha256` 绑定正在观看的白模文件,并把 `watch_evidence.duration_seconds` 写成实际探测时长;两者与资产账本或制作计划不一致时不得批准。`criteria` 严格按 `剧情因果与节拍`、`人物调度与表演`、`相机动机与运动曲线`、`构图与视觉层级`、`空间、轴线与连续性`、`物理与接触`、`技术交付` 原顺序记录,并写入对应满分 20/15/20/15/15/10/5 的 `score.breakdown`。同时按导演合同原顺序填写 `hard_gates[]`,每项包含 `gate/status/frame/observation`;任一硬门禁 failed 都不得批准。审核入口会在自动选版前复核导演合同路径与哈希、实际时长/帧率/帧数/分辨率及当前制作计划版本。总分至少 85、每项至少达到该项满分 70%、全部 criteria 和 hard_gates passed,且 `watchedFull` 与首/中/尾证据完整才可批准和选版。
12
12