@aswless_854771076/ai_short_studio_cli 0.1.157 → 0.1.159

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.
Files changed (28) hide show
  1. package/README.md +23 -5
  2. package/dist/command-helpers.js +1 -0
  3. package/dist/commands/canvas/asset/select.d.ts +1 -0
  4. package/dist/commands/canvas/asset/select.js +1 -0
  5. package/dist/commands/canvas/continuity/analyze.js +1 -1
  6. package/dist/commands/canvas/settings/set.d.ts +1 -0
  7. package/dist/commands/canvas/settings/set.js +2 -1
  8. package/package.json +1 -1
  9. package/skills/using-vvicat-ai-short-studio-cli/SKILL.md +15 -13
  10. package/skills/using-vvicat-ai-short-studio-cli/references/agent-recovery.md +1 -1
  11. package/skills/using-vvicat-ai-short-studio-cli/references/assets-and-storyboard.md +11 -0
  12. package/skills/using-vvicat-ai-short-studio-cli/references/canvas-inspection.md +10 -0
  13. package/skills/using-vvicat-ai-short-studio-cli/references/canvas-media-gates.md +39 -0
  14. package/skills/using-vvicat-ai-short-studio-cli/references/canvas-production-principles.md +11 -0
  15. package/skills/using-vvicat-ai-short-studio-cli/references/commands/canvas.md +8 -2
  16. package/skills/using-vvicat-ai-short-studio-cli/references/project-and-canvas.md +1 -1
  17. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/SKILL.md +2 -2
  18. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-character-images.md +1 -1
  19. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-prop-assets.md +1 -1
  20. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-scene-assets.md +1 -1
  21. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/codex-contracts.md +1 -1
  22. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/feature-completeness.md +2 -2
  23. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-storyboard-images.md +2 -2
  24. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/write-drama-video-prompts.md +1 -1
  25. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/prompt-craft.md +2 -1
  26. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt-skill-index.md +1 -1
  27. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-shots.md +1 -1
  28. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-shot-continuity.md +3 -3
package/README.md CHANGED
@@ -7,23 +7,35 @@ npm view @aswless_854771076/ai_short_studio_cli dist-tags.latest
7
7
  npm install --global @aswless_854771076/ai_short_studio_cli@latest
8
8
  ai-short-studio --version
9
9
  ai-short-studio auth login
10
+ ai-short-studio auth login --provider supabase
10
11
  ai-short-studio project list --json
11
12
  ai-short-studio canvas node types --json
12
13
  ```
13
14
 
14
15
  npm 包只内置一个 `using-vvicat-ai-short-studio-cli` Agent Skill。短剧和 humanizer 等参考资料统一放在该 Skill 的 `references/` 下。安装或升级 CLI 时,`postinstall` 会自动安装或更新这个 Skill;用户修改过或不由 CLI 管理的副本不会被覆盖。设置 `VVICAT_SKIP_SKILL_INSTALL=1` 可关闭自动安装。
15
16
 
16
- 短剧采用专业拆镜,Agent 按每镜制作目标选择单幅分镜图、时间故事版、镜头分镜板或专项板;不会自动补生成未选择的板型。用户要求只完成分镜图时不执行视频提示词或视频。`canvas node edit-shot` 会同步镜头字段别名并拒绝改写来源原文;修改时长后检查响应的 `durationOverrides`,保留的下游手工时长需要逐项确认。
17
+ 短剧默认采用专业拆镜,逐镜保留时间宫格与镜头故事版;`count: 1` 不表示单格,用户要求只完成分镜图时不执行视频提示词或视频。`canvas node edit-shot` 会同步镜头字段别名并拒绝改写来源原文;修改时长后检查响应的 `durationOverrides`,保留的下游手工时长需要逐项确认。普通单帧不能提交为专业双板审核。
17
18
 
18
19
  `skill install/status/update` 管理这个唯一 Skill。短剧创作、humanizer 审计和自由画布视频制作资料通过主 Skill 的 references 按需读取。
19
20
 
20
- CLI 默认使用 MemHub 浏览器授权。已有 Supabase 登录档案仍可用于兼容旧环境,但公开帮助只展示 MemHub 登录方式。
21
+ `references/canvas-production-principles.md`、`references/canvas-inspection.md` 与 `references/canvas-media-gates.md` 是 CLI 与内置 Agent 共用的业务经验正文;CLI 继续按原命令合同执行。内置接入仍在开发验证,不代表侧栏已可用。
21
22
 
22
- CLI 将长期凭据保存到系统钥匙串。短期 access token 会写入权限为 `0600` 的本机 session 缓存;同一 profile 的并发进程通过跨进程锁共享刷新结果。退出登录会清除该缓存,CI 可用 `VVICAT_ACCESS_TOKEN` 直接注入临时令牌。未配置服务地址时默认连接 `https://ai-short-studio.vvicat.dev`,`--base-url`、`VVICAT_BASE_URL` 和当前 profile 可依次覆盖。服务地址和非敏感 profile 写入系统配置目录;切换环境时必须使用独立的 `--profile`,避免复用旧认证。
23
+ 生产环境登录使用 MemHub 浏览器授权;兼容 Supabase 的邮箱注册和登录从 stdin 读取密码:
23
24
 
