@aswless_854771076/ai_short_studio_cli 0.1.158 → 0.1.160

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/README.md +35 -5
  2. package/dist/command-helpers.js +1 -0
  3. package/dist/commands/canvas/asset/audit.d.ts +14 -0
  4. package/dist/commands/canvas/asset/audit.js +90 -0
  5. package/dist/commands/canvas/asset/select.d.ts +1 -0
  6. package/dist/commands/canvas/asset/select.js +1 -0
  7. package/dist/commands/canvas/continuity/analyze.js +1 -1
  8. package/dist/commands/canvas/document/save.d.ts +1 -0
  9. package/dist/commands/canvas/document/save.js +14 -0
  10. package/dist/commands/canvas/settings/set.d.ts +1 -0
  11. package/dist/commands/canvas/settings/set.js +2 -1
  12. package/dist/commands/preflight.js +28 -0
  13. package/dist/commands/skill/diff.d.ts +16 -0
  14. package/dist/commands/skill/diff.js +17 -0
  15. package/dist/domain/canvas-asset-audit.d.ts +53 -0
  16. package/dist/domain/canvas-asset-audit.js +112 -0
  17. package/dist/domain/canvas-document-contract.d.ts +49 -0
  18. package/dist/domain/canvas-document-contract.js +94 -0
  19. package/dist/skill/skill-manager.d.ts +64 -0
  20. package/dist/skill/skill-manager.js +69 -5
  21. package/package.json +1 -1
  22. package/scripts/postinstall.mjs +6 -1
  23. package/skills/using-vvicat-ai-short-studio-cli/SKILL.md +5 -3
  24. package/skills/using-vvicat-ai-short-studio-cli/references/assets-and-storyboard.md +8 -0
  25. package/skills/using-vvicat-ai-short-studio-cli/references/canvas-inspection.md +10 -0
  26. package/skills/using-vvicat-ai-short-studio-cli/references/canvas-media-gates.md +39 -0
  27. package/skills/using-vvicat-ai-short-studio-cli/references/canvas-production-principles.md +11 -0
  28. package/skills/using-vvicat-ai-short-studio-cli/references/commands/assets-and-tasks.md +3 -0
  29. package/skills/using-vvicat-ai-short-studio-cli/references/commands/canvas.md +4 -0
  30. package/skills/using-vvicat-ai-short-studio-cli/references/commands/project.md +3 -1
  31. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/SKILL.md +3 -3
  32. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/define-drama-brief/prompts/drama_brief.en.txt +3 -3
  33. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/define-drama-brief/prompts/drama_brief.zh.txt +3 -3
  34. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/feature-completeness.md +2 -2
  35. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/write-drama-video-prompts.md +1 -1
  36. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/module-map.json +130 -0
  37. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/pipeline.md +25 -0
  38. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/seedance-prompting.md +1 -1
  39. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-shot-continuity.md +3 -3
