@aswless_854771076/ai_short_studio_cli 0.1.116 → 0.1.117
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 +4 -1
- package/dist/commands/canvas/asset/download.d.ts +2 -0
- package/dist/commands/canvas/asset/download.js +29 -16
- package/dist/commands/canvas/asset/review-context.d.ts +19 -0
- package/dist/commands/canvas/asset/review-context.js +14 -0
- package/dist/commands/canvas/asset/review.d.ts +17 -0
- package/dist/commands/canvas/asset/review.js +14 -0
- package/dist/commands/canvas/node/add.d.ts +2 -0
- package/dist/commands/canvas/node/add.js +19 -2
- package/dist/domain/vvicat-api.d.ts +2 -0
- package/dist/domain/vvicat-api.js +8 -1
- package/package.json +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/assets-and-storyboard.md +59 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/editing-delivery.md +14 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/reference-recreation-canvas.md +12 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/special-workflows.md +1 -1
package/README.md
CHANGED
|
@@ -43,6 +43,7 @@ CLI 只把 refresh token 保存到系统钥匙串。短期 access token 会写
|
|
|
43
43
|
- `ai-short-studio canvas edge`:连线读写。
|
|
44
44
|
- `ai-short-studio canvas continuity analyze`:视频生成前分析镜头依赖,可修复已具备源视频的首尾帧连线。
|
|
45
45
|
- `ai-short-studio canvas asset`:资产列表、上传、版本选择和下载。
|
|
46
|
+
- `ai-short-studio canvas asset review-context|review`:读取当前媒体摘要和必需维度,提交实际逐项审核并追加独立审核文档;不自动生成通过结论。
|
|
46
47
|
- `ai-short-studio canvas folder`:画布资产目录管理(5 预设 + 用户子目录 + 软删 + 跨项目复制)。
|
|
47
48
|
- `ai-short-studio canvas episode`:列出或创建无限画布分集。其他画布命令用 `--episode <ID|集数>` 选择分集。
|
|
48
49
|
- `ai-short-studio task`:项目任务列表、读取、受限批量等待和取消。
|
|
@@ -126,7 +127,9 @@ CLI 通过 `/api/v1/bootstrap` 完成版本、连通性与 Supabase 公共配置
|
|
|
126
127
|
|
|
127
128
|
`storyboard-image` schema 现在暴露节点级 `gridSize`。CLI 继续按实时 schema 通用写入,配套 Skill 会分析每个镜头的动作、运镜、多人调度和连续性难度,向用户确认后逐镜设置;未单独设置或连接旧服务时回退到项目格数,系统默认为 6 格。
|
|
128
129
|
|
|
129
|
-
|
|
130
|
+
专业拆镜使用 `storyboardPipelineVersion: 2`、`sourceFormat: screenplay-markdown.v1` 或 `screenplay-json.v1` 及非空 `platform`。JSON 接受 `scenes[].content[]` 的动作、逐句对白和旁白;Markdown 提供项目语言对应的本地化块。项目 `outputLanguage` 决定内容语言,画布设置优先决定画幅,CLI 不再要求节点重复配置这两项。新建可用 `canvas node add storyboard-breakdown --source-format screenplay-json.v1 --platform short-drama` 显式启用专业模式;Markdown 使用 `screenplay-markdown.v1`。历史节点不自动升级,通过 `node update` 切换前需连接可解析的选定剧本,失败整笔回滚;成功保留旧选版并将本节点和下游标为过期,运行中不可切换;拆镜测试只生成分镜文本和镜头资产,不自动运行声音、TTS、图片、音频或视频。
|
|
131
|
+
|
|
132
|
+
实时 `structuredOutputSchema` 公开专业导演字段及双时长:`duration` 是 5~15 秒素材,`edit_plan.intended_duration` 是正数保留秒数,可小于 5 秒,但不得超过素材或截断语音。`edit-shot` 可修改保留时间并保留其余导演字段。专业预算按保留时长计算,超过显式镜头上限或目标时长 120% 时有限纠错,最多三次调用。多分集项目的回读和 `edit-shot` / `edit-resource` 应使用相同 `--episode`;错误分集返回 404。
|
|
130
133
|
|
|
131
134
|
`storyboard-breakdown` 还可按实时 schema 写入 `targetDurationSeconds`、`pacingPreset` 和 `maxShotCount`。结构化剧本会先生成固定镜号、顺序和来源的确定性骨架;其中 `maxShotCount` 是硬预算,无法完整覆盖来源时会在模型调用前明确失败。纯文本旧链路仍按软提醒处理镜头数,`targetDurationSeconds` 始终是柔性时长目标。留空时不限制镜头数,也不启用时长硬门禁。生成链采用滚动异步调度:单镜分镜图完成后立即进入视频提示词,提示词通过审计后立即提交该镜视频,可恢复失败不阻塞其他镜头。内置 Skill 同时补全字幕、人物/场景首次介绍角标、有动机的镜头衔接、声音平衡和成片验收流程。
|
|
132
135
|
|
|
@@ -7,6 +7,8 @@ export default class CanvasAssetDownload extends BaseCommand {
|
|
|
7
7
|
project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
8
8
|
version: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
9
9
|
output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
10
|
+
attachment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
11
|
+
node: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
10
12
|
'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
11
13
|
json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
12
14
|
locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
@@ -5,30 +5,43 @@ import { BaseCommand } from '../../../base-command.js';
|
|
|
5
5
|
import { commandApi, projectFlag } from '../../../command-helpers.js';
|
|
6
6
|
export default class CanvasAssetDownload extends BaseCommand {
|
|
7
7
|
static args = { assetId: Args.string({ required: true }) };
|
|
8
|
-
static flags = { ...BaseCommand.baseFlags, project: projectFlag, version: Flags.string(), output: Flags.string({ default: '.' })
|
|
8
|
+
static flags = { ...BaseCommand.baseFlags, project: projectFlag, version: Flags.string(), output: Flags.string({ default: '.' }),
|
|
9
|
+
attachment: Flags.string({ options: ['srt', 'manifest'], dependsOn: ['node', 'version'], description: '下载当前内置渲染成片的字幕或交付清单' }),
|
|
10
|
+
node: Flags.string({ dependsOn: ['attachment'], description: '成片资源节点 ID' }) };
|
|
9
11
|
async run() {
|
|
10
12
|
const { args, flags } = await this.parse(CanvasAssetDownload);
|
|
11
13
|
const { api, client, profile } = await commandApi(flags);
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
14
|
+
let response;
|
|
15
|
+
let filename;
|
|
16
|
+
let versionId = flags.version;
|
|
17
|
+
if (flags.attachment) {
|
|
18
|
+
const query = new URLSearchParams({ nodeId: flags.node, versionId: flags.version, format: flags.attachment });
|
|
19
|
+
response = await client.response(`/api/projects/${encodeURIComponent(flags.project)}/canvas/assets/${encodeURIComponent(args.assetId)}/render-attachments?${query}`);
|
|
20
|
+
filename = flags.attachment === 'srt' ? 'captions.srt' : 'delivery-manifest.json';
|
|
21
|
+
}
|
|
22
|
+
else {
|
|
23
|
+
const payload = await api.asset(flags.project, args.assetId);
|
|
24
|
+
const asset = payload.asset;
|
|
25
|
+
if (!asset)
|
|
26
|
+
this.error('资产响应无效');
|
|
27
|
+
const version = flags.version ? asset.versions?.find((item) => item.id === flags.version) : asset.selectedVersion;
|
|
28
|
+
versionId = version?.id;
|
|
29
|
+
const media = version?.media || version?.items?.[0]?.media;
|
|
30
|
+
if (!media?.url)
|
|
31
|
+
this.error('所选资产版本没有可下载媒体');
|
|
32
|
+
const mediaUrl = new URL(media.url, profile.baseUrl);
|
|
33
|
+
mediaUrl.searchParams.set('download', '1');
|
|
34
|
+
response = await client.response(mediaUrl.toString(), {
|
|
35
|
+
auth: mediaUrl.origin === new URL(profile.baseUrl).origin,
|
|
36
|
+
});
|
|
37
|
+
filename = safeName(asset.name || basename(media.url));
|
|
38
|
+
}
|
|
25
39
|
await mkdir(flags.output, { recursive: true });
|
|
26
|
-
const filename = safeName(asset.name || basename(media.url));
|
|
27
40
|
const target = join(flags.output, filename);
|
|
28
41
|
const partial = `${target}.part`;
|
|
29
42
|
await writeFile(partial, Buffer.from(await response.arrayBuffer()));
|
|
30
43
|
await rename(partial, target);
|
|
31
|
-
this.print({ assetId:
|
|
44
|
+
this.print({ assetId: args.assetId, versionId, path: target });
|
|
32
45
|
}
|
|
33
46
|
}
|
|
34
47
|
function safeName(value) { return value.replace(/[\\/:*?"<>|]/g, '_') || 'download.bin'; }
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
2
|
+
export default class CanvasAssetReviewContext extends BaseCommand {
|
|
3
|
+
static description: string;
|
|
4
|
+
static args: {
|
|
5
|
+
assetId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
|
|
6
|
+
};
|
|
7
|
+
static flags: {
|
|
8
|
+
project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
9
|
+
node: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
10
|
+
version: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
11
|
+
stage: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
12
|
+
'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
13
|
+
json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
14
|
+
locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
15
|
+
profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
16
|
+
episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
17
|
+
};
|
|
18
|
+
run(): Promise<void>;
|
|
19
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { Args, Flags } from '@oclif/core';
|
|
2
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
3
|
+
import { commandApi, projectFlag } from '../../../command-helpers.js';
|
|
4
|
+
export default class CanvasAssetReviewContext extends BaseCommand {
|
|
5
|
+
static description = '读取当前媒体选版、内容摘要、必需审核维度和最新审核记录';
|
|
6
|
+
static args = { assetId: Args.string({ required: true }) };
|
|
7
|
+
static flags = { ...BaseCommand.baseFlags, project: projectFlag, node: Flags.string({ required: true }),
|
|
8
|
+
version: Flags.string({ required: true }), stage: Flags.string({ required: true, options: ['board', 'video', 'delivery'] }) };
|
|
9
|
+
async run() {
|
|
10
|
+
const { args, flags } = await this.parse(CanvasAssetReviewContext);
|
|
11
|
+
const { api } = await commandApi(flags);
|
|
12
|
+
this.print(await api.mediaReviewContext(flags.project, args.assetId, flags.node, flags.version, flags.stage));
|
|
13
|
+
}
|
|
14
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
2
|
+
export default class CanvasAssetReview extends BaseCommand {
|
|
3
|
+
static description: string;
|
|
4
|
+
static args: {
|
|
5
|
+
assetId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
|
|
6
|
+
};
|
|
7
|
+
static flags: {
|
|
8
|
+
project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
9
|
+
file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
10
|
+
'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
11
|
+
json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
12
|
+
locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
13
|
+
profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
14
|
+
episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
15
|
+
};
|
|
16
|
+
run(): Promise<void>;
|
|
17
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { Args, Flags } from '@oclif/core';
|
|
2
|
+
import { BaseCommand } from '../../../base-command.js';
|
|
3
|
+
import { commandApi, projectFlag, readJsonInput } from '../../../command-helpers.js';
|
|
4
|
+
export default class CanvasAssetReview extends BaseCommand {
|
|
5
|
+
static description = '提交实际媒体逐项审核并追加不可变文档;不自动填写通过结论';
|
|
6
|
+
static args = { assetId: Args.string({ required: true }) };
|
|
7
|
+
static flags = { ...BaseCommand.baseFlags, project: projectFlag, file: Flags.string({ description: '审核 JSON 文件;省略时从 stdin 读取' }) };
|
|
8
|
+
async run() {
|
|
9
|
+
const { args, flags } = await this.parse(CanvasAssetReview);
|
|
10
|
+
const body = await readJsonInput(flags.file);
|
|
11
|
+
const { api } = await commandApi(flags);
|
|
12
|
+
this.print(await api.reviewAsset(flags.project, args.assetId, body));
|
|
13
|
+
}
|
|
14
|
+
}
|
|
@@ -10,6 +10,8 @@ export default class CanvasNodeAdd extends BaseCommand {
|
|
|
10
10
|
title: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
11
11
|
'asset-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
12
12
|
config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
13
|
+
'source-format': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
14
|
+
platform: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
13
15
|
'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
14
16
|
json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
15
17
|
locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
@@ -3,6 +3,23 @@ import { BaseCommand } from '../../../base-command.js';
|
|
|
3
3
|
import { commandApi, projectFlag, readJsonInput } from '../../../command-helpers.js';
|
|
4
4
|
export default class CanvasNodeAdd extends BaseCommand {
|
|
5
5
|
static args = { kind: Args.string({ required: true }) };
|
|
6
|
-
static flags = {
|
|
7
|
-
|
|
6
|
+
static flags = {
|
|
7
|
+
...BaseCommand.baseFlags, project: projectFlag, x: Flags.integer({ default: 0 }), y: Flags.integer({ default: 0 }), title: Flags.string(),
|
|
8
|
+
'asset-id': Flags.string({ description: '绑定已有媒体资产 ID,仅用于 image、video、audio 节点' }),
|
|
9
|
+
config: Flags.string({ description: '配置 JSON 文件,例如 video-frame-extract 使用 {"position":"first"}' }),
|
|
10
|
+
'source-format': Flags.string({ description: '专业拆镜来源格式,显式启用 v2;仅用于 storyboard-breakdown', options: ['screenplay-json.v1', 'screenplay-markdown.v1'] }),
|
|
11
|
+
platform: Flags.string({ description: '专业拆镜发布平台,默认 short-drama', dependsOn: ['source-format'] }),
|
|
12
|
+
};
|
|
13
|
+
async run() {
|
|
14
|
+
const { args, flags } = await this.parse(CanvasNodeAdd);
|
|
15
|
+
if (flags['source-format'] && args.kind !== 'storyboard-breakdown')
|
|
16
|
+
this.error('--source-format 仅适用于 storyboard-breakdown');
|
|
17
|
+
const config = flags.config ? await readJsonInput(flags.config) : {};
|
|
18
|
+
if (flags['source-format'])
|
|
19
|
+
Object.assign(config, {
|
|
20
|
+
storyboardPipelineVersion: 2, sourceFormat: flags['source-format'], platform: flags.platform ?? config.platform ?? 'short-drama',
|
|
21
|
+
});
|
|
22
|
+
const { api } = await commandApi(flags);
|
|
23
|
+
this.print(await api.addNode(flags.project, { kind: args.kind, x: flags.x, y: flags.y, title: flags.title, assetId: flags['asset-id'], config }));
|
|
24
|
+
}
|
|
8
25
|
}
|
|
@@ -141,6 +141,8 @@ export declare class VvicatApi {
|
|
|
141
141
|
runNode(projectId: string, nodeId: string): Promise<JsonObject>;
|
|
142
142
|
listAssets(projectId: string, query?: string): Promise<JsonObject>;
|
|
143
143
|
asset(projectId: string, assetId: string): Promise<JsonObject>;
|
|
144
|
+
mediaReviewContext(projectId: string, assetId: string, nodeId: string, versionId: string, stage: string): Promise<JsonObject>;
|
|
145
|
+
reviewAsset(projectId: string, assetId: string, body: JsonObject): Promise<JsonObject>;
|
|
144
146
|
selectAssetVersion(projectId: string, assetId: string, versionId: string): Promise<JsonObject>;
|
|
145
147
|
uploadAsset(projectId: string, formData: FormData): Promise<JsonObject>;
|
|
146
148
|
task(taskId: string): Promise<{
|
|
@@ -16,7 +16,7 @@ function normalizeRequiredOutputLanguage(value) {
|
|
|
16
16
|
function validateConfigSchema(nodeType, config, requiredValues = config ?? {}) {
|
|
17
17
|
const values = config ?? {};
|
|
18
18
|
if (nodeType.kind === 'storyboard-breakdown' && requiredValues.storyboardPipelineVersion === 2) {
|
|
19
|
-
for (const key of ['sourceFormat', '
|
|
19
|
+
for (const key of ['sourceFormat', 'platform']) {
|
|
20
20
|
if (!(key in requiredValues) || requiredValues[key] === '') {
|
|
21
21
|
throw new Error(`专业分镜 v2 缺少配置:${key}`);
|
|
22
22
|
}
|
|
@@ -324,6 +324,13 @@ export class VvicatApi {
|
|
|
324
324
|
asset(projectId, assetId) {
|
|
325
325
|
return this.client.request(`/api/projects/${projectId}/canvas/assets/${assetId}`);
|
|
326
326
|
}
|
|
327
|
+
mediaReviewContext(projectId, assetId, nodeId, versionId, stage) {
|
|
328
|
+
const query = new URLSearchParams({ nodeId, versionId, stage });
|
|
329
|
+
return this.client.request(`/api/projects/${projectId}/canvas/assets/${assetId}/reviews?${query}`);
|
|
330
|
+
}
|
|
331
|
+
reviewAsset(projectId, assetId, body) {
|
|
332
|
+
return this.client.request(`/api/projects/${projectId}/canvas/assets/${assetId}/reviews`, { method: 'POST', body });
|
|
333
|
+
}
|
|
327
334
|
selectAssetVersion(projectId, assetId, versionId) {
|
|
328
335
|
return this.client.request(`/api/projects/${projectId}/canvas/assets/${assetId}`, {
|
|
329
336
|
method: 'PATCH', body: { selectedVersionId: versionId },
|
package/package.json
CHANGED
|
@@ -2,8 +2,18 @@
|
|
|
2
2
|
|
|
3
3
|
仅在生产人物/场景/道具、拆镜、分镜图或视频前审计时读取本文件。
|
|
4
4
|
|
|
5
|
+
## 实际媒体审核记录
|
|
6
|
+
|
|
7
|
+
先用 `canvas asset review-context <assetId> --project <projectId> --node <nodeId> --version <versionId> --stage board|video|delivery --json` 读取当前选版、真实 SHA-256、来源版本和必需维度。查看真实板图或完整播放并复听视频后,使用 `canvas asset review <assetId> --project <projectId> --file review.json --json` 提交;省略文件则读 stdin。
|
|
8
|
+
|
|
9
|
+
请求包含上下文的 `nodeId/versionId/stage/shotKey/sourceVersionIds/media` 和逐项 `criteria`(`dimension/status/observation`)。不得直接提交整个上下文或批量伪造 passed,不发送 `approved` 或自报审核人。视频批准还需要 `watchEvidence` 的人工完整播放声明及实际时长/起中末定位;技术探测、抽帧和 ASR 都不能替代观看。不会自动触发生成或修改媒体选版,新增审核文档保留历史;换版或来源变化需重审。当前记录能力不能单独证明视频生成、剪辑或交付的强制门禁已经接通。
|
|
10
|
+
|
|
11
|
+
专业双板到视频:在视频提示词节点连接本镜 `shot`、主 `storyboard`、两板 `temporalBoard/shotBoard` 和当前 `shotReview/continuityPlan`。预检的正式批准字段分别为 `summary.approved`、`approved`,必须覆盖原始 `shot_key`,没有未决问题或连续性冲突。视频节点使用 `references` 连接两张独立板和可选单帧参考,并连接同版本的提示词与两份预检;不要混连 start-frame/end-frame。模型参考图数量上限必须已知且足够,超限不能删参考硬跑。服务端提交与 Worker 调用前均复核当前板版本、真实摘要和各自审核,任务保存实际参考顺序。专业提示词/视频回写前再核对文件摘要,并在结果事务锁内复核选版和审核;已失效结果只追加历史版本,不自动选中或覆盖新任务。任务结果 `historical: true` 和版本 `generationParams.productionResultState: stale` 表示仅归档,需回读原资产版本列表及节点状态。额外图片参考须绑定同画布来源节点、选版和实际摘要;专业关键帧须匹配本镜及父拆镜。首尾帧提取记录源视频选版、位置和实际字节摘要,源视频改变会阻止继续使用;没有来源记录的旧提帧须重新提取。两板和关键帧生图绑定镜头、父拆镜及实际图片参考快照,生图前、返回后及锁内回写复核;来源变化仅归档历史结果。审核继续复核这些来源,没有来源快照的旧板图须重新生成后取得新批准。剪辑交付仍待闭合,不宣称完整生产链路已通过。
|
|
12
|
+
|
|
5
13
|
## 资产生产门禁
|
|
6
14
|
|
|
15
|
+
专业镜头的 `assetNodeRefs` 与 `visualAssetBindings` 共用镜头选版。通过 `canvas node edit-shot --file` 明确为每项设定来源绑定实际 `imageNodeId`,并把这些图片接到两板的 `reference` 端口;不能按节点标题猜归属。每个绑定图片节点只能代表一个选定媒体,多候选需使用单项资源节点。服务端在付费板图前检查全部声明资产、上游真实设定边、选版与实际上送图片;提示词按实际数组编译身份和参考序号。修改绑定会使两板及下游 stale;设定换版或文字投影变化同样使旧来源失效。两板都审核通过仍要比较实际参考集合,差异不能由文字批准覆盖;引用覆盖不代表图像像素已符合设定。
|
|
16
|
+
|
|
7
17
|
1. 只生产目标集实际出现的人物及形象版本、场景/子场景、关键道具及叙事版本。每项任务成功后展示真实预览,让用户确认并设置 selected version。
|
|
8
18
|
2. 每个形象候选使用独立输入、独立三视图节点和独立图片资产;`count` 的多个结果也不能拼图。视觉素材未另行指定时使用 16:9,并按实时 schema 显式写入。
|
|
9
19
|
3. 真/假、原版/复制、成年/童年等成对资源必须先生成基础版并确认,再把基础版 `image-resource` 作为 reference 生成派生版;prompt 只枚举允许差异,其余保持一致。
|
|
@@ -11,13 +21,25 @@
|
|
|
11
21
|
5. 结构化剧本的镜号、顺序和来源由服务端确定性编译,模型只补摄影、表演和画面。显式 `maxShotCount` 是硬预算;任务在模型调用前报 `STORYBOARD_SHOT_BUDGET_INFEASIBLE` 时必须放宽预算或缩短剧本,不得反复提交同一任务碰运气。
|
|
12
22
|
6. 拆镜成功后刷新画布并复用自动创建的 shot/image/prompt 节点;按 `parentAssetId`、`producerNodeId` 和集号核对归属,不按任务提交顺序猜测。
|
|
13
23
|
|
|
24
|
+
## 专业时间宫格与镜头故事版
|
|
25
|
+
|
|
26
|
+
专业拆镜每镜包含 `storyboard_strategy`:`primary_board_type` 为 `temporal` 或 `shot`,`required_board_types` 必须同时包含两类,`selection_basis` 说明选择依据,`frame_count` 使用 4/6/9/16/25,默认建议 6。时间宫格画同镜动作因果,镜头故事版画可见的空间、调度和视线关系;单幅首帧独立存在,不能替代任一板。
|
|
27
|
+
|
|
28
|
+
物化自动复用每镜的首帧、时间宫格和镜头故事版节点,不按任务完成顺序猜身份。`canvas inspect` 的 `data.production` 提供板型和镜头归属;该字段仅由服务端维护,禁止通过 `canvas apply` 伪造。生成任务记录当前镜头选版、父拆镜版本和板型,不能从草稿文字替代来源。编辑 `storyboard_strategy.frame_count` 后同步两板节点格数;已有选版保留但标记 stale,分别重新生成。完整导演上下文超过 10,000 字符时拒绝提交,先整理上游说明,不手写旁路提示词补救。
|
|
29
|
+
|
|
30
|
+
专业提示词完成后,自动派生的视频节点继承主图、两板及两份预检,同图兼任主板时只接一次参考;回读 inspect 核对实际连线和当前版本。板节点与图片存在仅证明已派生或已生成,不证明实际审核通过或已传入视频。逐板查看真实图像并核对版本与引用;同图换标题不算另一类板,抽帧或 ASR 不能代替声画审核。
|
|
31
|
+
|
|
14
32
|
## 拆镜语言匹配门禁
|
|
15
33
|
|
|
16
34
|
拆镜前先输出并核对一行语言契约:`源剧本语言 / 用户交付语言 / 项目 outputLanguage / 节点 targetLanguage / H3 人声语言 / 字幕语言`。项目交付语言在创建时确定,创建后不可修改;专有名词、品牌、咒语或剧情要求保留的外语另列白名单,除此之外任一项不明确或冲突都禁止执行。
|
|
17
35
|
|
|
18
36
|
- **普通拆镜**:直接使用项目创建时的规范 BCP 47 `outputLanguage`,如 `en`、`ar`、`fr`、`pt-BR`、`zh-Hant`;不能留空、自动猜测或通过 settings 修改。节点若残留 `targetLanguage`,先按实时 schema 清除,避免把专业模式字段误当普通模式覆盖。
|
|
19
|
-
-
|
|
20
|
-
- **写前回读**:执行前重新读取 `project get`、settings、拆镜节点原始 config 和 selected
|
|
37
|
+
- **专业拆镜**:提交任务的目标语言取项目 `outputLanguage`;缺少有效项目语言时在入队前拒绝。Worker 再核对项目与任务语言,不一致时返回 `STORYBOARD_PROJECT_LANGUAGE_MISMATCH`。Markdown 源文件必须为对白、旁白、屏显和标题提供同标签本地化块,例如 `- **PT-BR:** ...`;JSON 直接保留 `scenes[].content[]` 原文,执行前确认其符合项目交付语言。CLI `--locale` 只控制界面消息。
|
|
38
|
+
- **写前回读**:执行前重新读取 `project get`、settings、拆镜节点原始 config 和 selected 剧本,确认来源符合项目交付语言;专业节点不必重复设置 `targetLanguage` 或画幅,实际任务使用项目语言和画布有效画幅,旧节点语言不作为覆盖。创建后若发现项目语言选错,必须停止当前项目并新建项目,不能修改旧项目语言或复用旧语言镜头。
|
|
39
|
+
|
|
40
|
+
专业新建使用 `canvas node add storyboard-breakdown --source-format screenplay-json.v1 --platform short-drama`,Markdown 改为 `screenplay-markdown.v1`。无该参数的新建仍是普通自由文本。历史节点须通过 `node update` 显式升级,先连接一份可解析的选定剧本;保存失败整笔回滚,成功保留旧选版并标记本节点及下游过期。运行中的拆镜任务结束后才能切换。
|
|
41
|
+
|
|
42
|
+
专业拆镜的 `canvas node types` 提供 `structuredOutputSchema`,包括八组导演字段及双时长:`duration` 为 5~15 秒生成素材,`edit_plan.intended_duration` 为正数剪辑保留秒数,可小于 5 秒,不得超过素材长度且须容纳对白与旁白。编辑保留时长使用 `edit-shot` 的 `edit_plan.intended_duration`,不把整镜导演合同替换成只剩时长的对象。专业预算按保留时间汇总,超出显式镜头数或目标时长 120% 时纠错;未设镜头上限时没有固定 16 镜限制。来源或导演缺陷最多三次拆镜调用,失败后修复拥有缺陷的阶段,禁止手写独立提示词绕过。
|
|
21
43
|
|
|
22
44
|
拆镜完成后不抽样,逐镜检查所有语言字段:场景标题、description/action、对白、旁白、表演说明、摄影计划、图像提示词和视频提示词。专业流程还必须确认没有 `STORYBOARD_LANGUAGE_MISMATCH`;普通流程没有同等级服务端校验时,由本审计补齐。白名单外出现其他语言、台词被翻译成错误目标语言、角色名被错误翻译或同一镜混入两种输出语言,均记为 P1。
|
|
23
45
|
|
|
@@ -56,3 +78,38 @@ P0/P1 必须清零;只修复受影响镜头或边,禁止全量重建掩盖
|
|
|
56
78
|
## 分镜图后验
|
|
57
79
|
|
|
58
80
|
每批完成后回读任务、节点、连线、资产、最终配置和 selected version,并实际查看所有图片。检查身份、肢体、道具、构图、画幅、裁切、文字、连续性和空结果。缺陷需再次付费生成或改选版本时,先展示问题并取得确认。
|
|
81
|
+
|
|
82
|
+
专业双板的 `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 edit-shot --file` 保存完整策略,改格数时同步两类计划及两板节点配置。结构校验不证明语义或像素符合预期。
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
使用前镜尾帧时,在镜头编辑器的 `continuity` JSON 中为相邻两镜填写 `camera_setup_id`、`entry_state`、`exit_state`。机位 ID 必须相同,前镜 `exit_state` 必须与本镜 `entry_state` 完全一致,本镜 `mode` 为 `previous-tail`,`sourceShotKey` 指向紧邻前镜。状态描述应包含位置、朝向、持物、姿态动势、轴线、光照和天气;换机位使用 `independent`。视频生成必须接入同一父拆镜下、已通过当前版本实际播放审核的前镜视频所提取的真实尾帧,并占用一个独立参考名额。提示词可提前规划;实际生成不可缺少尾帧。建议接线也遵守机位和状态约束。前镜换版或审核变化会阻止执行,执行中变化则仅归档历史结果。旧镜头可读,重新使用尾帧前须补齐声明并重新审核。声明一致不证明像素衔接自然,仍须检查实际视频。
|
|
86
|
+
|
|
87
|
+
专业拆镜在规划通过后,按“摄影→表演→细化”顺序运行,复用现有三套模板和影视知识应用点。每批最多 4 镜;后阶段读取前阶段实际输出。每个阶段/批次的结构或合同错误最多纠错 3 次,取消、供应商和基础设施错误直接停止;任一必需阶段失败不把规划草稿保存为完成分镜。专业任务的调用数因此会增加,不能再按整集一次调用估算。
|
|
88
|
+
|
|
89
|
+
表演逐角色记录 `current_goal`、`attention_target`、`trigger`、`participation`、`stimulus`、`attention`、`reaction`、`decision` 和本镜 `sourceUnitIds`。`participation` 为 `active`、`listening` 或 `not-involved`,聆听或不参与不需要强加眨眼、摇摆、手势;每个出镜角色恰好出现一次。细化只追加画面描述、图片提示词和 `video_prompt`,不能改写对白、来源、资产、时长、连续性、导演或逐格合同。
|
|
90
|
+
|
|
91
|
+
最终版本的 `generationParams.storyboardStages` 保存规划及三阶段的镜号、成功次数、请求/响应摘要和实际响应文本。它用于追溯模型步骤,不能证明触发和反应在语义上正确或生成视频已自然表演;仍需实际媒体审核。旧版本不会因此自动重跑。
|
|
92
|
+
|
|
93
|
+
新生成专业镜头的 `speechUnits` 是服务器从剧本派生的只读说话人/语言/逐句原文/表演提示。`edit-shot` 不能改写该合同;纯对白/旁白文本若与来源不符会返回 `STORYBOARD_SPEECH_SOURCE_*`。先改源剧本并重新拆镜,不另写自由文本或字幕绕过。旧镜头不会自动追填身份。该元数据不是声音资产绑定,也不是语音时间戳。
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
### 专业声音绑定
|
|
97
|
+
|
|
98
|
+
`drama-audio-plan` 的 `reference-audios` 连接已有已选音频;`data.config.voiceBindings` 显式记录 `[{speaker,nodeId,limitation,reviewPlan}]`,speaker 必须来自真实 speechUnits。服务端根据已连接 nodeId 解析实际 asset/version/media,不按文件名或在场角色猜声音。无参考时 nodeId=null,limitation/reviewPlan 均须非空;支持声音参考的正式视频仍须使用实际绑定。
|
|
99
|
+
|
|
100
|
+
声音计划输出 voice_assignments,dialogue 逐句保留 sourceUnitId/type/speaker/language/text/performanceCue。生成前允许有制作计划依据且明确标注 planned 的预计 time_range;连预计时间也无依据时写 null 与 open_questions,不编造实测时间;修复未决原因后才能生成专业提示词。将声音计划连接到 storyboard-video-prompt.audioPlan,派生 video-generate 自动继承计划和提示词选版快照中的实际音频连线。正式原生视频开启 generateAudio,真实模型须登记原生音频能力;native/post_dub/external_audio 沿用现有枚举,后两者当前需另行后期制作,不自动增加 TTS。
|
|
101
|
+
|
|
102
|
+
声音或计划换版使旧提示词、视频声音审核及剪辑来源失效;重新编译并实际复听,不把版本绑定当作声纹/口型通过。剪辑所用声音计划须与视频生成时同版。产品操作见 content/zh/production/character-voices.mdx。
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
### 来源事实合同
|
|
106
|
+
|
|
107
|
+
新建短剧来源分析默认启用 `data.config.storyFactContractVersion:1`,必须连接真实文本来源;旧节点升级需显式设置并重跑。事实项含 `fact/evidence/source_locator/kind`,kind为confirmed/constraint/inference/unknown,factId由服务端分配。已明确的允许改编登记为用户约束;模型不能自行授权。简报、设定、大纲、单集剧本、审校与导演手册继承generationParams.productionStoryFacts,逐项输出fact_checks:{factId,status,locator,evidence},status为preserved/not_used/contradicted/unknown。冲突与未知不可批准;上游未决ID不能在下游清除。来源/选版变化须回到来源重编译、审校,生成期间变化的输出只归档。旧无合同文本不追认为已核验;结构检查不保证模型语义判断正确,仍须阅读实际剧本。
|
|
108
|
+
|
|
109
|
+
### 场景设定板与干净背景
|
|
110
|
+
|
|
111
|
+
`location-image` 的 `data.config.locationImagePurpose` 为 `location-sheet`(新节点默认)或 `background-plate`。前者用于空间设定多视图,后者要求单幅无文字、无分格、无人物背景。用途写入生成版本;修改配置不会重标旧图,需重新生成并选版。视频首尾帧拒绝已标记的设定多视图;已标记干净背景会固化来源选版与摘要,并在 Worker 和回写时复核,来源失效结果只留历史。动态视频端口同样检查;历史无用途素材不自动认证。详见 `/docs/production/location-image-purpose`。
|
|
112
|
+
|
|
113
|
+
### 同一母场景的天气变体
|
|
114
|
+
|
|
115
|
+
`location-image` 的 `data.config.locationWeatherVariant` 可设 `sunny` 或 `thundercloud`,用途必须为 `background-plate`。将同一已选干净基础背景连接到 `masterLocation`,该输入必须唯一对应一张图片,且母场景自身不是天气变体。未选天气时不要连接此端口;其他参考仍走 `reference`。模型参考图数量能力必须明确且足够。服务端生成 `locationWeatherContract`,只允许天气/光照变化,保存母场景选版和字节摘要;不要手写该合同。实际请求使用母场景参考序号并要求固定地形、建筑、门窗、通道、机位和画风。母场景换版后,天气图、双板、视频审核及剪辑/交付检查会拒绝旧来源;依次重跑并重新审核,既有产物留存。合同不证明实际像素一致。详见 `/docs/production/location-weather-variants`。
|
|
@@ -2,6 +2,12 @@
|
|
|
2
2
|
|
|
3
3
|
涉及时间线、字幕、转场、音频处理或渲染时,先加载 `remotion-best-practices`,并按实际需要读取其中 captions、markup 和 rendering 参考。H3 人声、旁白、环境音与 BGM 仍以每镜原生整轨为唯一来源;允许轻量修整,不允许外部 TTS、配音或音乐覆盖原生失败。
|
|
4
4
|
|
|
5
|
+
## 画布剪辑计划门禁
|
|
6
|
+
|
|
7
|
+
批准剪辑计划的每段还须给出 `assetId/versionId/mediaId`、`source_in_ms/source_out_ms`、`timeline_in_ms/timeline_out_ms`、`cut_reason` 和 `source_evidence`。服务端拒绝未批准素材、越界或反向区间、时长不符、时间线空洞,以及尚有未决问题却宣称批准的计划。转场可以重叠;变速等未验证处理先保留未批准草稿。非空证据文字只通过结构检查,不能替代对实际动作和对白切点的核对。
|
|
8
|
+
|
|
9
|
+
“短剧剪辑计划”的 `videos` 是必填输入。先对每个已选视频版本完成实际播放审核并取得 `stage: video` 批准,再连接逐镜预检、声音计划与这些视频;节点配置里的文本或预检 `approved=true` 不能替代真实视频审核。预检必须覆盖所接视频的镜号,且 P0/P1 与未决问题清零。任务固化视频版本、真实媒体摘要、实际探测时长、审核版本和两份文档选版;Worker 在调用文本模型前再次复核,并将真实来源及时长附入提示词。执行中换版或撤销批准时,已返回剪辑计划只保存为历史版本,不选中或物化。旧计划仍可读,重新执行须连接有效审核视频。本门禁证明输入可用,不能证明具体切点正确、成片已生成或交付已批准;动作/对白完成点仍须实际检查。
|
|
10
|
+
|
|
5
11
|
## 1. 入库与选镜
|
|
6
12
|
|
|
7
13
|
- 只下载逐镜四项验收通过的 selected 视频版本;保留原文件,不在源文件上覆盖写入。
|
|
@@ -46,3 +52,11 @@
|
|
|
46
52
|
- 先输出低码率审片版,逐镜检查字幕、角标、切点、转场和音频;问题清零后再渲染交付版。渲染过程必须可由 manifest 和项目文件复现。
|
|
47
53
|
- 完整观看并听完最终文件,检查叙事、画面、声音、转场、字幕和技术参数;抽帧或任务成功不能替代完整验收。
|
|
48
54
|
- 交付至少包括:批准版视频、SRT、ASS、manifest、逐镜版本清单和必要的审核记录。临时缓存与源素材分开;不得删除用户已有资产或未批准版本。
|
|
55
|
+
|
|
56
|
+
“短剧交付验收”必须连接 `editPlan`、`shotReview`、`audioPlan`、`manifest` 和唯一 `film`。剪辑计划须为本画布当前批准版本,并保留生成时的实际视频审核合同;逐镜预检和声音计划必须与该合同同版。先导入实际成片,对其当前版本完成 `stage: delivery` 全片播放审核,再执行交付报告。
|
|
57
|
+
|
|
58
|
+
清单为 JSON:`version: 1`、`editPlan: {nodeId, assetId, versionId}`、`film: {nodeId, assetId, versionId, mediaId, sha256}`、`segments`。身份及摘要必须对应实际连线,segments 与批准剪辑计划完全一致;成片实际时长与时间线末点的误差不得超过 0.1 秒。可附加其他交付字段。报告六项检查引用实际成片审核版本,字幕允许沿用审核中的“不适用”;来源变动或撤销批准后,执行中返回的报告仅归档。此节点不渲染影片,也不自动验证每个实际切点与清单一致或字幕附件可下载;仍须实际审核与交付文件检查。
|
|
59
|
+
|
|
60
|
+
视频审核 JSON 可带 `speechTiming: {method: "human-playback", units: [{sourceUnitId, start_ms, end_ms}]}`,逐句对应审核上下文的 `sourceShot.speechUnits`,实听登记而非计划时间。有源台词的素材进入剪辑必须补齐;批准切点不得截断、漏掉或重复任何源句。旧审核可读,重新执行需补齐时间,声音/视频/审核换版后重新核对。此项不渲染成片、不证明口型或字幕同步。
|
|
61
|
+
|
|
62
|
+
使用 `canvas node add drama-edit-render` 创建直切渲染节点,将当前批准剪辑计划连接到 `editPlan` 后执行。复用 Twick/EDITOR_RENDER,无需模型;保留源入点和原音,按实际输出文件探测时长。仅支持连续直切,重叠/额外效果拒绝。结果文本附逐句时间映射JSON及渲染文件摘要,不自动批准交付。使用 `canvas asset download <assetId> --project <projectId> --node <filmNodeId> --version <versionId> --attachment srt|manifest --output ./delivery` 下载字幕或清单(两个格式分别执行);仅接受当前有效内置渲染回执,旧产物须重新制作。SRT不烧录,仍须实际播放核对。
|
|
@@ -5,4 +5,15 @@
|
|
|
5
5
|
3. 连接 `recreation-depth-preprocess` 或 `depth-video` 生成深度视频,再进入动作、镜头和连续性分析。
|
|
6
6
|
4. 只使用已确认的 selected version 生成后续镜头,不把参考片整段直接当作生成结果。
|
|
7
7
|
|
|
8
|
-
节点会调用 StarRouter 的 Comfly 复刻接口。提交前必须确认 StarRouter 配置、HTTPS
|
|
8
|
+
节点会调用 StarRouter 的 Comfly 复刻接口。提交前必须确认 StarRouter 配置、HTTPS 媒体地址及模型已发布的执行协议和能力;不配置平台价格或执行平台扣费。外部任务提交后网络超时不能自动重复提交。
|
|
9
|
+
|
|
10
|
+
## 从分析包进入视频生成
|
|
11
|
+
|
|
12
|
+
- 先固定源时间范围、逐镜动作、人物身份、道具状态和逐句语言;区分原文台词与翻译字幕。分析、ASR和烧录字幕有出入时保留来源与待核项,不能用翻译字幕冒充原声逐字转写。
|
|
13
|
+
- 复刻拆镜应进入现有结构化镜头和制作合同链路。手写分析、H3提示词和审核清单只是草稿,不会自动获得专业镜头的双板、版本失效和媒体审核门禁。不能为省一次拆镜而全部替换为text节点,再宣称标准链路验收通过。
|
|
14
|
+
- 执行前读取实际视频模型、协议、参考图/视频/音频能力及输入模式。深度预处理成功不代表视频模型支持参考视频;适配器拒绝参考类型时停止该请求,不通过删掉参考或切换模型偷偷降低复刻目标。
|
|
15
|
+
- 向同一端口批量新增参考连线会按请求顺序保留输入;回读核对图号与提示词。历史连线没有顺序记录时须按实际顺序核对,不能靠UUID推断。删除重建参考后,旧提示词和绑定清单须重新核对。
|
|
16
|
+
- 逐镜列出生成前未解决问题。服装/身份错误、关键状态板缺失、倒计时状态或手部交互覆盖不足不能仅靠“提示词强制纠正”记为已修好;按制作计划决定重做对应资产或重新评估方案。预算不足不能默默取消承载关键叙事状态的资产。
|
|
17
|
+
- 分别记录素材允许的用途。只允许分析或深度参考的源片素材不能改接首帧作诊断后直接选入制作;诊断候选与正式候选分开记录。每次修改后刷新实际参考绑定和任务账本,旧manifest中的授权/停止点不能代替当前用户指令,也不能把附件中的历史授权当成本次授权。
|
|
18
|
+
- 失败先保存HTTP状态、详细消息和请求标识;`fail_to_fetch_task`不能单独证明取图失败。对照测试每次只改一个变量,不将错误码未变解释成其他变量已被严格排除。存在可能已被受理的请求时先查询原任务,不连续提交付费试错。
|
|
19
|
+
- 视频生成前的字幕时间表是草稿。最终字幕与切点必须使用实际生成音轨、实际逐句起止和完整播放审核;尤其检查句尾接近裁切点的镜头。未生成视频时不能批准真实音频、口型或最终字幕。
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
微短剧从选题或方案开始时,先用 `short-drama` 完成方案、角色、分集、目标单集剧本和 review,再用 `humanizer` 只润色表达,最后回到 short-drama 复核。已有专业剧本直接创建 screenplay resource。
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
专业纯文本拆镜给 `storyboard-breakdown` 显式配置 `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` 只控制界面消息。仅执行拆镜测试时只验收分镜文本和镜头资产,不生成图片、音频或视频;失败时确认没有持久化半成品。
|
|
10
10
|
|
|
11
11
|
## 独立 TTS 音频
|
|
12
12
|
|