@aswless_854771076/ai_short_studio_cli 0.1.167 → 0.1.168
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/dist/commands/canvas/node/add.js +3 -3
- package/dist/commands/canvas/node/types.js +1 -1
- package/dist/domain/canvas-document-check.d.ts +2 -0
- package/dist/domain/canvas-document-check.js +4 -2
- package/dist/domain/canvas-document-contract.js +2 -1
- package/dist/domain/vvicat-api.d.ts +1 -0
- package/dist/domain/vvicat-api.js +14 -3
- 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 +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/assets-and-storyboard.md +12 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/canvas-media-gates.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/commands/canvas.md +11 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/humanizer.md +2 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/module-map.json +17 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/pipeline.md +2 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-shots.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/build-drama-storyboard.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/special-workflows.md +1 -1
|
@@ -7,13 +7,13 @@ export default class CanvasNodeAdd extends BaseCommand {
|
|
|
7
7
|
...BaseCommand.baseFlags, project: projectFlag, x: Flags.integer({ default: 0 }), y: Flags.integer({ default: 0 }), title: Flags.string(),
|
|
8
8
|
'asset-id': Flags.string({ description: '绑定已有媒体资产 ID,仅用于 image、video、audio 节点' }),
|
|
9
9
|
config: Flags.string({ description: '配置 JSON 文件,例如 video-frame-extract 使用 {"position":"first"}' }),
|
|
10
|
-
'source-format': Flags.string({ description: '
|
|
10
|
+
'source-format': Flags.string({ description: '手写分镜来源格式;仅用于 storyboard-resource', options: ['screenplay-json.v1', 'screenplay-markdown.v1'] }),
|
|
11
11
|
platform: Flags.string({ description: '专业拆镜发布平台,默认 short-drama', dependsOn: ['source-format'] }),
|
|
12
12
|
};
|
|
13
13
|
async run() {
|
|
14
14
|
const { args, flags } = await this.parse(CanvasNodeAdd);
|
|
15
|
-
if (flags['source-format'] && args.kind !== 'storyboard-
|
|
16
|
-
this.error('--source-format 仅适用于 storyboard-
|
|
15
|
+
if (flags['source-format'] && args.kind !== 'storyboard-resource')
|
|
16
|
+
this.error('--source-format 仅适用于 storyboard-resource');
|
|
17
17
|
const config = flags.config ? await readJsonInput(flags.config) : {};
|
|
18
18
|
if (flags['source-format'])
|
|
19
19
|
Object.assign(config, {
|
|
@@ -2,7 +2,7 @@ import { Args } from '@oclif/core';
|
|
|
2
2
|
import { BaseCommand } from '../../../base-command.js';
|
|
3
3
|
import { commandApi } from '../../../command-helpers.js';
|
|
4
4
|
export default class CanvasNodeTypes extends BaseCommand {
|
|
5
|
-
static description = '
|
|
5
|
+
static description = '读取全局实时节点目录、配置与 schema(含镜头 shotEditSchema 视觉绑定合同;不带 --project)';
|
|
6
6
|
static args = { kind: Args.string() };
|
|
7
7
|
static flags = BaseCommand.baseFlags;
|
|
8
8
|
async run() { const { args, flags } = await this.parse(CanvasNodeTypes); const { api } = await commandApi(flags); const catalog = await api.nodeTypes(); this.print(args.kind ? catalog.nodeTypes.find((item) => item.kind === args.kind) ?? null : catalog); }
|
|
@@ -5,6 +5,7 @@ export type CanvasDocumentContract = {
|
|
|
5
5
|
required_fields: string[];
|
|
6
6
|
non_empty_fields?: string[];
|
|
7
7
|
array_fields?: string[];
|
|
8
|
+
object_array_fields?: string[];
|
|
8
9
|
aliases?: string[];
|
|
9
10
|
};
|
|
10
11
|
type DocumentContractMap = Record<string, CanvasDocumentContract>;
|
|
@@ -21,6 +22,7 @@ export type DocumentContentCheck = {
|
|
|
21
22
|
missing: string[];
|
|
22
23
|
empty: string[];
|
|
23
24
|
invalid: string[];
|
|
25
|
+
invalidItems: string[];
|
|
24
26
|
};
|
|
25
27
|
export declare function checkDocumentContent(map: DocumentContractMap, documentKey: string, content: unknown): DocumentContentCheck;
|
|
26
28
|
export {};
|
|
@@ -28,9 +28,11 @@ export function checkDocumentContent(map, documentKey, content) {
|
|
|
28
28
|
if (!contract)
|
|
29
29
|
return { contract: null };
|
|
30
30
|
if (!isPlainObject(content))
|
|
31
|
-
return { contract, missing: [...contract.required_fields], empty: [], invalid: [] };
|
|
31
|
+
return { contract, missing: [...contract.required_fields], empty: [], invalid: [], invalidItems: [] };
|
|
32
32
|
const missing = contract.required_fields.filter((field) => !isPresent(content[field]));
|
|
33
33
|
const empty = (contract.non_empty_fields ?? []).filter((field) => isPresent(content[field]) && isEmptyValue(content[field]));
|
|
34
34
|
const invalid = (contract.array_fields ?? []).filter((field) => isPresent(content[field]) && !Array.isArray(content[field]));
|
|
35
|
-
|
|
35
|
+
const invalidItems = (contract.object_array_fields ?? []).flatMap(field => Array.isArray(content[field])
|
|
36
|
+
? content[field].flatMap((item, index) => isPlainObject(item) ? [] : [`${field}[${index}]`]) : []);
|
|
37
|
+
return { contract, missing, empty, invalid, invalidItems };
|
|
36
38
|
}
|
|
@@ -69,11 +69,12 @@ export async function validateCanvasDocumentContent(input) {
|
|
|
69
69
|
if (input.schemaKey !== expected && input.schemaKey !== 'canvas.review.v1') {
|
|
70
70
|
warnings.push(`--schema-key ${input.schemaKey} 与文档键 ${input.documentKey} 不一致,建议使用 ${expected}。`);
|
|
71
71
|
}
|
|
72
|
-
if (!check.missing.length && !check.empty.length && !check.invalid.length)
|
|
72
|
+
if (!check.missing.length && !check.empty.length && !check.invalid.length && !check.invalidItems.length)
|
|
73
73
|
return { contract: check.contract, warnings };
|
|
74
74
|
const problems = [
|
|
75
75
|
check.missing.length ? `缺少顶层字段:${check.missing.join('、')}` : '',
|
|
76
76
|
check.empty.length ? `以下字段为空:${check.empty.join('、')}` : '',
|
|
77
|
+
check.invalidItems.length ? `以下数组项必须为对象:${check.invalidItems.join('、')}` : '',
|
|
77
78
|
check.invalid.length ? `以下字段必须为数组:${check.invalid.join('、')}` : '',
|
|
78
79
|
].filter(Boolean).join(';');
|
|
79
80
|
const message = `文档 ${input.documentKey} 不符合 ${templatePathOf(check.contract)} 的输出合同:${problems}。`
|
|
@@ -28,6 +28,7 @@ interface NodeType extends JsonObject {
|
|
|
28
28
|
defaultConfig: JsonObject;
|
|
29
29
|
configSchema: JsonObject;
|
|
30
30
|
structuredOutputSchema?: JsonObject;
|
|
31
|
+
shotEditSchema?: JsonObject;
|
|
31
32
|
}
|
|
32
33
|
export interface CanvasInspectOptions {
|
|
33
34
|
includes: Array<'summary' | 'nodes' | 'edges' | 'assets' | 'settings' | 'node-types'>;
|
|
@@ -15,7 +15,7 @@ function normalizeRequiredOutputLanguage(value) {
|
|
|
15
15
|
}
|
|
16
16
|
function validateConfigSchema(nodeType, config, requiredValues = config ?? {}) {
|
|
17
17
|
const values = config ?? {};
|
|
18
|
-
if (
|
|
18
|
+
if (['storyboard-breakdown', 'storyboard-resource'].includes(nodeType.kind) && requiredValues.storyboardPipelineVersion === 2) {
|
|
19
19
|
for (const key of ['sourceFormat', 'platform']) {
|
|
20
20
|
if (!(key in requiredValues) || requiredValues[key] === '') {
|
|
21
21
|
throw new Error(`专业分镜 v2 缺少配置:${key}`);
|
|
@@ -249,7 +249,10 @@ export class VvicatApi {
|
|
|
249
249
|
applyContinuity(projectId, input) {
|
|
250
250
|
return this.client.request(`/api/projects/${projectId}/canvas/continuity`, { method: 'POST', body: input });
|
|
251
251
|
}
|
|
252
|
-
patchCanvas(projectId, input) {
|
|
252
|
+
async patchCanvas(projectId, input) {
|
|
253
|
+
if (Array.isArray(input.upsertNodes) && input.upsertNodes.some(node => node && typeof node === 'object' && !Array.isArray(node) && node.kind === 'storyboard-breakdown')) {
|
|
254
|
+
throw new Error('CLI 禁止写入拆镜生成节点;请使用 storyboard-resource 与 canvas node storyboard-draft 自写镜头');
|
|
255
|
+
}
|
|
253
256
|
return this.client.request(`/api/projects/${projectId}/canvas`, {
|
|
254
257
|
method: 'PATCH', headers: { Prefer: 'return=representation' }, body: input,
|
|
255
258
|
});
|
|
@@ -286,6 +289,8 @@ export class VvicatApi {
|
|
|
286
289
|
return { ...payload.data, schemaVersion: payload.data.schemaVersion };
|
|
287
290
|
}
|
|
288
291
|
async addNode(projectId, input) {
|
|
292
|
+
if (input.kind === 'storyboard-breakdown')
|
|
293
|
+
throw new Error('CLI 禁止创建拆镜生成节点;请使用 storyboard-resource 与 canvas node storyboard-draft 自写镜头');
|
|
289
294
|
const canvas = await this.canvas(projectId);
|
|
290
295
|
const catalog = await this.nodeTypes();
|
|
291
296
|
const definition = catalog.nodeTypes.find((item) => item.kind === input.kind);
|
|
@@ -380,7 +385,13 @@ export class VvicatApi {
|
|
|
380
385
|
deleteEdgeIds: [edgeId],
|
|
381
386
|
});
|
|
382
387
|
}
|
|
383
|
-
runNode(projectId, nodeId) {
|
|
388
|
+
async runNode(projectId, nodeId) {
|
|
389
|
+
const canvas = await this.canvas(projectId);
|
|
390
|
+
const node = canvas.nodes.find(item => item.id === nodeId);
|
|
391
|
+
if (!node)
|
|
392
|
+
throw new Error(`节点不存在:${nodeId}`);
|
|
393
|
+
if (node.kind === 'storyboard-breakdown' || node.kind === 'storyboard-resource')
|
|
394
|
+
throw new Error('CLI 禁止调用拆镜生成节点;请使用 canvas node storyboard-draft 保存并物化自写镜头');
|
|
384
395
|
return this.client.request(`/api/projects/${projectId}/canvas/nodes/${nodeId}/execute`, { method: 'POST' });
|
|
385
396
|
}
|
|
386
397
|
listAssets(projectId, query = '') {
|
package/package.json
CHANGED
|
@@ -34,7 +34,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
|
|
|
34
34
|
| 单集剧本、来源片段转剧本、剧本润色 | `references/short-drama/creation/write-drama-episode.md`、`references/short-drama/review/review-drama-script.md`、`references/humanizer/humanizer.md`、`references/short-drama/creation/humanizer.md` | 已有专业剧本时先复用并审核,不得重复执行 `novel-to-script`;改编先保留原文事实和对白,再按官方 Humanizer 快照做自然化,短剧适配层只补充事实保留和表演边界;必须回到 `drama-script-review`,P0/P1 未清零不得进入导演阶段 |
|
|
35
35
|
| 导演手册、摄影与表演 | `references/short-drama/creation/write-drama-director-book.md`、`references/short-drama/director-composition.md` | 在资产生成和拆镜前完成 `drama-director-book`;构图、轴线和表演决定必须来自剧本事实,证据不足时降级构图,不补陈设或天气 |
|
|
36
36
|
| 人物、场景、道具和资产版本 | `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` | `
|
|
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
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
39
|
| 背景音乐、主题曲、纯音乐 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/generation/design-drama-audio.md` | 使用画布 `music-generate` 和实时音频模型目录;有自定义歌词时不得同时开启纯音乐;生成后试听并回读 AUDIO 资产版本 |
|
|
40
40
|
| 去字幕、参考视频复刻、深度视频 | `references/short-drama/recreation/recreation-qa.md`、`references/short-drama/generation/transform-drama-media.md` | 使用 `recreation-subtitle-remove → recreation-depth-preprocess/depth-video → video-generate`;不得把参考板或字幕带入成片 |
|
|
@@ -43,7 +43,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
|
|
|
43
43
|
|
|
44
44
|
自由画布短剧制作不要求预先搭建固定功能节点:Agent 先用 `canvas documents` 恢复分集,再按 `module-map.json` 选择模块;结果保存为 `canvas.<module>.v1` 版本并以 `--input` 记录来源,文档选版和审核证据作为阶段依据。
|
|
45
45
|
|
|
46
|
-
新项目禁止预搭旧版固定功能节点链(`screenplay-resource` 起始、`drama-*` 分析节点整条连好的流水线)。分析阶段每个产物都由 Agent 在无限画布创建或更新 `text-resource` 自由画布文档,并通过 `canvas document save`
|
|
46
|
+
新项目禁止预搭旧版固定功能节点链(`screenplay-resource` 起始、`drama-*` 分析节点整条连好的流水线)。分析阶段每个产物都由 Agent 在无限画布创建或更新 `text-resource` 自由画布文档,并通过 `canvas document save` 追加不可变版本;媒体节点只消费已审核的自由画布文档和选定媒体版本。媒体生成节点仍由画布按文档物化或按需单独创建;首次镜头用 `storyboard-resource` 和 `canvas node storyboard-draft` 自写、校验与物化。Agent/CLI 禁止创建或执行 `storyboard-breakdown`,该模型生成节点仅供网页人工使用。
|
|
47
47
|
|
|
48
48
|
旧版固定节点链仍保留用于读取和恢复历史项目,但不得作为新项目入口,也不得与 自由画布文档并行写入同一阶段。发现旧节点链时先用 `canvas documents` 和 `canvas workflow status` 建立 自由画布文档快照,再迁移受影响阶段;迁移完成后停止继续创建旧节点链。
|
|
49
49
|
## 核心原则
|
|
@@ -61,7 +61,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
|
|
|
61
61
|
3. **项目配置门禁**:项目初始化时必须向用户展示并确认创作配置,不得只采用账户默认值:交付语言、画幅、目标时长、画风、分镜板策略、分析/文本模型、图片模型及其厂商、视频模型及其厂商、视频提示词协议、音频/配乐模型及其厂商、声音一致性方式、分辨率、画质、候选数量、参考素材和预计请求范围。先读取 `canvas settings get`,展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options;确认 `imageResolution`、`imageQuality` 和 `videoResolution` 后,再按标准创作门禁用 `--file settings.json` 原子写入并携带 `expectedVersion`,回读一致前不得创建或运行付费节点。`$ART_STYLE_ID` 必须解析实时 `option.value`。节点确需不同参数时才按实时能力覆盖,并记录覆盖原因;`automation_mode` 只能省略已确认且未变化的重复询问,不能替用户确认模型/厂商或付费范围。
|
|
62
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
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#拆镜语言匹配门禁)
|
|
64
|
+
6. **拆镜与制作计划**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建使用手写分镜资源 `storyboard-resource`,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2`,不自动新增首帧节点。结构化分镜之后依次生成逐镜制作计划和跨镜连续性计划;只有前镜已审核且选版时才允许 previous-tail。视频提交前必须完成素材连线、镜头逻辑和上下镜连续性审计。
|
|
65
65
|
7. **分镜图与逐镜审计**:Agent 先读取每镜 `storyboard_strategy`,按制作目标选择单幅分镜图、时间故事版、镜头分镜板、专项板或 Blender;已选择一种板型时不得自动补生成另一种。只审核实际生成的板型,并让视频提示词只引用真实存在且已审核的分镜资产。逐镜审计 P0/P1 未清零不得写入视频提示词或提交视频。用户的停止阶段优先于 [滚动异步调度](references/async-pipeline.md):仅分镜图任务完成实际选择的板型并通过审核后停止,不运行视频提示词和视频。
|
|
66
66
|
8. **视频规划、提示词与 H3 生成门禁**:读取实时 `durationOptions`;只有选项恰为 5、10、15 秒时才按这三档向上取整。RunningHub MiniMax H3 支持纯文本和 0–9 张参考图、0–2 个参考视频、0–2 个参考音频,5–15 秒逐秒可选,1–4 秒归一为 5 秒;参考视频只传画面。画幅为 16:9 / 9:16,分辨率为 480p / 720p / 1K / 2K。`videoModel` 为 `comfly::minimax-h3` 或 `runninghub::minimax-h3-reference-to-video` 时,同次设置 `videoPromptType: "h3"`;仅有效的节点 `promptType` 可覆盖项目值,旧 `seedance` 覆盖必须清除并回读,否则不得执行视频生成或写入提示词。Agent 编写 H3 提示词时读取 `references/short-drama/prompt/h3-prompt-writing.md`,写入后回读提示词选版;进入生成前必须读取 [H3 成片规则](references/h3-video-delivery.md)。
|
|
67
67
|
9. **视频滚动生成与逐镜后验**:允许视频时,已就绪镜头滚动提交,单镜失败不阻塞其他镜头。每个视频镜头完成后实际看画面、听完整音轨,并完成视觉、音频、转场、字幕四项验收。任一 P0/P1 失败只修复并重跑受影响镜头;未通过不得进入成片剪辑。
|
|
@@ -47,7 +47,7 @@ ai-short-studio canvas node diagnose "$NODE_ID" --project "$PROJECT_ID" --json
|
|
|
47
47
|
|
|
48
48
|
```bash
|
|
49
49
|
ai-short-studio canvas node add screenplay-resource --project "$PROJECT_ID" --config screenplay-node.json --json
|
|
50
|
-
ai-short-studio canvas node add storyboard-
|
|
50
|
+
ai-short-studio canvas node add storyboard-resource --project "$PROJECT_ID" --source-format screenplay-json.v1 --json
|
|
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
|
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
|
|
10
10
|
保存 `character-profiles`(完整 `new_characters`、`updated_characters` 数组)直接派生人物资源。视觉设定以 `character-visual-design` 文档键保存 `characters[].appearances`;场景、道具分别用 `location-design` 的 `locations` 和 `prop-design` 的 `props`。均允许 `ep-001.` 分集前缀,正文按实时同名节点 `structuredOutputSchema` 编写;保存后回读派生资源及媒体节点。不要先建空资源、在 config 塞正文,或运行旧设计节点来“激活”文档。`asset-plan` 只作规划,不会凭简略清单伪造完整设定。
|
|
11
11
|
|
|
12
|
-
首次专业镜头使用 `canvas node storyboard-draft` 的 `create → dry-run/修订 → promote`,详见 `agent-recovery.md`;`storyboard-
|
|
12
|
+
首次专业镜头使用 `canvas node storyboard-draft` 的 `create → dry-run/修订 → promote`,详见 `agent-recovery.md`;`storyboard-resource` 只承载源合同、Agent 自写草稿与正式镜头,没有模型任务;禁止 Agent/CLI 创建或执行 `storyboard-breakdown`,该生成节点仅供网页人工使用。历史拆镜产物可读取复用,不能再次调用其拆镜模型。已有正式镜头直接复用,只有来源已改变或用户要求改镜时才修订草稿或镜头。物化不等于媒体审核,不提交虚假批准。制作计划、连续性计划、声音计划与镜头文字审计继续保存为带精确输入版本的 `text-resource` 文档,视频预检认可其当前有效选版。
|
|
13
13
|
|
|
14
14
|
## 拆镜模式与交付范围
|
|
15
15
|
|
|
@@ -81,7 +81,7 @@
|
|
|
81
81
|
- **专业拆镜**:提交任务的目标语言取项目 `outputLanguage`;缺少有效项目语言时在入队前拒绝。Worker 再核对项目与任务语言,不一致时返回 `STORYBOARD_PROJECT_LANGUAGE_MISMATCH`。Markdown 源文件必须为对白、旁白、屏显和标题提供同标签本地化块,例如 `- **PT-BR:** ...`;JSON 直接保留 `scenes[].content[]` 原文,执行前确认其符合项目交付语言。CLI `--locale` 只控制界面消息。
|
|
82
82
|
- **写前回读**:执行前重新读取 `project get`、settings、拆镜节点原始 config 和 selected 剧本,确认来源符合项目交付语言;专业节点不必重复设置 `targetLanguage` 或画幅,实际任务使用项目语言和画布有效画幅,旧节点语言不作为覆盖。创建后若发现项目语言选错,必须停止当前项目并新建项目,不能修改旧项目语言或复用旧语言镜头。
|
|
83
83
|
|
|
84
|
-
|
|
84
|
+
首次镜头使用 `canvas node add storyboard-resource --source-format screenplay-json.v1 --platform short-drama`,Markdown 改为 `screenplay-markdown.v1`;连接一份真实已选剧本与资源后,读取来源合同,自写 shots 并通过 `storyboard-draft` 预览、保存、物化。该资源没有执行按钮或模型任务。禁止创建/执行 `storyboard-breakdown`;已有拆镜结果或导演文档中的镜头直接复用,不因未物化再次拆镜。
|
|
85
85
|
|
|
86
86
|
专业拆镜的 `canvas node types` 提供 `structuredOutputSchema`,包括八组导演字段及双时长:`duration` 为 5~15 秒生成素材,`edit_plan.intended_duration` 为正数剪辑保留秒数,可小于 5 秒,不得超过素材长度且须容纳对白与旁白。编辑保留时长按下文增量修订流程提交 `edit_plan.intended_duration`,不把整镜导演合同替换成只剩时长的对象。专业预算按保留时间汇总,超出建议镜头数或目标时长时作为软提示复核,不仅为预算反复纠错;未设镜头上限时没有固定 16 镜限制。Agent 不提交拆镜模型调用;来源或导演缺陷在自写草稿中按诊断修复,禁止手写独立提示词绕过。
|
|
87
87
|
|
|
@@ -187,3 +187,13 @@
|
|
|
187
187
|
资产校验失败须读取 `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 在只读来源合同内重分配来源并增删拆并镜头。
|
|
188
188
|
|
|
189
189
|
最终 `script.humanized` 文档保存后派生 screenplay-resource(SCRIPT 端口),供专业草稿连接;不自动创建或执行拆镜节点,原稿仍作为文档来源保留。
|
|
190
|
+
|
|
191
|
+
## 视觉资产绑定的确切合同
|
|
192
|
+
|
|
193
|
+
先读取 `canvas node types storyboard-shot --json` 的 `shotEditSchema` 和 `canvas node diagnose <nodeId> --project <projectId> --json`,禁止通过批量试错猜字段。
|
|
194
|
+
|
|
195
|
+
```json
|
|
196
|
+
{"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
|
+
```
|
|
198
|
+
|
|
199
|
+
`sourceNodeId` 是白名单中的设定节点,`imageNodeId` 是选定媒体所属图片节点,均不是 assetId/versionId,也不填名字或自造 assetKey。每个设定节点只绑定一次,并覆盖本镜全部 `assetNodeRefs`。图片通过板图的 `reference` 端口接入;使用 `edit-shot` 或 `revise-storyboard` 增量修订,先 dry-run,成功后回读新的镜头、父汇总和画布版本。409 时重读诊断,再用当前真实版本重新计算补丁,不猜版本或删除门禁。图片必须真实选版并通过所需审核;绑定不会自动授予审核通过。
|
|
@@ -12,17 +12,17 @@
|
|
|
12
12
|
|
|
13
13
|
资产分析后只制作目标集实际出现的人物形象、场景及道具。基础版与派生版保留真实引用,派生提示只声明允许变化。候选、当前选版和人工确认分开记录;不能按标题猜节点归属、按提交顺序猜资产,不能把同一图片冒充独立资源。结构化资源编辑保留其他条目、身份及不可变历史。
|
|
14
14
|
|
|
15
|
-
##
|
|
15
|
+
## 自写分镜与板型选择
|
|
16
16
|
|
|
17
17
|
短剧专业链路按实时 schema 显式配置 sourceFormat、platform 与 storyboardPipelineVersion=2;不得因片长短、失败或用户只要图片而降级。原文、对白和镜头归属由源剧本及服务端编译决定;修改剧情先改来源,不通过镜头编辑伪造 sourceText/sourceUnitIds/speechUnits。硬镜数预算不可满足时修改目标或来源,不反复生成碰运气。
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
自写镜头物化后回读实际派生节点、父来源、镜号、板型和选版,不重复创建。每镜按 storyboard_strategy.required_board_types 选择时间宫格 temporal/grid、镜头故事版 shot/storyboard 中一种或两种,并记录 selection_basis;只生成、引用和审核已选板型,不强制双板。选择两板时须分别提供不同证据,keyframe/single 不替代已选板;count=1 不表示画面必须单格。板型、格数、布局、画幅及参考端口以当前节点目录和实际配置为准。缺少选择依据、来源、必需板或参考能力时停止,不削减参考绕过门禁。
|
|
20
20
|
|
|
21
21
|
人物、场景、道具的真实资产绑定须与当前镜头选版一致,并连接到实际板图参考端口;不能写服务端维护的 production 来源字段。构图说明落到可见的站位、视线、前中后景、光源、动作方向与镜尾状态;没有来源或已确认调度依据时不补天气、陈设、武器或额外人物。修改镜头或上游选版后重查下游 stale 和时长覆盖,旧媒体保留历史,不改其真实时长。
|
|
22
22
|
|
|
23
23
|
## 视频、声音与连续性
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
视频只消费本镜当前已选板型、提示词、逐镜预检和连续性计划。全部已选板分别获得有效人工审核后,仍须核对当前来源和实际参考集合。未决问题、连续性冲突、缺板、旧选版、失效审核或模型参考容量不足时不得生成;把 approved 改成 true 或删除参考都不能解决问题。连续性配置分析和提帧连线不等于媒体已生成或审核通过。
|
|
26
26
|
|
|
27
27
|
逐镜审核画面、完整音轨、转场与字幕,核对角色、动作、语言、逐字对白、说话者、同步、环境声及未声明音乐。没有观看和听取能力时交给用户在现有审核面板完整查看,不伪造审核声明或审核人。音频计划是文本,不能冒充已生成声音;独立配音、音乐或提帧仅在实时目录具备对应能力且用户明确授权时执行。保留已确认的原生对白,不擅自用外部配音替换。
|
|
28
28
|
|
|
@@ -23,7 +23,7 @@ ai-short-studio canvas workflow status --project <projectId> --json
|
|
|
23
23
|
|
|
24
24
|
## 历史节点兼容
|
|
25
25
|
|
|
26
|
-
旧版固定功能节点链(`screenplay-resource` 起始、`drama-*` 分析节点整条预连的流水线)只用于读取、审计和迁移历史项目,不得作为新项目入口,也不得与自由画布文档并行写入同一阶段。节点命令本身是当前接口:媒体生成节点(`character-turnaround`、`location-image`、`prop-turnaround`、`storyboard-*`、`video-generate
|
|
26
|
+
旧版固定功能节点链(`screenplay-resource` 起始、`drama-*` 分析节点整条预连的流水线)只用于读取、审计和迁移历史项目,不得作为新项目入口,也不得与自由画布文档并行写入同一阶段。节点命令本身是当前接口:媒体生成节点(`character-turnaround`、`location-image`、`prop-turnaround`、`storyboard-*`、`video-generate`)由画布按文档物化或按需单独创建,手写分镜用 `canvas node add storyboard-resource --source-format …` 作为无模型任务的草稿资源,禁止创建或执行人工专用的 `storyboard-breakdown`,Agent 使用 `storyboard-draft create/promote` 自写并物化,不执行该节点的模型任务;分析阶段产物仍以 `text-resource` 文档为准。
|
|
27
27
|
|
|
28
28
|
## 节点
|
|
29
29
|
|
|
@@ -139,3 +139,13 @@ handle 来自实时节点目录。只删除精确 edge ID;`--apply-ready` 只
|
|
|
139
139
|
阶段检查会同时核对随包 `module-map.json` 已登记文档的必需字段、非空字段和登记的数组类型。`incomplete-content` 表示当前版本只是草稿,读取正文后补齐并追加版本;下游引用此草稿也会失效。`duplicate-key` 表示同模块出现多份裸键、分集键或历史别名产物,先核对现有节点并保留明确的唯一依据,不通过继续创建测试节点修复。人物档案兼容历史 `generate-character-profiles` 键,新文档统一用 `character-profiles`;声音设计阶段识别 `audio-plan`。
|
|
140
140
|
|
|
141
141
|
网页初始化使用 `GET /api/projects/:projectId/canvas?view=bootstrap` 聚合快照;CLI 保持精简画布 GET,并通过现有 inspect/documents/asset 命令按需读取。助手重连保留会话和累计预算,不会重放制作指令;工具或活跃时间预算耗尽时应拆分任务,不能靠反复重连恢复额度。
|
|
142
|
+
|
|
143
|
+
## 脚本调用与错误恢复
|
|
144
|
+
|
|
145
|
+
- `canvas node types [kind] --json` 是全局目录,不带 `--project`。`canvas document status <nodeId> --project <projectId> --json` 接收节点 ID,不支持 `--document-key`;按文档键查找先用 `canvas documents`。
|
|
146
|
+
- `node list` 输出数组;`canvas inspect` 输出对象(`nodes`、`edges`);`document save` 直接输出 `assetId`、`versionId`。其他命令按各自实际返回形状解析,禁止统一假设有 `data` 包装。stdout 与 stderr 分开保存,检查退出码后再解析 JSON;不要用 `2>&1 | head` 掩盖错误或截断 JSON。
|
|
147
|
+
- zsh 不会把字符串变量自动拆成多个参数。批量 `node run` 用参数数组,不能把拼接字符串 `$CMD` 当多个 `--node` 参数;跨 shell 脚本优先用 Python `subprocess.run(["ai-short-studio", "canvas", "node", "run", "--project", project_id, *["--node="+node_id for node_id in node_ids], "--json"], check=True)`。下载也逐项传真实 node/asset/version 参数,不依赖 `set -- $pair` 拆词。
|
|
148
|
+
- 无 `task create` 命令;提交使用 `canvas node run`,查询和等待使用 `task get/wait`。先按实时 schema 写入资源,`location-resource` / `prop-resource` 不支持 `config.text` 时使用正式文档派生或 `edit-resource`,禁止猜字段强写。
|
|
149
|
+
- 合同错误先读 `error.details` 中的字段、示例和恢复入口;修复后只重试目标操作,不循环猜结构。网络中断后先查原任务与已保存版本再决定是否重试写入,不能把 `fetch failed` 或 `terminated` 当作未执行。
|
|
150
|
+
|
|
151
|
+
内置助手的节点执行也区分只读预检失败与写入阶段结果不明:前者返回明确 `failed` 与字段诊断,修正后再发起;后者仍为 `unknown`,先核对原调用。CLI 不应将网络失败、进程终止或阶段状态变化等同于“任务没有提交”。
|
package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/humanizer.md
CHANGED
|
@@ -7,3 +7,5 @@
|
|
|
7
7
|
短剧额外检查:角色都说同一种话、台词解释动机、连续完整句缺少打断与潜台词、旁白重复画面、舞台说明像散文、机械三段式、泛滥的转折词和总结句、口号式金句、同义反复、刻意悬念、过量标题与括号。让每个角色的词汇、句长、回避方式和情绪泄露符合人物档案;保留必要停顿、沉默、抢话和未说完的话,但不为“人味”堆口头禅。官方 Humanizer 的百科、脚注和引用规则不适用于剧本对白;不得为了去 AI 味删掉表演所必需的停顿或舞台事实。
|
|
8
8
|
|
|
9
9
|
输出完整剧本新版本,不输出修改建议代替成稿。用 `canvas document save` 写入下一个不可变版本并 `canvas document get`,禁止覆盖原稿;随后必须执行 `review-drama-script`。用户语言样本只作为风格参考,不能复制其中的个人信息或无关事实。
|
|
10
|
+
|
|
11
|
+
保存目标仍为 `text-resource`,文档键为 `humanized`(或 `ep-001.humanized`)。正文顶层必须保留非空的 `scenes` 场景对象数组及完整剧本,不能只写 `strategy`、`line_changes`、`final_dialogues` 或将成稿包入 `script`。服务端会派生 `screenplay-resource`,不要自行更换保存节点类型。
|
|
@@ -575,6 +575,23 @@
|
|
|
575
575
|
"aliases": [
|
|
576
576
|
"generate-character-profiles"
|
|
577
577
|
]
|
|
578
|
+
},
|
|
579
|
+
"humanized": {
|
|
580
|
+
"module": "write-drama-episode",
|
|
581
|
+
"template_stem": "screenplay_conversion",
|
|
582
|
+
"stage": "script",
|
|
583
|
+
"required_fields": [
|
|
584
|
+
"scenes"
|
|
585
|
+
],
|
|
586
|
+
"array_fields": [
|
|
587
|
+
"scenes"
|
|
588
|
+
],
|
|
589
|
+
"non_empty_fields": [
|
|
590
|
+
"scenes"
|
|
591
|
+
],
|
|
592
|
+
"object_array_fields": [
|
|
593
|
+
"scenes"
|
|
594
|
+
]
|
|
578
595
|
}
|
|
579
596
|
},
|
|
580
597
|
"provider_prompts": [
|
|
@@ -34,12 +34,13 @@
|
|
|
34
34
|
| `outline` | `outline-drama-series` | 分集大纲,`episodes` 不得为空 |
|
|
35
35
|
| `script` | `write-drama-episode` | 单集剧本,保存时使用 `ep-001.script` 这类带分集前缀的键,`scenes` 不得为空 |
|
|
36
36
|
| `director-book` | `write-drama-director-book` | 导演本,逐场摄影与表演决定 |
|
|
37
|
+
| `humanized` | `write-drama-episode` | 自然化完整剧本,顶层 `scenes` 必须为场景对象数组,不能只存润色摘要 |
|
|
37
38
|
| `character-profiles` | `generate-character-profiles` | 人物档案,`new_characters` 与 `updated_characters` 数组,不能通过额外生图代替 |
|
|
38
39
|
| `asset-plan` | `plan-drama-assets` | 资产计划,人物、场景、道具与未决问题 |
|
|
39
40
|
| `production-plan` | `plan-drama-production` | 逐镜制作计划,`shots` 不得为空 |
|
|
40
41
|
| `continuity-plan` | `plan-shot-continuity` | 跨镜连续性计划,`shots` 不得为空 |
|
|
41
42
|
|
|
42
|
-
其余阶段文档键固定为 `brief`、`
|
|
43
|
+
其余阶段文档键固定为 `brief`、`script.review`、`art-style`、`asset-selection`、`storyboard`、`storyboard-images`、`video-prompts`、`videos`、`shot-review`、`edit-plan`、`delivery-review`;审核类文档另存为 `canvas.review.v1`,正文按 [画布命令](../commands/canvas.md) 的审核形状写 `decision` 与 `issues`,不能写成模板里的 `approved` 字段。
|
|
43
44
|
|
|
44
45
|
保存顺序固定为:读取 `module-map.json` 的文档合同 → 完整读取对应 `assets/modules/<module>/prompts/<template_stem>.zh.txt` 模板 → 按模板声明的顶层字段生成 JSON → `canvas document save --document-key <登记键> --schema-key canvas.<键末段>.v1 --input <上游节点>` → `canvas documents` 与 `canvas document get` 回读必需字段和来源快照。
|
|
45
46
|
|
package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-shots.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
每镜已选择的分镜板生成候选后,先用图像查看能力逐张检查完整画面的保真预览;小字、面部、手部、道具或格间细节另做局部裁切检查,不得把生产原件直接上传,也不能只看界面缩略图、文件存在或生成状态。随后结合前后镜、结构化分镜、人物/场景/道具选版和项目画风做整集连续审计。每个已生成板型都必须写独立审核记录,`criteria` 严格按以下八项原顺序记录 `{criterion,status,observation}`:`空间关系与轴线`、`时间与动作连续性`、`物理与交互逻辑`、`光线与色彩连续性`、`人物身份与造型一致性`、`场景与道具一致性`、`构图与镜头语言`、`叙事覆盖与阅读顺序`。时间故事版重点核对动作阶段与状态变化,镜头分镜板重点核对景别、调度、轴线和叙事节拍;每个已选择的板型都需完整通过八项。任何一项 failed 都必须修订或重生成后复审,所有已选板型通过前不得制作正式视频。
|
|
8
8
|
|
|
9
|
-
顺序固定为 `
|
|
9
|
+
顺序固定为 `Agent 自写分镜 → production-plan 文档 → continuity-plan 文档 → 分镜板生成与逐镜审计`:`drama-shot-review` 的 `continuityPlan` 是入参,逐镜审计前必须已有与当前分镜和制作计划同版本的连续性计划。审计完成后再发现上下镜冲突时,追加新的连续性计划版本、重新审计受影响镜头,不改写旧版本,也不带缺失入参提交审计。审计观察必须足以支持人物位置、姿态、运动方向、持物、出入画边、轴线、机位侧和主光锚点;看不清或上下镜冲突的内容进入连续性计划 `unresolved`,不得用主观判断补齐。启用 previous-tail 的下一镜还要确认上一镜结束状态已稳定可读,并与同机位承接相容。
|
|
10
10
|
|
|
11
11
|
`storyboard_strategy.mode=blender` 的镜头还要完整观看白模分镜,并核对实际选择的静态分镜板;未选择的板型不产生额外审核门禁。审核记录必须以 `asset_sha256` 绑定正在观看的白模文件,并把 `watch_evidence.duration_seconds` 写成实际探测时长;两者与资产账本或制作计划不一致时不得批准。`criteria` 严格按 `剧情因果与节拍`、`人物调度与表演`、`相机动机与运动曲线`、`构图与视觉层级`、`空间、轴线与连续性`、`物理与接触`、`技术交付` 原顺序记录,并写入对应满分 20/15/20/15/15/10/5 的 `score.breakdown`。同时按导演合同原顺序填写 `hard_gates[]`,每项包含 `gate/status/frame/observation`;任一硬门禁 failed 都不得批准。审核入口会在自动选版前复核导演合同路径与哈希、实际时长/帧率/帧数/分辨率及当前制作计划版本。总分至少 85、每项至少达到该项满分 70%、全部 criteria 和 hard_gates passed,且 `watchedFull` 与首/中/尾证据完整才可批准和选版。
|
|
12
12
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 构建分镜
|
|
2
2
|
|
|
3
|
-
Agent 执行本模块时,先复用已保存的导演文档与有效镜头;首次镜头通过 `canvas node storyboard-draft create/promote`
|
|
3
|
+
Agent 执行本模块时,先复用已保存的导演文档与有效镜头;首次镜头通过 `canvas node storyboard-draft create/promote` 自写并校验物化,只新建 `storyboard-resource`,禁止创建或运行 `storyboard-breakdown`,也不调用额外镜头分析 LLM。下文导演字段是 Agent 的写作与复核标准,不是另开模型任务的指令。
|
|
4
4
|
|
|
5
5
|
先核对源剧本语言、交付语言、人物说话语言和字幕语言,并从已选 Provider/制作计划取得 `shot_duration_constraints`。由 Codex 使用本 Skill 的 `../assets/modules/build-drama-storyboard/prompts/agent_storyboard_plan.{zh,en}.txt` 生成严格 JSON;需要整集合同输出时,向 `professional_storyboard` 显式传入 screenplay_contract、asset_whitelist、cinema_knowledge、production_constraints、correction 和 target_language。新生成分镜必须依次执行 `agent_cinematographer`、`agent_acting_direction` 与 `agent_storyboard_detail`,不得把表演、眼神、自然运动和声音证据留到最终视频提示词阶段才临时补写;只有读取旧项目且不重制分镜时允许保留历史薄合同。
|
|
6
6
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
微短剧从选题或方案开始时,先用 `short-drama` 完成方案、角色、分集、目标单集剧本和 review,再用 `humanizer` 只润色表达,最后回到 short-drama 复核。已有专业剧本直接创建 screenplay resource。
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
Agent 纯文本分镜给无模型任务的 `storyboard-resource` 显式配置 `storyboardPipelineVersion: 2`、来源格式、非空平台和合法画幅,且只连接一条剧本。Markdown 使用 `sourceFormat: screenplay-markdown.v1`;结构化单集剧本使用 `screenplay-json.v1`,其 `scenes[].content[]` 支持 action/text、dialogue/character/lines 和 voiceover/text,parenthetical 保留为表演提示。JSON 每句台词生成独立来源单元,未知内容类型或空台词须修正源剧本。内容语言取项目 `outputLanguage`,画幅优先取画布设置;节点旧 `targetLanguage` 不覆盖项目语言。执行前按 [拆镜语言匹配门禁](assets-and-storyboard.md#拆镜语言匹配门禁) 核对来源;CLI `--locale` 只控制界面消息。仅执行拆镜测试时只验收分镜文本和镜头资产,不生成图片、音频或视频;失败时检查是否保留未批准草稿;正式选版和下游不应被非法规划覆盖,完整草稿可按 agent-recovery.md 继续修复。
|
|
10
10
|
|
|
11
11
|
## 独立 TTS 音频
|
|
12
12
|
|