@@ -0,0 +1,94 @@
1
+ import { readFile } from 'node:fs/promises';
2
+ import { join } from 'node:path';
3
+ import { bundledSkillPath } from '../skill/skill-manager.js';
4
+ const MODULE_MAP_PATH = join(bundledSkillPath(), 'references', 'short-drama', 'module-map.json');
5
+ let contractsPromise = null;
6
+ async function loadContracts() {
7
+ try {
8
+ const raw = JSON.parse(await readFile(MODULE_MAP_PATH, 'utf8'));
9
+ if (!raw.documents || typeof raw.documents !== 'object' || Array.isArray(raw.documents))
10
+ return {};
11
+ return raw.documents;
12
+ }
13
+ catch {
14
+ return null;
15
+ }
16
+ }
17
+ function contracts() {
18
+ contractsPromise ??= loadContracts();
19
+ return contractsPromise;
20
+ }
21
+ /**
22
+ * 按服务端同一套规则解析文档键:先精确匹配登记键,再匹配 `ep-001.script` 这类带分集前缀的键。
23
+ * 与 `documentForModule` 保持一致,避免 CLI 放行、阶段却始终 missing。
24
+ */
25
+ export function matchDocumentContract(map, documentKey) {
26
+ if (map[documentKey])
27
+ return map[documentKey];
28
+ const key = Object.keys(map).find((candidate) => documentKey.endsWith(`.${candidate}`));
29
+ return key ? map[key] : null;
30
+ }
31
+ function isPlainObject(value) {
32
+ return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
33
+ }
34
+ function isPresent(value) {
35
+ return value !== undefined && value !== null;
36
+ }
37
+ function isEmptyValue(value) {
38
+ if (Array.isArray(value))
39
+ return value.length === 0;
40
+ if (typeof value === 'string')
41
+ return value.trim().length === 0;
42
+ if (isPlainObject(value))
43
+ return Object.keys(value).length === 0;
44
+ return false;
45
+ }
46
+ export function templatePathOf(contract) {
47
+ return `references/short-drama/assets/modules/${contract.module}/prompts/${contract.template_stem}.zh.txt`;
48
+ }
49
+ export function checkDocumentContent(map, documentKey, content) {
50
+ const contract = matchDocumentContract(map, documentKey);
51
+ if (!contract)
52
+ return { contract: null };
53
+ if (!isPlainObject(content))
54
+ return { contract, missing: [...contract.required_fields], empty: [] };
55
+ const missing = contract.required_fields.filter((field) => !isPresent(content[field]));
56
+ const empty = (contract.non_empty_fields ?? []).filter((field) => isPresent(content[field]) && isEmptyValue(content[field]));
57
+ return { contract, missing, empty };
58
+ }
59
+ /**
60
+ * 文档键的 schema-key 约定:`canvas.<document-key 末段>.v1`;审核记录统一用 `canvas.review.v1`。
61
+ * 服务端只校验 `canvas.*` 形状,写错不会报错,所以这里给出可修正的提示。
62
+ */
63
+ export function expectedSchemaKey(documentKey) {
64
+ const segment = documentKey.split('.').pop() ?? documentKey;
65
+ return `canvas.${segment}.v1`;
66
+ }
67
+ export async function validateCanvasDocumentContent(input) {
68
+ const warnings = [];
69
+ const map = await contracts();
70
+ if (!map) {
71
+ warnings.push('未找到随包 module-map.json 的文档合同,已跳过正文结构核对。');
72
+ return { contract: null, warnings };
73
+ }
74
+ const check = checkDocumentContent(map, input.documentKey, input.content);
75
+ if (!check.contract)
76
+ return { contract: null, warnings };
77
+ const expected = expectedSchemaKey(input.documentKey);
78
+ if (input.schemaKey !== expected && input.schemaKey !== 'canvas.review.v1') {
79
+ warnings.push(`--schema-key ${input.schemaKey} 与文档键 ${input.documentKey} 不一致,建议使用 ${expected}。`);
80
+ }
81
+ if (!check.missing.length && !check.empty.length)
82
+ return { contract: check.contract, warnings };
83
+ const problems = [
84
+ check.missing.length ? `缺少顶层字段:${check.missing.join('、')}` : '',
85
+ check.empty.length ? `以下字段为空:${check.empty.join('、')}` : '',
86
+ ].filter(Boolean).join(';');
87
+ const message = `文档 ${input.documentKey} 不符合 ${templatePathOf(check.contract)} 的输出合同:${problems}。`
88
+ + `先完整读取该模板,按它声明的顶层字段生成正文;只写摘要的占位文档会让后续阶段建立在空分析上。`;
89
+ if (input.allowPartial) {
90
+ warnings.push(`${message}(已按 --allow-partial 保存,该版本不得作为阶段依据)`);
91
+ return { contract: check.contract, warnings };
92
+ }
93
+ throw new Error(message);
94
+ }
@@ -11,6 +11,8 @@ export declare function skillStatus(target: string): Promise<{
11
11
  installed: boolean;
12
12
  managed: boolean;
13
13
  current: boolean;
14
+ state: "missing" | "unmanaged" | "modified" | "current" | "outdated";
15
+ outdated: boolean;
14
16
  packageVersion: string;
15
17
  installedVersion: string | null;
16
18
  modified: boolean;
@@ -29,16 +31,21 @@ export declare function installSkills(input: {
29
31
  installed: boolean;
30
32
  managed: boolean;
31
33
  current: boolean;
34
+ state: "missing" | "unmanaged" | "modified" | "current" | "outdated";
35
+ outdated: boolean;
32
36
  packageVersion: string;
33
37
  installedVersion: string | null;
34
38
  modified: boolean;
35
39
  } | {
36
40
  action: "skipped";
41
+ skipReason: "unmanaged" | "modified";
37
42
  name: "using-vvicat-ai-short-studio-cli";
38
43
  target: string;
39
44
  installed: boolean;
40
45
  managed: boolean;
41
46
  current: boolean;
47
+ state: "missing" | "unmanaged" | "modified" | "current" | "outdated";
48
+ outdated: boolean;
42
49
  packageVersion: string;
43
50
  installedVersion: string | null;
44
51
  modified: boolean;
@@ -49,6 +56,8 @@ export declare function installSkills(input: {
49
56
  installed: boolean;
50
57
  managed: boolean;
51
58
  current: boolean;
59
+ state: "missing" | "unmanaged" | "modified" | "current" | "outdated";
60
+ outdated: boolean;
52
61
  packageVersion: string;
53
62
  installedVersion: string | null;
54
63
  modified: boolean;
@@ -64,16 +73,21 @@ export declare function autoInstallSkills(root: string): Promise<{
64
73
  installed: boolean;
65
74
  managed: boolean;
66
75
  current: boolean;
76
+ state: "missing" | "unmanaged" | "modified" | "current" | "outdated";
77
+ outdated: boolean;
67
78
  packageVersion: string;
68
79
  installedVersion: string | null;
69
80
  modified: boolean;
70
81
  } | {
71
82
  action: "skipped";
83
+ skipReason: "unmanaged" | "modified";
72
84
  name: "using-vvicat-ai-short-studio-cli";
73
85
  target: string;
74
86
  installed: boolean;
75
87
  managed: boolean;
76
88
  current: boolean;
89
+ state: "missing" | "unmanaged" | "modified" | "current" | "outdated";
90
+ outdated: boolean;
77
91
  packageVersion: string;
78
92
  installedVersion: string | null;
79
93
  modified: boolean;
@@ -84,6 +98,8 @@ export declare function autoInstallSkills(root: string): Promise<{
84
98
  installed: boolean;
85
99
  managed: boolean;
86
100
  current: boolean;
101
+ state: "missing" | "unmanaged" | "modified" | "current" | "outdated";
102
+ outdated: boolean;
87
103
  packageVersion: string;
88
104
  installedVersion: string | null;
89
105
  modified: boolean;
@@ -98,6 +114,8 @@ export declare function skillStatuses(rootInput: string): Promise<{
98
114
  installed: boolean;
99
115
  managed: boolean;
100
116
  current: boolean;
117
+ state: "missing" | "unmanaged" | "modified" | "current" | "outdated";
118
+ outdated: boolean;
101
119
  packageVersion: string;
102
120
  installedVersion: string | null;
103
121
  modified: boolean;
@@ -112,6 +130,8 @@ export declare function installSkill(input: {
112
130
  installed: boolean;
113
131
  managed: boolean;
114
132
  current: boolean;
133
+ state: "missing" | "unmanaged" | "modified" | "current" | "outdated";
134
+ outdated: boolean;
115
135
  packageVersion: string;
116
136
  installedVersion: string | null;
117
137
  modified: boolean;
@@ -122,6 +142,8 @@ export declare function autoInstallSkill(target: string): Promise<{
122
142
  installed: boolean;
123
143
  managed: boolean;
124
144
  current: boolean;
145
+ state: "missing" | "unmanaged" | "modified" | "current" | "outdated";
146
+ outdated: boolean;
125
147
  packageVersion: string;
126
148
  installedVersion: string | null;
127
149
  modified: boolean;
@@ -132,21 +154,63 @@ export declare function autoInstallSkill(target: string): Promise<{
132
154
  installed: boolean;
133
155
  managed: boolean;
134
156
  current: boolean;
157
+ state: "missing" | "unmanaged" | "modified" | "current" | "outdated";
158
+ outdated: boolean;
135
159
  packageVersion: string;
136
160
  installedVersion: string | null;
137
161
  modified: boolean;
138
162
  action: "skipped";
163
+ skipReason: "unmanaged" | "modified";
139
164
  } | {
140
165
  name: "using-vvicat-ai-short-studio-cli";
141
166
  target: string;
142
167
  installed: boolean;
143
168
  managed: boolean;
144
169
  current: boolean;
170
+ state: "missing" | "unmanaged" | "modified" | "current" | "outdated";
171
+ outdated: boolean;
145
172
  packageVersion: string;
146
173
  installedVersion: string | null;
147
174
  modified: boolean;
148
175
  action: "updated" | "installed";
149
176
  }>;
177
+ /**
178
+ * 对比已安装 Skill 与随包版本,列出本地相对随包新增、缺失和内容不同的文件。
179
+ * 版本落后且被手工修改时,这是用户决定"合并还是覆盖"的唯一依据。
180
+ */
181
+ export declare function diffSkill(target: string): Promise<{
182
+ missing: string[];
183
+ extra: string[];
184
+ changed: string[];
185
+ comparedWith: "bundled";
186
+ bundledPath: string;
187
+ name: "using-vvicat-ai-short-studio-cli";
188
+ target: string;
189
+ installed: boolean;
190
+ managed: boolean;
191
+ current: boolean;
192
+ state: "missing" | "unmanaged" | "modified" | "current" | "outdated";
193
+ outdated: boolean;
194
+ packageVersion: string;
195
+ installedVersion: string | null;
196
+ modified: boolean;
197
+ }>;
198
+ /**
199
+ * 创作前的 Skill 状态摘要。preflight 用它把"CLI 已升级、Skill 停在旧版"暴露出来。
200
+ */
201
+ export declare function skillGate(environment?: NodeJS.ProcessEnv): Promise<{
202
+ skillReady: boolean;
203
+ name: "using-vvicat-ai-short-studio-cli";
204
+ target: string;
205
+ installed: boolean;
206
+ managed: boolean;
207
+ current: boolean;
208
+ state: "missing" | "unmanaged" | "modified" | "current" | "outdated";
209
+ outdated: boolean;
210
+ packageVersion: string;
211
+ installedVersion: string | null;
212
+ modified: boolean;
213
+ }>;
150
214
  export declare function withLegacySkillFields<T extends {
151
215
  root: string;
152
216
  current: boolean;
@@ -24,11 +24,21 @@ async function statusFor(name, target) {
24
24
  const installed = await exists(target);
25
25
  const manifest = installed ? await readManifest(target) : null;
26
26
  const installedChecksum = installed ? await directoryChecksum(target) : null;
27
+ const current = Boolean(manifest && manifest.packageVersion === packageVersion && installedChecksum === bundledChecksum);
28
+ const modified = Boolean(manifest && installedChecksum !== manifest.checksum);
29
+ const outdated = Boolean(manifest && manifest.packageVersion !== packageVersion);
30
+ // state 是给调用方和 Agent 的判断依据:自动更新只允许无修改的 outdated,其余必须由用户决定。
31
+ const state = !installed ? 'missing'
32
+ : !manifest ? 'unmanaged'
33
+ : modified ? 'modified'
34
+ : current ? 'current' : 'outdated';
27
35
  return {
28
36
  name, target, installed, managed: Boolean(manifest),
29
- current: Boolean(manifest && manifest.packageVersion === packageVersion && installedChecksum === bundledChecksum),
37
+ current,
38
+ state,
39
+ outdated,
30
40
  packageVersion, installedVersion: manifest?.packageVersion ?? null,
31
- modified: Boolean(manifest && installedChecksum !== manifest.checksum),
41
+ modified,
32
42
  };
33
43
  }
34
44
  export async function skillStatus(target) {
@@ -70,7 +80,8 @@ export async function installSkills(input) {
70
80
  continue;
71
81
  }
72
82
  if (current.installed && !input.force && (!current.managed || current.modified)) {
73
- results.push({ ...current, action: 'skipped' });
83
+ // 静默跳过会让 CLI 升级后 Skill 长期停在旧版本,必须把原因带回调用方。
84
+ results.push({ ...current, action: 'skipped', skipReason: current.managed ? 'modified' : 'unmanaged' });
74
85
  continue;
75
86
  }
76
87
  results.push({ ...await installOne(name, target), action: current.installed ? 'updated' : 'installed' });
@@ -101,10 +112,63 @@ export async function autoInstallSkill(target) {
101
112
  const current = await statusFor(name, target);
102
113
  if (current.current)
103
114
  return { action: 'unchanged', ...current };
104
- if (current.installed && (!current.managed || current.modified))
105
- return { action: 'skipped', ...current };
115
+ if (current.installed && (!current.managed || current.modified)) {
116
+ return { action: 'skipped', skipReason: current.managed ? 'modified' : 'unmanaged', ...current };
117
+ }
106
118
  return { action: current.installed ? 'updated' : 'installed', ...await installOne(name, target) };
107
119
  }
120
+ /**
121
+ * 对比已安装 Skill 与随包版本,列出本地相对随包新增、缺失和内容不同的文件。
122
+ * 版本落后且被手工修改时,这是用户决定"合并还是覆盖"的唯一依据。
123
+ */
124
+ export async function diffSkill(target) {
125
+ const name = BUNDLED_SKILL_NAMES[0];
126
+ const status = await statusFor(name, target);
127
+ const bundledRoot = bundledSkillPath(name);
128
+ const empty = { missing: [], extra: [], changed: [] };
129
+ if (!status.installed)
130
+ return { ...status, comparedWith: 'bundled', bundledPath: bundledRoot, ...empty };
131
+ const bundledFiles = new Set((await filesBelow(bundledRoot)).map((file) => relative(bundledRoot, file)));
132
+ const installedFiles = new Set((await filesBelow(target))
133
+ .map((file) => relative(target, file))
134
+ .filter((file) => file !== MANIFEST));
135
+ const missing = [...bundledFiles].filter((file) => !installedFiles.has(file)).sort();
136
+ const extra = [...installedFiles].filter((file) => !bundledFiles.has(file)).sort();
137
+ const changed = [];
138
+ for (const file of bundledFiles) {
139
+ if (!installedFiles.has(file))
140
+ continue;
141
+ const [bundledContent, installedContent] = await Promise.all([
142
+ readFile(join(bundledRoot, file)),
143
+ readFile(join(target, file)),
144
+ ]);
145
+ if (!bundledContent.equals(installedContent))
146
+ changed.push(file);
147
+ }
148
+ return { ...status, comparedWith: 'bundled', bundledPath: bundledRoot, missing, extra, changed: changed.sort() };
149
+ }
150
+ /**
151
+ * 创作前的 Skill 状态摘要。preflight 用它把"CLI 已升级、Skill 停在旧版"暴露出来。
152
+ */
153
+ export async function skillGate(environment = process.env) {
154
+ // 显式指定目录/根目录时只看该位置:用户已经用环境变量固定了 Skill 来源,不能再回退到默认目录。
155
+ if (environment.VVICAT_SKILL_DIRECTORY) {
156
+ return gateFor([environment.VVICAT_SKILL_DIRECTORY]);
157
+ }
158
+ if (environment.VVICAT_SKILLS_ROOT) {
159
+ const target = join(normalizeSkillsRoot(environment.VVICAT_SKILLS_ROOT), BUNDLED_SKILL_NAMES[0]);
160
+ return gateFor([target]);
161
+ }
162
+ return gateFor([defaultSkillTarget('codex'), defaultSkillTarget('agents')]);
163
+ }
164
+ async function gateFor(candidates) {
165
+ for (const target of candidates) {
166
+ const status = await statusFor(BUNDLED_SKILL_NAMES[0], target);
167
+ if (status.installed)
168
+ return { ...status, skillReady: status.current };
169
+ }
170
+ return { ...await statusFor(BUNDLED_SKILL_NAMES[0], candidates[0]), skillReady: false };
171
+ }
108
172
  export function withLegacySkillFields(result) {
109
173
  return { ...result.skills[0], root: result.root, allCurrent: result.current, skills: result.skills };
110
174
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aswless_854771076/ai_short_studio_cli",
3
- "version": "0.1.158",
3
+ "version": "0.1.160",
4
4
  "description": "VVICAT 无限画布项目命令行工具",
5
5
  "license": "MIT",
6
6
  "private": false,
@@ -24,7 +24,12 @@ export async function main(environment = process.env) {
24
24
  }
25
25
  : await autoInstallSkills(environment.VVICAT_SKILLS_ROOT || defaultSkillsRoot('codex'))
26
26
  for (const skill of result.skills) {
27
- process.stdout.write(`VVICAT Skill ${skill.name} ${skill.action}: ${skill.target}\n`)
27
+ // 跳过必须说明原因,否则 CLI 升级后 Skill 会静默停在旧版本。
28
+ const reason = skill.action !== 'skipped' ? ''
29
+ : skill.skipReason === 'modified'
30
+ ? ` (本地 Skill ${skill.installedVersion ?? '未知'} 已被手工修改,未覆盖为 ${skill.packageVersion};运行 ai-short-studio skill diff 查看差异,确认后再 skill install --force)`
31
+ : ` (目录不由 CLI 托管,未覆盖为 ${skill.packageVersion};运行 ai-short-studio skill diff 核对差异)`
32
+ process.stdout.write(`VVICAT Skill ${skill.name} ${skill.action}: ${skill.target}${reason}\n`)
28
33
  }
29
34
  } catch (error) {
30
35
  process.stderr.write(`VVICAT CLI 已安装,Skill 自动安装已跳过:${error instanceof Error ? error.message : String(error)}\n`)
@@ -9,6 +9,8 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
9
9
 
10
10
  ## 按需读取
11
11
 
12
+ 先遵循 [共享制作纪律](references/canvas-production-principles.md);只读检查现有画布时遵循 [共享画布检查流程](references/canvas-inspection.md)。媒体制作前读取 [共享媒体门禁](references/canvas-media-gates.md)。这些正文由 CLI 和内置助手共用;CLI 执行仍使用本 Skill 的命令合同。
13
+
12
14
  `SKILL.md` 只保留路由和主流程。按实际进度逐阶段读取命中的资料;长任务可以先后读取多份,但不要在开始时一次加载全部:
13
15
 
14
16
  - 项目创建、settings、批处理、目录或安全边界:[references/project-and-canvas.md](references/project-and-canvas.md)
@@ -54,11 +56,11 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
54
56
 
55
57
  ## 主流程
56
58
 
57
- 1. **预检与实时节点目录门禁**:运行 `preflight --json`;更新后重跑。再读取 `config get`、目标项目、`canvas documents` 和 `canvas workflow status`,并在创建或配置任何节点前读取 `canvas node types --json`。config 只写实时 `configSchema.properties` 声明的键;`title`、坐标和连线身份属于节点属性(`canvas node add --title`、`canvas node update --title`),不写入 `config`,`music-generate` 的 `title` 只是 Suno 模型参数,不得复制到其他节点;服务端或调用方拒绝未知配置字段时,删除该字段并按实时 schema 重试,不猜字段名。结构化短剧节点的输出按 `structuredOutputSchema` 组织,不能从 `TEXT`/`SCRIPT` 端口猜 JSON。`skill status --target codex` 非 current 时先询问再更新,禁止强制覆盖用户修改。
59
+ 1. **预检与实时节点目录门禁**:运行 `preflight --json`;更新后重跑。再读取 `config get`、目标项目、`canvas documents` 和 `canvas workflow status`,并在创建或配置任何节点前读取 `canvas node types --json`。config 只写实时 `configSchema.properties` 声明的键;`title`、坐标和连线身份属于节点属性(`canvas node add --title`、`canvas node update --title`),不写入 `config`,`music-generate` 的 `title` 只是 Suno 模型参数,不得复制到其他节点;服务端或调用方拒绝未知配置字段时,删除该字段并按实时 schema 重试,不猜字段名。结构化短剧节点的输出按 `structuredOutputSchema` 组织,不能从 `TEXT`/`SCRIPT` 端口猜 JSON。**Skill 版本门禁**:`preflight --json` 返回的 `skill.state` 不是 `current`(`outdated`、`modified`、`unmanaged`、`missing` 都算)时,停止创作并先处理——`modified`/`outdated` 先运行 `ai-short-studio skill diff --target codex --json`,把 `changed`/`extra`/`missing` 文件展示给用户,让其决定"保留改动并手工合并"还是"`skill install --force` 覆盖";`missing` 先 `skill install`。CLI 升级不会覆盖用户改过的 Skill,因此 CLI 版本新、Skill 停在旧版时,你运行的是旧规则,不得继续创作,也不得强制覆盖用户修改。
58
60
  2. **项目语言门禁**:新建项目前必须从用户确认交付语言,并用 `project create --language <BCP47>` 写入;界面 `--locale` 不能代替内容语言。创建后回读 `project get` 与 `canvas settings get`,确认两者语言一致且不可修改。项目语言约束剧本、分镜、台词、配音、画面文字和字幕;验收须区分剧情内容与制作信息:项目语言允许正常外语穿插和规范英文摄影术语,不按字符种类判死;道具文字和剧情内界面遵循来源原文。存在实际语言合同冲突时停止并说明。
59
61
  3. **项目配置门禁**:项目初始化时必须向用户展示并确认创作配置,不得只采用账户默认值:交付语言、画幅、目标时长、画风、分镜板策略、分析/文本模型、图片模型及其厂商、视频模型及其厂商、视频提示词协议、音频/配乐模型及其厂商、声音一致性方式、分辨率、画质、候选数量、参考素材和预计请求范围。先读取 `canvas settings get`,展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options;确认 `imageResolution`、`imageQuality` 和 `videoResolution` 后,再按标准创作门禁用 `--file settings.json` 原子写入并携带 `expectedVersion`,回读一致前不得创建或运行付费节点。`$ART_STYLE_ID` 必须解析实时 `option.value`。节点确需不同参数时才按实时能力覆盖,并记录覆盖原因;`automation_mode` 只能省略已确认且未变化的重复询问,不能替用户确认模型/厂商或付费范围。
60
- 4. **创作链路与自由画布文档**:按 `canvas workflow status` 返回的 `currentStage` 依次生成来源分析 → 创作简报 → 故事设定 → 分集大纲 → 单集剧本 → Humanizer 自然化 → 剧本审校 → 导演手册 → 资产计划;每步用 `canvas document save` 写入 `canvas.<module>.v1`,用 `--input` 固化上游选版,审核必须另存为 `canvas.review.v1` 并绑定被审核版本。无需先调用固定节点或生成模型,不要创建没有版本的文档空壳。已有自由画布文档直接复用;历史 `screenplay-resource` 或结构化资源先迁移成 自由画布文档,再继续流程。需要创作微短剧时,按需读取 `references/short-drama/`,再完整读取 [官方 Humanizer 快照](references/humanizer/humanizer.md)(来源见 [快照说明](references/humanizer/SOURCE.md))和 [短剧适配层](references/short-drama/creation/humanizer.md) 去除 AI 味;不得改动已经确认的剧情事实,剧本审校 P0/P1 未清零不得进入导演与资产阶段,润色后回到短剧 reference 复核。确认目标集数后,只生产该集实际需要的资产。
61
- 5. **资产门禁**:先完成人物、场景、道具及其派生版本。资产图分别用 `character-turnaround`、`location-image`(`locationImagePurpose: location-sheet`)、`prop-turnaround`,`prompt` 端口连接结构化设定节点;默认模板 `character_asset_sheet`、`scene_asset_sheet`、`prop_generate` 是参考正文,不得删除,也不得改用 `image-generate` 代替设定板。每批生成完成后必须用 `canvas asset download` 或等效预览能力取得真实候选,并在当前对话中展示候选缩略图/文件链接、资产 key、版本和用途;用户确认后才能写入 selected version。只在用户看过候选且确认后选版。执行资产—剧情匹配审计;缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
62
+ 4. **创作链路与自由画布文档**:按 `canvas workflow status` 返回的 `currentStage` 依次生成来源分析 → 创作简报 → 故事设定 → 分集大纲 → 单集剧本 → Humanizer 自然化 → 剧本审校 → 导演手册 → 资产计划。每步固定四件事,缺一步不算完成:①从 [文档键与内容合同](references/short-drama/pipeline.md#文档键与内容合同) 取登记的 `--document-key`,不能按节点标题或 module ID 自行拼写;②完整读取 `references/short-drama/assets/modules/<module>/prompts/` 下该模块的模板,按它声明“顶层必须且只能包含”的字段生成严格 JSON,不得只写 `summary`、`source_type` 一类自造字段或空数组;③用 `canvas document save` 写入 `canvas.<module>.v1`,并用 `--input` 固化上游选版;④用 `canvas documents` 和 `canvas document get` 回读,逐项确认必需字段是真实分析而不是占位。`canvas document save` 会按随包合同拦下缺字段和空字段文档,报错时补正文并重读模板,不得用 `--allow-partial` 把占位文档当成阶段产物。审核必须另存为 `canvas.review.v1` 并绑定被审核版本。无需先调用固定节点或生成模型,不要创建没有版本的文档空壳,也不要先铺一批空 `text-resource` 节点再补正文。已有自由画布文档直接复用;历史 `screenplay-resource` 或结构化资源先迁移成 自由画布文档,再继续流程。需要创作微短剧时,按需读取 `references/short-drama/`,再完整读取 [官方 Humanizer 快照](references/humanizer/humanizer.md)(来源见 [快照说明](references/humanizer/SOURCE.md))和 [短剧适配层](references/short-drama/creation/humanizer.md) 去除 AI 味;不得改动已经确认的剧情事实,剧本审校 P0/P1 未清零不得进入导演与资产阶段,润色后回到短剧 reference 复核。确认目标集数后,只生产该集实际需要的资产。
63
+ 5. **资产门禁**:先完成人物、场景、道具及其派生版本。资产图分别用 `character-turnaround`、`location-image`(`locationImagePurpose: location-sheet`)、`prop-turnaround`,`prompt` 端口连接结构化设定节点;默认模板 `character_asset_sheet`、`scene_asset_sheet`、`prop_generate` 是参考正文,不得删除,也不得改用 `image-generate` 代替设定板:它是透明边界,服务端不会为它追加三视图或九视角合同。提交资产生成前先运行 `canvas node list --project <projectId> --json` 逐项核对 `kind` 与 `prompt` 端口;出现用 `image-generate` 生成的人物、场景或道具图,必须用对应设定板节点重建并回读,旧候选只留作历史,不选版、不进入分镜和视频。**机器门禁**:资产计划文档保存并回读后、提交任何资产生成前,必须运行 `ai-short-studio canvas asset audit --project <projectId> --json`;只有 `ok: true` 才能继续,`errors` 非空(例如 `sheet-node-missing`,即计划里有资产却全部用 `image-generate`)时按 `nodeIds` 重建设定板节点后重跑,不得跳过或用手工核对代替。`warnings` 要逐条读并修正(手写 `config.prompt`、`prompt` 端口来源不是结构化设定节点、端口未接线、覆盖不全),`blocked: asset-plan-not-ready` 说明资产计划文档还没保存或未审核,回到第 4 步。每批生成完成后必须用 `canvas asset download` 或等效预览能力取得真实候选,并在当前对话中展示候选缩略图/文件链接、资产 key、版本和用途;用户确认后才能写入 selected version。只在用户看过候选且确认后选版。执行资产—剧情匹配审计;缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
62
64
  6. **拆镜与制作计划**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建默认专业拆镜,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2`,不自动新增首帧节点。结构化分镜之后依次生成逐镜制作计划和跨镜连续性计划;只有前镜已审核且选版时才允许 previous-tail。视频提交前必须完成素材连线、镜头逻辑和上下镜连续性审计。
63
65
  7. **分镜图与逐镜审计**:Agent 先读取每镜 `storyboard_strategy`,按制作目标选择单幅分镜图、时间故事版、镜头分镜板、专项板或 Blender;已选择一种板型时不得自动补生成另一种。只审核实际生成的板型,并让视频提示词只引用真实存在且已审核的分镜资产。逐镜审计 P0/P1 未清零不得写入视频提示词或提交视频。用户的停止阶段优先于 [滚动异步调度](references/async-pipeline.md):仅分镜图任务完成实际选择的板型并通过审核后停止,不运行视频提示词和视频。
64
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)。
@@ -39,6 +39,14 @@
39
39
 
40
40
  这些资产不得用 `image-generate` 生成:它是透明边界,只组合用户直填或连入的文本,不追加设定板或分镜板合同。每项资产使用独立节点和独立资产版本,`count` 的多结果不能拼图。模板变量必须由已选资产计划、已确认档案和完整画风对象填充,不保留占位符,不把临时 URL、节点标题或未选版素材写进正文。
41
41
 
42
+ 提交资产生成前执行节点类型核对,避免用错节点白付一次生成:
43
+
44
+ 1. 运行 `canvas node list --project <projectId> --json`,逐项读取 `kind`:人物只能是 `character-turnaround`,场景只能是 `location-image`,道具只能是 `prop-turnaround`,分镜板只能是 `storyboard-grid-image`、`storyboard-board-image` 或 `storyboard-image`。
45
+ 2. 人物、场景、道具的 `prompt` 必须来自结构化设定节点连线(`character-visual-design`、`location-resource`、`prop-resource`);`config.prompt` 不手写外观描述冒充设定,否则服务端合同与手写正文会互相拉扯。
46
+ 3. 发现 `image-generate` 承载上述任一资产时按错节点处理:新建正确节点、重连端口、回读新节点的 `kind` 与端口,再提交生成;已生成的候选只作历史,不选版、不进入分镜和视频。修改标题或补写 `config.prompt` 不能把普通生图补成设定板。
47
+ 4. 资产计划文档保存并回读后运行 `canvas asset audit --project <projectId> --json`:这是本节的机器门禁,命令会对照资产计划逐类统计设定板节点,`ok: false` 时按 `errors[].nodeIds` 重建设定板节点后重跑;`warnings` 中的 `sheet-config-prompt`、`sheet-prompt-source`、`sheet-prompt-unconnected`、`sheet-coverage-partial` 逐条修正,不能用手工核对替代。`blocked: asset-plan-not-ready` 表示资产计划文档未保存或未审核,先回到资产计划阶段。
48
+ 5. 生成后回读 `prompt` 与 `reference` 端口,确认没有悬空、临时 URL 或未选版素材,再下载真实候选交给用户确认。
49
+
42
50
  专业镜头的 `assetNodeRefs` 与 `visualAssetBindings` 共用镜头选版。通过下文专业增量修订流程,为每项设定来源绑定实际 `imageNodeId`,并把这些图片接到已选择板型的 `reference` 端口;不能按节点标题猜归属。每个绑定图片节点只能代表一个选定媒体,多候选需使用单项资源节点。服务端在付费板图前检查全部声明资产、上游真实设定边、选版与实际上送图片;提示词按实际数组编译身份和参考序号。修改绑定会使已选择板型及下游 stale;设定换版或文字投影变化同样使旧来源失效。所有已选择板型都审核通过仍要比较实际参考集合,差异不能由文字批准覆盖;引用覆盖不代表图像像素已符合设定。
43
51
 
44
52
  1. 只生产目标集实际出现的人物及形象版本、场景/子场景、关键道具及叙事版本。每项任务成功后展示真实预览,让用户确认并设置 selected version。
@@ -0,0 +1,10 @@
1
+ # 画布只读检查
2
+
3
+ 适用于了解现有画布、检查制作进度、定位缺失输入和版本风险。这个阶段不修改图、不创建任务、不切换选版,也不提交审核。
4
+
5
+ 1. 读取已授权的持久画布,记录真实 canvas version、目标节点、连接关系及截断/分页信息。若用户指定了读取版本,必须与实际版本核对;版本变化时停止应用旧分析,提示核对后重发。
6
+ 2. 读取目标节点的实时类型、端口和配置 schema。结构化输出以实时 structuredOutputSchema 为准,不能从 TEXT、SCRIPT 等端口名称猜 JSON 结构,也不能用文档示例替代实时 schema。
7
+ 3. 按真实输入连接逐项检查来源、语言、节点定义版本和缺失配置。区分“缺少输入”“任务尚未完成”“结果尚未审核”和“信息不足”;不要把任意一项归为已完成。
8
+ 4. 图或目录被截断时按返回 cursor 继续读取;无法完整读取时报告已检查的范围和缺口,不声称检查了全部节点。不要为扩大检查范围读取无关项目、分集或用户资产。
9
+ 5. 给出可定位的节点 ID、具体问题、所依据的版本,以及下一步所需能力。没有任务/资产/审核读取能力时,只报告图结构和配置事实,不能推断产物质量、当前选版或审核结论。
10
+ 6. 结束前确认没有执行任何写入或生成。结果列出已验证事实、待核对问题和用户可继续的操作,检查通过不能替代后续制作或审片门禁。
@@ -0,0 +1,39 @@
1
+ # 画布媒体制作门禁
2
+
3
+ 这是 CLI 与内置助手共用的制作规则;执行使用当前入口已发布的合同。节点名用于识别业务阶段,不是可以猜测或直接调用的接口。实时目录、当前选版和服务端门禁优先于示例。没有真实工具时停止,不使用外部 Runtime、Shell、插件或任意 URL 补齐能力。
4
+
5
+ ## 目标、语言与制作配置
6
+
7
+ 先确定目标分集、交付语言、片长、画幅、风格和停止阶段,复用已有剧本、节点及产物。项目输出语言创建后固定,界面语言不改变内容语言。只读取或修改当前入口支持的制作设置;模型、参数、时长与参考数量均取实时目录,不按模型名猜能力,不修改助手模型或供应商凭据。用户未授权生成时只做检查。
8
+
9
+ ## 剧本、导演与资产
10
+
11
+ 需要创作时,按真实节点及已确认输入推进来源分析、Brief、Bible、分集规划、单集剧本、剧本审查和导演手册;这些只是节点阶段,不能因为正文包含 approved 就宣布完成。已有专业剧本优先复用,不重复改编。open_questions、来源覆盖、改编边界或关键用户决定缺失时先补齐;不编造原文事实、人物和对白。
12
+
13
+ 资产分析后只制作目标集实际出现的人物形象、场景及道具。基础版与派生版保留真实引用,派生提示只声明允许变化。候选、当前选版和人工确认分开记录;不能按标题猜节点归属、按提交顺序猜资产,不能把同一图片冒充独立资源。结构化资源编辑保留其他条目、身份及不可变历史。
14
+
15
+ ## 拆镜与专业双板
16
+
17
+ 短剧专业链路按实时 schema 显式配置 sourceFormat、platform 与 storyboardPipelineVersion=2;不得因片长短、失败或用户只要图片而降级。原文、对白和镜头归属由源剧本及服务端编译决定;修改剧情先改来源,不通过镜头编辑伪造 sourceText/sourceUnitIds/speechUnits。硬镜数预算不可满足时修改目标或来源,不反复生成碰运气。
18
+
19
+ 拆镜成功后回读实际派生节点、父来源、镜号、板型和选版,不重复创建。每镜时间宫格 temporal/grid 与镜头故事版 shot/storyboard 是两张独立必需板,keyframe/single 不替代双板;count=1 不表示画面必须单格。板型、格数、布局、画幅及参考端口以当前节点目录和实际配置为准。缺少选择依据、来源、必需板或参考能力时停止,不削减参考绕过门禁。
20
+
21
+ 人物、场景、道具的真实资产绑定须与当前镜头选版一致,并连接到实际板图参考端口;不能写服务端维护的 production 来源字段。构图说明落到可见的站位、视线、前中后景、光源、动作方向与镜尾状态;没有来源或已确认调度依据时不补天气、陈设、武器或额外人物。修改镜头或上游选版后重查下游 stale 和时长覆盖,旧媒体保留历史,不改其真实时长。
22
+
23
+ ## 视频、声音与连续性
24
+
25
+ 视频只消费本镜当前双板、提示词、逐镜预检和连续性计划。两板分别获得有效人工审核后,仍须核对当前来源和实际参考集合。未决问题、连续性冲突、缺板、旧选版、失效审核或模型参考容量不足时不得生成;把 approved 改成 true 或删除参考都不能解决问题。连续性配置分析和提帧连线不等于媒体已生成或审核通过。
26
+
27
+ 逐镜审核画面、完整音轨、转场与字幕,核对角色、动作、语言、逐字对白、说话者、同步、环境声及未声明音乐。没有观看和听取能力时交给用户在现有审核面板完整查看,不伪造审核声明或审核人。音频计划是文本,不能冒充已生成声音;独立配音、音乐或提帧仅在实时目录具备对应能力且用户明确授权时执行。保留已确认的原生对白,不擅自用外部配音替换。
28
+
29
+ ## 任务、选版与交付
30
+
31
+ 只对输入和授权齐备的节点提交一次。任务成功、原生回执成功、产物选中、来源有效和人工批准是不同事实。任务未完成不提交依赖它的下游;同节点同输入已有在途任务时先查原任务。并发、预算、继续和停止采用当前入口限制,不照搬 CLI 默认并发或启动第二个调度器。失败或回执未知时核对原调用,不自动重试、换调用ID或重新付费生成。
32
+
33
+ 只到分镜图的目标在范围内必需板核对完成后停止,派生的视频节点不自动获得执行授权。停止助手不等于取消已提交媒体任务;取消须明确指定,已完成任务不能报告取消成功。换版遵从用户目标并复核下游,来源改变的历史结果不作为当前有效产物。
34
+
35
+ 剪辑只用当前有效且人工审核通过的精确素材版本,核对来源区间、成片区间、对白完整性、总时长和切点理由。编辑计划保存、计划批准、渲染完成和交付人工审片逐项区分。清单和字幕元信息不证明已观看;独立字幕 burnedIn=false 不能说字幕已经压入画面。下载使用现有附件入口,不编造文件链接。缺少声音平衡、转场、字幕或其他技术处理能力时列明缺口,不能靠软提示宣称实现。
36
+
37
+ ## 完成报告
38
+
39
+ 按本次停止阶段报告真实节点、任务、资产及精确版本、实际核对范围、人工审核状态与未解决问题。经验加载不是阶段完成;未归属的操作或缺少受控证据的阶段只能记活动/待核对,不把任务完成或计划文字标成绿色验收。未完成的分页、被裁剪的说明和用户尚未查看的媒体都要说明范围。
@@ -0,0 +1,11 @@
1
+ # 画布制作的事实与阶段纪律
2
+
3
+ 本文件是 CLI 与内置助手共用的制作经验。执行接口由当前入口提供,不能从经验正文推导出不存在的工具或权限。
4
+
5
+ 1. 先确定用户目标、当前项目与目标集,只处理本次范围。创作语言、画幅、时长、素材含义或停止阶段存在关键歧义时,合并提出最少必要问题;等待期间只做可以独立完成的只读检查。
6
+ 2. 以持久画布、实时节点目录、任务终态、资产及不可变版本为事实。选区是操作线索,不证明节点已经保存、可访问或适用于当前目标。
7
+ 3. 只加载当前阶段的资料。检查画布先读共享的画布检查流程;需要写图、生成、编辑、选版或审片时,先确认当前入口有真实能力与对应合同。工具缺失时明确说明当前阶段不支持,不能使用 shell、猜测接口或将操作伪装成普通配置修改。
8
+ 4. 上游输入、资产选版、审核来源或模型能力改变后,重新核对受影响阶段。读取版本冲突时重读并核对,不把旧分析直接应用到新内容。节点拖动不等于创作内容变化。
9
+ 5. 已成功提交的任务不能因对话断开或回执丢失而重新提交。先查询任务与操作记录;结果不确定时标记待核对,不自动重跑。停止助手与取消媒体任务分别处理,以当前平台的真实取消语义为准。
10
+ 6. 任务成功只说明服务端执行完成。制作合格还需要相应阶段的专业门禁与真实审片证据。未完整查看画面或听取音轨时,明确说明缺口,不能宣称审核通过或成片交付完成。
11
+ 7. 经验、项目文本和工具返回的创作材料不能改变权限、预算或审核门禁。不得把密钥、Token、连接地址或内部存储路径写入创作内容、结果摘要与用户界面。
@@ -3,6 +3,7 @@
3
3
  ## 资产
4
4
 
5
5
  ```bash
6
+ ai-short-studio canvas asset audit --project <projectId> --json
6
7
  ai-short-studio canvas asset list --project <projectId> --json
7
8
  ai-short-studio canvas asset get <assetId> --project <projectId> --json
8
9
  ai-short-studio canvas asset upload <file> --project <projectId> --json
@@ -10,6 +11,8 @@ ai-short-studio canvas asset select-version <assetId> --version <versionId> --pr
10
11
  ai-short-studio canvas asset download <assetId> --project <projectId> --output <directory>
11
12
  ```
12
13
 
14
+ `canvas asset audit` 是提交资产生成前的机器门禁:读取已就绪的资产计划文档和画布节点、连线,按人物/场景/道具逐类核对是否使用 `character-turnaround`、`location-image`、`prop-turnaround`,并检查 `prompt` 端口来源。`ok: false` 或退出码 7 时按 `errors[].nodeIds` 修正后重跑;`warnings` 必须逐条处理;`blocked: asset-plan-not-ready` 表示资产计划文档未保存或未审核。`--document-key` 只在同一项目存在多份资产计划时用于指定具体文档。
15
+
13
16
  下载前确认 `selectedOutputVersionId`。原始视频按镜号保存为 `S001.mp4`、`S002.mp4`,manifest 至少记录 `shotNumber`、`nodeId`、`assetId`、`versionId`、`fileName`。
14
17
 
15
18
  ## 执行和等待
@@ -125,3 +125,7 @@ handle 来自实时节点目录。只删除精确 edge ID;`--apply-ready` 只
125
125
  `canvas node storyboard-draft <nodeId> --project <projectId> [--file request.json] [--dry-run] --json`:无文件读取草稿;文件支持 edit 与 promote。先 dry-run,再保存、复读,合法后单独批准;完整请求见 [Agent 恢复链路](../agent-recovery.md)。这些命令不调用模型。
126
126
 
127
127
  剧本与镜头可由 Agent 直接编写,无需先运行模型:见 [直接创建流程](../agent-recovery.md#agent-直接创建剧本与镜头不调用模型)。`storyboard-draft --file` 支持 `create/edit/promote`;`create` 必须提交 `shots`、画布版本、基础草稿版本(首次为 null)及唯一 requestId。
128
+
129
+ ## 节点选版与资产全局选版
130
+
131
+ `canvas asset select-version`(或 `asset select`)修改资产全局选版,不覆盖任何节点的 `selectedOutputVersionId`。网页“查看版本”和内置 `canvas_select_version` 只切换目标节点、保留兄弟节点与全局选版,并使下游过期;运行中节点不可切版。读取节点内容和编辑基线时优先使用节点固定版本。CLI 没有把全局选版命令自动转换为节点切版;需要更改固定版本时使用网页节点入口,不能用普通 config patch 写服务端选版字段。
@@ -5,12 +5,14 @@
5
5
  ```bash
6
6
  ai-short-studio preflight --json
7
7
  ai-short-studio skill status --target codex --json
8
+ ai-short-studio skill diff --target codex --json
9
+ ai-short-studio skill install --target codex --force
8
10
  ai-short-studio auth login
9
11
  ai-short-studio auth status --json
10
12
  ai-short-studio auth logout
11
13
  ```
12
14
 
13
- 更新 CLI 后重跑 preflight。CLI 默认通过 MemHub 浏览器授权登录。
15
+ 更新 CLI 后重跑 preflight。CLI 默认通过 MemHub 浏览器授权登录。`preflight` 返回的 `skill` 块给出 Skill 状态和 `skillReady`;`state` 不是 `current` 时不得继续创作。`skill diff` 对照随包版本列出 `changed`、`extra`、`missing`,用于在“手工合并用户改动”和 `skill install --force` 覆盖之间做决定;`--force` 会丢弃用户改过的 Skill,只在用户明确同意后使用。
14
16
 
15
17
  ## 项目与供应商
16
18
 
@@ -16,9 +16,9 @@ description: 短剧全流程唯一入口。用于原创短剧的创建、恢复
16
16
  2. 新项目读取 [项目管理模块](operations/manage-drama-projects.md) 后初始化;AI Short Studio 项目先运行 `canvas documents` 和 `canvas workflow status`。
17
17
  3. 运行 `ai-short-studio canvas workflow status --project <projectId> --json`,以远程画布状态和文档版本作为唯一事实来源;不要用本地状态文件覆盖。
18
18
  4. 对返回的每个 `module_id`,从本目录 `module-map.json` 读取唯一 `path`(相对插件根目录),完整读取该 reference 后执行其输入、输出、失败关闭和验收合同。
19
- 5. 文本由 Codex 生成;只有图片、视频、声音和媒体变换调用 Provider。所有提示词使用 `assets/modules/<module_id>/prompts/` 中登记的模板。
20
- 6. 每个模块完成后,把实际输入、已选版本和验收证据保存为新的 `canvas.<module>.v1` 文档版本,并用 `--input` 记录上游版本;不得用本地状态文件或本地完成标记代替服务端版本。
21
- 7. 运行 `canvas workflow status` 复核当前阶段;只有当前及已完成阶段的文档、资产、审核和选版证据全部有效时才进入下一阶段。修改上游事实时回退受影响阶段并追加新版本,不手改完成状态。
19
+ 5. 文本由 Codex 生成;只有图片、视频、声音和媒体变换调用 Provider。所有提示词使用 `references/short-drama/assets/modules/<module_id>/prompts/` 中登记的模板。生成文档正文前必须完整读取该模块的模板,输出以其“顶层必须且只能包含”的字段为准;不得按节点标题或自己的摘要字段臆造结构。
20
+ 6. 每个模块完成后,把实际输入、已选版本和验收证据保存为新的 `canvas.<module>.v1` 文档版本,并用 `--input` 记录上游版本;不得用本地状态文件或本地完成标记代替服务端版本。文档键取 [文档键与内容合同](pipeline.md#文档键与内容合同) 的登记值,`canvas document save` 会按合同核对正文,缺字段时先补正文而不是改用 `--allow-partial`。
21
+ 7. 运行 `canvas workflow status` 复核当前阶段;只有当前及已完成阶段的文档、资产、审核和选版证据全部有效时才进入下一阶段。修改上游事实时回退受影响阶段并追加新版本,不手改完成状态。`ready` 只表示文档键、版本和来源快照有效,不证明正文有分析内容;推进前用 `canvas document get` 回读正文并对照模板字段。
22
22
 
23
23
  ## 九阶段基础路由
24
24
 
@@ -14,10 +14,10 @@ Execution role: short-drama production planner. Turn the source analysis and use
14
14
  {market_inspiration}
15
15
 
16
16
  Rules:
17
- 1. Put every unresolved parameter that changes the creative result in open_questions, use null for its field, and set approved to false.
18
- 2. Use BCP 47 language tags and record output text, spoken dialogue, and subtitle language separately.
17
+ 1. For every unresolved parameter that changes the creative result, set its field to null and add one open_questions item naming the field and the open question; open_questions must be an array and approved must be false.
18
+ 2. language and subtitle_language are BCP 47 strings for delivery/dialogue language and subtitle language; use null for an unconfirmed subtitle language and add an open_questions item when dialogue and delivery languages differ.
19
19
  3. Never choose episode count, duration, aspect ratio, platform, rating, or ending type from convention. episode_duration_seconds is a planning target, not an exact frame-level cutoff; treat it as a hard maximum only when the platform explicitly imposes one.
20
- 4. Keep adaptation_mode consistent with source-analysis and record adaptation boundaries in creative_constraints.
20
+ 4. adaptation_mode is exactly original, faithful_adaptation, or authorized_adaptation, and must match source-analysis; record adaptation boundaries in creative_constraints.
21
21
  5. approved may be true only after open_questions is empty and the user has confirmed the whole brief.
22
22
  6. Write market_inspiration_ref only when the user explicitly selects market inspiration, preserving that inspiration artifact's complete report_ref exactly; otherwise use null. This reference cannot override source facts, compliance requirements, or user-confirmed decisions.
23
23
 
@@ -14,10 +14,10 @@
14
14
  {market_inspiration}
15
15
 
16
16
  规则:
17
- 1. 未由用户确认且会改变创作结果的参数写入 open_questions,对应字段用 null,approved 必须为 false。
18
- 2. 语言使用 BCP 47;分别记录交付文本、人物说话和字幕语言。
17
+ 1. 未由用户确认且会改变创作结果的参数,对应字段用 null,并把字段名和待确认问题作为一项写入 open_questions;open_questions 必须是数组,approved 必须为 false。
18
+ 2. language 与 subtitle_language 使用 BCP 47 字符串,分别记录交付/对白语言与字幕语言;字幕语言未确认时为 null,对白与交付语言不同时写入 open_questions。
19
19
  3. episode_count、episode_duration_seconds、画幅、平台、分级和结局类型不得从行业惯例自动代选。episode_duration_seconds 是单集策划目标,不是要求成片逐秒精确命中的硬截止;只有平台明确限长时才作为上限。
20
- 4. adaptation_mode 和 source-analysis 一致;改编边界写入 creative_constraints。
20
+ 4. adaptation_mode 只能是 original、faithful_adaptation 或 authorized_adaptation,并与 source-analysis 一致;改编边界写入 creative_constraints。
21
21
  5. approved 只有在 open_questions 为空且用户已确认整份简报后才能为 true。
22
22
  6. 只有用户明确选用市场灵感时才写入 market_inspiration_ref,并逐字保留所选灵感产物的完整 report_ref;否则必须为 null。该引用不能代替来源事实、合规要求或用户确认的决定。
23
23
 
@@ -14,9 +14,9 @@
14
14
  | 导演本 | `write-drama-director-book` | 场次导演合同单独保存 |
15
15
  | 剧本自然化与复核 | `humanizer`、`review-drama-script` | 新版本落盘,复核版本必须匹配所选剧本;合规清单形成硬门禁 |
16
16
  | 人物、场景、道具分析 | `plan-drama-assets`、三类资产 Skills | 证据化提取、版本和未决项门禁 |
17
- | 人物/场景/道具设定板 | 各资产生成 Skill、人物吸引力审核、人物吸引力审核 | 人物含脸部、三主视图与辅助设定;成年魅力、儿童可爱保护、专属妆造和记忆锚点使用不可互相补偿的生成与选版门禁;场景含九视角、平面/轴测;道具含主视图、三视图与结构细节 |
17
+ | 人物/场景/道具设定板 | 各资产生成 Skill、人物吸引力审核 | 人物含脸部、三主视图与辅助设定;成年魅力、儿童可爱保护、专属妆造和记忆锚点使用不可互相补偿的生成与选版门禁;场景含九视角、平面/轴测;道具含主视图、三视图与结构细节 |
18
18
  | 分镜与镜头修订 | storyboard/revision Skills | 资产白名单、来源覆盖、连续性与版本化 |
19
- | 镜头组、跨镜空间与尾帧承接 | `shot_group`、`plan-shot-continuity`、上一镜尾帧承接、上一镜尾帧承接 | 校验叙事组连续性;按 previous-tail 链派生生成组,不同组并行、同组串行;只从已审核 selected 上一镜派生带 SHA-256 来源链的首帧 |
19
+ | 镜头组、跨镜空间与尾帧承接 | `shot_group`、`plan-shot-continuity`、`previous-tail` 尾帧承接 | 校验叙事组连续性;按 `previous-tail` 链派生生成组,不同组并行、同组串行;只从已审核 selected 上一镜派生带 SHA-256 来源链的首帧 |
20
20
  | 分镜图、视频提示词、镜头视频 | storyboard image/video Skills | 视频提示词按 Seedance 2.0、MiniMax H3 或已确认通用协议编译并本地版本化;由 Provider 实时能力控制参数 |
21
21
  | 原生声音与外部音频 | `design-drama-audio`、原生音频审核步骤 | native-first 路由、电影感旁白、受控 TTS(以实时目录为准,百炼 CosyVoice 可用时可用于设计/克隆音色)、七维复听和已授权外部音频;七维后配兜底和口型驱动仍停用 |
22
22
  | 授权配乐目录 | [授权音乐目录与导入边界](music-catalog-providers.md)、音乐授权记录、`music-generate` 节点 | 剧情条件编译、官方入口、本地试听下载边界、不可变许可证收据与时间线用途校验 |