@aswless_854771076/ai_short_studio_cli 0.1.212 → 0.1.213

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/README.md CHANGED
@@ -33,7 +33,7 @@ Agent 代操作时,用户已在当前会话明确提供的密码只能直接
33
33
 
34
34
  注册确认链接使用当前 profile 的 `baseUrl` 和 `--locale`,指向同域的 `/{locale}/auth/callback`。API 与网页需保持同域,并在 Supabase Redirect URLs 中允许各环境的 `/**`;Site URL 只作为未显式传入回调时的生产兜底。
35
35
 
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`,避免复用旧认证。
36
+ CLI 只把 refresh token 保存到系统钥匙串。短期 access token 会写入权限为 `0600` 的本机 session 缓存;同一 profile 的并发进程通过跨进程锁共享刷新结果,只有缓存缺失或确实需要刷新时才访问钥匙串,从而避免 Agent 批量操作反复触发 macOS Keychain。退出登录会清除该缓存,CI 可用 `VVICAT_ACCESS_TOKEN` 直接注入临时令牌。未配置服务地址时默认连接 `https://pixelshort.studio`,`--base-url`、`VVICAT_BASE_URL` 和当前 profile 可依次覆盖。首次登录会从服务端 bootstrap 取得 Supabase 公共配置,也可用 `VVICAT_SUPABASE_URL`、`VVICAT_SUPABASE_PUBLISHABLE_KEY` 显式覆盖。Google 登录在 Windows 上直接调用系统 URL Handler,确保带 `&` 的 PKCE 授权参数完整传给浏览器。服务地址和非敏感 profile 写入系统配置目录;切换环境时必须使用独立的 `--profile`,避免复用旧认证。
37
37
 
38
38
  创作前运行 `ai-short-studio preflight --json`。CLI 会通过公开的 `/api/v1/bootstrap` 检查服务连通性、取得 Supabase 公共配置、读取 npm `latest` 稳定版本并自动更新全局 CLI;更新成功后按输出重新运行。临时不更新时传 `--no-update`。随后预检检查登录态和文本、人物、场景、故事版、视频模型配置。npm registry 暂时不可用时服务端使用配置版本降级。
39
39
 
@@ -198,7 +198,6 @@ ai-short-studio skill diff --target codex --json
198
198
  ```bash
199
199
  export NODE_AUTH_TOKEN="<token>"
200
200
  npm run release:dry-run
201
- npm run release:test -- --version 0.1.0-beta.0
202
201
  # 加入 @vvicat organization 后发布正式包
203
202
  npm run release
204
203
  ```
@@ -223,11 +222,7 @@ cd packages/ai_short_studio_cli
223
222
  npm run release:ci
224
223
  ```
225
224
 
226
- 个人账号 beta 测试使用:
227
-
228
- ```bash
229
- npm run release:ci:test -- --version 0.1.1-beta.0
230
- ```
225
+ staging 不再发布 CLI,原 `release:test` 和 `release:ci:test` 入口已移除。Docker 自动发布要求 `NPM_PUBLISH_ENABLED=true` 且 `NEXT_PUBLIC_SITE_URL=https://pixelshort.studio`(允许末尾 `/`);地址缺失或为测试站时跳过发布。测试环境应持续设置 `NPM_PUBLISH_ENABLED=false`。生产正式包沿用已配置的包名和 `latest` tag。
231
226
 
232
227
  `release:ci` 会依次运行测试和类型检查、发布 npm、等待 registry 可见,再从 npm 安装该精确版本并验证 CLI 与配套 Skill。无需配置自有 Runner;只有访问内网或需要固定出口 IP 时才使用自有构建集群。
233
228
 
package/dist/runtime.d.ts CHANGED
@@ -10,7 +10,7 @@ interface RuntimeFlags {
10
10
  'supabase-publishable-key'?: string;
11
11
  'supabase-url'?: string;
12
12
  }
