@aswless_854771076/ai_short_studio_cli 0.1.132 → 0.1.133

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.
@@ -2,7 +2,7 @@ import { Args, Flags } from '@oclif/core';
2
2
  import { BaseCommand } from '../../../base-command.js';
3
3
  import { canvasEditConflictReason, commandApi, projectFlag, readJsonInput, resolveCanvasNodeVersionId, } from '../../../command-helpers.js';
4
4
  export default class CanvasNodeEditShot extends BaseCommand {
5
- static description = '追加镜头修订版本;来源原文只读,别名冲突会拒绝。修改时长后检查返回的 durationOverrides,确认下游手工覆盖。';
5
+ static description = '追加镜头修订版本;专业镜头同步父汇总并执行完整校验,建议用 revise-storyboard 先预览。来源原文只读,别名冲突会拒绝;409 后重新审阅,跨镜合同须批量修订。检查 durationOverrides 确认下游手工覆盖。';
6
6
  static args = { nodeId: Args.string({ required: true }) };
7
7
  static flags = {
8
8
  ...BaseCommand.baseFlags,
@@ -22,6 +22,9 @@ function readUpdate(value) {
22
22
  if (!value || typeof value !== 'object' || Array.isArray(value))
23
23
  throw new Error('updates 每一项必须是对象');
24
24
  const update = value;
25
+ const unknown = Object.keys(update).filter((key) => !['nodeId', 'set', 'unset', 'title', 'x', 'y'].includes(key));
26
+ if (unknown.length)
27
+ throw new Error(`未知更新字段:${unknown.join(', ')}${unknown.includes('config') ? ';配置字段请放入 set 对象' : ''}`);
25
28
  if (typeof update.nodeId !== 'string' || !update.nodeId)
26
29
  throw new Error('updates.nodeId 不能为空');
27
30
  if (update.set !== undefined && (!update.set || typeof update.set !== 'object' || Array.isArray(update.set))) {
@@ -37,6 +40,10 @@ function readUpdate(value) {
37
40
  }
38
41
  if (update.title !== undefined && typeof update.title !== 'string')
39
42
  throw new Error(`节点 ${update.nodeId} 的 title 必须是字符串`);
43
+ if (!Object.keys((update.set ?? {})).length && !update.unset?.length
44
+ && update.title === undefined && update.x === undefined && update.y === undefined) {
45
+ throw new Error(`节点 ${update.nodeId} 没有更新字段`);
46
+ }
40
47
  return {
41
48
  nodeId: update.nodeId,
42
49
  set: update.set,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aswless_854771076/ai_short_studio_cli",
3
- "version": "0.1.132",
3
+ "version": "0.1.133",
4
4
  "description": "VVICAT 无限画布项目命令行工具",
5
5
  "license": "MIT",
6
6
  "private": false,
@@ -54,7 +54,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
54
54
  ## 主流程
55
55
 
56
56
  1. **预检**:运行 `preflight --json`;更新后重跑。再读取 `config get`、实时 `canvas node types` 和目标项目。`skill status --target codex` 非 current 时先询问再更新,禁止强制覆盖用户修改。
57
- 2. **项目语言门禁**:新建项目前必须从用户确认交付语言,并用 `project create --language <BCP47>` 写入;界面 `--locale` 不能代替内容语言。创建后回读 `project get` 与 `canvas settings get`,确认两者语言一致且不可修改。项目语言约束剧本、分镜、台词、配音、画面文字和字幕;任何下游节点含有不同语言时停止执行。
57
+ 2. **项目语言门禁**:新建项目前必须从用户确认交付语言,并用 `project create --language <BCP47>` 写入;界面 `--locale` 不能代替内容语言。创建后回读 `project get` 与 `canvas settings get`,确认两者语言一致且不可修改。项目语言约束剧本、分镜、台词、配音、画面文字和字幕;验收须区分剧情内容与制作信息:项目语言允许正常外语穿插和规范英文摄影术语,不按字符种类判死;道具文字和剧情内界面遵循来源原文。存在实际语言合同冲突时停止并说明。
58
58
  3. **项目配置门禁**:读取 `canvas settings get`,展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options。确认 `aspectRatio`、`artStyle`、`visualBible`、`storyboardImageType`、`outputLanguage`、`analysisModel`、`imageModel`、`imageResolution`、`imageQuality` 和 `videoResolution`,以及 `editModel`、`videoModel`、`videoPromptType`、`audioModel`、`musicModel`;`$ART_STYLE_ID` 必须解析实时 `option.value`。标准创作门禁使用 `--file settings.json` 原子写入并携带 `expectedVersion`,回读一致前不得创建或运行付费节点。节点确需不同参数时才按实时能力覆盖。
59
59
  4. **剧本和目标集**:已有专业剧本时直接复用,不得重复执行 `novel-to-script`。需要创作微短剧时,按需读取 `references/short-drama/`,再读取 `references/humanizer/` 去除 AI 味;不得改动已经确认的剧情事实,润色后回到短剧 reference 复核。确认目标集数后,只生产该集实际需要的资产。
60
60
  5. **资产门禁**:先完成人物、场景、道具及其派生版本,展示真实预览并确认 selected version。执行资产—剧情匹配审计;缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
@@ -26,13 +26,13 @@
26
26
 
27
27
  ## 资产生产门禁
28
28
 
29
- 专业镜头的 `assetNodeRefs` 与 `visualAssetBindings` 共用镜头选版。通过 `canvas node edit-shot --file` 明确为每项设定来源绑定实际 `imageNodeId`,并把这些图片接到两板的 `reference` 端口;不能按节点标题猜归属。每个绑定图片节点只能代表一个选定媒体,多候选需使用单项资源节点。服务端在付费板图前检查全部声明资产、上游真实设定边、选版与实际上送图片;提示词按实际数组编译身份和参考序号。修改绑定会使两板及下游 stale;设定换版或文字投影变化同样使旧来源失效。两板都审核通过仍要比较实际参考集合,差异不能由文字批准覆盖;引用覆盖不代表图像像素已符合设定。
29
+ 专业镜头的 `assetNodeRefs` 与 `visualAssetBindings` 共用镜头选版。通过下文专业增量修订流程,为每项设定来源绑定实际 `imageNodeId`,并把这些图片接到两板的 `reference` 端口;不能按节点标题猜归属。每个绑定图片节点只能代表一个选定媒体,多候选需使用单项资源节点。服务端在付费板图前检查全部声明资产、上游真实设定边、选版与实际上送图片;提示词按实际数组编译身份和参考序号。修改绑定会使两板及下游 stale;设定换版或文字投影变化同样使旧来源失效。两板都审核通过仍要比较实际参考集合,差异不能由文字批准覆盖;引用覆盖不代表图像像素已符合设定。
30
30
 
31
31
  1. 只生产目标集实际出现的人物及形象版本、场景/子场景、关键道具及叙事版本。每项任务成功后展示真实预览,让用户确认并设置 selected version。
32
32
  2. 每个形象候选使用独立输入、独立三视图节点和独立图片资产;`count` 的多个结果也不能拼图。视觉素材未另行指定时使用 16:9,并按实时 schema 显式写入。
33
33
  3. 真/假、原版/复制、成年/童年等成对资源必须先生成基础版并确认,再把基础版 `image-resource` 作为 reference 生成派生版;prompt 只枚举允许差异,其余保持一致。
34
34
  4. 每个分镜拆解节点只连接一条目标集剧本,以及该集全部确认人物、场景和道具。素材缺失、未选版、映射歧义或连线不足时禁止执行。
35
- 5. 结构化剧本的镜号、顺序和来源由服务端确定性编译,模型只补摄影、表演和画面。显式 `maxShotCount` 是硬预算;任务在模型调用前报 `STORYBOARD_SHOT_BUDGET_INFEASIBLE` 时必须放宽预算或缩短剧本,不得反复提交同一任务碰运气。
35
+ 5. 结构化剧本的镜号、顺序和来源由服务端确定性编译,模型只补摄影、表演和画面。镜头数和总时长预算是质量建议,超出时保留软提示,不拒绝合法规划;来源覆盖、对白时长和双板等硬合同仍须满足。
36
36
  6. 拆镜成功后刷新画布并复用自动创建的 shot/image/prompt 节点;按 `parentAssetId`、`producerNodeId` 和集号核对归属,不按任务提交顺序猜测。
37
37
 
38
38
  ## 专业时间宫格与镜头故事版
@@ -45,7 +45,7 @@
45
45
 
46
46
  ## 拆镜语言匹配门禁
47
47
 
48
- 拆镜前先输出并核对一行语言契约:`源剧本语言 / 用户交付语言 / 项目 outputLanguage / 节点 targetLanguage / H3 人声语言 / 字幕语言`。项目交付语言在创建时确定,创建后不可修改;专有名词、品牌、咒语或剧情要求保留的外语另列白名单,除此之外任一项不明确或冲突都禁止执行。
48
+ 拆镜前先输出并核对一行语言契约:`源剧本语言 / 用户交付语言 / 项目 outputLanguage / 节点 targetLanguage / H3 人声语言 / 字幕语言`。项目交付语言在创建时确定,创建后不可修改;正常外语穿插、专有名词、品牌和规范英文摄影术语按语义与来源复核,不要求逐词白名单;实际交付语言合同不明确或冲突时禁止执行。
49
49
 
50
50
  - **普通拆镜**:直接使用项目创建时的规范 BCP 47 `outputLanguage`,如 `en`、`ar`、`fr`、`pt-BR`、`zh-Hant`;不能留空、自动猜测或通过 settings 修改。节点若残留 `targetLanguage`,先按实时 schema 清除,避免把专业模式字段误当普通模式覆盖。
51
51
  - **专业拆镜**:提交任务的目标语言取项目 `outputLanguage`;缺少有效项目语言时在入队前拒绝。Worker 再核对项目与任务语言,不一致时返回 `STORYBOARD_PROJECT_LANGUAGE_MISMATCH`。Markdown 源文件必须为对白、旁白、屏显和标题提供同标签本地化块,例如 `- **PT-BR:** ...`;JSON 直接保留 `scenes[].content[]` 原文,执行前确认其符合项目交付语言。CLI `--locale` 只控制界面消息。
@@ -53,11 +53,11 @@
53
53
 
54
54
  专业新建使用 `canvas node add storyboard-breakdown --source-format screenplay-json.v1 --platform short-drama`,Markdown 改为 `screenplay-markdown.v1`。无该参数的新建仍是普通自由文本。历史节点须通过 `node update` 显式升级,先连接一份可解析的选定剧本;保存失败整笔回滚,成功保留旧选版并标记本节点及下游过期。运行中的拆镜任务结束后才能切换。
55
55
 
56
- 专业拆镜的 `canvas node types` 提供 `structuredOutputSchema`,包括八组导演字段及双时长:`duration` 为 5~15 秒生成素材,`edit_plan.intended_duration` 为正数剪辑保留秒数,可小于 5 秒,不得超过素材长度且须容纳对白与旁白。编辑保留时长使用 `edit-shot` 的 `edit_plan.intended_duration`,不把整镜导演合同替换成只剩时长的对象。专业预算按保留时间汇总,超出显式镜头数或目标时长 120% 时纠错;未设镜头上限时没有固定 16 镜限制。来源或导演缺陷最多三次拆镜调用,失败后修复拥有缺陷的阶段,禁止手写独立提示词绕过。
56
+ 专业拆镜的 `canvas node types` 提供 `structuredOutputSchema`,包括八组导演字段及双时长:`duration` 为 5~15 秒生成素材,`edit_plan.intended_duration` 为正数剪辑保留秒数,可小于 5 秒,不得超过素材长度且须容纳对白与旁白。编辑保留时长按下文增量修订流程提交 `edit_plan.intended_duration`,不把整镜导演合同替换成只剩时长的对象。专业预算按保留时间汇总,超出建议镜头数或目标时长时作为软提示复核,不仅为预算反复纠错;未设镜头上限时没有固定 16 镜限制。来源或导演缺陷最多三次拆镜调用,失败后修复拥有缺陷的阶段,禁止手写独立提示词绕过。
57
57
 
58
- 拆镜完成后不抽样,逐镜检查所有语言字段:场景标题、description/action、对白、旁白、表演说明、摄影计划、图像提示词和视频提示词。专业流程还必须确认没有 `STORYBOARD_LANGUAGE_MISMATCH`;普通流程没有同等级服务端校验时,由本审计补齐。白名单外出现其他语言、台词被翻译成错误目标语言、角色名被错误翻译或同一镜混入两种输出语言,均记为 P1。
58
+ 拆镜完成后不抽样,逐镜检查所有语言字段:场景标题、description/action、对白、旁白、表演说明、摄影计划、图像提示词和视频提示词。专业流程还必须确认没有 `STORYBOARD_LANGUAGE_MISMATCH`;普通流程没有同等级服务端校验时,由本审计补齐。只对实际语言合同冲突记 P1,例如对白被翻译成错误目标语言或人物身份被错误翻译;正常语言穿插、来源内道具文字和 CU/OTS/pan 等规范术语不因此判错。
59
59
 
60
- 全局错配先修正 settings/config 后重跑 `storyboard-breakdown`;仅单镜偶发错词且其他镜头语言正确时,使用 `canvas node edit-shot` 精确追加修正版并重新执行该镜后续链路。不得通过只改字幕掩盖错误台词或错误旁白。
60
+ 全局错配先修正 settings/config 后重跑 `storyboard-breakdown`;仅单镜描述或提示词偶发错词且其他镜头语言正确时,专业镜头通过增量修订流程精确追加修正版;对白、旁白和来源合同只读,须回源修正后重新拆镜。不得通过只改字幕掩盖错误台词或错误旁白。
61
61
 
62
62
  ## 分镜素材连线门禁
63
63
 
@@ -93,12 +93,12 @@ P0/P1 必须清零;只修复受影响镜头或边,禁止全量重建掩盖
93
93
 
94
94
  每批完成后回读任务、节点、连线、资产、最终配置和 selected version,并实际查看所有图片。检查身份、肢体、道具、构图、画幅、裁切、文字、连续性和空结果。缺陷需再次付费生成或改选版本时,先展示问题并取得确认。
95
95
 
96
- 专业双板的 `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` 保存完整策略,改格数时同步两类计划及两板节点配置。结构校验不证明语义或像素符合预期。
96
+ 专业双板的 `storyboard_strategy.frame_plan` 必须登记 `beats:[{id,sourceUnitIds,description}]`,来源并集恰好等于本镜 `sourceUnitIds`;`temporal_cells` 与 `shot_cells` 各为 `frame_count` 个 `{beat_id,visible_change}`,各自覆盖全部节拍且不重复填格。时间格按节拍顺序,空间格表达几何证据,不能复制同一计划。`overflow_strategy` 固定 `return-to-breakdown`;容量不足退回拆镜,不截断、不借邻镜来源。旧策略可读,重新生成/审核前须补计划;`STORYBOARD_BOARD_FRAME_PLAN_*` 指出计划缺陷。专业镜头按下文“读取—预览—保存—复查”通过 `canvas node revise-storyboard` 保存策略补丁,改格数时同步两类计划及两板节点配置。结构校验不证明语义或像素符合预期。
97
97
 
98
98
 
99
99
  使用前镜尾帧时,在镜头编辑器的 `continuity` JSON 中为相邻两镜填写 `camera_setup_id`、`entry_state`、`exit_state`。机位 ID 必须相同,前镜 `exit_state` 必须与本镜 `entry_state` 完全一致,本镜 `mode` 为 `previous-tail`,`sourceShotKey` 指向紧邻前镜。状态描述应包含位置、朝向、持物、姿态动势、轴线、光照和天气;换机位使用 `independent`。视频生成必须接入同一父拆镜下、已通过当前版本实际播放审核的前镜视频所提取的真实尾帧,并占用一个独立参考名额。提示词可提前规划;实际生成不可缺少尾帧。建议接线也遵守机位和状态约束。前镜换版或审核变化会阻止执行,执行中变化则仅归档历史结果。旧镜头可读,重新使用尾帧前须补齐声明并重新审核。声明一致不证明像素衔接自然,仍须检查实际视频。
100
100
 
101
- 专业拆镜在规划通过后,按“摄影→表演→细化”顺序运行,复用现有三套模板和影视知识应用点。每批最多 4 镜;后阶段读取前阶段实际输出。每个阶段/批次的结构或合同错误最多纠错 3 次,取消、供应商和基础设施错误直接停止;任一必需阶段失败不把规划草稿保存为完成分镜。专业任务的调用数因此会增加,不能再按整集一次调用估算。
101
+ 专业拆镜在规划通过后,按“摄影→表演→细化”顺序运行,复用现有三套模板和影视知识应用点。每批最多 4 镜;后阶段读取前阶段实际输出。规划仅为硬错误最多纠错 3 轮;摄影、表演、细化失败保留最近通过硬校验的结果及已完成批次,上游超时或限流结束细化并提示。取消、权限、保存故障或任务被替代正常中止;没有合法规划则明确失败。软提示不阻断交付,回退不表示细化已完成。专业任务的调用数因此会增加,不能再按整集一次调用估算。
102
102
 
103
103
  表演逐角色记录 `current_goal`、`attention_target`、`trigger`、`participation`、`stimulus`、`attention`、`reaction`、`decision` 和本镜 `sourceUnitIds`。`participation` 为 `active`、`listening` 或 `not-involved`,聆听或不参与不需要强加眨眼、摇摆、手势;每个出镜角色恰好出现一次。细化只追加画面描述、图片提示词和 `video_prompt`,不能改写对白、来源、资产、时长、连续性、导演或逐格合同。
104
104
 
@@ -136,3 +136,15 @@ P0/P1 必须清零;只修复受影响镜头或边,禁止全量重建掩盖
136
136
  读取 `canvas node revise-storyboard PARENT_NODE_ID --project PROJECT_ID --json`,取得 `data.canvasVersion`、`data.parentVersionId`、`data.shots` 当前版本、来源合同、白名单及结构化提示。构造 `{expectedCanvasVersion,basedOnVersionId,edits:[{nodeId,basedOnVersionId,patch,warningIds?}]}` 文件,先用同一命令的 `--file patch.json --dry-run --json` 预览,再去掉 `--dry-run` 保存,最后重新读取。
137
137
 
138
138
  只针对已授权范围修改。对象递归合并、数组替换;使用 shot_type/camera_move/video_prompt 等专业字段。镜号、来源和原文只读,不增删或拆合镜头。跨镜转场两侧须同批修改。硬错误拒绝、软提示保留;409 后重新审阅,不盲目覆盖。旧版本和媒体保留,下游待更新,不自动生图或生视频。未完成细化可再次运行原节点恢复;Agent 修订会使旧检查点失效。
139
+
140
+ ### 专业镜头版本与实际图片验收
141
+
142
+ 专业修改统一使用上述“读取诊断—提交 dryRun—检查完整差异—保存—重新读取诊断”的流程;即使旧 `edit-shot` 入口也会执行完整专业校验和父子版本同步。跨镜转场或连续性两侧必须同批提交。409 后重新读取选版和差异,不能以刷新基线直接重放旧补丁覆盖用户修改。保存后复查父汇总、修改镜头选版、剩余提示和下游待更新状态,不用旧父版本继续生成制作计划。未改镜头、来源原文、历史选版及媒体不重写。
143
+
144
+ 验收将故事板工作纸、分框、格号、动作箭头和必要制作标注与剧情画面分开:制作标注跟随项目语言,CU、OTS、pan 等规范术语可用英文,不因正常标注拒绝;来源要求的道具文字、招牌和剧情内界面保持原始语言及内容,不得翻译或虚构对白字幕。真实换手、道具功能面/开口朝向错误、缺少动作起态、状态重置或提前揭示仍判缺陷。
145
+
146
+ 申请付费重生前先核对最终请求提示词是否与参考图、当前导演合同及逐格计划冲突,记录具体镜号/格号、操作者、持物手、道具朝向和首尾状态的可见缺陷。修正输入后再按用户授权生成;不追加“每格都说话/反应”的统一要求,不绕过双板合同另写独立生成提示词,不自动循环重生。基础人物参考只锁定稳定外貌,不能提前携带后续揭示道具或强行重置剧情状态。
147
+
148
+ 连续性批准必须显式 `approved=true`、覆盖全部目标 shot_key、检查完成且无冲突/未决项;空问题列表不代表批准。未批准必须说明原因,结构通过和计划声明不能替代图片的实际检查。
149
+
150
+ 专业拆镜若仅剩双板策略硬错误,服务端在原有三轮上限内只纠正报错镜头的策略;不改其他镜头、来源或对白。失败诊断按格号和节拍定位时间逆序、双板重复等具体问题;不能靠自动排序、补格或放宽硬校验交付,也不自动反复提交原任务。
@@ -18,6 +18,12 @@
18
18
  - 同批已就绪的独立节点用一次 `node run` 提交;跨阶段生成按 [滚动异步流水线](async-pipeline.md) 由单个调度器轮询并即时触发下游。项目状态用一次 `task list --project <id> --status running` 获取,不为每个节点单独查询。不要用一次 `task wait` 阻塞整批,也不要 shell 并发多个相互竞争的 CLI 调度进程。
19
19
  - 批量命令缺失或合法批量请求因粒度失败时,只回退尚未生效的单项。不得用单项调用绕过权限、schema、业务或付费门禁。
20
20
 
21
+ 批量字段更新使用 `{"updates":[{"nodeId":"NODE_ID","set":{"prompt":"修正要求"},"unset":["model"]}]}`,不能把 `config` 放在条目顶层。未知字段和只有 nodeId 的空更新均拒绝;全部条目检查通过才提交。保存后回读实际 config,不以成功回执代替内容核对。
22
+
23
+ `canvas apply` 的 `upsertEdges` 使用 `{"id":"EDGE_ID","sourceNodeId":"SOURCE_ID","sourceHandle":"text","targetNodeId":"TARGET_ID","targetHandle":"source"}`;端口必须来自实时节点 schema,不使用 source/target 简写。请求失败先回读画布,核对已生效内容和版本,再修正未生效项。
24
+
25
+ 来源分析要区分用户已批准的制作剧本与原片考据限制;后者保留说明,不能把本轮未要求的信息全部列成制作阻塞,也不能清空真实剧情冲突。资产预检的缺失/歧义名称按候选节点逐项核对,不把同一人物的服装版本当成多个身份,不擅自把群体台词分配给某个人。剧本对白角色须在所属场景 characters 内登记,按返回字段路径修正后回读,保留原文。
26
+
21
27
  ## 资产目录
22
28
 
23
29
  先用 `canvas episode list/create` 确认分集,再用 `canvas folder list` 取得真实目录 ID。预设的道具、人物、场景、配音、分镜目录不可重命名、移动或删除;用户子目录最多 32 层,删除后有 30 天恢复窗口。移动不得形成环,删除被引用目录前先解除引用。跨项目复制只复制资产及版本,不复制目录结构,写后用目标项目回读。