@aswless_854771076/ai_short_studio_cli 0.1.144 → 0.1.146
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 +2 -2
- package/dist/commands/canvas/workflow/status.js +1 -5
- package/dist/domain/vvicat-api.d.ts +1 -0
- package/dist/domain/vvicat-api.js +9 -0
- package/package.json +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/SKILL.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/agent-recovery.md +5 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/assets-and-storyboard.md +13 -13
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/SKILL.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/reference-recreation-canvas.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/SKILL.md +5 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-drama-art-style.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/plan-drama-production/prompts/production_plan.zh.txt +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/plan-shot-continuity/prompts/continuity_plan.zh.txt +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-video-prompts/prompts/h3_video.zh.txt +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-video-prompts/prompts/panel_storyboard_video.zh.txt +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-storyboard-images.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/write-drama-video-prompts.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/module-map.json +1 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/short-drama-skill-index.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/use-short-drama-studio.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/pipeline.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-shots.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz/direction-contract.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-drama-production.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-shot-continuity.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/usage-guide.md +6 -6
package/README.md
CHANGED
|
@@ -13,7 +13,7 @@ ai-short-studio canvas node types --json
|
|
|
13
13
|
|
|
14
14
|
npm 包只内置一个 `using-vvicat-ai-short-studio-cli` Agent Skill。hypit、短剧和 humanizer 等第三方资料统一放在该 Skill 的 `references/` 下。安装或升级 CLI 时,`postinstall` 会自动安装或更新这个 Skill;用户修改过或不由 CLI 管理的副本不会被覆盖。设置 `VVICAT_SKIP_SKILL_INSTALL=1` 可关闭自动安装。
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
短剧采用专业拆镜,Agent 按每镜制作目标选择单幅分镜图、时间故事版、镜头分镜板或专项板;不会自动补生成未选择的板型。用户要求只完成分镜图时不执行视频提示词或视频。`canvas node edit-shot` 会同步镜头字段别名并拒绝改写来源原文;修改时长后检查响应的 `durationOverrides`,保留的下游手工时长需要逐项确认。
|
|
17
17
|
|
|
18
18
|
`skill install/status/update` 管理这个唯一 Skill。短剧创作、humanizer 审计和 hypit 视频制作资料通过主 Skill 的 references 按需读取。
|
|
19
19
|
|
|
@@ -23,7 +23,7 @@ CLI 将长期凭据保存到系统钥匙串。短期 access token 会写入权
|
|
|
23
23
|
|
|
24
24
|
创作前运行 `ai-short-studio preflight --json`。CLI 会通过公开的 `/api/v1/bootstrap` 检查服务连通性、取得 Supabase 公共配置、读取 npm `latest` 稳定版本并报告 `updateAvailable`,默认只检查、不修改全局包。需要更新时显式传 `--update`,更新成功后按输出重跑。随后预检检查登录态和文本、人物、场景、故事版、视频模型配置。npm registry 暂时不可用时服务端使用配置版本降级。
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
专业拆镜由 Agent 按镜头合同选择实际需要的板型;已有首帧与历史产物保留,额外单图、时间故事版或镜头分镜板按需添加和接线,不为满足默认规则自动补板。
|
|
27
27
|
|
|
28
28
|
## 命令范围
|
|
29
29
|
|
|
@@ -6,10 +6,6 @@ export default class CanvasWorkflowStatus extends BaseCommand {
|
|
|
6
6
|
async run() {
|
|
7
7
|
const { flags } = await this.parse(CanvasWorkflowStatus);
|
|
8
8
|
const { api } = await commandApi(flags);
|
|
9
|
-
|
|
10
|
-
if (!response || typeof response !== 'object' || !('workflow' in response)) {
|
|
11
|
-
throw new Error('服务端未返回 Hypit 工作流状态');
|
|
12
|
-
}
|
|
13
|
-
this.print(response.workflow);
|
|
9
|
+
this.print(await api.canvasWorkflowStatus(flags.project));
|
|
14
10
|
}
|
|
15
11
|
}
|
|
@@ -119,6 +119,7 @@ export declare class VvicatApi {
|
|
|
119
119
|
}>;
|
|
120
120
|
canvasDocumentStatus(projectId: string, nodeId: string): Promise<JsonObject>;
|
|
121
121
|
canvasDocuments(projectId: string): Promise<JsonObject>;
|
|
122
|
+
canvasWorkflowStatus(projectId: string): Promise<JsonObject>;
|
|
122
123
|
listEdges(projectId: string): Promise<JsonObject[]>;
|
|
123
124
|
inspectCanvas(projectId: string, options: CanvasInspectOptions): Promise<JsonObject>;
|
|
124
125
|
continuityAnalysis(projectId: string): Promise<JsonObject>;
|
|
@@ -168,6 +168,15 @@ export class VvicatApi {
|
|
|
168
168
|
canvasDocuments(projectId) {
|
|
169
169
|
return this.client.request(`/api/projects/${projectId}/canvas/documents`);
|
|
170
170
|
}
|
|
171
|
+
async canvasWorkflowStatus(projectId) {
|
|
172
|
+
const response = await this.canvasDocuments(projectId);
|
|
173
|
+
const workflow = response && typeof response === 'object' && !Array.isArray(response)
|
|
174
|
+
? response.workflow : undefined;
|
|
175
|
+
if (!workflow || typeof workflow !== 'object' || Array.isArray(workflow)) {
|
|
176
|
+
throw new Error('服务端未返回 Hypit 工作流状态');
|
|
177
|
+
}
|
|
178
|
+
return workflow;
|
|
179
|
+
}
|
|
171
180
|
async listEdges(projectId) {
|
|
172
181
|
return (await this.canvas(projectId)).edges;
|
|
173
182
|
}
|
package/package.json
CHANGED
|
@@ -29,9 +29,9 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
|
|
|
29
29
|
| --- | --- | --- |
|
|
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
|
-
| 单集剧本、来源片段转剧本、剧本润色 | `references/short-drama/creation/write-drama-episode.md`、`references/short-drama/review/review-drama-script.md`、`references/short-drama/creation/humanizer.md` |
|
|
32
|
+
| 单集剧本、来源片段转剧本、剧本润色 | `references/short-drama/creation/write-drama-episode.md`、`references/short-drama/review/review-drama-script.md`、`references/short-drama/creation/humanizer.md` | 已有专业剧本时先复用并审核,不得重复执行 `novel-to-script`;改编先保留原文事实和对白,再做人味优化;必须回到 `drama-script-review`,P0/P1 未清零不得进入导演阶段 |
|
|
33
33
|
| 人物、场景、道具和资产版本 | `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 → storyboard
|
|
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
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 |
|
|
36
36
|
| 视频提示词、H3、Seedance、原生音频 | `references/short-drama/generation/write-drama-video-prompts.md`、`references/short-drama/generation/seedance-community-skills.md`、`references/h3-video-delivery.md`、`references/short-drama/generation/design-drama-audio.md` | 默认由 Agent 生成并保存 Hypit 文档;按实时 Provider schema 选择协议并审计后提交视频 |
|
|
37
37
|
| 背景音乐、主题曲、纯音乐 | `references/short-drama/generation/design-drama-audio.md`、`references/short-drama/starrouter-provider.md` | 使用画布 `music-generate` 和实时音频模型目录;有自定义歌词时不得同时开启纯音乐;生成后试听并回读 AUDIO 资产版本 |
|
|
@@ -59,7 +59,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
|
|
|
59
59
|
3. **项目配置门禁**:读取 `canvas settings get`,展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options。确认 `aspectRatio`、`artStyle`、`visualBible`、`storyboardImageType`、`outputLanguage`、`analysisModel`、`imageModel`、`imageResolution`、`imageQuality` 和 `videoResolution`,以及 `editModel`、`videoModel`、`videoPromptType`、`audioModel`、`musicModel`;`$ART_STYLE_ID` 必须解析实时 `option.value`。标准创作门禁使用 `--file settings.json` 原子写入并携带 `expectedVersion`,回读一致前不得创建或运行付费节点。节点确需不同参数时才按实时能力覆盖。
|
|
60
60
|
4. **Hypit 文档和目标集**:先读取 `canvas workflow status`,按当前阶段和条件模块生成 JSON;使用 `canvas document save` 写入 `hypit.<module>.v1`,用 `--input` 固化上游选版。审核必须另存为 `hypit.review.v1` 并绑定被审核版本。无需先调用固定节点或生成模型,不要创建没有版本的文档空壳。已有 Hypit 文档直接复用;历史 `screenplay-resource` 或结构化资源先迁移成 Hypit 文档,再继续流程。需要创作微短剧时,按需读取 `references/short-drama/`,再读取 `references/humanizer/` 去除 AI 味;不得改动已经确认的剧情事实,润色后回到短剧 reference 复核。确认目标集数后,只生产该集实际需要的资产。
|
|
61
61
|
5. **资产门禁**:先完成人物、场景、道具及其派生版本,展示真实预览并确认 selected version。执行资产—剧情匹配审计;缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
|
|
62
|
-
6. **拆镜和滚动生成**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建默认专业拆镜,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2
|
|
62
|
+
6. **拆镜和滚动生成**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建默认专业拆镜,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2`,不自动新增首帧节点。Agent 先读取每镜 `storyboard_strategy`,按制作目标选择单幅分镜图、时间故事版、镜头分镜板、专项板或 Blender;已选择一种板型时不得自动补生成另一种。只审核实际生成的板型,并让视频提示词只引用真实存在且已审核的分镜资产。用户的停止阶段优先于 [滚动异步调度](references/async-pipeline.md):仅分镜图任务完成实际选择的板型并通过审核后停止,不运行视频提示词和视频。允许视频时,已就绪镜头滚动提交,单镜失败不阻塞其他镜头。
|
|
63
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
64
|
8. **H3 生成门禁**:`videoModel` 为 `comfly::minimax-h3` 或 `runninghub::minimax-h3-reference-to-video` 时,同次设置 `videoPromptType: "h3"`。仅有效的节点 `promptType` 可覆盖项目值;旧 `seedance` 覆盖必须清除并回读,否则不得执行视频生成或写入提示词。Agent 编写 H3 提示词时读取 `references/hypit/playbooks/craft/h3-prompt-writing.md`;进入生成前必须读取 [H3 成片规则](references/h3-video-delivery.md)。
|
|
65
65
|
9. **逐镜后验**:每个视频镜头完成后实际看画面、听完整音轨,并完成视觉、音频、转场、字幕四项验收。任一 P0/P1 失败只修复并重跑受影响镜头;未通过不得进入成片剪辑。
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
平台不自动看图判断换手、缺道具、白胡须、构图或角色是否正确。人或 Agent 必须查看实际当前选版,提交每项 `criteria` 的状态和具体观察;服务端检查记录结构、来源版本、媒体摘要和技术指标,并据真实记录计算批准,调用方不能填写 `approved`。没有审核记录与实际质量不合格是两种不同状态,不能混为“平台检测到图片错误”。
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
已选板型审核流程:先读取 `canvas asset review-context`,实际查看本镜已选择的分镜板图片,按返回的 `requiredDimensions` 提交 `canvas asset review`。视频须完整看画面并听音轨,检查真实起中末及实际时长,提交相应播放证据。不能把技术探测、抽帧、ASR 或提示词当作完整观看;没有观察能力时明确指出缺口,不填虚假通过。不把失败改写为通过来绕过审核。
|
|
10
10
|
|
|
11
11
|
文本审计称缺原文时,先区分 `source_text/sourceText`(画内文字和受保护字面量)与剧本原文。没有画内文字时空值合法,不得把动作原文塞进该只读字段。读取服务端来源合同,按准确来源 ID 将原文作为制作计划/审计节点的证据输入,再仅重跑受影响文本节点。
|
|
12
12
|
|
|
@@ -51,7 +51,7 @@ ai-short-studio canvas node add storyboard-breakdown --project "$PROJECT_ID" --s
|
|
|
51
51
|
ai-short-studio canvas edge add --project "$PROJECT_ID" --from "$SCRIPT_ID:script" --to "$BREAKDOWN_NODE_ID:script" --json
|
|
52
52
|
```
|
|
53
53
|
|
|
54
|
-
人物、场景、道具也可直接创建对应 `*-resource` 并写入 `config.text
|
|
54
|
+
人物、场景、道具也可直接创建对应 `*-resource` 并写入 `config.text`,不要求先调用分析模型。已选板型会按节点和正文摘要追踪手工设定,修改正文会使旧来源失效;实际图片参考仍须生成或导入、明确绑定并连接到对应板型。
|
|
55
55
|
|
|
56
56
|
按需要把真实人物、场景、道具资源连到对应输入,随后读取 `storyboard-draft`,取得服务端解析的来源合同、资产白名单和当前画布版本。没有草稿时返回 `available:false`,并不要求先执行模型任务。
|
|
57
57
|
|
|
@@ -67,7 +67,7 @@ ai-short-studio canvas edge add --project "$PROJECT_ID" --from "$SCRIPT_ID:scrip
|
|
|
67
67
|
}
|
|
68
68
|
```
|
|
69
69
|
|
|
70
|
-
用下节同一命令分别 `--dry-run` 和正式提交。提交后回读,使用 `edit` 和 `replace-range` 创建/拆分/合并镜头草稿,再显式 `promote`
|
|
70
|
+
用下节同一命令分别 `--dry-run` 和正式提交。提交后回读,使用 `edit` 和 `replace-range` 创建/拆分/合并镜头草稿,再显式 `promote` 生成正式镜头节点及已选板型制作节点。批准不生成图片或视频。不要只添加空 `storyboard-shot` 外壳或伪造 `artifact`,那没有可供下游读取的镜头版本。初始镜头不需要平台先调用模型生成。
|
|
71
71
|
|
|
72
72
|
若已有草稿,要整体重新规划必须显式带当前 `basedOnDraftVersionId`;不能以 `null` 覆盖。来源变更后可基于当前连线重新 `create`,旧版本仍保留;不从客户端提交或覆盖来源合同和资产白名单。正式镜头的后续字段修改用受控 `revise-storyboard`,不要用创建动作绕过父子同步。
|
|
73
73
|
|
|
@@ -94,10 +94,10 @@ ai-short-studio canvas node storyboard-draft "$BREAKDOWN_NODE_ID" --project "$PR
|
|
|
94
94
|
}
|
|
95
95
|
```
|
|
96
96
|
|
|
97
|
-
`replace-range` 使用当前连续区间的 `shotIds` 和替换 `shots:[{id,panel}]`;可以增删、拆分和合并,新增镜头使用新唯一 ID,保留镜头沿用其 ID
|
|
97
|
+
`replace-range` 使用当前连续区间的 `shotIds` 和替换 `shots:[{id,panel}]`;可以增删、拆分和合并,新增镜头使用新唯一 ID,保留镜头沿用其 ID。提供完整目标镜头,镜号由服务端重算;来源单元可重新分配,来源定义和原文不可改写。相邻转场、已选板型、镜头组及连续性联动修正。数组整体替换,对象字段合并;未知字段报错,409 后重新读取再审阅。只读来源变化时旧草稿仅可查看,须重新规划。
|
|
98
98
|
|
|
99
99
|
`blockingIssues` 阻止批准,不阻止草稿保存。保存后检查服务端新诊断、差异和版本,不能由 Agent 自行宣布问题已解决。没出现完整解析结果时 `available:false`,可用 `create` 主动编写草稿,不得声称模型已生成。
|
|
100
100
|
|
|
101
|
-
修复后单独提交 `action:"promote"`,`operations:[]`,并携带当前画布/草稿版本及新 `requestId
|
|
101
|
+
修复后单独提交 `action:"promote"`,`operations:[]`,并携带当前画布/草稿版本及新 `requestId`。批准失败仍保留草稿和诊断;批准成功才更新正式父子版本并派生已选板型节点,不调用生成模型。软建议不阻断批准;不得从资产历史直接选中未批准草稿。
|
|
102
102
|
|
|
103
103
|
规划内置最多三轮;后续模型输出无效时上一完整草稿仍可修复,不自动追加第四轮。需要拆镜重组的时长问题,应按完整来源单元拆分,并更新素材时长与剪辑保留时长;不要删词、加速或静默夹取到15秒。草稿批准没有运行的摄影、表演、细化阶段如实标为跳过,不宣称已完成独立设计。
|
|
@@ -4,9 +4,9 @@
|
|
|
4
4
|
|
|
5
5
|
## 拆镜模式与交付范围
|
|
6
6
|
|
|
7
|
-
新建短剧或修复专业链路时,默认使用专业拆镜:JSON 剧本设置 `--source-format screenplay-json.v1 --platform short-drama`,Markdown 设置对应格式;回读确认 `sourceFormat`、`platform` 和 `storyboardPipelineVersion: 2
|
|
7
|
+
新建短剧或修复专业链路时,默认使用专业拆镜:JSON 剧本设置 `--source-format screenplay-json.v1 --platform short-drama`,Markdown 设置对应格式;回读确认 `sourceFormat`、`platform` 和 `storyboardPipelineVersion: 2`。只有用户明确选择普通自由分镜或单帧交付时才采用普通链路,不能把“只到分镜图停止”理解成跳过已选择板型的审核,也不能因一分钟片长、调用次数或校验失败自行降级。失败应修复来源或当前阶段,不清除专业字段绕过校验。
|
|
8
8
|
|
|
9
|
-
`count: 1` 只表示一次生成一张图片;该图可以包含 6
|
|
9
|
+
`count: 1` 只表示一次生成一张图片;该图可以包含 6 格。专业镜头按 `production-plan.required_board_types` 生成时间故事版、镜头分镜板或其他已选择板型;首帧 `keyframe/single` 可按需使用,不能代替已选择板型的审核。专业拆镜只派生计划中声明的板型,不自动补建未选择的板型;Agent 也不得为每镜补建首帧。已有首帧及历史媒体保留,删除后拆镜不再补建;只有需要额外单图参考时才按需添加并接线,普通单图不能冒充已选板型审核。普通单图节点允许合法覆盖布局,但代理不得仅凭“单图更清楚”覆盖用户已确认的项目宫格设置。提交生图前回读每个节点的实际 `imageLayout/gridSize/aspectRatio` 及 `data.production`,按镜号列出已选择板型覆盖;只看项目 settings 或节点标题不算核验。
|
|
10
10
|
|
|
11
11
|
用户要求“不生成视频,只到分镜图完成”时,停止点是范围内所有必需板图的实际验收,不运行视频提示词或视频任务。节点自动派生不代表有权执行。专业板使用正式 `stage: board` 审核;普通单帧只能报告人工目检,接口返回 `MEDIA_REVIEW_PROFESSIONAL_BOARD_REQUIRED` 时不得伪造 production 合同或称系统审核通过。结构完成、像素合格、审核批准和视频生成分别报告。
|
|
12
12
|
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
|
|
25
25
|
板图质量未通过时,只有用户明确授权才可按 [显式风险接受](agent-recovery.md#已观察板图缺陷显式接受风险后继续生成) 继续测试生成;审核仍为未通过,不删除缺陷,不用于宣称成片合格。
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
已选分镜板到视频:在视频提示词节点连接本镜 `shot`、主 `storyboard`、已选择的分镜板和当前 `shotReview/continuityPlan`。预检的正式批准字段分别为 `summary.approved`、`approved`,必须覆盖原始 `shot_key`,没有未决问题或连续性冲突。默认由 Agent 审阅这些选版后用 `canvas node write-video-prompt` 写入最终提示词;用户也可在尚未写入时手动点击原生成节点。Agent 写入后节点拒绝自动生成。视频节点使用 `references` 连接实际选择的独立板和可选单帧参考,并连接同版本的提示词与对应预检;不要混连 start-frame/end-frame。模型参考图数量上限必须已知且足够,超限不能删参考硬跑。服务端提交与 Worker 调用前均复核当前板版本、真实摘要和各自审核,任务保存实际参考顺序。专业提示词/视频回写前再核对文件摘要,并在结果事务锁内复核选版和审核;已失效结果只追加历史版本,不自动选中或覆盖新任务。任务结果 `historical: true` 和版本 `generationParams.productionResultState: stale` 表示仅归档,需回读原资产版本列表及节点状态。额外图片参考须绑定同画布来源节点、选版和实际摘要;专业关键帧须匹配本镜及父拆镜。首尾帧提取记录源视频选版、位置和实际字节摘要,源视频改变会阻止继续使用;没有来源记录的旧提帧须重新提取。已选择板型和关键帧生图绑定镜头、父拆镜及实际图片参考快照,生图前、返回后及锁内回写复核;来源变化仅归档历史结果。审核继续复核这些来源,没有来源快照的旧板图须重新生成后取得新批准。剪辑交付仍待闭合,不宣称完整生产链路已通过。
|
|
28
28
|
|
|
29
29
|
## 资产生产门禁
|
|
30
30
|
|
|
@@ -34,16 +34,16 @@
|
|
|
34
34
|
2. 每个形象候选使用独立输入、独立三视图节点和独立图片资产;`count` 的多个结果也不能拼图。视觉素材未另行指定时使用 16:9,并按实时 schema 显式写入。
|
|
35
35
|
3. 真/假、原版/复制、成年/童年等成对资源必须先生成基础版并确认,再把基础版 `image-resource` 作为 reference 生成派生版;prompt 只枚举允许差异,其余保持一致。
|
|
36
36
|
4. 每个分镜拆解节点只连接一条目标集剧本,以及该集全部确认人物、场景和道具。素材缺失、未选版、映射歧义或连线不足时禁止执行。
|
|
37
|
-
5.
|
|
37
|
+
5. 结构化剧本的镜号、顺序和来源由服务端确定性编译,模型只补摄影、表演和画面。镜头数和总时长预算是质量建议,超出时保留软提示,不拒绝合法规划;来源覆盖、对白时长和已选择板型等硬合同仍须满足。
|
|
38
38
|
6. 拆镜成功后刷新画布并复用自动创建的 shot/image/prompt 节点;按 `parentAssetId`、`producerNodeId` 和集号核对归属,不按任务提交顺序猜测。
|
|
39
39
|
|
|
40
40
|
## 专业时间宫格与镜头故事版
|
|
41
41
|
|
|
42
42
|
专业拆镜每镜包含 `storyboard_strategy`:`primary_board_type` 为 `temporal` 或 `shot`,`required_board_types` 必须同时包含两类,`selection_basis` 说明选择依据,`frame_count` 使用 4/6/9/16/25,默认建议 6。时间宫格画同镜动作因果,镜头故事版画可见的空间、调度和视线关系;单幅首帧独立存在,不能替代任一板。
|
|
43
43
|
|
|
44
|
-
|
|
44
|
+
物化按每镜 `required_board_types` 复用已选择的板型,并维护已有首帧,不按任务完成顺序猜身份。`canvas inspect` 的 `data.production` 提供板型和镜头归属;该字段仅由服务端维护,禁止通过 `canvas apply` 伪造。生成任务记录当前镜头选版、父拆镜版本和板型,不能从草稿文字替代来源。编辑 `storyboard_strategy.frame_count` 后同步已选择板型的格数;已有选版保留但标记 stale,分别重新生成。导演上下文不设独立的 10,000 字符门槛;最终提示词按实际供应商和模型能力校验,当前 GPT Image 2 支持 36,000 字符。不手写旁路提示词绕过来源和已选择板型合同。
|
|
45
45
|
|
|
46
|
-
|
|
46
|
+
专业提示词完成后,自动派生的视频节点继承主图、两板及对应预检,同图兼任主板时只接一次参考;回读 inspect 核对实际连线和当前版本。板节点与图片存在仅证明已派生或已生成,不证明实际审核通过或已传入视频。逐板查看真实图像并核对版本与引用;同图换标题不算另一类板,抽帧或 ASR 不能代替声画审核。
|
|
47
47
|
|
|
48
48
|
## 拆镜语言匹配门禁
|
|
49
49
|
|
|
@@ -95,7 +95,7 @@
|
|
|
95
95
|
|
|
96
96
|
每批完成后回读任务、节点、连线、资产、最终配置和 selected version,并实际查看所有图片。检查身份、肢体、道具、构图、画幅、裁切、文字、连续性和空结果。缺陷需再次付费生成或改选版本时,遵循已有授权;超出用户已确认的生成数量或修改范围才补充确认。
|
|
97
97
|
|
|
98
|
-
|
|
98
|
+
已选板型的 `storyboard_strategy.frame_plan` 必须登记 `beats:[{id,sourceUnitIds,description}]`,来源并集恰好等于本镜 `sourceUnitIds`;`temporal_cells` 与 `shot_cells` 各为 `frame_count` 个 `{beat_id,visible_change}`,各自覆盖全部节拍且不重复填格。时间格按节拍顺序,空间格表达几何证据,不能复制同一计划。`overflow_strategy` 固定 `return-to-breakdown`;容量不足退回拆镜,不截断、不借邻镜来源。旧策略可读,重新生成/审核前须补计划;`STORYBOARD_BOARD_FRAME_PLAN_*` 指出计划缺陷。专业镜头按下文“读取—预览—保存—复查”通过 `canvas node revise-storyboard` 保存策略补丁,改格数时同步已选择板型的计划及节点配置。结构校验不证明语义或像素符合预期。
|
|
99
99
|
|
|
100
100
|
|
|
101
101
|
使用前镜尾帧时,在镜头编辑器的 `continuity` JSON 中为相邻两镜填写 `camera_setup_id`、`entry_state`、`exit_state`。机位 ID 必须相同,前镜 `exit_state` 必须与本镜 `entry_state` 完全一致,本镜 `mode` 为 `previous-tail`,`sourceShotKey` 指向紧邻前镜。状态描述应包含位置、朝向、持物、姿态动势、轴线、光照和天气;换机位使用 `independent`。视频生成必须接入同一父拆镜下、已通过当前版本实际播放审核的前镜视频所提取的真实尾帧,并占用一个独立参考名额。提示词可提前规划;实际生成不可缺少尾帧。建议接线也遵守机位和状态约束。前镜换版或审核变化会阻止执行,执行中变化则仅归档历史结果。旧镜头可读,重新使用尾帧前须补齐声明并重新审核。声明一致不证明像素衔接自然,仍须检查实际视频。
|
|
@@ -128,12 +128,12 @@
|
|
|
128
128
|
|
|
129
129
|
### 同一母场景的天气变体
|
|
130
130
|
|
|
131
|
-
`location-image` 的 `data.config.locationWeatherVariant` 可设 `sunny` 或 `thundercloud`,用途必须为 `background-plate`。将同一已选干净基础背景连接到 `masterLocation`,该输入必须唯一对应一张图片,且母场景自身不是天气变体。未选天气时不要连接此端口;其他参考仍走 `reference`。模型参考图数量能力必须明确且足够。服务端生成 `locationWeatherContract
|
|
131
|
+
`location-image` 的 `data.config.locationWeatherVariant` 可设 `sunny` 或 `thundercloud`,用途必须为 `background-plate`。将同一已选干净基础背景连接到 `masterLocation`,该输入必须唯一对应一张图片,且母场景自身不是天气变体。未选天气时不要连接此端口;其他参考仍走 `reference`。模型参考图数量能力必须明确且足够。服务端生成 `locationWeatherContract`,只允许天气/光照变化,保存母场景选版和字节摘要;不要手写该合同。实际请求使用母场景参考序号并要求固定地形、建筑、门窗、通道、机位和画风。母场景换版后,天气图、已选择分镜板、视频审核及剪辑/交付检查会拒绝旧来源;依次重跑并重新审核,既有产物留存。合同不证明实际像素一致。详见 `/docs/production/location-weather-variants`。
|
|
132
132
|
|
|
133
133
|
|
|
134
134
|
## 专业拆镜软提示与增量修订
|
|
135
135
|
|
|
136
|
-
|
|
136
|
+
专业拆镜的节奏、重点比例和建议预算是软提示;来源原文、资产、素材时长、已选择板型和相邻合同仍是硬门禁。部分细化回退不等于已完成独立设计或媒体审核。
|
|
137
137
|
|
|
138
138
|
读取 `canvas node revise-storyboard PARENT_NODE_ID --project PROJECT_ID --json`,取得 `data.canvasVersion`、`data.parentVersionId`、`data.shots` 当前版本、来源合同、白名单及结构化提示。构造 `{expectedCanvasVersion,basedOnVersionId,edits:[{nodeId,basedOnVersionId,patch,warningIds?}]}` 文件,先用同一命令的 `--file patch.json --dry-run --json` 预览,再去掉 `--dry-run` 保存,最后重新读取。
|
|
139
139
|
|
|
@@ -145,15 +145,15 @@
|
|
|
145
145
|
|
|
146
146
|
验收将故事板工作纸、分框、格号、动作箭头和必要制作标注与剧情画面分开:制作标注跟随项目语言,CU、OTS、pan 等规范术语可用英文,不因正常标注拒绝;来源要求的道具文字、招牌和剧情内界面保持原始语言及内容,不得翻译或虚构对白字幕。真实换手、道具功能面/开口朝向错误、缺少动作起态、状态重置或提前揭示仍判缺陷。
|
|
147
147
|
|
|
148
|
-
|
|
148
|
+
申请付费重生前先核对最终请求提示词是否与参考图、当前导演合同及逐格计划冲突,记录具体镜号/格号、操作者、持物手、道具朝向和首尾状态的可见缺陷。修正输入后再按用户授权生成;不追加“每格都说话/反应”的统一要求,不绕过已选择板型合同另写独立生成提示词,不自动循环重生。基础人物参考只锁定稳定外貌,不能提前携带后续揭示道具或强行重置剧情状态。
|
|
149
149
|
|
|
150
150
|
连续性批准必须显式 `approved=true`、覆盖全部目标 shot_key、检查完成且无冲突/未决项;空问题列表不代表批准。未批准必须说明原因,结构通过和计划声明不能替代图片的实际检查。
|
|
151
151
|
|
|
152
|
-
|
|
152
|
+
专业拆镜若仅剩板型策略硬错误,服务端在原有三轮上限内只纠正报错镜头的策略;不改其他镜头、来源或对白。失败诊断按格号和节拍定位时间逆序、板型重复等具体问题;不能靠自动排序、补格或放宽硬校验交付,也不自动反复提交原任务。
|
|
153
153
|
|
|
154
154
|
|
|
155
155
|
终场纯“黑场/切黑/CUT TO BLACK/FADE OUT”按剪辑结束状态处理,保留来源ID并与同场景前一叙事来源同镜,不单独制作两张全黑宫格。黑场单独对应一个节拍,只占一个最终时间格和一个空间格,其余格继续按真实剧情与空间证据填写;不得删黑场来源、虚构黑场动作或改写对白。服务端返回 STORYBOARD_EDITORIAL_CUE_INVALID 时需要重新规划来源归属,已批准单镜入口不能改来源;未批准草稿可用 storyboard-draft 调整来源归属和镜头拓扑,保留完整原文并复查。
|
|
156
156
|
|
|
157
|
-
|
|
157
|
+
规划内置纠错最多三轮:仅板型策略问题修策略;来源集合合法且目标镜数可保留时,结构或终场分配问题仅替换报错镜头(必要时含前一镜),不改目标外镜头,目标来源集合保持不变并重跑整集校验。原始规划没有合法来源覆盖,或终场合并后无法保留目标镜数时,回到完整规划;不得为了维持镜数补空镜。不要为了“必须25镜”等数量要求补无来源空镜;模型新增的assetNodeRefs_note等未知字段继续拒绝,不静默忽略。每轮诊断记录full/board/panel模式与目标镜号;验收报告要区分通过硬校验、细化完成和实际媒体合格,不自动追加第四轮或重生。
|
|
158
158
|
|
|
159
|
-
资产校验失败须读取 `problems` 中镜号、字段、实际值和允许名称/节点 ID,不按 `STORYBOARD_ASSET_INVALID` 汇总代码猜测缺图或替换身份。`shot_group.role` 只允许 setup/action/reaction/bridge/payoff;build/turn/climax/release 属于 `rhythm_plan.beat_role`,不能混用。语音校验同时约束素材时长与剪辑保留时长;需要超过 15
|
|
159
|
+
资产校验失败须读取 `problems` 中镜号、字段、实际值和允许名称/节点 ID,不按 `STORYBOARD_ASSET_INVALID` 汇总代码猜测缺图或替换身份。`shot_group.role` 只允许 setup/action/reaction/bridge/payoff;build/turn/climax/release 属于 `rhythm_plan.beat_role`,不能混用。语音校验同时约束素材时长与剪辑保留时长;需要超过 15 秒时,应在规划阶段重分配完整来源单元并更新已选择板型/相邻合同,不能只拉到 15 秒、快进或删词。单个不可分来源本身超过上限时,报告来源约束;正式分镜增量入口不得改来源或镜头拓扑;未批准草稿可用 storyboard-draft 在只读来源合同内重分配来源并增删拆并镜头。
|
|
@@ -10,7 +10,7 @@ description: Direct and produce videos with Hypit, primarily through generated m
|
|
|
10
10
|
|
|
11
11
|
短剧原创制作和短剧参考片复刻是两条不同链路,开始工作前必须先根据用户目标和项目事实判定类型,不能把一条链路的步骤套到另一条链路上。
|
|
12
12
|
|
|
13
|
-
- **原创短剧链路**:没有要复刻的参考片时,使用 `short-drama`
|
|
13
|
+
- **原创短剧链路**:没有要复刻的参考片时,使用 `short-drama` 的标准流程,从项目、剧本、导演本、资产、分镜、制作、剪辑到交付推进;运动参考按镜头制作目标选择分镜板或必要的 Blender 白模。
|
|
14
14
|
- **参考片复刻链路**:用户要求复刻、克隆、仿拍或提供了要还原的原片时,使用原生 `hypit recreate`:导入参考片 → 理解与正式分析 → 设计新人物、场景和道具并选定资产图 → 逐镜去字幕、恢复时间基准、制作并审核深度视频 → 编写逐镜提示词和 Run → 核对制作计划与实际媒体绑定 → 用户确认后生成、审片和交付。复刻项目使用 `workflow.type=viral-recreation`;短剧插件只负责原创短剧,不接受复刻 profile。普通复刻不强制制作双分镜板或原片关键帧;精确文字、接触和复杂动作等风险镜头可按需制作分镜板。
|
|
15
15
|
|
|
16
16
|
如果用户只说“做短剧”但没有说明是否复刻,先确认是否存在需要保留结构、镜头运动或节奏关系的参考片;一旦存在这类参考片,就按复刻链路处理,并在项目记录中写明来源、权利范围和复刻类型。
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
## 从分析包进入视频生成
|
|
11
11
|
|
|
12
12
|
- 先固定源时间范围、逐镜动作、人物身份、道具状态和逐句语言;区分原文台词与翻译字幕。分析、ASR和烧录字幕有出入时保留来源与待核项,不能用翻译字幕冒充原声逐字转写。
|
|
13
|
-
- 复刻拆镜应进入现有结构化镜头和制作合同链路。手写分析、H3
|
|
13
|
+
- 复刻拆镜应进入现有结构化镜头和制作合同链路。手写分析、H3提示词和审核清单只是草稿,不会自动获得专业镜头的已选板型、版本失效和媒体审核门禁。不能为省一次拆镜而全部替换为text节点,再宣称标准链路验收通过。
|
|
14
14
|
- 执行前读取实际视频模型、协议、参考图/视频/音频能力及输入模式。深度预处理成功不代表视频模型支持参考视频;适配器拒绝参考类型时停止该请求,不通过删掉参考或切换模型偷偷降低复刻目标。
|
|
15
15
|
- 向同一端口批量新增参考连线会按请求顺序保留输入;回读核对图号与提示词。历史连线没有顺序记录时须按实际顺序核对,不能靠UUID推断。删除重建参考后,旧提示词和绑定清单须重新核对。
|
|
16
16
|
- 逐镜列出生成前未解决问题。服装/身份错误、关键状态板缺失、倒计时状态或手部交互覆盖不足不能仅靠“提示词强制纠正”记为已修好;按制作计划决定重做对应资产或重新评估方案。预算不足不能默默取消承载关键叙事状态的资产。
|
|
@@ -46,7 +46,7 @@ description: 短剧全流程唯一入口。用于原创短剧的创建、恢复
|
|
|
46
46
|
| asset-analysis | `plan-drama-assets` → `generate-drama-art-style`,存在人物时增加 `generate-character-profiles` |
|
|
47
47
|
| asset-generation | `manage-drama-assets`,缺少可复用资产时按需增加人物、场景、道具生成与生成服务模块 |
|
|
48
48
|
| production-plan | 按条件加入 `design-fight-video`,再执行结构化分镜、制作计划与连续性模块 |
|
|
49
|
-
| media-production |
|
|
49
|
+
| media-production | 原创项目按镜头选择分镜图类型、视频提示词、镜头审核、视频生成和任务监控;复杂调度按需增加 Blender 白模,按声音策略增加音频模块 |
|
|
50
50
|
| editing | `remotion-best-practices` → `edit-drama-timeline` |
|
|
51
51
|
| delivery | `edit-deliver-drama` |
|
|
52
52
|
|
|
@@ -62,8 +62,9 @@ description: 短剧全流程唯一入口。用于原创短剧的创建、恢复
|
|
|
62
62
|
|
|
63
63
|
制作计划按项目来源决定主运动参考,并逐镜记录 `storyboard_strategy.mode=image|blender`:
|
|
64
64
|
|
|
65
|
-
-
|
|
66
|
-
- `
|
|
65
|
+
- 每个镜头由 Agent 根据制作目标选择单幅分镜图、时间故事版、镜头分镜板或专项板;只有确实需要同时表达动作顺序和构图关系时才选择多个板型,不能自动补齐未选择的板型。
|
|
66
|
+
- 选择标准:只需要构图、景别和画面关系时选单幅分镜图;需要动作顺序或状态变化时选时间故事版;需要轴线、调度和镜头节拍时选镜头分镜板;同时需要动作过程与构图关系时选 `temporal + shot-board`;静态图无法证明空间、接触或复杂运动时才追加 Blender。选择结果写入 `production-plan`,后续审核和视频提示词只引用实际存在且已审核的板型。
|
|
67
|
+
- `standard` 无参考视频项目默认先用静态分镜图;只有静态图无法证明复杂路线、多人交互、精确接触、轴线风险或连续运镜时才追加 Blender 白模作为运动参考。不得先生成伪参考视频再转深度。
|
|
67
68
|
- 需要白模时加载 [白模编导](storyboard/direct-blender-previz.md)、[白模生成](storyboard/generate-blender-previz.md) 和七项导演验收。
|
|
68
69
|
- UE Mannequin 是默认人物模型;镜头时长、导演合同、媒体实际时长和制作计划必须一致。生成成功不等于通过,必须完整观看并完成多维审计。
|
|
69
70
|
|
|
@@ -85,7 +86,7 @@ description: 短剧全流程唯一入口。用于原创短剧的创建、恢复
|
|
|
85
86
|
- Agent 检视本地图片时必须把生产原件与分析输入分开:先读取尺寸和文件体积,默认生成最长边不超过 2048 px、文件不超过 2 MB 的临时预览,并以普通/高细节模式读取,禁止首次直接读取或上传原图。预览仍不足时只裁切或分块读取关注区域,每块沿用相同上限;只有确需像素级核验且确认请求体安全时才读取原图。临时预览不得替换资产账本、哈希、Provider 参考或交付中的原件。
|
|
86
87
|
- 远端生成前展示完整制作计划,包括 Provider、模型、参数、素材用途、候选数和请求次数;不计算具体价格,计划未确认不得提交。
|
|
87
88
|
- 所有剧情事实、人物关系、结局、逐字对白与旁白变更先获得用户确认。
|
|
88
|
-
- 画风确认必须先形成包含 `renderingContract` 的完整 style
|
|
89
|
+
- 画风确认必须先形成包含 `renderingContract` 的完整 style 对象;人物、场景、道具、已选分镜板和视频提示词一律从该对象编译媒介与渲染规则。不得把真人写实当成通用默认,也不得让“设定板/故事板/电影感”等版式或质量词覆盖用户选择的二维、三维、定格、像素或自定义媒介。
|
|
89
90
|
- 成年人物突出帅气、漂亮、飒、性张力、独立妆造和记忆点;儿童突出可爱并禁止成人化或性化。
|
|
90
91
|
- 任何人物、场景、道具、分镜、视频、音频和剪辑产物都必须登记真实本地路径、版本、来源和 SHA-256;不得用占位文件通过门禁。
|
|
91
92
|
- 图片分镜、白模、视频、原生声音、兜底配音和成片必须执行各自 reference 的完整多维审核。未观看/未听完不得批准。
|
|
@@ -4,6 +4,6 @@
|
|
|
4
4
|
|
|
5
5
|
画风必须统一人物、场景、道具、分镜与视频的媒介、色板、光线和运动语言,但不得写入具体人物身份、剧情动作或地点事实。画风确认阶段就必须形成 `renderingContract`,明确 `medium`、`rendering_method`、`surface_language`、`image_formation` 和 `forbidden_substitutions`;不得把真人写实设为隐式默认,也不得用“电影感”“高级感”代替媒介定义。需要预览时调用 `drama-generation-service`,展示并确认图片 Provider、模型、尺寸、参考图和候选数,不计算具体价格;预览保存到本地 `assets/other/`。
|
|
6
6
|
|
|
7
|
-
用户确认后,用 `project-store.mjs update-project` 将完整配置写入 `.short-drama/project.json` 的 `creative.art_style`。随后必须使用 `art_style_decision.{zh,en}.txt` 输出确认合同,并以 `project-store.mjs put-document <项目> art-style <JSON>` 保存为 `.short-drama/art-style.json`;其 style 必须与项目配置完全相同,才能登记本 Skill。下游 `render-prompt.mjs` 必须接收完整 style
|
|
7
|
+
用户确认后,用 `project-store.mjs update-project` 将完整配置写入 `.short-drama/project.json` 的 `creative.art_style`。随后必须使用 `art_style_decision.{zh,en}.txt` 输出确认合同,并以 `project-store.mjs put-document <项目> art-style <JSON>` 保存为 `.short-drama/art-style.json`;其 style 必须与项目配置完全相同,才能登记本 Skill。下游 `render-prompt.mjs` 必须接收完整 style 对象,统一把它编译成画风合同后再注入人物、场景、道具、已选分镜板和视频提示词;不得只传名称、分类或一行风格短语。
|
|
8
8
|
|
|
9
9
|
当用户确认的是自定义画风(而非系统画风)时,必须将完整 style 对象追加或更新到统一工作区根目录下的 `art-styles.custom.json`(或环境变量 `SHORT_DRAMA_CUSTOM_ART_STYLES_FILE` 指定的路径),确保下次可直接选择。只登记已确认且通过完整字段校验的画风;不得把草稿、未确认结果或系统画风复制进自定义库,也不得覆盖系统画风同 ID。修改已投入使用的画风必须标记受影响资产为 stale,不静默混用旧风格。
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
|
|
25
25
|
前置选择门:在决定 image_strategy、storyboard_strategy、Provider 或付费任务之前,先逐镜阅读导演本、已选分镜和用户限制,判断本镜主要不确定性属于:单一构图/首尾状态(single-frame)、连续动作与精确状态(temporal)、剧情因果/发现/情绪转折(narrative)、人物路线与空间调度(blocking)、格斗/追逐/冲击动作链(action)、舞蹈/武术/运动姿态拆解(choreography)、场景鸟瞰(scene-overview)、平面规划(scene-plan)、同一场景多视角固定(scene-turnaround)、导演节奏交付(director-track)或高风险全维度主镜头(comprehensive)。只选择能解决当前主要风险的最小主类型,并在 `selection_basis` 写出命中的原文证据和排除其他类型的理由;不得因为默认值或模型习惯直接把所有镜头标成 shot-board。
|
|
26
26
|
|
|
27
|
-
完整板型合同:standard 视频镜头的 `required_board_types`
|
|
27
|
+
完整板型合同:standard 视频镜头的 `required_board_types` 由 Agent 按镜头主要不确定性选择最小集合,不再自动包含 `temporal` 与 `shot-board`;主类型和每个附加类型都必须在 `selection_basis` 记录可观察证据和用途,只有同一镜确实需要表达多个独立信息时才选择多个板型。空间风险无法由已选静态参考证明时追加 `previz-3d`,它不能替代已选静态板。single-frame、scene-overview、scene-plan、scene-turnaround 等非视频资产不自动追加视频板。`image_strategy.board_type` 继续固定为 `shot-board` 以兼容现有图片生成执行器,但它不代表前置选择的主故事版类型。
|
|
28
28
|
|
|
29
29
|
规则:
|
|
30
30
|
1. 只能引用账本中存在的本地稳定 key 和 selected version;缺失或错版写入 unresolved。
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
5. unresolved 非空、参考素材用途未确认或任何制作参数缺失时,approved 必须为 false。
|
|
35
35
|
6. status 初始只能是 blocked 或 ready;依赖不齐不得写 ready。
|
|
36
36
|
8. Provider 支持 MiniMax H3 原生音频(video.native-audio)时,audio_strategy.mode 默认写 native,并记录逐秒 speech_timeline、跨镜统一 music_anchor 和相邻镜 transition_pair;这类镜头不得另排 TTS。仅当用户明确要求后配、或 Provider/模型明确声明不支持原生音频时才写 post-dub/independent 并排入独立音频流程;能力未明确时默认按原生处理,不得因信息缺失而静默转后配。相邻 H3 镜头的 transition_out 与 transition_in 必须成对一致。
|
|
37
|
-
9a. 生成前必须先落实 `required_board_types
|
|
37
|
+
9a. 生成前必须先落实 `required_board_types`:只生成其中声明的板型;主类型必须在集合中,每个板型都必须有对应的可观察风险或用途,未选择的板型不得自动生成。若选择 `previz-3d`,它仅为空间参考,并按其自身合同审核。`image_strategy.board_type=shot-board` 只是执行器兼容字段,不得覆盖 `primary_board_type`。
|
|
38
38
|
10. review_checks 按逐镜真实风险填写,每个检查项必须是具体、具名、可观察的短语(如「镜面反射一致性」「雨幕接触点可读」),并从合同 ai_risks 与证据元素反推:对白检查说话人与每张可见嘴部状态;多人镜检查人数、顺序、朝向和肢体归属;道具交互检查接触前/中/后状态及邻接物;步行/打斗检查落脚、重心、方向、速度和跨镜姿态;画内屏幕检查是否需要后期精确图形。命中构图风险时必须逐项落为检查:镜面/光滑水面核对映像与真人及现场陈设一致、无多指、无多余摄像机或反射穿帮;雨、雾、霓虹、烟尘核对天气光色有据、雨丝/烟向统一且不淹没接触点与人物身份;群体镜核对人数、身份、服色锚点且无多余路人;武器与多手交互核对形制、持有关系、手数与接触前/中/后;窄门缝或前景遮挡核对可见宽度、双眼完整与关键动作不被盖;高速拖影核对双眼、面部与接触点清晰可辨、主体不糊;前后夹击/包围核对前后景两方身份、距离与朝向可辨;竖屏镜核对脸、关键道具与接触点在中上安全区、底部字幕安全区不被占、动势边缘留 10% 余量。只保留本镜命中的风险项,不得复制同一组空泛检查覆盖所有镜头。
|
|
39
39
|
|
|
40
40
|
11. 仅当 previz_strategy.mode=blender 时,白模才由 direct-blender-previz 先生成导演合同,再由 generate-blender-previz 生成和评分;白模不能替代时间故事版、镜头分镜板、人物、场景、道具、服装、材质或最终画质参考。
|
|
@@ -45,8 +45,8 @@
|
|
|
45
45
|
|
|
46
46
|
禁止 API Key、Token、远程业务 ID、Markdown 和解释。
|
|
47
47
|
|
|
48
|
-
|
|
48
|
+
复核规则:时间故事版负责连续动作、运镜与精确状态,镜头分镜板负责景别、调度、轴线与叙事节拍;每个被选择的板型必须是独立资产。只有已选择的板型和其他独立参考实际超过 Provider 图片槽位才使用 compose-assets。项目 automation_mode=true 且仅缺 Provider 已支持的分辨率时,直接选支持值并写入计划。
|
|
49
49
|
|
|
50
|
-
standard 默认写 `storyboard_strategy.mode=image` 与 `previz_strategy={"mode":"none"}
|
|
50
|
+
standard 默认写 `storyboard_strategy.mode=image` 与 `previz_strategy={"mode":"none"}`;只有已选静态板仍无法无歧义表达复杂路线、多人交互、精确接触、轴线风险或连续运镜时,才追加可选白模作为 Blender 运动参考。
|
|
51
51
|
|
|
52
52
|
每镜必须明确列出 `visible_character_keys`、`visible_event_keys`,并让声音事件携带 `evidence_event_key`。
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
本文件由所属 Skill 读取,用于约束 Codex 的输入、判断与输出;不是发送给外部文本模型的 system prompt。花括号字段是当前项目 selected 文档和已审核资产组装的具名输入槽。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
执行职责:场记与连续性导演。依据已批准结构化分镜、导演本、制作计划和选中资产,建立逐镜空间与状态承接;不生成媒体,也不引用尚未生成或未被 required_board_types 选择的分镜板或白模。
|
|
6
6
|
|
|
7
7
|
【分集】
|
|
8
8
|
{episode_key}
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
start_state 与 end_state 必须且只能包含 `actors,props,axis_id,camera_side,lighting_anchor`。actor 必须且只能包含 `actor_key,zone,depth,facing,eyeline_target,screen_direction,entry_edge,exit_edge,posture,held_props`;prop 必须且只能包含 `prop_key,zone,depth,state,held_by`。transition_link 必须且只能包含 `mode,source_shot_number,source_camera_setup_id,enabled,reason,required_provider_capability`。
|
|
27
27
|
|
|
28
28
|
规则:
|
|
29
|
-
1. `coordinate_mode` 固定为 `semantic`,zone/depth
|
|
29
|
+
1. `coordinate_mode` 固定为 `semantic`,zone/depth 使用画面和景深语义位置;不得估算精确米制坐标。后续已选择的分镜板或白模暴露冲突时,必须回退并生成连续性计划新版本。
|
|
30
30
|
2. 第一镜必须为 independent,来源字段和能力为 null,enabled=false。相邻镜先比较上一镜 end_state 与本镜 start_state,再调用 `recommendTailLink`;只有同场景、同 camera_setup_id、同轴线/机位侧且无未解释差异时才用 previous-tail。
|
|
31
31
|
3. previous-tail 必须 enabled=true,source_shot_number 是紧邻上一镜,source_camera_setup_id 与上一镜一致,required_provider_capability 固定为 `video.first-frame`。切机位、越轴、换场或有意跳变必须 independent。
|
|
32
32
|
4. inherited_fields 只列实际继承字段。allowed_changes 只接受剧本、导演本或已批准调度明确支持的变化;不得用它掩盖冲突。
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
8. 末尾只完成当前镜 transition_out 和结束画面,不生成下一镜。画内屏幕或招牌内容只能来自原文或已批准图形合同;无证据时保持关闭、空白或不可辨读,不生成随机文字和 UI,剧情依赖的精确界面留给后期图形层。反宫格是最高构图约束:视觉描述段(Ref2VA 为 `detailed_description`,其他模式为 `integrated_multimodal_description`;I2VA/FL2VA/L2VA 放在强制对齐行之后)必须以该固定声明开头,并在段末原样再写一次(一字不改):The final video must be one single continuous cinematic frame filling the entire screen; no grid, split screen, panels, collage, dividing lines, panel numbers, or any multi-image composition. 紧接开头声明还必须原样写入:The source video must contain no generated subtitles, captions, titles, labels, logos, watermarks, UI text, or any other readable text; all approved text must be added only in post-production. 任何段落仍不得出现宫格、故事板纸张、分框、箭头、编号、批注、字幕、水印、Logo 或 UI;不得混入 Seedance `@图片N` 语法。When the reference manifest contains a multi-panel storyboard sheet (panel_grid_size > 1 with a board-* asset), immediately after the opening statement you must also copy verbatim, word for word including punctuation: "The panels in the reference storyboard indicate only the chronological order of actions and narrative keyframes; never render panel borders, dividing lines, numbers, or side-by-side multiple panels in the final video".
|
|
31
31
|
9. audio_policy 使用三层合同:delivery_mode 只允许 native/post_dub/external_audio,presentation 只允许 visible-dialogue/offscreen-dialogue/narration,fallback_mode 只允许 none/post-dub/cinematic-tts/sound-design。每行必须读取自己的 BCP 47 `language`,并把原文写成 `<d>[该 language] 原文</d>`;不得用项目默认语言覆盖多语言对白。native 行按时间点逐字生成指定说话人的对白;画外对白不得驱动可见人物嘴部;旁白立即注明画内人物自然闭嘴,并逐项编译 tone arc、每个 emotion beat、pace、breath and pause、distance and space。post_dub/external_audio 行只生成环境声和动作声,不得生成成品人声。原生音频镜头不得另行安排 TTS,缺少语言、精确台词、时间范围或旁白表演字段时写入 errors。
|
|
32
32
|
10. 构图契约必须编译进时间轴。结构化分镜 storyboard_context_json 中若出现 composition_contract(或 photographyPlan.composition、visual_plan.composition),它是本镜已确认构图合同:若仅有 plan 期瘦合同 visual_plan.composition(只含 primary/secondary/reason/evidence),不要求 11 个几何字段齐全,缺失几何从当前分镜与原文推断、推断不出按旧分镜回退,不编造字段值;primary/secondary 的 code 与构图模式名仅作索引,禁止写进最终英文 prompt,也禁止只交 cinematic/oppressive/lonely 等抽象形容词;合同几何必须按播放顺序写进视觉描述段(Ref2VA 写进 detailed_description,其他模式写进 integrated_multimodal_description;I2VA/FL2VA/L2VA 放在强制对齐行之后):① 首帧——read_order 第一眼落点、subject_placement 的画面左右/前后景/机位高度、eyeline_room 视线与留白方向、depth_layers 前中后景内容与虚实、light_and_color_geometry 主光方向与剧内来源;② 运动中——主体在层次间的位移、遮挡何时出现与让出、视线变化,以及 action_vector 的屏幕方向、入画/出画边、逼近或远离;动作镜按蓄力—接触—结果—反应写全地理、接触点与受力反应;③ 镜尾——按 tail_state 在结束画面之前到达终结姿态并短暂稳定,静止合同显式写 locked-off camera,禁止未要求的 push-in、orbit、drift;④ 承接——出入画边、屏幕方向与轴线和相邻镜一致,continuity 为 previous-tail 时直接继承前镜尾部。竖屏 9:16:关系镜用前后纵深、越肩或上下站位而非硬挤左右;关键脸、证据道具、接触点放在画面中上安全区且双眼完整可读;群体戏用时间段拆成 crowd establishment、protagonist action、reaction/result,不横向平铺多人。证据门为 OR:evidence 中的 set_dressing、weather_atmosphere、action_blocking 等级必须在原文明确描述或已选场景/道具资产中存在,二者任一即可;action_blocking 等级还可由已确认动作事实支撑,已确认动作事实不能替代天气/陈设所需的原文或资产证据(复合证据以 + 连接时逐组件成立)。任一不满足时不生成 prompt(prompt 置空字符串),在 errors 写明所缺证据并退回分镜阶段补证据或更换构图,禁止让模型自补 rain、snow、fog、neon、mirrors、smoke、doors/windows/columns、weapons、crowds 或 extra figures。ai_risks 每个风险码都要有可见防控(遮挡不超过三分之一且双眼完整、留白区纯净、接触点清晰、动势边缘留 10%、跨镜方向一致)。本条不得改变第 3/4 条固定段落顺序、强制对齐行或标签语法,不得移动或改写第 8 条固定反宫格声明,不新增槽位或素材引用。
|
|
33
|
-
11. continuity.mode=previous-tail 时仍使用 Ref2VA,把已派生的 other-transition-* 放在第一个图片槽并标记 first_frame
|
|
33
|
+
11. continuity.mode=previous-tail 时仍使用 Ref2VA,把已派生的 other-transition-* 放在第一个图片槽并标记 first_frame,其余人物、已选择的分镜板、音频参考及制作计划实际启用的主运动参考不得省略。必须从该像素状态精确延续人物位置、姿态、运动方向、持物状态、主光方向与轴线;不得重新建立场景,也不得把动作重置为蓄力或起势。
|
|
34
34
|
12. 每个 char-* 引用必须带可校验的 `identity_binding` 与 `identity_constraints`。`identity_binding` 仅用于版本和 `appearance_id` 校验,不写入成片;把 `identity_constraints` 的 `grooming_and_makeup`、`costume_signature` 和全部 `memory_anchors` 原样编译进人物定义及可见描述。不得新增、删减或改写锚点;与 continuity.visual_identity 冲突时返回 errors。
|
|
35
35
|
13. 自然运动不是一句“动作自然”,而是逐主体编译的时间合同。每个可见人物只指定一个当前主要动作、注意对象、反应触发和未参与时的状态;多人除非剧情明确要求齐步、仪式或共同受惊,必须用不同起始时刻、幅度、视线和反应延迟错开,禁止所有人同时转头、点头、眨眼、起步或做相同手势。静止人物也不能冻结:在景别可读时保留不规则且不同步的眨眼、短促眼动/重新对焦、呼吸带来的胸肩微动、轻微重心调整和连续表情过渡,但不得把微动作机械列成循环或让背景人物抢戏。身体动作按支撑脚落地、重心转移、髋肩带动、关节路径、加减速、惯性跟随和恢复停稳描述;持物手在接触后保持正确抓握与受力。头发、衣摆、宽松袖口、饰物和道具只受已存在的风、角色加速、重力或接触驱动,以略有延迟的较小幅度跟随并逐渐衰减,不得无风自动飘动、全身同相摆动或瞬间停止。环境只对已发生且有证据的作用作局部响应,例如脚步后的轻微尘土、坐下后的坐垫压缩或开门后的短促气流;不得为了“有动态”新增天气、特效或事件。每镜只保留叙事必需的主动作和少量有因果的次级运动;指令过载、多人精确互动或多个独立接触无法保持归属时必须拆镜。相机只执行一个有起点、速度变化和终点的动机曲线,固定镜头不得自动漂移。
|
|
36
36
|
14. 每个 char-* 引用还必须带与人物档案逐字段一致的 `performance_constraints`:`center_of_gravity`、`gait`、`habitual_actions`、`eyeline_behavior`、`blink_rhythm`、`stress_response`、`forbidden_performance`。长期习惯只在本镜出现其档案触发条件时使用,禁止每镜机械复现;`forbidden_performance` 始终生效。心理戏必须翻译为可见时间链“刺激/信息进入 → 注意和眼神转移 → 试图维持的表情面具 → 短暂泄露 → 决定或动作 → 镜尾残留”,没有原文、分镜或人物档案证据时不得编造内心。眼神戏写清注视对象、画面方向、是持续注视/快速扫视/回避/返回,以及眼睛与头部谁先启动;除主观镜头或明确直视观众外禁止看镜头,画外对象的视线方向必须与空间账本一致,听者也要有独立注意和反应。微表情只在近景或特写可读时使用,一次优先一至两个面部区域,写可见的眉间、眼睑、眼角、鼻翼、唇角、下唇或下颌变化及其轻微起势—峰值—释放,不把“悲伤、震惊、腹黑”等心理标签直接当动作,不向模型提交 AU 编码,不堆满整张脸,也不让微表情长时间定格。中景把心理变化放大到眼神、头部、呼吸和下颌,远景改由姿态、停顿、距离和走位表现;对白镜同时写说话者与听者的注意关系,表情转折必须落在具体词、停顿、声音或可见事件之后。
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
4. 保持角色身份、外貌、服装、场景、道具、光源方向、运动轴线和项目视觉风格连续。角色操作手机、终端或其他带功能面的道具时,功能面默认朝向操作者,镜头通常看到背面或侧面;只有主观镜头、屏幕特写、证据展示、交接或共同观看等明确叙事需要才让功能面朝向镜头。
|
|
24
24
|
【连续性】按 storyboard_context_json.continuity 执行:mode 为 independent 时,只根据已有信息简洁交代时间、地点、空间关系、关键光线和道具;为 previous-tail 时,从前镜尾部状态直接继续,继承人物位置、姿态、动作方向、道具持有、光向和轴线,不重新建立或重置场景。字段缺失时沿用当前分镜,不得猜测。
|
|
25
25
|
【声音策略】按 storyboard_context_json.audio_policy.mode 执行:native 可在对应时间段生成原文对白、旁白、环境声和动作声;post-dub 只生成环境声与动作声,对白和旁白仅指导表演及节奏,不得生成重复成品人声;silent 不生成原生声音;auto 只描述剧情必要的声音意图,不强制完整混音。画内对白由可见说话者做自然口型;画外对白不得让其他可见角色代说;旁白或内心独白不做说话口型,嘴部保持自然呼吸和当前表情。每项环境底必须带受控 evidence.source 与具体 evidence.detail;每项动作声必须用 evidence_event_key 精确命中计划和分镜共同声明的 visible_event_keys,禁止无走动生成脚步、无可见能量生成能量声。
|
|
26
|
-
5. 反宫格是最高构图约束:prompt 的首句必须原样写入固定声明,写完第 8 条结束画面后再另起一句原样重复该声明(一字不改,标点也不改):「成片必须是单一连续的电影画面并铺满整个屏幕,严禁宫格、分屏、分框、拼贴、分割线、分镜编号或任何多画面构图」。紧接首句还必须原样写入:「源视频画面不得生成任何字幕、标题、标签、Logo、水印、UI文字或其他可读文字,所有获批文字只允许由后期图形层添加」。故事版纸张、白底、画框、宫格、时间码、文字、编号、箭头和导演批注只用于理解,不得出现在成片。当引用清单含多格分镜板(panel_grid_size>1
|
|
26
|
+
5. 反宫格是最高构图约束:prompt 的首句必须原样写入固定声明,写完第 8 条结束画面后再另起一句原样重复该声明(一字不改,标点也不改):「成片必须是单一连续的电影画面并铺满整个屏幕,严禁宫格、分屏、分框、拼贴、分割线、分镜编号或任何多画面构图」。紧接首句还必须原样写入:「源视频画面不得生成任何字幕、标题、标签、Logo、水印、UI文字或其他可读文字,所有获批文字只允许由后期图形层添加」。故事版纸张、白底、画框、宫格、时间码、文字、编号、箭头和导演批注只用于理解,不得出现在成片。当引用清单含多格分镜板(panel_grid_size>1 且实际引用 board-* 资产)时,紧接首句声明之后还必须原样写入(一字不改,标点也不改):「参考分镜板中的画格只表示动作的时间顺序与叙事关键帧,禁止把画格边框、分割线、编号或多格并排构图拍进成片」。
|
|
27
27
|
6. 时长必须满足当前 Provider 的约束:{duration_constraints}。不得擅自向上取整或使用未声明档位;用清晰时间段描述画面、动作和镜头推进。
|
|
28
28
|
7. 不要堆砌重复画质词;只保留与镜头叙事和视觉连续性有关的信息。
|
|
29
29
|
8. prompt 最后必须是“镜尾转场【转场类型】”及一行当前镜头的结束画面;转场类型必须由当时的命中、遮挡、快速运动、强光、匹配动作、时间变化或段落结束提供依据。只描述当前素材如何结束,不得生成下一镜剧情。
|
|
@@ -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
|
|
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`,使用 `@hypit/gpt-image-kits/storyboard` 的对应 `board-type` 生成独立主类型资产,并以 `board-epNNN-{type}-NNN` 登记;`previz-3d` 仍由 Blender 模块生成。所有已选择的视频板均使用 `image_strategy.panel_grid_size`,默认 6 格,Codex 可按不可合并的动作或叙事节拍选择 2–16 格;不得用同一图片或同一资产版本冒充不同板型。Blender 是按需追加的空间和运动预演,不替代已选择的分镜参考。
|
|
4
4
|
|
|
5
5
|
严格填充 [提示词索引](../prompt-skill-index.md) 的变量;`style` 必须传项目当前完整 `creative.art_style` 对象,交给 `render-prompt.mjs` 编译 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
|
-
|
|
9
|
+
整集所有门禁已通过的镜头只提交已选择板型对应的 `generate_image` 目标全量提交;请求统一使用 Hypit Runtime 的 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 一致;旧画风资产先失效重做,不让新提示词与旧媒介参考互相拉扯。提交前只展示模型、数量、尺寸、参考用途与制作计划,不计算具体价格。所有已生成板型分别完成对应审核并选版后,才进入视频提示词与生成。
|
|
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`。
|
|
@@ -4,7 +4,7 @@ Seedance 的逐镜检查可按 [社区 Skill 参考](seedance-community-skills.m
|
|
|
4
4
|
|
|
5
5
|
## 无限画布 Agent 写入路径
|
|
6
6
|
|
|
7
|
-
默认由 Agent
|
|
7
|
+
默认由 Agent 在真实选版的分镜、已选择的板型、声音计划和审核记录上逐镜编写最终提示词。先用纸面镜头表核对机位一侧、人物位置与朝向、视线、主动作、其他可见人物的持续行为、光线、道具持有的手及镜尾可见状态;内部表格不复制进模型提示词。每个参考素材先绑定实际用途,不发明未上传的 `@` 标签。Agent 使用 `canvas node write-video-prompt <节点ID> --project <项目ID> --file <UTF-8文件> --type h3|seedance --expected-version <画布版本>` 保存成品,回读文本资源及选版后才提交视频。新镜头不自动运行 `storyboard-video-prompt` 的 LLM 任务;未有 Agent 写入时,用户可手动点击该节点生成。一旦 Agent 写入,服务端禁止再次运行该节点,避免覆盖成品。
|
|
8
8
|
|
|
9
9
|
H3 使用 Ref2VA 六段英文正文,保留原文对白,最终发给 Provider 的文本不得超过 7000 字符。Seedance 使用中文“本镜元数据与实际素材用途 → 画面和表演 → 镜尾”;对白保持原文。每个可见人物只写本镜可读的动作、注意对象、反应触发和结果,听者与说话者在同一段交叠表演。提示词长度由必要信息决定,不按任意字数填充;先删重复画质词和已由参考图表达的背景,再考虑调整动作密度。
|
|
10
10
|
|
|
@@ -27,7 +27,7 @@ H3 使用 Ref2VA 六段英文正文,保留原文对白,最终发给 Provider
|
|
|
27
27
|
|
|
28
28
|
每次模板编译统一输出严格 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` 排列,仅对白、歌词和画内文字保留原语言。不得混用两套语法。
|
|
29
29
|
|
|
30
|
-
`continuity.mode=previous-tail` 时仍使用 `full-reference`/`Ref2VA`,由 `prepare_previous_tail` 生成的 `other-transition-*` 作为第一个 `image/first_frame`
|
|
30
|
+
`continuity.mode=previous-tail` 时仍使用 `full-reference`/`Ref2VA`,由 `prepare_previous_tail` 生成的 `other-transition-*` 作为第一个 `image/first_frame` 语义连续性锚点,其余人物、实际选择的分镜板和音频参考不得省略。编译前核对其来源版本与 SHA-256 仍对应上一镜当前 selected 视频;来源镜换版后必须重新派生尾帧。
|
|
31
31
|
|
|
32
32
|
保存前把逐镜编译结果包装为顶层严格合同 `{episode_key,source_versions,shots,unresolved,approved}`;每个 `shots` 项在上述八个模板字段外,必须从已选制作计划原样补入 `shot_number`、`production_plan_version`、`storyboard_version`、`provider` 和 `model_or_workflow`。任一镜 `errors` 非空时同步写入 `unresolved` 且 `approved=false`,禁止省略 `errors`、伪造空数组或手写占位文档。
|
|
33
33
|
|
|
@@ -138,6 +138,7 @@
|
|
|
138
138
|
"path": "skills/short-drama/references/generation/generate-storyboard-images.md",
|
|
139
139
|
"category": "generation",
|
|
140
140
|
"stage": "media-production",
|
|
141
|
+
"description": "按每镜 production-plan.required_board_types 生成已选择的分镜板;不自动补生成未选择的板型。",
|
|
141
142
|
"condition": "always",
|
|
142
143
|
"dependencies": []
|
|
143
144
|
},
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
- 场景、道具 → `generate-scene-assets`、`generate-prop-assets`
|
|
13
13
|
- 打斗动作链、空间路线与动作分镜 → `design-fight-video`
|
|
14
14
|
- 首次拆镜、分镜修订 → `build-drama-storyboard`、`revise-drama-storyboards`
|
|
15
|
-
- 分镜参考 →
|
|
15
|
+
- 分镜参考 → 每镜按 `storyboard_strategy` 选择板型,使用 `generate-storyboard-images` 与 `review-drama-shots` 审计实际生成的板;可选白模使用 `direct-blender-previz`、`generate-blender-previz` 与导演评分;图片确定性变换使用 `transform-drama-media`
|
|
16
16
|
- 制作规划、跨镜连续性、尾帧首帧承接、Seedance 2.0/H3/通用视频提示词 → `plan-drama-production`、`plan-shot-continuity`、`write-drama-video-prompts`
|
|
17
17
|
- 视频镜头 → `generate-drama-videos`
|
|
18
18
|
- 原生音频复听、受控 TTS/外部音频兜底与口型 → `design-drama-audio`;授权配乐与许可证也由该 Skill 规划,媒体登记和变换走 `drama-generation-service`、`transform-drama-media`
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
项目 `automation_mode` 默认开启;开启后 agent 自主处理常规确认,不重复打断用户,但不能伪造权限、素材权利或绕过安全门禁。
|
|
10
10
|
|
|
11
|
-
标准顺序是:初始化与环境预检 → 打开项目 Dashboard → Codex 分析小说与要求 → `short-drama` 方法论 + 剧本初稿 → `humanizer` 自然化新版本 → 剧本复核批准 → 导演本落盘 → 资产分析 → 人物吸引力/儿童保护审核与资产生成落盘 →
|
|
11
|
+
标准顺序是:初始化与环境预检 → 打开项目 Dashboard → Codex 分析小说与要求 → `short-drama` 方法论 + 剧本初稿 → `humanizer` 自然化新版本 → 剧本复核批准 → 导演本落盘 → 资产分析 → 人物吸引力/儿童保护审核与资产生成落盘 → 制作规划(每镜板型选择、可选白模、模型和提示词协议)→ 按镜头选择的板型生成/选版/审计,复杂镜头追加白模编导/生成/评分 → 空间连续性与可选尾帧承接 → Seedance 2.0/H3/通用逐镜提示词落盘 → 原生声音生成和复听 → 仅对失败区间兜底、按需口型 → 授权配乐与媒体修复 → 对已选视频按需超分并复审 → `remotion-best-practices` + Remotion 剪辑 → 成片交付。每阶段必须先用 `module-runs.mjs required` 获取原子 Skill,完整读取并执行,再用 `module-runs.mjs record` 记录项目内产物;仅生成文件但没有 Skill 凭证不能通过阶段门禁。
|
|
12
12
|
|
|
13
13
|
文本资产全部由 Codex 直接创作和校验,不调用任何文本生成 Provider;媒体生成统一交给 `drama-generation-service`,由用户选择 StarRouter 模型和参数。需要公网 URL 时,另行路由 `publish-drama-references`;TempFile.org 链接公开、临时且受用途条款约束。项目 `automation_mode=true` 时,已配置范围内的生成、上传、选版、覆盖、回退和切换按合同自动继续,不为常规步骤重复询问;`false` 时才逐项等待确认。真实付费、素材权利、安全事实和删除项目仍需明确确认,不能由 agent 代替授权;缺少这些条件时一次说明缺口并停在安全边界。阶段交付前再次运行项目校验。
|
|
14
14
|
|
|
@@ -62,11 +62,11 @@
|
|
|
62
62
|
|
|
63
63
|
剧本阶段的 `short-drama` 必须绑定实际分集剧本版本;人物分析必须绑定 `assets/characters/profiles.json`。人物链路固定为:年龄证据 → `audience_appeal` 校验 → 人物定妆候选 → 人物专项审核与选版 → 分镜/白模/正式视频引用绑定 → 跨镜一致性复核。明确成年人物使用 `adult-charisma`,必须有专属 `grooming_and_makeup`、`costume_signature` 和角色级 `memory_anchors`;儿童只使用 `child-cuteness`,任何成人化或性化处理都是不可由总分抵消的硬失败。未知年龄停在人物档案阶段。新生成角色候选只能经 `validateCharacterAppealReview` 和 `review-character` 选版,正式视频人物引用还要通过 `assertCharacterReadyForVisuals` 及档案 SHA、appearance 与可见身份约束校验。
|
|
64
64
|
|
|
65
|
-
|
|
65
|
+
每个镜头由 Agent 根据 `storyboard_strategy` 选择一种或多种独立参考板,分别选版并完成对应审计。原创项目默认从单幅分镜图或一种板型开始;只有复杂路线、多人交互、精确接触、轴线风险或连续运镜需要同时表达多种信息时才追加其他板型或 Blender 白模。Blender 不能替代已选择的分镜参考。
|
|
66
66
|
|
|
67
|
-
选择 Blender 的镜头先由 `direct-blender-previz` 写入 `episodes/<episode>/previz/shot-NNN-vNNN.json` 导演合同,再由 `generate-blender-previz` 渲染为 `other-previz-epNNN-NNN`,登记、完整观看、按七项 100 分合同验收并选版;总分低于 85 或任一单项低于 70%
|
|
67
|
+
选择 Blender 的镜头先由 `direct-blender-previz` 写入 `episodes/<episode>/previz/shot-NNN-vNNN.json` 导演合同,再由 `generate-blender-previz` 渲染为 `other-previz-epNNN-NNN`,登记、完整观看、按七项 100 分合同验收并选版;总分低于 85 或任一单项低于 70% 时不得提交正式视频。已选分镜板和白模都不能替代正式视频所需的人物、场景和道具资产。
|
|
68
68
|
|
|
69
|
-
结构化分镜与制作计划批准后,由 `plan-shot-continuity` 汇总 selected 分镜、导演本和制作计划,生成并显式选定 `continuity-plan/vNNN.json`。分镜 `shot_group` 表达叙事组;计划逐镜固定机位、轴线、人物/道具起止状态与转场方式,只有同场景同机位且状态连续时才允许 previous-tail。Runtime 把连续 previous-tail
|
|
69
|
+
结构化分镜与制作计划批准后,由 `plan-shot-continuity` 汇总 selected 分镜、导演本和制作计划,生成并显式选定 `continuity-plan/vNNN.json`。分镜 `shot_group` 表达叙事组;计划逐镜固定机位、轴线、人物/道具起止状态与转场方式,只有同场景同机位且状态连续时才允许 previous-tail。Runtime 把连续 previous-tail 链派生为生成镜头组:不同组并行、同组串行,一次只生成各组当前前沿镜头。后续已选分镜板或白模若暴露冲突,必须回退生成连续性计划新版本。媒体阶段用 `prepare_previous_tail` 从上一镜当前 selected 且已审核的视频派生下一镜首帧,正式提交前再次比对来源版本和 SHA-256。
|
|
70
70
|
|
|
71
71
|
资产计划中的人物、场景或道具若已有 selected、未失效且不是 Provider 产出的本地版本,可直接复用;缺失、失效或由 Provider 生成/变换时,动态要求对应生成 Skill 与 `drama-generation-service`,防止 Provider 变换资产绕过执行凭证。
|
|
72
72
|
|
package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-shots.md
CHANGED
|
@@ -4,11 +4,11 @@
|
|
|
4
4
|
|
|
5
5
|
新生成场景和道具候选执行 `review-ledger.mjs review-visual-asset`,审核写 `review_type:"visual-asset"`、`assetKey`、`versionId`、`inspected_full:true`、`approved`、`structure_identity`、`sheet_consistency`、`unsupported_content` 和同结构的 `art_style_fidelity`。审核观察必须是画面实际可见证据,不得把提示词里的画风名称当作通过证据;画风 ID 或合同内容变化后旧审核哈希自动失效。
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
每镜已选择的分镜板生成候选后,先用图像查看能力逐张检查完整画面的保真预览;小字、面部、手部、道具或格间细节另做局部裁切检查,不得把生产原件直接上传,也不能只看界面缩略图、文件存在或生成状态。随后结合前后镜、结构化分镜、人物/场景/道具选版和项目画风做整集连续审计。每个已生成板型都必须写独立审核记录,`criteria` 严格按以下八项原顺序记录 `{criterion,status,observation}`:`空间关系与轴线`、`时间与动作连续性`、`物理与交互逻辑`、`光线与色彩连续性`、`人物身份与造型一致性`、`场景与道具一致性`、`构图与镜头语言`、`叙事覆盖与阅读顺序`。时间故事版重点核对动作阶段与状态变化,镜头分镜板重点核对景别、调度、轴线和叙事节拍;每个已选择的板型都需完整通过八项。任何一项 failed 都必须修订或重生成后复审,所有已选板型通过前不得制作正式视频。
|
|
8
8
|
|
|
9
9
|
分镜审计通过后、视频提示词编译前执行 `plan-shot-continuity`。审计观察必须足以支持人物位置、姿态、运动方向、持物、出入画边、轴线、机位侧和主光锚点;看不清或上下镜冲突的内容进入连续性计划 `unresolved`,不得用主观判断补齐。启用 previous-tail 的下一镜还要确认上一镜结束状态已稳定可读,并与同机位承接相容。
|
|
10
10
|
|
|
11
|
-
`storyboard_strategy.mode=blender`
|
|
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
|
|
|
13
13
|
空间检查人物左右、景深层次、出入口、视线、180 度轴线和跨格/跨镜位置;时间检查动作起点—过程—结果、口型/反应先后、道具状态和昼夜;物理检查重力、落脚、接触点、受力、持物、遮挡、镜像及人体结构;光线检查主光来源、方向、影子、曝光、色温和同场景连续性。其余四项分别核对人物身份/服装/年龄、场景结构与道具版本、第七项构图五问(见下段),以及剧情信息是否无遗漏、无重复、按正确阅读顺序呈现。观察必须写出实际可见证据,不能复述提示词或只写“合理”。
|
|
14
14
|
|
|
@@ -72,7 +72,7 @@ JSON 顶层同时保存编导依据和 Blender 可执行场景:
|
|
|
72
72
|
|
|
73
73
|
单机位摄影使用 `camera`;正反打、多机位覆盖使用具名 `cameras[]` 和从第 1 帧开始的 `camera_cuts[]`。每个摄影机的 `keyframes[]` 可分别设置 `location`、`target` 和可选 `lens`。正反打机位必须位于同一轴线侧,匹配相邻镜头的视线方向、头部留白和景别尺度;接触或命中优先回到能同时说明双方空间关系的机位。默认保持固定焦段;只有叙事需要透视变化时才给 `lens` 做关键帧。
|
|
74
74
|
|
|
75
|
-
|
|
75
|
+
已选静态分镜板的版本与审核由项目账本独立校验,不复制进白模合同;因此白模模式保持 `board_asset=null`,`source.storyboard_version` 绑定同镜结构化分镜。生成的白模资产 provenance 必须在 `parameters.direction_contract` 记录本合同的项目内相对路径,在 `parameters.direction_contract_sha256` 记录合同文件 SHA-256,并用 `parameters.duration` 记录制作计划时长。门禁会重新探测 MP4 的实际时长、平均帧率、帧数和分辨率,同时复核合同与媒体哈希,声明值不能替代实际媒体证据。
|
|
76
76
|
|
|
77
77
|
`beats` 必须按时间顺序排列;相邻节拍可共享一个边界帧或首尾相接,但不得倒序、被前一节拍完全覆盖或大段重叠。`review_contract.hard_gates` 至少完整包含示例中的五项固定硬门禁,不得用模糊名称删减。
|
|
78
78
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 编导 Blender 白模预演
|
|
2
2
|
|
|
3
|
-
只处理制作计划中 `previz_strategy.mode=blender` 的镜头。读取当前 selected
|
|
3
|
+
只处理制作计划中 `previz_strategy.mode=blender` 的镜头。读取当前 selected 剧本、导演本、结构化分镜、制作计划、人物/场景/道具选版,以及本镜 `required_board_types` 中已选且通过八维审计的静态分镜板;白模不能替代已选静态参考,也不凭文字单独猜测资产已定义的三维空间。
|
|
4
4
|
|
|
5
5
|
信息优先级固定:剧本和导演本决定因果与表演先后,结构化分镜决定时间和连续动作,人物/场景/道具选版约束身份与空间;时间故事版锚定动作阶段和状态,镜头分镜板锚定构图与屏幕方向。白模负责验证三维距离、遮挡、接触、节奏和相机路径。冲突时退回上游澄清,不用白模悄悄改剧情。
|
|
6
6
|
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
读取本地已选导演本、人物/场景/道具、分镜和项目配置。由 Codex 使用 `../../assets/modules/plan-drama-production/prompts/production_plan.{zh,en}.txt` 输出 `production-plan.json`,逐镜记录:输入版本、`storyboard_strategy`、分镜图类型与实际格数、`previz_strategy`、视频方式、声音方式、Provider、模型或工作流、`prompt_profile`、`input_mode`、分辨率、画幅、时长、候选数、参考素材及其用途与顺序、依赖关系、预计付费次数、失败回退和验收项。
|
|
6
6
|
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
时间故事版用于连续动作阶段、运镜轨迹和状态变化;镜头分镜板用于景别、人物关系、调度、轴线与叙事节拍。Agent 按镜头目标选择一种或多种板型,分别记录 `required_board_types` 和 `selection_basis`;视频只引用实际存在且已审核的板。其余人物、场景、道具超过 Provider 剩余图片槽位时按既有 `overflow_strategy` 处理。
|
|
9
9
|
|
|
10
10
|
|
|
11
11
|
格数必须按本分镜构图合同复核(`visual_plan.composition`、`composition_contract` 或 `photographyPlan.composition` 的 primary/secondary code、evidence 与 ai_risks;权威解释见 [导演构图模式参考](../director-composition.md)):静态单一情绪仍至少用 2 格固定起止状态;追逐、接触、倒计时和运镜按不可合并阶段增加格数;多人站位、包围、遮挡、武器或多手交互按叙事节拍增加格数。风险只决定格数与回退,不得用增加格数替代证据。证据不足时 `status=blocked` 并写入 `unresolved`,退回分镜修订。
|
|
@@ -16,6 +16,6 @@
|
|
|
16
16
|
|
|
17
17
|
Provider 支持 MiniMax H3 原生音频(`video.native-audio`)时,默认使用 `audio_strategy.mode=native`,并锁定逐秒对白表、全片音乐锚点和相邻镜头成对声音转场;此时不安排独立 TTS。仅当用户明确要求后配、或 Provider/模型明确声明不支持原生音频时,才写 `post-dub`/`independent` 并进入 `design-drama-audio`;能力信息缺失不得作为转后配的理由。
|
|
18
18
|
|
|
19
|
-
使用 `project-store.mjs put-episode-document <项目目录> production-plan <episode-key> <version> <文件>` 保存不可变版本。选定后,所有镜头执行 `generate-storyboard-images
|
|
19
|
+
使用 `project-store.mjs put-episode-document <项目目录> production-plan <episode-key> <version> <文件>` 保存不可变版本。选定后,所有镜头执行 `generate-storyboard-images`,只生成 `required_board_types` 中已选择的板型并完成对应审计;启用白模的镜头再执行 `direct-blender-previz`、`generate-blender-previz` 并完成导演评分。逐镜门禁全部通过后才能调用 `generate-drama-videos`。计划不得包含 API Key、Token 或远程业务对象 ID。
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
只有已选择的板型和独立参考图实际超过 Provider 槽位才使用 `compose-assets`,未超槽位保留独立参考图。项目 `automation_mode=true` 且仅缺 Provider 已支持的分辨率时,agent 直接选择并落档,不等待用户。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 规划跨镜连续性
|
|
2
2
|
|
|
3
|
-
读取当前 selected 且已批准的 `storyboard`、`director-book` 和 `production-plan`,并使用 `../../assets/modules/plan-shot-continuity/prompts/continuity_plan.{zh,en}.txt` 生成一份 `continuity-plan
|
|
3
|
+
读取当前 selected 且已批准的 `storyboard`、`director-book` 和 `production-plan`,并使用 `../../assets/modules/plan-shot-continuity/prompts/continuity_plan.{zh,en}.txt` 生成一份 `continuity-plan`。只采用这些结构化文档和已选资产中的证据;不得引用尚未生成、未被 `required_board_types` 选择或未审核通过的分镜板或白模,也不得推断未声明的道具、持物关系、入画边、出画边或精确米制坐标。
|
|
4
4
|
|
|
5
5
|
规划阶段固定使用 `coordinate_mode=semantic`,以画面左/中/右、前/中/后景、朝向、视线对象和出入画边表达语义位置;不得从结构化分镜、图片透视或经验估算三维坐标。后续 Blender 白模只能验证或暴露冲突,不能静默改写已批准连续性计划;冲突必须回退规划阶段生成新版本。
|
|
6
6
|
|
|
@@ -17,8 +17,8 @@
|
|
|
17
17
|
7. **声音证据与合同**:对原声或外部音频先执行 `analyze_speech_timing`,人工复核后用当前 timing 写逐句表演合同;`compile_dubbing_request` 只预检,不产生费用。
|
|
18
18
|
8. **三轮生成与审核**:最多生成三轮,最终 alignment 达到一帧容差后执行八维完整听看审核;通过候选才能 selected。
|
|
19
19
|
9. **字幕与口型**:调用 `build_subtitles_from_audio` 从最终 selected 音频生成绑定字幕;换版后重建字幕、口型和剪辑引用。
|
|
20
|
-
10. **制作规划**:构建/修订结构化分镜,`plan-drama-production`
|
|
21
|
-
11.
|
|
20
|
+
10. **制作规划**:构建/修订结构化分镜,`plan-drama-production` 逐镜按 `storyboard_strategy` 确定所需板型、格数、按需启用的 Blender 白模、模型、`prompt_profile`、输入模式和参考顺序,只汇总任务与素材数量。
|
|
21
|
+
11. **分镜与素材制作**:制作规划先建立空间连续性。Agent 按镜头目标选择单幅分镜图、时间故事版、镜头分镜板或专项板;只有复杂调度风险无法由已选静态参考证明时才追加 Blender 白模。每个实际生成的板型分别完成对应审计,再由 `write-drama-video-prompts` 绑定本镜实际需要的参考和音频参考。声音按 native-first 执行。
|
|
22
22
|
随后执行 `hypit short-drama production plan ep-001 --runtime <profile> --workspace <项目>`;计划中的 `generation_groups` 会列出不同连续生成组及 `ready`、`waiting-review`、`waiting-tail`、`complete` 状态。确认计划后执行 `production build ... --confirmed`,一次只提交每组当前的 `ready_shot_number`。候选生成后先按制作计划审核;审核通过会自动选版。若下一镜显示 `waiting-tail`,调用 `prepare_previous_tail`,再重新执行 production plan/build;系统会把上一镜当前选版的尾帧作为下一镜第一个 `first_frame`,相同来源重复调用会直接复用。存在 `pending-build.json` 时再次执行 build 只恢复原任务,不产生新付费提交;它会核对提交时提示词文档、Run 和 Runtime Profile 的 SHA-256,文件变化或 Runtime 不同则须先恢复,终态失败也会先回收成功镜头。成功候选审核并选中后,未变化镜头会从重试 Run 中排除。启用白模的镜头绑定已审核的主运动参考。项目不得调用 legacy `submit_video` 绕过 Runtime。
|
|
23
23
|
12. **授权音乐与本地修复**:许可证用途验证通过后才把目录音乐放入时间线;本地局部修复保留来源、范围和专项审核。远端超分暂时禁用,等待 StarRouter 等价模型验证。
|
|
24
24
|
13. **剪辑**:`remotion-best-practices` 约束 Remotion 工程与帧确定实现,`edit-drama-timeline` 按本地剪辑方案完成粗剪、字幕、转场、声音和渲染。
|
|
@@ -60,14 +60,14 @@
|
|
|
60
60
|
| `drama-generation-service` | 通过 Hypit Runtime 的 StarRouter 配置生成图片、视频与音频 | 所有远端媒体生成入口 | 模型、参数、参考文件用途和制作计划;切换或重试 |
|
|
61
61
|
| `publish-drama-references` | 查询或用 TempFile.org 临时托管把本地选版图转为公网 HTTPS URL | StarRouter 需要公网参考素材时 | 先查有效收据;素材权利、公开暴露、用途许可、逐项资产版本和 24h 时效;强制重传需再次确认 |
|
|
62
62
|
| `configure-generation-providers` | 配置和探活 Provider,不生成 | 首次使用或凭据/目录变化时 | 各模态 Provider 选择;密钥由用户自行配置 |
|
|
63
|
-
| `generate-storyboard-images` |
|
|
64
|
-
| `direct-blender-previz` / `generate-blender-previz` | standard
|
|
65
|
-
| `generate-drama-videos` | 生成并下载逐镜视频 |
|
|
63
|
+
| `generate-storyboard-images` | 按每镜 required_board_types 独立生成已选择的分镜板 | 制作计划批准后、视频提示词编译前 | Provider、格数、尺寸、候选数、参考图、制作计划、选版 |
|
|
64
|
+
| `direct-blender-previz` / `generate-blender-previz` | standard 仅为已选静态板无法证明的复杂调度生成可选白模;原创项目仅为复杂调度追加 review 白模 | 已选分镜板之后、视频提示词编译前 | 剧情节拍、调度、轴线、运镜、评分与选版 |
|
|
65
|
+
| `generate-drama-videos` | 生成并下载逐镜视频 | 已选择的分镜板、按需审核的白模主运动参考、音频参考与视频提示词确认后 | Provider、模型/工作流、时长、分辨率、参考素材、声音、制作计划、重试 |
|
|
66
66
|
| `design-drama-audio` | 原生音频优先;做七维复听,并允许导入已授权外部音频;自定义音色克隆和口型驱动暂时禁用 | 制作计划或逐镜视频阶段 | StarRouter 语音模型、声音权利、文本、失败区间、制作计划、选版 |
|
|
67
67
|
| `transform-drama-media` | 本地裁剪、抽帧、剪接等版本化媒体操作;远端口型和超分暂时禁用 | 媒体生产中按需 | 来源资产、操作范围、结果选版与专项审核 |
|
|
68
68
|
| `monitor-drama-tasks` | 本地登记、去重、查询异步任务并校验完成文件 | 媒体生产贯穿执行 | 取消任务、扩大重试或重新付费 |
|
|
69
69
|
| `recover-drama-pipeline` | 恢复中断任务、缺失下载和 stale 下游 | 失败或续作时 | 重提、换 Provider/模型、重新付费、回退阶段 |
|
|
70
|
-
| `review-drama-shots` |
|
|
70
|
+
| `review-drama-shots` | 分别审计已生成分镜板的逻辑、按导演合同评分可选白模,并验收正式视频 | 分镜选版后、视频生成前必做;视频落盘后再次执行 | 接受 P2 缺陷、重生成或选用替代版本 |
|
|
71
71
|
| `remotion-best-practices` | 约束 Remotion 工程、React 时间线、字幕、音频、预览与渲染 | editing 阶段首个实现层 | 工程初始化、外部包安装和输出规格 |
|
|
72
72
|
| `edit-drama-timeline` | 用本地 Remotion 工程完成剪辑、字幕、转场、声音和渲染 | 全部选镜验收通过后 | 入选版本、剪辑结构、字幕样式、转场、声音目标、输出规格 |
|
|
73
73
|
| `edit-deliver-drama` | 完整审片、技术检查和本地交付打包 | 最后一步 | 批准版、文件名、交付目录和发布规格 |
|