13
- export declare const DEFAULT_BASE_URL = "https://ai-short-studio.vvicat.dev";
13
+ export declare const DEFAULT_BASE_URL = "https://pixelshort.studio";
14
14
  export declare function createRuntime(flags: RuntimeFlags): Promise<{
15
15
  profile: CliProfile;
16
16
  session: SessionManager;
package/dist/runtime.js CHANGED
@@ -6,7 +6,7 @@ import { ApiKeyAuthProvider } from './auth/api-key-auth-provider.js';
6
6
  import { FileAccessTokenCache } from './auth/session-cache.js';
7
7
  import { defaultConfigDirectory, ProfileStore } from './config/profiles.js';
8
8
  import { fetchBootstrap } from './preflight.js';
9
- export const DEFAULT_BASE_URL = 'https://ai-short-studio.vvicat.dev';
9
+ export const DEFAULT_BASE_URL = 'https://pixelshort.studio';
10
10
  export async function createRuntime(flags) {
11
11
  const profiles = new ProfileStore();
12
12
  const selected = flags.profile ? await profiles.get(flags.profile) : await profiles.current();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aswless_854771076/ai_short_studio_cli",
3
- "version": "0.1.212",
3
+ "version": "0.1.213",
4
4
  "description": "VVICAT 无限画布项目命令行工具",
5
5
  "license": "MIT",
6
6
  "private": false,
@@ -32,8 +32,6 @@
32
32
  "postinstall": "node scripts/postinstall.mjs",
33
33
  "prepack": "npm run build",
34
34
  "release:dry-run": "node scripts/publish.mjs --dry-run",
35
- "release:test": "node scripts/publish.mjs --name @aswless_854771076/ai_short_studio_cli --tag beta",
36
- "release:ci:test": "npm test && npm run typecheck && node scripts/publish.mjs --name @aswless_854771076/ai_short_studio_cli --tag beta --verify",
37
35
  "release:ci": "npm test && npm run typecheck && node scripts/publish.mjs --tag latest --verify",
38
36
  "release": "node scripts/publish.mjs --tag latest",
39
37
  "test": "vitest run",
@@ -5,6 +5,8 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
5
5
 
6
6
  # 使用 VVICAT AI Short Studio CLI
7
7
 
8
+ 默认自动出片直接完成生成、选版、剪辑和渲染,不主动创建或执行文字审计、媒体审核、逐镜复审、审核修复循环或交付审片节点,不等待审核批准。只有用户明确要求审计/审核时,才执行下文的内容检查与记录;审核报告是诊断结果,不作为生成、剪辑、渲染或导出的准入门禁。不得为绕过等待伪造 approved、审核人或观看/听音证据。真实任务完成、来源权限、精确选版、媒体可播放、时长和剪辑区间仍须校验;声音提取/绑定及字幕所需的真实时间来源照常处理。交付报告如实说明“未执行内容审计”,不自动补做审核。本文中审图、审片、P0/P1 复审及人工检查点的步骤仅适用于用户明确要求的审计任务。
9
+
8
10
  所有画布制作都先遵循 [Agent 恢复链路](references/agent-recovery.md)。节点失败或审核待办不是结束整个任务的条件:读取具体诊断,修正输入或产物,保存并复查,仅继续受影响步骤。平台不自动看图审核质量;Agent 须观察真实媒体并如实提交记录。不要把缺少审核记录当成检测出图片缺陷。已授权范围内自主修复,不因同一操作重复索取确认;单镜问题不阻塞无依赖的其他镜头。每次创作前先运行 `ai-short-studio preflight --json`;预检默认检查并自动更新全局 CLI,更新后按输出重新运行。只有离线或明确需要保留当前版本时才使用 `--no-update`。更新失败必须报告原因并停止依赖新版本的流程,不得静默继续。
9
11
 
10
12
  ## 按需读取
@@ -31,19 +33,19 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
31
33
  | --- | --- | --- |
32
34
  | 原创短剧、小说改编、来源材料、市场灵感 | `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`,不写剧本 |
33
35
  | 故事设定、人物弧线、分集规划 | `references/short-drama/creation/design-drama-bible.md`、`references/short-drama/creation/outline-drama-series.md` | 先确认 Brief,再运行 `drama-bible → drama-outline`;未确认集数、时长或结局不得自动补齐 |
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 未清零不得进入导演阶段 |
36
+ | 单集剧本、来源片段转剧本、剧本润色 | `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` 诊断 |
35
37
  | 导演手册、摄影与表演 | `references/short-drama/creation/write-drama-director-book.md`、`references/short-drama/director-composition.md` | 在资产生成和拆镜前完成 `drama-director-book`;构图、轴线和表演决定必须来自剧本事实,证据不足时降级构图,不补陈设或天气 |
36
38
  | 人物、场景、道具和资产版本 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/assets/` 下对应资产文档、`references/short-drama/assets/plan-drama-assets.md` | 运行资产分析后再生成;每批候选下载或读取真实预览并展示给用户,用户确认后才选版;缺证据、错版、stale 或身份歧义时标记 blocked,不用相似资产替代 |
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` | `Agent 自写分镜 → production-plan 文档 → continuity-plan 文档 → selected storyboard image type`;由 Agent 按镜头目标选择单图、时间故事版、镜头分镜板或专项板,只生成已选择的板型;只有前镜已审核且选版时允许 previous-tail |
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 选择协议并审计后提交视频 |
39
+ | 结构化分镜、分镜图、逐镜制作计划与跨镜连续性 | `references/short-drama/storyboard/build-drama-storyboard.md`、`references/short-drama/storyboard/plan-drama-production.md`、`references/short-drama/storyboard/plan-shot-continuity.md` | `Agent 自写分镜 → production-plan 文档 → continuity-plan 文档 → selected storyboard image type`;由 Agent 按镜头目标选择单图、时间故事版、镜头分镜板或专项板,只生成已选择的板型;前镜真实完成并选版后允许 previous-tail,不要求内容审核 |
40
+ | 视频提示词、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 选择协议,完成输入结构与来源校验后提交视频,不自动审计 |
39
41
  | 背景音乐、主题曲、纯音乐 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/generation/design-drama-audio.md` | 使用画布 `music-generate` 和实时音频模型目录;有自定义歌词时不得同时开启纯音乐;生成后试听并回读 AUDIO 资产版本 |
40
42
  | 去字幕、参考视频复刻、深度视频 | `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
43
  | 参考对白转写、剪辑、字幕和多图模板 | `references/short-drama/recreation/recreation-qa.md`、`references/short-drama/editing-workflow.md` | WAV 音频使用 `recreation-transcribe`(默认 StarRouter `whisper-1`);剪辑和字幕进入现有编辑器/Remotion 时间线;多图合板使用 `grid` 或分镜宫格节点 |
42
- | 逐镜审计、剪辑、字幕、声音平衡、成片交付 | `references/short-drama/review/review-drama-shots.md`、`references/short-drama/editing/edit-drama-timeline.md`、`references/short-drama/editing/edit-deliver-drama.md` | `drama-shot-review → drama-edit-plan → drama-delivery-review`;未通过的镜头、无 provenance 或未完整观看不得交付 |
44
+ | 逐镜审计、剪辑、字幕、声音平衡、成片交付 | `references/short-drama/review/review-drama-shots.md`、`references/short-drama/editing/edit-drama-timeline.md`、`references/short-drama/editing/edit-deliver-drama.md` | 默认 `drama-edit-plan → drama-edit-render`;审核模块仅用户明确要求时加载,真实来源与文件有效后即可交付 |
43
45
 
44
- 自由画布短剧制作不要求预先搭建固定功能节点:Agent 先用 `canvas documents` 恢复分集,再按 `module-map.json` 选择模块;结果保存为 `canvas.<module>.v1` 版本并以 `--input` 记录来源,文档选版和审核证据作为阶段依据。
46
+ 自由画布短剧制作不要求预先搭建固定功能节点:Agent 先用 `canvas documents` 恢复分集,再按 `module-map.json` 选择模块;结果保存为 `canvas.<module>.v1` 版本并以 `--input` 记录来源,文档有效选版和真实媒体任务作为阶段依据,审核证据仅用于用户明确要求的诊断。
45
47
 
46
- 新项目禁止预搭旧版固定功能节点链(`screenplay-resource` 起始、`drama-*` 分析节点整条连好的流水线)。分析阶段每个产物都由 Agent 在无限画布创建或更新 `text-resource` 自由画布文档,并通过 `canvas document save` 追加不可变版本;媒体节点只消费已审核的自由画布文档和选定媒体版本。媒体生成节点仍由画布按文档物化或按需单独创建;首次镜头用 `storyboard-resource` 和 `canvas node storyboard-draft` 自写、校验与物化。Agent/CLI 禁止创建或执行 `storyboard-breakdown`,该模型生成节点仅供网页人工使用。
48
+ 新项目禁止预搭旧版固定功能节点链(`screenplay-resource` 起始、`drama-*` 分析节点整条连好的流水线)。分析阶段每个产物都由 Agent 在无限画布创建或更新 `text-resource` 自由画布文档,并通过 `canvas document save` 追加不可变版本;媒体节点只消费来源有效的自由画布文档和选定媒体版本,不要求内容审核。媒体生成节点仍由画布按文档物化或按需单独创建;首次镜头用 `storyboard-resource` 和 `canvas node storyboard-draft` 自写、校验与物化。Agent/CLI 禁止创建或执行 `storyboard-breakdown`,该模型生成节点仅供网页人工使用。
47
49
 
48
50
  旧版固定节点链仍保留用于读取和恢复历史项目,但不得作为新项目入口,也不得与 自由画布文档并行写入同一阶段。发现旧节点链时先用 `canvas documents` 和 `canvas workflow status` 建立 自由画布文档快照,再迁移受影响阶段;迁移完成后停止继续创建旧节点链。
49
51
  ## 核心原则
@@ -59,12 +61,12 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
59
61
  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 版本门禁**:`preflight --json` 返回的 `skill.state` 不是 `current`(`outdated`、`modified`、`unmanaged`、`missing` 都算)时,停止创作并先处理——`modified`/`outdated` 先运行 `ai-short-studio skill diff --target codex --json`,把 `changed`/`extra`/`missing` 文件展示给用户,让其决定"保留改动并手工合并"还是"`skill install --force` 覆盖";`missing` 先 `skill install`。CLI 升级不会覆盖用户改过的 Skill,因此 CLI 版本新、Skill 停在旧版时,你运行的是旧规则,不得继续创作,也不得强制覆盖用户修改。
60
62
  2. **项目语言门禁**:新建项目前必须从用户确认交付语言,并用 `project create --language <BCP47>` 写入;界面 `--locale` 不能代替内容语言。创建后回读 `project get` 与 `canvas settings get`,确认两者语言一致且不可修改。项目语言约束剧本、分镜、台词、配音、画面文字和字幕;验收须区分剧情内容与制作信息:项目语言允许正常外语穿插和规范英文摄影术语,不按字符种类判死;道具文字和剧情内界面遵循来源原文。存在实际语言合同冲突时停止并说明。
61
63
  3. **项目配置门禁**:项目初始化时必须向用户展示并确认创作配置,不得只采用账户默认值:交付语言、画幅、目标时长、画风、分镜板策略、分析/文本模型、图片模型及其厂商、视频模型及其厂商、视频提示词协议、音频/配乐模型及其厂商、声音一致性方式、分辨率、画质、候选数量、参考素材和预计请求范围。先读取 `canvas settings get`,展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options;确认 `imageResolution`、`imageQuality` 和 `videoResolution` 后,再按标准创作门禁用 `--file settings.json` 原子写入并携带 `expectedVersion`,回读一致前不得创建或运行付费节点。`$ART_STYLE_ID` 必须解析实时 `option.value`。节点确需不同参数时才按实时能力覆盖,并记录覆盖原因;`automation_mode` 只能省略已确认且未变化的重复询问,不能替用户确认模型/厂商或付费范围。
62
- 4. **创作链路与自由画布文档**:按 `canvas workflow status` 返回的 `currentStage` 依次生成来源分析 → 创作简报 → 故事设定 → 分集大纲 → 单集剧本 → Humanizer 自然化 → 剧本审校 → 导演手册 → 资产计划。每步固定四件事,缺一步不算完成:①从 [文档键与内容合同](references/short-drama/pipeline.md#文档键与内容合同) 取登记的 `--document-key`,不能按节点标题或 module ID 自行拼写;②完整读取 `references/short-drama/assets/modules/<module>/prompts/` 下该模块的模板,按它声明“顶层必须且只能包含”的字段生成严格 JSON,不得只写 `summary`、`source_type` 一类自造字段或空数组;③用 `canvas document save` 写入 `canvas.<module>.v1`,并用 `--input` 固化上游选版;④用 `canvas documents` 和 `canvas document get` 回读,逐项确认必需字段是真实分析而不是占位。`canvas document save` 会按随包合同拦下缺字段和空字段文档,报错时补正文并重读模板,不得用 `--allow-partial` 把占位文档当成阶段产物。审核必须另存为 `canvas.review.v1` 并绑定被审核版本。无需先调用固定节点或生成模型,不要创建没有版本的文档空壳,也不要先铺一批空 `text-resource` 节点再补正文。已有自由画布文档直接复用;历史 `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 node list --project <projectId> --json` 逐项核对 `kind` 与 `prompt` 端口;出现用 `image-generate` 生成的人物、场景或道具图,必须用对应设定板节点重建并回读,旧候选只留作历史,不选版、不进入分镜和视频。**机器门禁**:资产计划文档保存并回读后、提交任何资产生成前,必须运行 `ai-short-studio canvas asset audit --project <projectId> --json`;只有 `ok: true` 才能继续,`errors` 非空(例如 `sheet-node-missing`,即计划里有资产却全部用 `image-generate`)时按 `nodeIds` 重建设定板节点后重跑,不得跳过或用手工核对代替。`warnings` 要逐条读并修正(手写 `config.prompt`、`prompt` 端口来源不是结构化设定节点、端口未接线、覆盖不全),`blocked: asset-plan-not-ready` 说明资产计划文档还没保存或未审核,回到第 4 步。每批生成完成后必须用 `canvas asset download` 或等效预览能力取得真实候选,并在当前对话中展示候选缩略图/文件链接、资产 key、版本和用途;用户确认后才能写入 selected version。只在用户看过候选且确认后选版。执行资产—剧情匹配审计;缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
64
- 6. **拆镜与制作计划**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建使用手写分镜资源 `storyboard-resource`,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2`,不自动新增首帧节点。结构化分镜之后依次生成逐镜制作计划和跨镜连续性计划;只有前镜已审核且选版时才允许 previous-tail。视频提交前必须完成素材连线、镜头逻辑和上下镜连续性审计。
65
- 7. **分镜图与逐镜审计**:Agent 先读取每镜 `storyboard_strategy`,按制作目标选择单幅分镜图、时间故事版、镜头分镜板、专项板或 Blender;已选择一种板型时不得自动补生成另一种。只审核实际生成的板型,并让视频提示词只引用真实存在且已审核的分镜资产。逐镜审计 P0/P1 未清零不得写入视频提示词或提交视频。用户的停止阶段优先于 [滚动异步调度](references/async-pipeline.md):仅分镜图任务完成实际选择的板型并通过审核后停止,不运行视频提示词和视频。
64
+ 4. **创作链路与自由画布文档**:按 `canvas workflow status` 返回的 `currentStage` 依次生成来源分析 → 创作简报 → 故事设定 → 分集大纲 → 单集剧本 → Humanizer 自然化 → 导演手册 → 资产计划。每步固定四件事,缺一步不算完成:①从 [文档键与内容合同](references/short-drama/pipeline.md#文档键与内容合同) 取登记的 `--document-key`,不能按节点标题或 module ID 自行拼写;②完整读取 `references/short-drama/assets/modules/<module>/prompts/` 下该模块的模板,按它声明“顶层必须且只能包含”的字段生成严格 JSON,不得只写 `summary`、`source_type` 一类自造字段或空数组;③用 `canvas document save` 写入 `canvas.<module>.v1`,并用 `--input` 固化上游选版;④用 `canvas documents` 和 `canvas document get` 回读,逐项确认必需字段是真实分析而不是占位。`canvas document save` 会按随包合同拦下缺字段和空字段文档,报错时补正文并重读模板,不得用 `--allow-partial` 把占位文档当成阶段产物。用户明确要求审核时另存为 `canvas.review.v1` 并绑定被审核版本,不作为制作前置条件。无需先调用固定节点或生成模型,不要创建没有版本的文档空壳,也不要先铺一批空 `text-resource` 节点再补正文。已有自由画布文档直接复用;历史 `screenplay-resource` 或结构化资源先迁移成 自由画布文档,再继续流程。需要创作微短剧时,按需读取 `references/short-drama/`,再完整读取 [官方 Humanizer 快照](references/humanizer/humanizer.md)(来源见 [快照说明](references/humanizer/SOURCE.md))和 [短剧适配层](references/short-drama/creation/humanizer.md) 去除 AI 味;不得改动已经确认的剧情事实,默认跳过剧本审校直接进入导演与资产阶段,润色后回到短剧 reference 复核。确认目标集数后,只生产该集实际需要的资产。
65
+ 5. **资产门禁**:先完成人物、场景、道具及其派生版本。资产图分别用 `character-turnaround`、`location-image`(`locationImagePurpose: location-sheet`)、`prop-turnaround`,`prompt` 端口连接结构化设定节点;默认模板 `character_asset_sheet`、`scene_asset_sheet`、`prop_generate` 是参考正文,不得删除,也不得改用 `image-generate` 代替设定板:它是透明边界,服务端不会为它追加三视图或九视角合同。提交资产生成前先运行 `canvas node list --project <projectId> --json` 逐项核对 `kind` 与 `prompt` 端口;出现用 `image-generate` 生成的人物、场景或道具图,必须用对应设定板节点重建并回读,旧候选只留作历史,不选版、不进入分镜和视频。**机器门禁**:资产计划文档保存并回读后、提交任何资产生成前,必须运行 `ai-short-studio canvas asset audit --project <projectId> --json`;只有 `ok: true` 才能继续,`errors` 非空(例如 `sheet-node-missing`,即计划里有资产却全部用 `image-generate`)时按 `nodeIds` 重建设定板节点后重跑,不得跳过或用手工核对代替。`warnings` 要逐条读并修正(手写 `config.prompt`、`prompt` 端口来源不是结构化设定节点、端口未接线、覆盖不全),`blocked: asset-plan-not-ready` 说明资产计划文档还没保存、内容缺失或来源失效,回到第 4 步。每批生成完成后核对真实任务、候选版本和用途,在自动出片授权范围内选版,无需逐项人工确认;用户明确要求手动选版时才等待确认。核对资产计划与真实设定节点及引用覆盖,不自动执行内容审计;缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
66
+ 6. **拆镜与制作计划**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建使用手写分镜资源 `storyboard-resource`,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2`,不自动新增首帧节点。结构化分镜之后依次生成逐镜制作计划和跨镜连续性计划;前镜真实完成并选版后允许 previous-tail,无需内容审核批准。视频提交前核对真实素材连线、选版与连续性输入,不自动执行内容审计。
67
+ 7. **分镜图与逐镜审计**:Agent 先读取每镜 `storyboard_strategy`,按制作目标选择单幅分镜图、时间故事版、镜头分镜板、专项板或 Blender;已选择一种板型时不得自动补生成另一种。视频提示词只引用真实存在、来源有效且精确选版的分镜资产;默认不执行逐镜审计,不等待审核批准。用户的停止阶段优先于 [滚动异步调度](references/async-pipeline.md):仅分镜图任务完成实际选择的板型后停止,不运行视频提示词和视频。
66
68
  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 失败只修复并重跑受影响镜头;未通过不得进入成片剪辑。
69
+ 9. **视频滚动生成与逐镜后验**:允许视频时,已就绪镜头滚动提交,单镜失败不阻塞其他镜头。每个视频镜头完成并选版后进入剪辑;只有用户要求审片时才检查画面、音轨、转场和字幕并报告诊断,不以审核批准阻塞剪辑。
68
70
  10. **成片和交付**:剪辑只使用通过验收的 selected 版本,并完整执行 [剪辑与交付](references/editing-delivery.md)。默认对白/旁白字幕进入成片,人物与场景介绍仅在首次出现时显示短暂角标,同时输出独立 SRT/ASS。根据叙事动机选择硬切、动作切、J/L-cut、遮挡匹配或短淡化,不给所有镜头机械套淡入淡出。完成节奏裁切、声音平衡、画面统一、字幕和必要技术处理后,从头到尾观看成片并执行完整成片验收;未通过不得声称完成。原始视频按 `selectedOutputVersionId` 下载,字幕独立保存,`manifest` 记录镜号、节点、任务、资产、版本、时间线和文件名。
69
71
 
70
72
  ## 强制分流
@@ -78,6 +80,6 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
78
80
 
79
81
  不把密码、Token 或 API Key 写入参数、日志、Skill 或仓库。删除项目、覆盖画布、切换模型、重新付费生成或覆盖用户选版须在用户已授权的目标和范围内;只有超出既有授权才补充确认。临时项目在所有结束路径清理;既有项目不得擅自删除。
80
82
 
81
- 任务成功只代表服务端完成,不代表创作合格。每批产物都要回读任务、画布、连线、资产和最终配置并查看真实预览;只有阶段门禁、逐镜四项验收和最终成片验收全部通过,才可交付。
83
+ 任务成功只代表服务端完成,不代表创作合格。每批产物都要回读任务、画布、连线、资产和最终配置并查看真实预览;完成来源、区间和渲染技术校验即可交付文件;未做内容审计时如实标注,不等待审核批准。
82
84
 
83
85
  分镜图完成后不会自动添加 `storyboard-video-prompt` 节点。只有用户制作范围需要视频提示词时,按实时节点目录按需添加并连接;仅生成分镜图时不创建该节点。项目列表的封面可能回退到首个已有图片资产,仅用于展示,不表示项目已设置封面或已通过审核。
@@ -1,5 +1,7 @@
1
1
  # 资产、拆镜与生成前审计
2
2
 
3
+ 默认自动出片直接完成生成、选版、剪辑和渲染,不主动创建或执行文字审计、媒体审核、逐镜复审、审核修复循环或交付审片节点,不等待审核批准。只有用户明确要求审计/审核时,才执行下文的内容检查与记录;审核报告是诊断结果,不作为生成、剪辑、渲染或导出的准入门禁。不得为绕过等待伪造 approved、审核人或观看/听音证据。真实任务完成、来源权限、精确选版、媒体可播放、时长和剪辑区间仍须校验;声音提取/绑定及字幕所需的真实时间来源照常处理。交付报告如实说明“未执行内容审计”,不自动补做审核。本文中审图、审片、P0/P1 复审及人工检查点的步骤仅适用于用户明确要求的审计任务。
4
+
3
5
  仅在生产人物/场景/道具、拆镜、分镜图或视频前审计时读取本文件。
4
6
 
5
7
 
@@ -9,7 +11,7 @@
9
11
 
10
12
  保存 `character-profiles`(完整 `new_characters`、`updated_characters` 数组)直接派生人物资源。视觉设定以 `character-visual-design` 文档键保存 `characters[].appearances`;场景、道具分别用 `location-design` 的 `locations` 和 `prop-design` 的 `props`。均允许 `ep-001.` 分集前缀,正文按实时同名节点 `structuredOutputSchema` 编写;保存后回读派生资源及媒体节点。不要先建空资源、在 config 塞正文,或运行旧设计节点来“激活”文档。`asset-plan` 只作规划,不会凭简略清单伪造完整设定。
11
13
 
12
- 首次专业镜头使用 `canvas node storyboard-draft` 的 `create → dry-run/修订 → promote`,详见 `agent-recovery.md`;`storyboard-resource` 只承载源合同、Agent 自写草稿与正式镜头,没有模型任务;禁止 Agent/CLI 创建或执行 `storyboard-breakdown`,该生成节点仅供网页人工使用。历史拆镜产物可读取复用,不能再次调用其拆镜模型。已有正式镜头直接复用,只有来源已改变或用户要求改镜时才修订草稿或镜头。物化不等于媒体审核,不提交虚假批准。制作计划、连续性计划、声音计划与镜头文字审计继续保存为带精确输入版本的 `text-resource` 文档,视频预检认可其当前有效选版。
14
+ 首次专业镜头使用 `canvas node storyboard-draft` 的 `create → dry-run/修订 → promote`,详见 `agent-recovery.md`;`storyboard-resource` 只承载源合同、Agent 自写草稿与正式镜头,没有模型任务;禁止 Agent/CLI 创建或执行 `storyboard-breakdown`,该生成节点仅供网页人工使用。历史拆镜产物可读取复用,不能再次调用其拆镜模型。已有正式镜头直接复用,只有来源已改变或用户要求改镜时才修订草稿或镜头。物化不等于媒体审核,不提交虚假批准。制作计划、连续性计划与声音计划保存为带精确输入版本的 `text-resource` 文档,视频预检核对其当前有效选版;镜头文字审计仅用户明确要求时保存,不作为生成或剪辑前置条件。
13
15
 
14
16
  ## 拆镜模式与交付范围
15
17
 
@@ -53,7 +55,7 @@
53
55
  1. 运行 `canvas node list --project <projectId> --json`,逐项读取 `kind`:人物只能是 `character-turnaround`,场景只能是 `location-image`,道具只能是 `prop-turnaround`,分镜板只能是 `storyboard-grid-image`、`storyboard-board-image` 或 `storyboard-image`。
54
56
  2. 人物、场景、道具的 `prompt` 必须来自结构化设定节点连线(含视觉设定的 `character-resource`、`location-resource`、`prop-resource`);`config.prompt` 不手写外观描述冒充设定,否则服务端合同与手写正文会互相拉扯。
55
57
  3. 发现 `image-generate` 承载上述任一资产时按错节点处理:新建正确节点、重连端口、回读新节点的 `kind` 与端口,再提交生成;已生成的候选只作历史,不选版、不进入分镜和视频。修改标题或补写 `config.prompt` 不能把普通生图补成设定板。
56
- 4. 资产计划文档保存并回读后运行 `canvas asset audit --project <projectId> --json`:这是本节的机器门禁,命令会对照资产计划逐类统计设定板节点,`ok: false` 时按 `errors[].nodeIds` 重建设定板节点后重跑;`warnings` 中的 `sheet-config-prompt`、`sheet-prompt-source`、`sheet-prompt-unconnected`、`sheet-coverage-partial` 逐条修正,不能用手工核对替代。`blocked: asset-plan-not-ready` 表示资产计划文档未保存或未审核,先回到资产计划阶段。
58
+ 4. 资产计划文档保存并回读后运行 `canvas asset audit --project <projectId> --json`:这是本节的机器门禁,命令会对照资产计划逐类统计设定板节点,`ok: false` 时按 `errors[].nodeIds` 重建设定板节点后重跑;`warnings` 中的 `sheet-config-prompt`、`sheet-prompt-source`、`sheet-prompt-unconnected`、`sheet-coverage-partial` 逐条修正,不能用手工核对替代。`blocked: asset-plan-not-ready` 表示资产计划文档未保存、内容缺失或来源失效,先回到资产计划阶段。
57
59
  5. 生成后回读 `prompt` 与 `reference` 端口,确认没有悬空、临时 URL 或未选版素材,再下载真实候选交给用户确认。
58
60
 
59
61
  专业镜头的 `assetNodeRefs` 与 `visualAssetBindings` 共用镜头选版。通过下文专业增量修订流程,为每项设定来源绑定实际 `imageNodeId`,并把这些图片接到已选择板型的 `reference` 端口;不能按节点标题猜归属。每个绑定图片节点只能代表一个选定媒体,多候选需使用单项资源节点。服务端在付费板图前检查全部声明资产、上游真实设定边、选版与实际上送图片;提示词按实际数组编译身份和参考序号。修改绑定会使已选择板型及下游 stale;设定换版或文字投影变化同样使旧来源失效。所有已选择板型都审核通过仍要比较实际参考集合,差异不能由文字批准覆盖;引用覆盖不代表图像像素已符合设定。
@@ -196,4 +198,4 @@
196
198
  {"assetNodeRefs":{"characterNodeIds":["character-resource-node-id"],"locationNodeId":"location-resource-node-id","propNodeIds":[]},"visualAssetBindings":[{"sourceNodeId":"character-resource-node-id","imageNodeId":"character-image-node-id"},{"sourceNodeId":"location-resource-node-id","imageNodeId":"location-image-node-id"}]}
197
199
  ```
198
200
 
199
- `sourceNodeId` 是白名单中的设定节点,`imageNodeId` 是选定媒体所属图片节点,均不是 assetId/versionId,也不填名字或自造 assetKey。每个设定节点只绑定一次,并覆盖本镜全部 `assetNodeRefs`。图片通过板图的 `reference` 端口接入;使用 `edit-shot` 或 `revise-storyboard` 增量修订,先 dry-run,成功后回读新的镜头、父汇总和画布版本。409 时重读诊断,再用当前真实版本重新计算补丁,不猜版本或删除门禁。图片必须真实选版并通过所需审核;绑定不会自动授予审核通过。
201
+ `sourceNodeId` 是白名单中的设定节点,`imageNodeId` 是选定媒体所属图片节点,均不是 assetId/versionId,也不填名字或自造 assetKey。每个设定节点只绑定一次,并覆盖本镜全部 `assetNodeRefs`。图片通过板图的 `reference` 端口接入;使用 `edit-shot` 或 `revise-storyboard` 增量修订,先 dry-run,成功后回读新的镜头、父汇总和画布版本。409 时重读诊断,再用当前真实版本重新计算补丁,不猜版本或删除门禁。图片必须真实选版、来源有效且文件可用,内容审核不作为制作前置条件;绑定不会自动授予审核通过。
@@ -1,5 +1,7 @@
1
1
  # 滚动异步生成流水线
2
2
 
3
+ 默认自动出片直接完成生成、选版、剪辑和渲染,不主动创建或执行文字审计、媒体审核、逐镜复审、审核修复循环或交付审片节点,不等待审核批准。只有用户明确要求审计/审核时,才执行下文的内容检查与记录;审核报告是诊断结果,不作为生成、剪辑、渲染或导出的准入门禁。不得为绕过等待伪造 approved、审核人或观看/听音证据。真实任务完成、来源权限、精确选版、媒体可播放、时长和剪辑区间仍须校验;声音提取/绑定及字幕所需的真实时间来源照常处理。交付报告如实说明“未执行内容审计”,不自动补做审核。本文中审图、审片、P0/P1 复审及人工检查点的步骤仅适用于用户明确要求的审计任务。
4
+
3
5
  用于资产派生图、分镜图、Agent 逐镜提示词和视频生成。目标是让每个镜头独立向前流动。
4
6
 
5
7
  ## 调度模型
@@ -1,5 +1,7 @@
1
1
  # 画布媒体制作门禁
2
2
 
3
+ 默认自动出片直接完成生成、选版、剪辑和渲染,不主动创建或执行文字审计、媒体审核、逐镜复审、审核修复循环或交付审片节点,不等待审核批准。只有用户明确要求审计/审核时,才执行下文的内容检查与记录;审核报告是诊断结果,不作为生成、剪辑、渲染或导出的准入门禁。不得为绕过等待伪造 approved、审核人或观看/听音证据。真实任务完成、来源权限、精确选版、媒体可播放、时长和剪辑区间仍须校验;声音提取/绑定及字幕所需的真实时间来源照常处理。交付报告如实说明“未执行内容审计”,不自动补做审核。本文中审图、审片、P0/P1 复审及人工检查点的步骤仅适用于用户明确要求的审计任务。
4
+
3
5
  这是 CLI 与内置助手共用的制作规则;执行使用当前入口已发布的合同。节点名用于识别业务阶段,不是可以猜测或直接调用的接口。实时目录、当前选版和服务端门禁优先于示例。没有真实工具时停止,不使用外部 Runtime、Shell、插件或任意 URL 补齐能力。
4
6
 
5
7
  核对跨镜边界时,真实提取的来源视频尾帧须标明来源节点及精确版本,与当前视频0秒分别观察并比较站位、朝向、持物手、道具形态和姿态;普通设定图不能代替尾态证据。无明确转场设计的状态跳变属于连续性失败,单镜内部动作成立不能豁免。内置视频审核在最多六张参考中优先保留已校验尾帧及来源标签;补查未采样0秒时仍须记录首态未核对。尾帧来源不自动证明剪辑相邻关系,两张图也不能证明尾段至首段完整运动;仍须核对实际剪辑版本并完整播放。
@@ -24,7 +26,7 @@
24
26
 
25
27
  ## 视频、声音与连续性
26
28
 
27
- 视频只消费本镜当前已选板型、提示词、逐镜预检和连续性计划。逐阶段模式下,全部已选板分别获得有效审核后,仍须核对当前来源和实际参考集合。支持识图的 Agent 必须实际查看图片并留下 AI 审核证据,不能要求用户代做 AI 可完成的审图。目标模式可按当前入口明确支持的 final-only 策略自动制作、最终人工验收;未覆盖的模态保持未审核;先按证据与实际影响分流:not-reviewed 是证据不足,优先对同一媒体补采样,不重生成、不计内容修复次数;failed 才是已确认缺陷。P0/P1 是身份、关键动作因果、道具状态或叙事信息错误,先定向修复并复核;P2 仅为不影响这些信息的轻微偏差,final-only 保留真实 reviewWarnings 继续待验收草稿,不强制重生成、不伪造批准或用户接受。未分级的历史 failed 先读 observation 判断证据和影响,不能默认 P2。per-stage 仍保留既定人工检查点。P0/P1 经有效修复仍受能力限制时,final-only 可记录未解决原因继续待验收草稿;不把 P2 当作必须先失败两次的条件。连续两次上限只统计实际输入已改变、生成完成且同症状复审仍失败的尝试,补采样、技术失败和未知回执不计数。缺少必需板、来源失效、权限/版本冲突及技术 QC 失败仍阻断。连续性配置分析和提帧连线不等于媒体已生成或审核通过。
29
+ 视频只消费本镜当前已选板型、提示词、逐镜预检和连续性计划。默认核对当前来源和实际参考集合后直接生成,不要求内容审核证据。仅用户明确要求时执行以下诊断,不作为制作门禁:支持识图的 Agent 实际查看图片并留下真实观察,不能要求用户代做 AI 可完成的审图;未覆盖的模态保持未审核;先按证据与实际影响分流:not-reviewed 是证据不足,优先对同一媒体补采样,不重生成、不计内容修复次数;failed 才是已确认缺陷。P0/P1 是身份、关键动作因果、道具状态或叙事信息错误,先定向修复并复核;P2 仅为不影响这些信息的轻微偏差,final-only 保留真实 reviewWarnings 继续待验收草稿,不强制重生成、不伪造批准或用户接受。未分级的历史 failed 先读 observation 判断证据和影响,不能默认 P2。历史 per-stage 设置不再要求内容审核批准。P0/P1 经有效修复仍受能力限制时,final-only 可记录未解决原因继续待验收草稿;不把 P2 当作必须先失败两次的条件。连续两次上限只统计实际输入已改变、生成完成且同症状复审仍失败的尝试,补采样、技术失败和未知回执不计数。缺少必需板、来源失效、权限/版本冲突及技术 QC 失败仍阻断。连续性配置分析和提帧连线不等于媒体已生成或审核通过。
28
30
 
29
31
  左右手按人物自身的解剖左右判断,不是画面左右;先根据人物朝向及肩臂到手的连续连接确认手侧,再单独记录该手的画面位置。交叉手臂、侧身或镜像构图时不能用屏幕位置直接替代手侧;腕表只作为可见定位线索,不能假定佩戴侧。无法沿可见轮廓确认时明确写无法辨认,不给出与目标帧证据相反的确定归属。
30
32
 
@@ -47,7 +49,7 @@
47
49
 
48
50
  只到分镜图的目标在范围内必需板核对完成后停止,派生的视频节点不自动获得执行授权。停止助手不等于取消已提交媒体任务;取消须明确指定,已完成任务不能报告取消成功。换版遵从用户目标并复核下游,来源改变的历史结果不作为当前有效产物。
49
51
 
50
- 剪辑只用当前有效且通过当前入口制作审核策略的精确素材版本;final-only 无逐句时间证据时只能整段保留,核对来源区间、成片区间、对白完整性、总时长和切点理由。编辑计划保存、计划批准、渲染完成和交付人工审片逐项区分。清单和字幕元信息不证明已观看;独立字幕 burnedIn=false 不能说字幕已经压入画面。下载使用现有附件入口,不编造文件链接。缺少声音平衡、转场、字幕或其他技术处理能力时列明缺口,不能靠软提示宣称实现。
52
+ 剪辑只用当前来源有效且技术可用的精确素材版本;final-only 无逐句时间证据时只能整段保留,核对来源区间、成片区间、对白完整性、总时长和切点理由。编辑计划保存、计划批准、渲染完成和交付人工审片逐项区分。清单和字幕元信息不证明已观看;独立字幕 burnedIn=false 不能说字幕已经压入画面。下载使用现有附件入口,不编造文件链接。缺少声音平衡、转场、字幕或其他技术处理能力时列明缺口,不能靠软提示宣称实现。
51
53
 
52
54
  ## 完成报告
53
55
 
@@ -61,9 +63,9 @@
61
63
 
62
64
  审核标记失败不证明观察正确:例如“书仍打开”和“书已离开画面”是不同事实,即使都不满足镜尾合同,也不能报告两者观察一致。实际目标帧与审核 observation 矛盾时,不宣称该维度通过或修复已验收;保留模型可靠性缺口,最终由完整播放验收确认。
63
65
 
64
- 换机位的 independent 只取消尾帧输入要求,不取消实际状态依赖。后镜明确承接前镜的动作进度、持物手或精确姿态时,先等待将采用的前镜当前视频完成并选版,按制作审核策略核对实际镜尾,再确定后镜首帧与提示词;不能把独立机位当作可盲目并行的独立镜组。实际镜尾不符合既定合同则先修前镜,不改后镜合同迎合穿帮。首镜、明确时间省略/换场且没有上述状态承接的镜头仍可按实际依赖并行。
66
+ 换机位的 independent 只取消尾帧输入要求,不取消实际状态依赖。后镜明确承接前镜的动作进度、持物手或精确姿态时,先等待将采用的前镜当前视频完成并选版,核对真实尾帧来源和选版,再确定后镜首帧与提示词;不能把独立机位当作可盲目并行的独立镜组。实际镜尾不符合既定合同则先修前镜,不改后镜合同迎合穿帮。首镜、明确时间省略/换场且没有上述状态承接的镜头仍可按实际依赖并行。
65
67
 
66
- 已规划 previous-tail 的镜头因前镜未完成、未选版或未满足当前审核策略而等待时,先补齐上游依赖,不能改成 independent 绕过。换机位或换场等真实调度采用 independent 时仍须核对人物和道具状态。提帧按当前目录的真实节点与执行入口完成,保留前镜精确选版、position=last 和来源哈希;提取节点存在不表示图片已生成。尾帧作为参考图不等于严格首帧约束,只有当前模型与专业提交合同实际支持 start-frame 才能宣称锁定首帧,不能绕过参考模式门禁。
68
+ 已规划 previous-tail 的镜头因前镜未完成、未选版或来源失效而等待时,先补齐上游依赖,不能改成 independent 绕过。换机位或换场等真实调度采用 independent 时仍须核对人物和道具状态。提帧按当前目录的真实节点与执行入口完成,保留前镜精确选版、position=last 和来源哈希;提取节点存在不表示图片已生成。尾帧作为参考图不等于严格首帧约束,只有当前模型与专业提交合同实际支持 start-frame 才能宣称锁定首帧,不能绕过参考模式门禁。
67
69
 
68
70
  提交生成前,将提示词里每个“参照已批准首帧/尾帧/姿态/板图”的声明逐一对照实际媒体端口、引用顺序及精确选版;写出参考名称不等于该图已输入。声明缺少真实接线时先补齐当前工具支持的引用并回读;来源身份或版本不兼容时报告能力缺口,不能继续用未输入的参考承诺姿态一致。连续两次同类失败先检查实际编译输入与来源合同,不只增加同义负面词再生成。
69
71
 
@@ -1,5 +1,7 @@
1
1
  # 画布制作的事实与阶段纪律
2
2
 
3
+ 默认自动出片直接完成生成、选版、剪辑和渲染,不主动创建或执行文字审计、媒体审核、逐镜复审、审核修复循环或交付审片节点,不等待审核批准。只有用户明确要求审计/审核时,才执行下文的内容检查与记录;审核报告是诊断结果,不作为生成、剪辑、渲染或导出的准入门禁。不得为绕过等待伪造 approved、审核人或观看/听音证据。真实任务完成、来源权限、精确选版、媒体可播放、时长和剪辑区间仍须校验;声音提取/绑定及字幕所需的真实时间来源照常处理。交付报告如实说明“未执行内容审计”,不自动补做审核。本文中审图、审片、P0/P1 复审及人工检查点的步骤仅适用于用户明确要求的审计任务。
4
+
3
5
  本文件是 CLI 与内置助手共用的制作经验。执行接口由当前入口提供,不能从经验正文推导出不存在的工具或权限。
4
6
 
5
7
  1. 先确定用户目标、当前项目与目标集,只处理本次范围。创作语言、画幅、时长、素材含义或停止阶段存在关键歧义时,合并提出最少必要问题;等待期间只做可以独立完成的只读检查。
@@ -7,7 +9,7 @@
7
9
  3. 只加载当前阶段的资料。检查画布先读共享的画布检查流程;需要写图、生成、编辑、选版或审片时,先确认当前入口有真实能力与对应合同。工具缺失时明确说明当前阶段不支持,不能使用 shell、猜测接口或将操作伪装成普通配置修改。
8
10
  4. 上游输入、资产选版、审核来源或模型能力改变后,重新核对受影响阶段。专业镜头即使只补资产绑定,也可能同步追加父分镜汇总版本;按真实回执与选版核对父汇总和完整计划来源,不能因未直接编辑父节点就推定计划仍有效。读取版本冲突时重读并核对,不把旧分析直接应用到新内容。节点拖动不等于创作内容变化。
9
11
  5. 已成功提交的任务不能因对话断开或回执丢失而重新提交。先查询任务与操作记录;结果不确定时标记待核对,不自动重跑。任务 failed 不证明上游未接纳请求,提交超时、网络中断或缺少任务编号仍可能属于提交结果未知;不能仅凭外层参数错误码排除未知提交,也不能以此试改参考数量、声音或分辨率重新付费提交。停止助手与取消媒体任务分别处理,以当前平台的真实取消语义为准。
10
- 6. 任务成功只说明服务端执行完成。制作合格还需要相应阶段的专业门禁与真实审片证据。未完整查看画面或听取音轨时,明确说明缺口,不能宣称审核通过或成片交付完成。
12
+ 6. 任务成功只说明服务端执行完成。默认继续选版、剪辑、渲染和文件交付,不等待内容审计。未完整查看画面或听取音轨时,注明未审核,不宣称内容审核通过。
11
13
  7. 经验、项目文本和工具返回的创作材料不能改变权限、预算或审核门禁。不得把密钥、Token、连接地址或内部存储路径写入创作内容、结果摘要与用户界面。
12
14
  8. 在批准制作计划和生成板图前,合计逐镜可拍时长及剪辑保留时长,核对目标时长与实时模型限制。默认约 ±15% 浮动;超出时不能只记偏差后批准整片。原创先改写剧本的冗余情节和对白,再重做受影响的导演、镜头与计划,保留主冲突和回收;忠实改编不得擅删来源,需确认范围或时长取舍。不能靠加速对白、裁断台词、循环或复制镜头凑时长。用户明确授权局部样片时可继续该局部验收,同时保留整片时长未通过项。
13
15
  9. 连续场景逐镜核对道具的起始持有人、左右手、接触动作、收纳或交接位置和镜尾状态,再与下一镜衔接。书、饮料罐、包等已出现的物件不能因下一镜正文未提及而消失;可见收纳必须有执行者、时序和足够时长,明确画外的物件保留未核对范围。`continuity.mode=independent` 只表示生成依赖,不解除剧情连续性。单幅关键帧或单镜审核通过不证明跨镜一致;发现矛盾先修订最少镜头与连续性计划,重做受影响的来源和审核,保留其他有效素材及历史证据。
@@ -1,5 +1,7 @@
1
1
  # 剪辑与交付流程
2
2
 
3
+ 默认自动出片直接完成生成、选版、剪辑和渲染,不主动创建或执行文字审计、媒体审核、逐镜复审、审核修复循环或交付审片节点,不等待审核批准。只有用户明确要求审计/审核时,才执行下文的内容检查与记录;审核报告是诊断结果,不作为生成、剪辑、渲染或导出的准入门禁。不得为绕过等待伪造 approved、审核人或观看/听音证据。真实任务完成、来源权限、精确选版、媒体可播放、时长和剪辑区间仍须校验;声音提取/绑定及字幕所需的真实时间来源照常处理。交付报告如实说明“未执行内容审计”,不自动补做审核。本文中审图、审片、P0/P1 复审及人工检查点的步骤仅适用于用户明确要求的审计任务。
4
+
3
5
  涉及时间线、字幕、转场、音频处理或渲染时,先加载 `remotion-best-practices`,并按实际需要读取其中 captions、markup 和 rendering 参考。H3 已生成的人声、旁白、环境音与 BGM 保留每镜原生整轨,允许轻量修整;已确认的独立配乐按声音计划另行加入,不允许用外部 TTS、配音或音乐覆盖原生失败。
4
6
 
5
7
  内置画布与外部 Remotion 的能力以各自实时合同为准:画布支持直切、独立混音、J/L-cut、ASR 字幕烧录和 SRT;任意图形层/介绍角标、画面叠化及独立 ASS 下载不能因外部流程有说明就宣称内置已实现。
@@ -8,13 +10,13 @@
8
10
 
9
11
  ## 画布剪辑计划门禁
10
12
 
11
- 批准剪辑计划的每段还须给出 `assetId/versionId/mediaId`、`source_in_ms/source_out_ms`、`timeline_in_ms/timeline_out_ms`、`cut_reason` 和 `source_evidence`。服务端拒绝未批准素材、越界或反向区间、时长不符、时间线空洞,以及尚有未决问题却宣称批准的计划。内置画面片段不允许重叠或变速;J/L-cut 通过独立声音时间线实现,外部 Remotion 的重叠转场须遵循其自身合同。非空证据文字只通过结构检查,不能替代对实际动作和对白切点的核对。
13
+ 批准剪辑计划的每段还须给出 `assetId/versionId/mediaId`、`source_in_ms/source_out_ms`、`timeline_in_ms/timeline_out_ms`、`cut_reason` 和 `source_evidence`。服务端拒绝来源失效的素材、越界或反向区间、时长不符、时间线空洞,以及尚有未决问题却宣称批准的计划。内置画面片段不允许重叠或变速;J/L-cut 通过独立声音时间线实现,外部 Remotion 的重叠转场须遵循其自身合同。非空证据文字只通过结构检查,不能替代对实际动作和对白切点的核对。
12
14
 
13
- “短剧剪辑计划”的 `videos` 是必填输入。按 mediaReviewMode 核对每个已选视频:per-stage 取得 `stage: video` 批准;final-only 可用真实来源、选版、哈希和技术 QC 有效的待验收草稿,保留内容失败警告而不伪造批准。再连接逐镜预检、声音计划与这些视频;节点配置里的文本或预检 `approved=true` 不能替代真实视频审核。预检必须覆盖所接视频的镜号,且 P0/P1 与未决问题清零。任务固化视频版本、真实媒体摘要、实际探测时长、审核版本和两份文档选版;Worker 在调用文本模型前再次复核,并将真实来源及时长附入提示词。执行中换版或撤销批准时,已返回剪辑计划只保存为历史版本,不选中或物化。旧计划仍可读,重新执行须连接有效审核视频。本门禁证明输入可用,不能证明具体切点正确、成片已生成或交付已批准;动作/对白完成点仍须实际检查。
15
+ “短剧剪辑计划”的 `videos` 是必填输入,连接当前来源、精确选版、哈希、真实时长和技术 QC 有效的视频与声音计划。默认不连接逐镜审计,不要求 stage: video 批准;历史 mediaReviewMode 不改变这一规则。任务固定媒体和声音计划的精确版本,Worker 与锁内回写继续核对真实依赖。源文件、选版、时长或声音计划发生实质变化时拒绝旧结果;审核报告新增、拒绝或换版不使制作失效。剪辑计划 approved 表示可执行,不表示人工审片批准;没有真实切点证据时整段保留,不能猜测或截断对白。
14
16
 
15
17
  ## 1. 入库与选镜
16
18
 
17
- - 按项目 `mediaReviewMode` 使用当前 selected 精确版本:per-stage 要求逐镜四项真实验收通过;final-only 可将来源与技术 QC 有效的未验收版本纳入候选剪辑,保留内容失败和未核实项,不能把选版或导出当作人工批准。保留原文件,不在源文件上覆盖写入。
19
+ - 使用来源与技术 QC 有效的当前 selected 精确版本,默认自动选版,不等待内容审核或人工批准;保留已知诊断和未观察范围。原文件保留,不覆盖写入。
18
20
  - 用媒体探针记录分辨率、帧率、时长、编码、音频采样率、声道和实际响度;坏帧、黑帧、冻结、闪烁、静音或损坏文件不得入时间线。
19
21
  - 建立 manifest:镜号、shot/node/task/asset/version、源文件、入出点、时间线起止、转场、字幕、音频处理、验收结论和重跑记录。
20
22
 
@@ -237,14 +237,14 @@
237
237
  "path": "references/short-drama/review/review-drama-script.md",
238
238
  "category": "review",
239
239
  "stage": "script",
240
- "condition": "always",
240
+ "condition": "user-requested-review",
241
241
  "dependencies": []
242
242
  },
243
243
  "review-drama-shots": {
244
244
  "path": "references/short-drama/review/review-drama-shots.md",
245
245
  "category": "review",
246
246
  "stage": "media-production",
247
- "condition": "always",
247
+ "condition": "user-requested-review",
248
248
  "dependencies": []
249
249
  },
250
250
  "revise-drama-storyboards": {
@@ -316,7 +316,6 @@
316
316
  "short-drama",
317
317
  "write-drama-episode",
318
318
  "humanizer",
319
- "review-drama-script",
320
319
  "write-drama-director-book",
321
320
  "plan-drama-assets",
322
321
  "generate-drama-art-style",
@@ -330,7 +329,6 @@
330
329
  "plan-drama-production",
331
330
  "plan-shot-continuity",
332
331
  "generate-storyboard-images",
333
- "review-drama-shots",
334
332
  "direct-blender-previz",
335
333
  "generate-blender-previz",
336
334
  "write-drama-video-prompts",
@@ -366,8 +364,7 @@
366
364
  "script": [
367
365
  "short-drama",
368
366
  "write-drama-episode",
369
- "humanizer",
370
- "review-drama-script"
367
+ "humanizer"
371
368
  ],
372
369
  "director-book": [
373
370
  "write-drama-director-book"
@@ -389,7 +386,6 @@
389
386
  "generate-storyboard-images",
390
387
  "write-drama-video-prompts",
391
388
  "drama-generation-service",
392
- "review-drama-shots",
393
389
  "generate-drama-videos",
394
390
  "monitor-drama-tasks"
395
391
  ],
@@ -2,7 +2,7 @@
2
2
 
3
3
  标准流程固定为:
4
4
 
5
- `analysis → script → director-book → asset-analysis → asset-generation → production-plan(自写镜头物化 → production-plan 文档 → plan-shot-continuity)→ 已选分镜板 → shot-review → video prompts → videos/audio → editing → delivery`
5
+ `analysis → script → director-book → asset-analysis → asset-generation → production-plan(自写镜头物化 → production-plan 文档 → plan-shot-continuity)→ 已选分镜板 → video prompts → videos/audio → editing → delivery`
6
6
 
7
7
  镜头编辑可能同时推进父故事板选版,保存下游文档前回读父来源。文档保存返回来源冲突的 nodeId、expectedVersionId、currentVersionId 时,回读该节点正文后重算依赖,不删除实际来源或只替换版本号。每轮限制生成两个镜头只限制执行数量;整集制作计划仍覆盖全部镜头,shots、shot_count 和总时长必须一致,不能用两镜摘要覆盖整集计划。
8
8
 
@@ -54,7 +54,7 @@
54
54
 
55
55
  ## 资产与媒体
56
56
 
57
- 图片、音频和视频生成成功后,必须立即下载或回读真实产物,登记为画布资产版本并记录 SHA-256、来源和任务信息,再允许选版或进入下游。远程 URL 只是临时传输结果,不得作为最终资产;未选版、未审核或带过期链接的素材不得写入下游节点。
57
+ 图片、音频和视频生成成功后,必须立即下载或回读真实产物,登记为画布资产版本并记录 SHA-256、来源和任务信息,再允许选版或进入下游。远程 URL 只是临时传输结果,不得作为最终资产;未选版、来源失效或带过期链接的素材不得写入下游节点;内容审核不是准入条件。
58
58
 
59
59
  结构化资产和分镜节点的输入来自已选版资产或结构化端口;只写 `prompt` 而让端口悬空,等同于没有引用素材。节点 `prompt` 只补充创作意图,服务端追加的语言与最终结构合同优先。
60
60
 
@@ -68,11 +68,11 @@
68
68
 
69
69
  剧本阶段必须绑定实际分集剧本版本;人物分析必须绑定已选人物档案。人物链路固定为:年龄证据 → `audience_appeal` 校验 → 人物定妆候选 → 人物专项审核与选版 → 分镜/白模/正式视频引用绑定 → 跨镜一致性复核。明确成年人物使用 `adult-charisma`,必须有专属 `grooming_and_makeup`、`costume_signature` 和角色级 `memory_anchors`;儿童只使用 `child-cuteness`,任何成人化或性化处理都是不可由总分抵消的硬失败。未知年龄停在人物档案阶段。正式视频人物引用还要通过档案 SHA、appearance 与可见身份约束校验。
70
70
 
71
- 每个镜头由 Agent 根据 `storyboard_strategy` 选择一种或多种独立参考板,分别选版并完成对应审计。原创项目默认从单幅分镜图或一种板型开始;只有复杂路线、多人交互、精确接触、轴线风险或连续运镜需要同时表达多种信息时才追加其他板型或 Blender 白模。Blender 不能替代已选择的分镜参考。
71
+ 每个镜头由 Agent 根据 `storyboard_strategy` 选择一种或多种独立参考板,分别核对来源、真实生成结果并选版;仅用户要求时做内容审计。原创项目默认从单幅分镜图或一种板型开始;只有复杂路线、多人交互、精确接触、轴线风险或连续运镜需要同时表达多种信息时才追加其他板型或 Blender 白模。Blender 不能替代已选择的分镜参考。
72
72
 
73
73
  选择 Blender 的镜头先写入白模导演合同,再生成白模参考,登记、完整观看、按七项 100 分合同验收并选版;总分低于 85 或任一单项低于 70% 时不得提交正式视频。已选分镜板和白模都不能替代正式视频所需的人物、场景和道具资产。
74
74
 
75
- 结构化分镜与制作计划批准后,由 `plan-shot-continuity` 汇总已选分镜、导演本和制作计划,生成并显式选定连续性计划新版本。分镜 `shot_group` 表达叙事组;计划逐镜固定机位、轴线、人物/道具起止状态与转场方式,只有同场景同机位且状态连续时才允许 previous-tail。不同组可并行、同组串行,一次只生成各组当前前沿镜头。后续已选分镜板或白模若暴露冲突,必须回退生成连续性计划新版本。previous-tail 从上一镜当前已选且已审核的视频派生下一镜首帧,正式提交前再次比对来源版本和 SHA-256。
75
+ 结构化分镜与制作计划批准后,由 `plan-shot-continuity` 汇总已选分镜、导演本和制作计划,生成并显式选定连续性计划新版本。分镜 `shot_group` 表达叙事组;计划逐镜固定机位、轴线、人物/道具起止状态与转场方式,只有同场景同机位且状态连续时才允许 previous-tail。不同组可并行、同组串行,一次只生成各组当前前沿镜头。后续已选分镜板或白模若暴露冲突,必须回退生成连续性计划新版本。previous-tail 从上一镜当前真实完成并选版的视频派生下一镜首帧,正式提交前再次比对来源版本和 SHA-256。
76
76
 
77
77
  资产计划中的人物、场景或道具若已有已选、未失效且来源合规的版本,可直接复用;缺失、失效或来源不足时,动态要求对应生成模块,防止未登记资产绕过阶段门禁。
78
78