24
- 创作前运行 `ai-short-studio preflight --json`。CLI 会通过公开的 `/api/v1/bootstrap` 检查服务连通性、取得 Supabase 公共配置、读取 npm `latest` 稳定版本并自动更新全局 CLI;更新成功后按输出重新运行。临时不更新时传 `--no-update`。随后预检检查登录态和文本、人物、场景、故事版、视频模型配置。npm registry 暂时不可用时服务端使用配置版本降级。
25
+ ```bash
26
+ ai-short-studio auth signup --provider supabase --email user@example.com --password-stdin
27
+ ai-short-studio auth login --provider supabase --email user@example.com --password-stdin
28
+ ```
29
+
30
+ Agent 代操作时,用户已在当前会话明确提供的密码只能直接写入正在等待的隐藏密码提示,不得复述、拼入 shell 命令、落盘或跨会话保存。
31
+
32
+ 注册响应中的 `confirmationRequired` 表示是否需要先完成邮件验证。Supabase 直接返回会话时,CLI 会立即登录并把 refresh token 保存到系统钥匙串;需要邮件验证时不会写入空凭据,验证后再执行登录。MemHub 登录成功后使用短期 API Key 访问服务。
33
+
34
+ 注册确认链接使用当前 profile 的 `baseUrl` 和 `--locale`,指向同域的 `/{locale}/auth/callback`。API 与网页需保持同域,并在 Supabase Redirect URLs 中允许各环境的 `/**`;Site URL 只作为未显式传入回调时的生产兜底。
25
35
 
26
- 专业拆镜由 Agent 按镜头合同选择实际需要的板型;已有首帧与历史产物保留,额外单图、时间故事版或镜头分镜板按需添加和接线,不为满足默认规则自动补板。
36
+ CLI 只把 refresh token 保存到系统钥匙串。短期 access token 会写入权限为 `0600` 的本机 session 缓存;同一 profile 的并发进程通过跨进程锁共享刷新结果,只有缓存缺失或确实需要刷新时才访问钥匙串,从而避免 Agent 批量操作反复触发 macOS Keychain。退出登录会清除该缓存,CI 可用 `VVICAT_ACCESS_TOKEN` 直接注入临时令牌。未配置服务地址时默认连接 `https://ai-short-studio.vvicat.dev`,`--base-url`、`VVICAT_BASE_URL` 和当前 profile 可依次覆盖。首次登录会从服务端 bootstrap 取得 Supabase 公共配置,也可用 `VVICAT_SUPABASE_URL`、`VVICAT_SUPABASE_PUBLISHABLE_KEY` 显式覆盖。Google 登录在 Windows 上直接调用系统 URL Handler,确保带 `&` 的 PKCE 授权参数完整传给浏览器。服务地址和非敏感 profile 写入系统配置目录;切换环境时必须使用独立的 `--profile`,避免复用旧认证。
37
+
38
+ 创作前运行 `ai-short-studio preflight --json`。CLI 会通过公开的 `/api/v1/bootstrap` 检查服务连通性、取得 Supabase 公共配置、读取 npm `latest` 稳定版本并自动更新全局 CLI;更新成功后按输出重新运行。临时不更新时传 `--no-update`。随后预检检查登录态和文本、人物、场景、故事版、视频模型配置。npm registry 暂时不可用时服务端使用配置版本降级。
27
39
 
28
40
  ## 命令范围
29
41
 
@@ -222,3 +234,9 @@ Use `canvas node diagnose` to inspect inputs, selected versions, task status and
222
234
  Agent 可直接在 `text-resource` 节点保存剧本、导演本和制作计划等自由画布文档(文档结构由平台画布统一校验);每次保存都通过 `--input` 固化上游版本,审核使用独立 `canvas.review.v1` 文档。历史 `screenplay-resource` 和 `storyboard-draft` 只用于迁移旧项目,不得用于新项目。
223
235
 
224
236
  Agents author freeform JSON documents directly in `text-resource` nodes and preserve every source version through `--input`; legacy screenplay resources and storyboard drafts are migration-only compatibility paths.
237
+
238
+ `canvas asset select-version`(或 `asset select`)修改资产全局选版,不覆盖节点的固定输出版本。网页节点“查看版本”和内置助手的 `canvas_select_version` 只切换当前节点,保留兄弟节点与全局选版,并使下游过期;运行中节点不能切版。读取或编辑节点时优先使用 `selectedOutputVersionId`。本次没有新增 CLI 节点切版命令,不能用普通配置补丁代替。
239
+
240
+ 画布 settings 管理制作配置,不修改内置助手 agentModel;项目 outputLanguage 创建后不可改。null 只对可覆盖字段恢复默认。内置助手使用专用工具复用同一保存服务,CLI 继续使用 canvas settings get/set。
241
+
242
+ 连续性 --apply-ready 只配置尾帧提取节点和连线,不运行媒体任务。网页、CLI与内置助手复用同一分析规则;读取图和设置版本不一致时重新分析,不覆盖新图。内置助手的专用工具额外核对分析指纹和指定建议。
@@ -22,6 +22,7 @@ export function canvasEditConflictReason(error) {
22
22
  return reason === 'CANVAS_VERSION_CONFLICT' || reason === 'ASSET_VERSION_RACE' ? reason : null;
23
23
  }
24
24
  export async function resolveCanvasNodeVersionId(api, projectId, node) {
25
+ // 普通媒体和结构化资源都可固定节点选版,不能被资产全局选版替代。
25
26
  const selectedOutputVersionId = node.data.selectedOutputVersionId;
26
27
  if (typeof selectedOutputVersionId === 'string' && selectedOutputVersionId) {
27
28
  return selectedOutputVersionId;
@@ -1,5 +1,6 @@
1
1
  import { BaseCommand } from '../../../base-command.js';
2
2
  export default class CanvasAssetSelect extends BaseCommand {
3
+ static description: string;
3
4
  static args: {
4
5
  assetId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
5
6
  };
@@ -2,6 +2,7 @@ import { Args, Flags } from '@oclif/core';
2
2
  import { BaseCommand } from '../../../base-command.js';
3
3
  import { commandApi, projectFlag } from '../../../command-helpers.js';
4
4
  export default class CanvasAssetSelect extends BaseCommand {
5
+ static description = '设置资产全局选版;不覆盖节点已固定的输出版本';
5
6
  static args = { assetId: Args.string({ required: true }) };
6
7
  static flags = { ...BaseCommand.baseFlags, project: projectFlag, version: Flags.string({ required: true }) };
7
8
  async run() { const { args, flags } = await this.parse(CanvasAssetSelect); const { api } = await commandApi(flags); this.print(await api.selectAssetVersion(flags.project, args.assetId, flags.version)); }
@@ -2,7 +2,7 @@ import { Flags } from '@oclif/core';
2
2
  import { BaseCommand } from '../../../base-command.js';
3
3
  import { commandApi, projectFlag } from '../../../command-helpers.js';
4
4
  export default class CanvasContinuityAnalyze extends BaseCommand {
5
- static description = '在生成视频前分析镜头依赖,并可修复已具备源视频的首尾帧连线';
5
+ static description = '只读分析镜头依赖;显式 --apply-ready 仅创建尾帧链,不运行媒体任务';
6
6
  static flags = {
7
7
  ...BaseCommand.baseFlags,
8
8
  project: projectFlag,
@@ -8,6 +8,7 @@ type ReadInput = (file?: string) => Promise<Record<string, unknown>>;
8
8
  export declare function parseSettingFlagValue(value: string): unknown;
9
9
  export declare function buildCanvasSettingsInput(flags: CanvasSettingsFlags, readInput?: ReadInput): Promise<Record<string, unknown>>;
10
10
  export default class CanvasSettingsSet extends BaseCommand {
11
+ static description: string;
11
12
  static flags: {
12
13
  project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
13
14
  field: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -40,10 +40,11 @@ export async function buildCanvasSettingsInput(flags, readInput = readJsonInput)
40
40
  return readInput(flags.file);
41
41
  }
42
42
  export default class CanvasSettingsSet extends BaseCommand {
43
+ static description = '修改画布制作设置;不修改助手模型,项目输出语言不可更改';
43
44
  static flags = {
44
45
  ...BaseCommand.baseFlags,
45
46
  project: projectFlag,
46
- field: Flags.string({ description: '要更新的设置字段;outputLanguage 支持 pt-BR 等 BCP 47 标签', dependsOn: ['value'], exclusive: ['file'] }),
47
+ field: Flags.string({ description: '要更新的画布字段;null 清除覆盖并继承默认,outputLanguage 只允许项目原语言', dependsOn: ['value'], exclusive: ['file'] }),
47
48
  value: Flags.string({ description: '字段值', dependsOn: ['field'], exclusive: ['file'] }),
48
49
  file: Flags.string({ description: '设置 JSON 文件;省略时读取 stdin', exclusive: ['field', 'value'] }),
49
50
  };
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.159",
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
@@ -9,6 +9,8 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
9
9
 
10
10
  ## 按需读取
11
11
 
12
+ 先遵循 [共享制作纪律](references/canvas-production-principles.md);只读检查现有画布时遵循 [共享画布检查流程](references/canvas-inspection.md)。媒体制作前读取 [共享媒体门禁](references/canvas-media-gates.md)。这些正文由 CLI 和内置助手共用;CLI 执行仍使用本 Skill 的命令合同。
13
+
12
14
  `SKILL.md` 只保留路由和主流程。按实际进度逐阶段读取命中的资料;长任务可以先后读取多份,但不要在开始时一次加载全部:
13
15
 
14
16
  - 项目创建、settings、批处理、目录或安全边界:[references/project-and-canvas.md](references/project-and-canvas.md)
@@ -30,9 +32,9 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
30
32
  | 原创短剧、小说改编、来源材料、市场灵感 | `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
33
  | 故事设定、人物弧线、分集规划 | `references/short-drama/creation/design-drama-bible.md`、`references/short-drama/creation/outline-drama-series.md` | 先确认 Brief,再运行 `drama-bible → drama-outline`;未确认集数、时长或结局不得自动补齐 |
32
34
  | 单集剧本、来源片段转剧本、剧本润色 | `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 未清零不得进入导演阶段 |
35
+ | 导演手册、摄影与表演 | `references/short-drama/creation/write-drama-director-book.md`、`references/short-drama/director-composition.md` | 在资产生成和拆镜前完成 `drama-director-book`;构图、轴线和表演决定必须来自剧本事实,证据不足时降级构图,不补陈设或天气 |
33
36
  | 人物、场景、道具和资产版本 | `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 |
37
+ | 结构化分镜、分镜图、逐镜制作计划与跨镜连续性 | `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
38
  | 视频提示词、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
39
  | 背景音乐、主题曲、纯音乐 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/generation/design-drama-audio.md` | 使用画布 `music-generate` 和实时音频模型目录;有自定义歌词时不得同时开启纯音乐;生成后试听并回读 AUDIO 资产版本 |
38
40
  | 去字幕、参考视频复刻、深度视频 | `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 +43,28 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
41
43
 
42
44
  自由画布短剧制作不要求预先搭建固定功能节点:Agent 先用 `canvas documents` 恢复分集,再按 `module-map.json` 选择模块;结果保存为 `canvas.<module>.v1` 版本并以 `--input` 记录来源,文档选版和审核证据作为阶段依据。
43
45
 
44
- 新项目禁止搭建上述固定功能节点链。每个阶段都必须由 Agent 在无限画布创建或更新 `text-resource` 自由画布文档,并通过 `canvas document save` 追加不可变版本;媒体节点只消费已审核的 自由画布文档和选定媒体版本。
46
+ 新项目禁止预搭旧版固定功能节点链(`screenplay-resource` 起始、`drama-*` 分析节点整条连好的流水线)。分析阶段每个产物都由 Agent 在无限画布创建或更新 `text-resource` 自由画布文档,并通过 `canvas document save` 追加不可变版本;媒体节点只消费已审核的自由画布文档和选定媒体版本。媒体生成节点和专业拆镜入口(`canvas node add storyboard-breakdown --source-format …`)仍是当前接口,由画布按文档物化或按需单独创建。
45
47
 
46
- 旧版固定节点命令仍保留用于读取和恢复历史项目,但不得作为新项目入口,也不得与 自由画布文档并行写入同一阶段。发现旧节点链时先用 `canvas documents` 和 `canvas workflow status` 建立 自由画布文档快照,再迁移受影响阶段;迁移完成后停止继续创建旧节点。
48
+ 旧版固定节点链仍保留用于读取和恢复历史项目,但不得作为新项目入口,也不得与 自由画布文档并行写入同一阶段。发现旧节点链时先用 `canvas documents` 和 `canvas workflow status` 建立 自由画布文档快照,再迁移受影响阶段;迁移完成后停止继续创建旧节点链。
47
49
  ## 核心原则
48
50
 
49
51
  生产环境认证优先使用 MemHub;CLI 通过浏览器 PKCE 登录或个人 API Key 访问,只有本地明确关闭 MemHub 时才使用 Supabase 兼容登录。
50
52
 
51
- 把 `ai-short-studio` 当作机器可读的远程控制接口。目标、素材含义、平台、语言、画幅、时长、风格、人物、场景、道具、模型、实时 schema、候选版本、付费范围或覆盖影响存在未知、缺失或矛盾时,合并询问最少必要问题;得到答复前只做只读检查。不得用示例值替用户作创作决定。短剧结构化节点的 `canvas node types` 结果包含 `structuredOutputSchema`;创建或运行前必须按该字段组织输出,不能从 `TEXT`/`SCRIPT` 字符串端口猜 JSON。节点 `prompt` 只能补充创作意图,服务端会把语言与最终结构合同追加在它之后,冲突时以后置合同为准。
53
+ 把 `ai-short-studio` 当作机器可读的远程控制接口。目标、素材含义、平台、语言、画幅、时长、风格、人物、场景、道具、模型、实时 schema、候选版本、付费范围或覆盖影响存在未知、缺失或矛盾时,合并询问最少必要问题;得到答复前只做只读检查。不得用示例值替用户作创作决定。节点 `prompt` 只能补充创作意图,服务端会把语言与最终结构合同追加在它之后,冲突时以后置合同为准。
52
54
 
53
55
  优先使用一次 `canvas inspect` 聚合查询。同阶段可合并的 settings、节点和连线分别使用 `canvas settings set --file`、`canvas apply`、`canvas node update-many`。生成链使用单个调度循环滚动提交,不用 `--wait` 把整批阶段串行化:节点一完成就刷新画布并立即提交它已就绪的下游节点。默认每类并发 4、总并发上限 16;同一节点同一输入指纹只允许一个在途任务,不并发启动多个相互竞争的调度器。409 重读并审阅差异;schema 和业务检查错误进入恢复链路,能修正的自主修正后继续。401/403、供应商余额等无法自主修正的问题报告准确原因,继续不依赖该节点的工作。
54
56
 
55
57
  ## 主流程
56
58
 
57
- 1. **预检与恢复**:运行 `preflight --json`;更新后重跑。再读取 `config get`、目标项目、`canvas documents` 和 `canvas workflow status`。只有历史项目需要新增媒体节点时才读取实时 `canvas node types`。`skill status --target codex` 非 current 时先询问再更新,禁止强制覆盖用户修改。
59
+ 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
60
  2. **项目语言门禁**:新建项目前必须从用户确认交付语言,并用 `project create --language <BCP47>` 写入;界面 `--locale` 不能代替内容语言。创建后回读 `project get` 与 `canvas settings get`,确认两者语言一致且不可修改。项目语言约束剧本、分镜、台词、配音、画面文字和字幕;验收须区分剧情内容与制作信息:项目语言允许正常外语穿插和规范英文摄影术语,不按字符种类判死;道具文字和剧情内界面遵循来源原文。存在实际语言合同冲突时停止并说明。
59
61
  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 失败只修复并重跑受影响镜头;未通过不得进入成片剪辑。
62
+ 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 复核。确认目标集数后,只生产该集实际需要的资产。
63
+ 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、错边未清零时拆镜前门禁失败。
64
+ 6. **拆镜与制作计划**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建默认专业拆镜,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2`,不自动新增首帧节点。结构化分镜之后依次生成逐镜制作计划和跨镜连续性计划;只有前镜已审核且选版时才允许 previous-tail。视频提交前必须完成素材连线、镜头逻辑和上下镜连续性审计。
65
+ 7. **分镜图与逐镜审计**:Agent 先读取每镜 `storyboard_strategy`,按制作目标选择单幅分镜图、时间故事版、镜头分镜板、专项板或 Blender;已选择一种板型时不得自动补生成另一种。只审核实际生成的板型,并让视频提示词只引用真实存在且已审核的分镜资产。逐镜审计 P0/P1 未清零不得写入视频提示词或提交视频。用户的停止阶段优先于 [滚动异步调度](references/async-pipeline.md):仅分镜图任务完成实际选择的板型并通过审核后停止,不运行视频提示词和视频。
66
+ 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)。
67
+ 9. **视频滚动生成与逐镜后验**:允许视频时,已就绪镜头滚动提交,单镜失败不阻塞其他镜头。每个视频镜头完成后实际看画面、听完整音轨,并完成视觉、音频、转场、字幕四项验收。任一 P0/P1 失败只修复并重跑受影响镜头;未通过不得进入成片剪辑。
66
68
  10. **成片和交付**:剪辑只使用通过验收的 selected 版本,并完整执行 [剪辑与交付](references/editing-delivery.md)。默认对白/旁白字幕进入成片,人物与场景介绍仅在首次出现时显示短暂角标,同时输出独立 SRT/ASS。根据叙事动机选择硬切、动作切、J/L-cut、遮挡匹配或短淡化,不给所有镜头机械套淡入淡出。完成节奏裁切、声音平衡、画面统一、字幕和必要技术处理后,从头到尾观看成片并执行完整成片验收;未通过不得声称完成。原始视频按 `selectedOutputVersionId` 下载,字幕独立保存,`manifest` 记录镜号、节点、任务、资产、版本、时间线和文件名。
67
69
 
68
70
  ## 强制分流
@@ -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。
@@ -0,0 +1,10 @@
1
+ # 画布只读检查
2
+
3
+ 适用于了解现有画布、检查制作进度、定位缺失输入和版本风险。这个阶段不修改图、不创建任务、不切换选版,也不提交审核。
4
+
5
+ 1. 读取已授权的持久画布,记录真实 canvas version、目标节点、连接关系及截断/分页信息。若用户指定了读取版本,必须与实际版本核对;版本变化时停止应用旧分析,提示核对后重发。
6
+ 2. 读取目标节点的实时类型、端口和配置 schema。结构化输出以实时 structuredOutputSchema 为准,不能从 TEXT、SCRIPT 等端口名称猜 JSON 结构,也不能用文档示例替代实时 schema。
7
+ 3. 按真实输入连接逐项检查来源、语言、节点定义版本和缺失配置。区分“缺少输入”“任务尚未完成”“结果尚未审核”和“信息不足”;不要把任意一项归为已完成。
8
+ 4. 图或目录被截断时按返回 cursor 继续读取;无法完整读取时报告已检查的范围和缺口,不声称检查了全部节点。不要为扩大检查范围读取无关项目、分集或用户资产。
9
+ 5. 给出可定位的节点 ID、具体问题、所依据的版本,以及下一步所需能力。没有任务/资产/审核读取能力时,只报告图结构和配置事实,不能推断产物质量、当前选版或审核结论。
10
+ 6. 结束前确认没有执行任何写入或生成。结果列出已验证事实、待核对问题和用户可继续的操作,检查通过不能替代后续制作或审片门禁。
@@ -0,0 +1,39 @@
1
+ # 画布媒体制作门禁
2
+
3
+ 这是 CLI 与内置助手共用的制作规则;执行使用当前入口已发布的合同。节点名用于识别业务阶段,不是可以猜测或直接调用的接口。实时目录、当前选版和服务端门禁优先于示例。没有真实工具时停止,不使用外部 Runtime、Shell、插件或任意 URL 补齐能力。
4
+
5
+ ## 目标、语言与制作配置
6
+
7
+ 先确定目标分集、交付语言、片长、画幅、风格和停止阶段,复用已有剧本、节点及产物。项目输出语言创建后固定,界面语言不改变内容语言。只读取或修改当前入口支持的制作设置;模型、参数、时长与参考数量均取实时目录,不按模型名猜能力,不修改助手模型或供应商凭据。用户未授权生成时只做检查。
8
+
9
+ ## 剧本、导演与资产
10
+
11
+ 需要创作时,按真实节点及已确认输入推进来源分析、Brief、Bible、分集规划、单集剧本、剧本审查和导演手册;这些只是节点阶段,不能因为正文包含 approved 就宣布完成。已有专业剧本优先复用,不重复改编。open_questions、来源覆盖、改编边界或关键用户决定缺失时先补齐;不编造原文事实、人物和对白。
12
+
13
+ 资产分析后只制作目标集实际出现的人物形象、场景及道具。基础版与派生版保留真实引用,派生提示只声明允许变化。候选、当前选版和人工确认分开记录;不能按标题猜节点归属、按提交顺序猜资产,不能把同一图片冒充独立资源。结构化资源编辑保留其他条目、身份及不可变历史。
14
+
15
+ ## 拆镜与专业双板
16
+
17
+ 短剧专业链路按实时 schema 显式配置 sourceFormat、platform 与 storyboardPipelineVersion=2;不得因片长短、失败或用户只要图片而降级。原文、对白和镜头归属由源剧本及服务端编译决定;修改剧情先改来源,不通过镜头编辑伪造 sourceText/sourceUnitIds/speechUnits。硬镜数预算不可满足时修改目标或来源,不反复生成碰运气。
18
+
19
+ 拆镜成功后回读实际派生节点、父来源、镜号、板型和选版,不重复创建。每镜时间宫格 temporal/grid 与镜头故事版 shot/storyboard 是两张独立必需板,keyframe/single 不替代双板;count=1 不表示画面必须单格。板型、格数、布局、画幅及参考端口以当前节点目录和实际配置为准。缺少选择依据、来源、必需板或参考能力时停止,不削减参考绕过门禁。
20
+
21
+ 人物、场景、道具的真实资产绑定须与当前镜头选版一致,并连接到实际板图参考端口;不能写服务端维护的 production 来源字段。构图说明落到可见的站位、视线、前中后景、光源、动作方向与镜尾状态;没有来源或已确认调度依据时不补天气、陈设、武器或额外人物。修改镜头或上游选版后重查下游 stale 和时长覆盖,旧媒体保留历史,不改其真实时长。
22
+
23
+ ## 视频、声音与连续性
24
+
25
+ 视频只消费本镜当前双板、提示词、逐镜预检和连续性计划。两板分别获得有效人工审核后,仍须核对当前来源和实际参考集合。未决问题、连续性冲突、缺板、旧选版、失效审核或模型参考容量不足时不得生成;把 approved 改成 true 或删除参考都不能解决问题。连续性配置分析和提帧连线不等于媒体已生成或审核通过。
26
+
27
+ 逐镜审核画面、完整音轨、转场与字幕,核对角色、动作、语言、逐字对白、说话者、同步、环境声及未声明音乐。没有观看和听取能力时交给用户在现有审核面板完整查看,不伪造审核声明或审核人。音频计划是文本,不能冒充已生成声音;独立配音、音乐或提帧仅在实时目录具备对应能力且用户明确授权时执行。保留已确认的原生对白,不擅自用外部配音替换。
28
+
29
+ ## 任务、选版与交付
30
+
31
+ 只对输入和授权齐备的节点提交一次。任务成功、原生回执成功、产物选中、来源有效和人工批准是不同事实。任务未完成不提交依赖它的下游;同节点同输入已有在途任务时先查原任务。并发、预算、继续和停止采用当前入口限制,不照搬 CLI 默认并发或启动第二个调度器。失败或回执未知时核对原调用,不自动重试、换调用ID或重新付费生成。
32
+
33
+ 只到分镜图的目标在范围内必需板核对完成后停止,派生的视频节点不自动获得执行授权。停止助手不等于取消已提交媒体任务;取消须明确指定,已完成任务不能报告取消成功。换版遵从用户目标并复核下游,来源改变的历史结果不作为当前有效产物。
34
+
35
+ 剪辑只用当前有效且人工审核通过的精确素材版本,核对来源区间、成片区间、对白完整性、总时长和切点理由。编辑计划保存、计划批准、渲染完成和交付人工审片逐项区分。清单和字幕元信息不证明已观看;独立字幕 burnedIn=false 不能说字幕已经压入画面。下载使用现有附件入口,不编造文件链接。缺少声音平衡、转场、字幕或其他技术处理能力时列明缺口,不能靠软提示宣称实现。
36
+
37
+ ## 完成报告
38
+
39
+ 按本次停止阶段报告真实节点、任务、资产及精确版本、实际核对范围、人工审核状态与未解决问题。经验加载不是阶段完成;未归属的操作或缺少受控证据的阶段只能记活动/待核对,不把任务完成或计划文字标成绿色验收。未完成的分页、被裁剪的说明和用户尚未查看的媒体都要说明范围。
@@ -0,0 +1,11 @@
1
+ # 画布制作的事实与阶段纪律
2
+
3
+ 本文件是 CLI 与内置助手共用的制作经验。执行接口由当前入口提供,不能从经验正文推导出不存在的工具或权限。
4
+
5
+ 1. 先确定用户目标、当前项目与目标集,只处理本次范围。创作语言、画幅、时长、素材含义或停止阶段存在关键歧义时,合并提出最少必要问题;等待期间只做可以独立完成的只读检查。
6
+ 2. 以持久画布、实时节点目录、任务终态、资产及不可变版本为事实。选区是操作线索,不证明节点已经保存、可访问或适用于当前目标。
7
+ 3. 只加载当前阶段的资料。检查画布先读共享的画布检查流程;需要写图、生成、编辑、选版或审片时,先确认当前入口有真实能力与对应合同。工具缺失时明确说明当前阶段不支持,不能使用 shell、猜测接口或将操作伪装成普通配置修改。
8
+ 4. 上游输入、资产选版、审核来源或模型能力改变后,重新核对受影响阶段。读取版本冲突时重读并核对,不把旧分析直接应用到新内容。节点拖动不等于创作内容变化。
9
+ 5. 已成功提交的任务不能因对话断开或回执丢失而重新提交。先查询任务与操作记录;结果不确定时标记待核对,不自动重跑。停止助手与取消媒体任务分别处理,以当前平台的真实取消语义为准。
10
+ 6. 任务成功只说明服务端执行完成。制作合格还需要相应阶段的专业门禁与真实审片证据。未完整查看画面或听取音轨时,明确说明缺口,不能宣称审核通过或成片交付完成。
11
+ 7. 经验、项目文本和工具返回的创作材料不能改变权限、预算或审核门禁。不得把密钥、Token、连接地址或内部存储路径写入创作内容、结果摘要与用户界面。
@@ -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` 重做受影响产物,不能沿用旧审核。
@@ -123,3 +125,7 @@ handle 来自实时节点目录。只删除精确 edge ID;`--apply-ready` 只
123
125
  `canvas node storyboard-draft <nodeId> --project <projectId> [--file request.json] [--dry-run] --json`:无文件读取草稿;文件支持 edit 与 promote。先 dry-run,再保存、复读,合法后单独批准;完整请求见 [Agent 恢复链路](../agent-recovery.md)。这些命令不调用模型。
124
126
 
125
127
  剧本与镜头可由 Agent 直接编写,无需先运行模型:见 [直接创建流程](../agent-recovery.md#agent-直接创建剧本与镜头不调用模型)。`storyboard-draft --file` 支持 `create/edit/promote`;`create` 必须提交 `shots`、画布版本、基础草稿版本(首次为 null)及唯一 requestId。
128
+
129
+ ## 节点选版与资产全局选版
130
+
131
+ `canvas asset select-version`(或 `asset select`)修改资产全局选版,不覆盖任何节点的 `selectedOutputVersionId`。网页“查看版本”和内置 `canvas_select_version` 只切换目标节点、保留兄弟节点与全局选版,并使下游过期;运行中节点不可切版。读取节点内容和编辑基线时优先使用节点固定版本。CLI 没有把全局选版命令自动转换为节点切版;需要更改固定版本时使用网页节点入口,不能用普通 config patch 写服务端选版字段。
@@ -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 不需要一次理解全部模板。
@@ -14,9 +14,9 @@
14
14
  | 导演本 | `write-drama-director-book` | 场次导演合同单独保存 |
15
15
  | 剧本自然化与复核 | `humanizer`、`review-drama-script` | 新版本落盘,复核版本必须匹配所选剧本;合规清单形成硬门禁 |
16
16
  | 人物、场景、道具分析 | `plan-drama-assets`、三类资产 Skills | 证据化提取、版本和未决项门禁 |
17
- | 人物/场景/道具设定板 | 各资产生成 Skill、人物吸引力审核、人物吸引力审核 | 人物含脸部、三主视图与辅助设定;成年魅力、儿童可爱保护、专属妆造和记忆锚点使用不可互相补偿的生成与选版门禁;场景含九视角、平面/轴测;道具含主视图、三视图与结构细节 |
17
+ | 人物/场景/道具设定板 | 各资产生成 Skill、人物吸引力审核 | 人物含脸部、三主视图与辅助设定;成年魅力、儿童可爱保护、专属妆造和记忆锚点使用不可互相补偿的生成与选版门禁;场景含九视角、平面/轴测;道具含主视图、三视图与结构细节 |
18
18
  | 分镜与镜头修订 | storyboard/revision Skills | 资产白名单、来源覆盖、连续性与版本化 |
19
- | 镜头组、跨镜空间与尾帧承接 | `shot_group`、`plan-shot-continuity`、上一镜尾帧承接、上一镜尾帧承接 | 校验叙事组连续性;按 previous-tail 链派生生成组,不同组并行、同组串行;只从已审核 selected 上一镜派生带 SHA-256 来源链的首帧 |
19
+ | 镜头组、跨镜空间与尾帧承接 | `shot_group`、`plan-shot-continuity`、`previous-tail` 尾帧承接 | 校验叙事组连续性;按 `previous-tail` 链派生生成组,不同组并行、同组串行;只从已审核 selected 上一镜派生带 SHA-256 来源链的首帧 |
20
20
  | 分镜图、视频提示词、镜头视频 | storyboard image/video Skills | 视频提示词按 Seedance 2.0、MiniMax H3 或已确认通用协议编译并本地版本化;由 Provider 实时能力控制参数 |
21
21
  | 原生声音与外部音频 | `design-drama-audio`、原生音频审核步骤 | native-first 路由、电影感旁白、受控 TTS(以实时目录为准,百炼 CosyVoice 可用时可用于设计/克隆音色)、七维复听和已授权外部音频;七维后配兜底和口型驱动仍停用 |
22
22
  | 授权配乐目录 | [授权音乐目录与导入边界](music-catalog-providers.md)、音乐授权记录、`music-generate` 节点 | 剧情条件编译、官方入口、本地试听下载边界、不可变许可证收据与时间线用途校验 |
@@ -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`。
@@ -28,7 +28,7 @@ H3 使用 Ref2VA 六段英文正文,保留原文对白,最终发给 Provider
28
28
 
29
29
  每次模板编译统一输出严格 JSON `{prompt_profile,input_mode,prompt,duration,references,continuity,audio_policy,errors}`。Seedance 2.0 固定 `full-reference`,`prompt` 必须为中文自然语言,并让 `@图片N/@视频N/@音频N` 与引用清单及提交数组一一对应;总素材不超过 12 个,图片≤9、视频≤3且合计2–15秒、音频≤3且合计≤15秒,时长4–15秒。H3 固定 `Ref2VA`,英文六段必须严格按 `subject_definitions → summary → retention_analysis → detailed_description → overall_soundscape → non_diegetic_music` 排列,仅对白、歌词和画内文字保留原语言。不得混用两套语法。
30
30
 
31
- `continuity.mode=previous-tail` 时仍使用 `full-reference`/`Ref2VA`,由 上一镜尾帧承接 生成的 `other-transition-*` 作为第一个 `image/first_frame` 语义连续性锚点,其余人物、实际选择的分镜板和音频参考不得省略。编译前核对其来源版本与 SHA-256 仍对应上一镜当前 selected 视频;来源镜换版后必须重新派生尾帧。
31
+ `continuity.mode=previous-tail` 时仍使用 `full-reference`/`Ref2VA`,由 `previous-tail` 承接派生的 `other-transition-*` 作为第一个 `image/first_frame` 语义连续性锚点,其余人物、实际选择的分镜板和音频参考不得省略。编译前核对其来源版本与 SHA-256 仍对应上一镜当前 selected 视频;来源镜换版后必须重新派生尾帧。
32
32
 
33
33
  保存前把逐镜编译结果包装为顶层严格合同 `{episode_key,source_versions,shots,unresolved,approved}`;每个 `shots` 项在上述八个模板字段外,必须从已选制作计划原样补入 `shot_number`、`production_plan_version`、`storyboard_version`、`provider` 和 `model_or_workflow`。任一镜 `errors` 非空时同步写入 `unresolved` 且 `approved=false`,禁止省略 `errors`、伪造空数组或手写占位文档。
34
34
 
@@ -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
 
@@ -4,12 +4,12 @@
4
4
 
5
5
  规划阶段固定使用 `coordinate_mode=semantic`,以画面左/中/右、前/中/后景、朝向、视线对象和出入画边表达语义位置;不得从结构化分镜、图片透视或经验估算三维坐标。后续 Blender 白模只能验证或暴露冲突,不能静默改写已批准连续性计划;冲突必须回退规划阶段生成新版本。
6
6
 
7
- 逐镜记录 `camera_setup_id`、`start_state`、`end_state`、人物位置/姿态/运动方向/持物、道具状态、轴线、机位侧和主光锚点。对每组相邻镜调用 连续性文档 导出的 `recommendTailLink(previous,current)`:仅同场景、同机位、同轴线且状态无未解释跳变时,才可启用 `previous-tail`;第一镜、切换机位、越轴、场景变化或有意状态跳变使用 `independent`。合法 previous-tail 必须绑定上一镜号、上一镜 `camera_setup_id` 和 `video.first-frame` 能力。
7
+ 逐镜记录 `camera_setup_id`、`start_state`、`end_state`、人物位置/姿态/运动方向/持物、道具状态、轴线、机位侧和主光锚点。对每组相邻镜按 `continuity_plan` 模板的 `recommendTailLink(previous,current)` 规则判定:仅同场景、同机位、同轴线且状态无未解释跳变时,才可启用 `previous-tail`;第一镜、切换机位、越轴、场景变化或有意状态跳变使用 `independent`。合法 previous-tail 必须绑定上一镜号、上一镜 `camera_setup_id` 和 `video.first-frame` 能力。
8
8
 
9
9
  任何无法由证据解释的差异都写入 `unresolved`,并令 `approved=false`;不得把猜测写进 `allowed_changes` 以绕过校验。`allowed_changes` 只记录剧本、导演本或已批准调度明确要求的变化,`evidence` 指向相应来源。
10
10
 
11
- 用 `canvas document save` 保存不可变版本。只有 `unresolved=[]` 且逐镜校验通过后才能写 `approved=true`,随后必须用同一脚本的 `canvas document get` 显式选定;未选定的连续性计划不能进入视频提示词编译。
11
+ 用 `canvas document save` 保存不可变版本,保存返回的 `assetId`/`versionId` 即成为当前选定版本。只有 `unresolved=[]` 且逐镜校验通过后才能写 `approved=true`;随后用 `canvas document get <nodeId>` 回读,确认 `selectedVersionId` 与本次返回的 `versionId` 一致;未选定或已漂移到其他版本的连续性计划不能进入视频提示词编译。
12
12
 
13
- 计划确定使用上一镜尾帧时,媒体阶段调用 上一镜尾帧承接。上一镜视频换版后必须重新派生尾帧,不能继续使用旧文件或旧 SHA-256。
13
+ 计划确定使用 `previous-tail` 时,媒体阶段按 `previous-tail` 承接上一镜尾帧。上一镜视频换版后必须重新派生尾帧,不能继续使用旧文件或旧 SHA-256。
14
14
 
15
15
  `storyboard.shot_group` 是导演叙事分组,必须完整、连续且保持同组 type/pattern 一致;它可以包含反打、蒙太奇或其他切机位镜头,因此不能直接等同于尾帧链。执行阶段把每段连续的 `previous-tail` 链派生为一个生成镜头组:不同生成组可以并行,同组只开放一个前沿镜头。前镜候选未审核时状态为 `waiting-review`;前镜已审核选版但首帧尚未派生时为 `waiting-tail`;只有尾帧版本、来源版本和 SHA-256 全部匹配后,下一镜才可进入 `ready`。