@aswless_854771076/ai_short_studio_cli 0.1.41 → 0.1.43

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aswless_854771076/ai_short_studio_cli",
-  "version": "0.1.41",
+  "version": "0.1.43",
   "description": "VVICAT 无限画布项目命令行工具",
   "license": "MIT",
   "private": false,

package/skills/using-vvicat-ai-short-studio-cli/SKILL.md

@@ -59,7 +59,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
 
    用户明确要求专业 Markdown 剧本拆镜测试时，给 `storyboard-breakdown` 显式配置 `storyboardPipelineVersion: 2`、`sourceFormat: screenplay-markdown.v1`、目标集的 `targetLanguage: en|ar`、`platform: TikTok` 和 `aspectRatio: 9:16`，且只能连接一条剧本。该模式只验收分镜文本和镜头资产：声音只记录音色设定，不执行 `voice-design`；不执行 TTS、图片、音频或视频节点。任务成功后确认来源与逐字校验通过且没有新增 IMAGE/AUDIO/VIDEO 版本；任务失败时确认没有新增分镜版本或镜头。
 5. 生成分镜图前，必须先通过“分镜素材连线门禁”。再用 `canvas asset get/list` 取得人物、场景、道具等已选版本，必要时下载，并把实际图片或可访问预览展示给用户；只提供资产 ID、文件路径或文字说明不算展示。用户明确确认素材与选版后，读取 `storyboard-image` 的实时 `configSchema`，用户未指定画幅且 schema 支持时将 `aspectRatio: 16:9` 显式写入节点，再分析每个镜头的动作阶段、运镜变化、多人调度和连续性难度，选择 schema 允许的最小够用格数：简单镜头建议 4 格，常规镜头使用默认 6 格，复杂镜头建议 9 格，16/25 格只用于用户明确需要的长动作或高密度关键帧。向用户展示逐镜建议并确认后，将各自 `gridSize` 写入对应节点；旧服务 schema 未暴露字段时不得虚假写入，应说明限制并回退到项目有效值，`gridSize` 未另行确认时为 6 格。连续叙事优先建议 `imageLayout: storyboard`，同时说明 `grid` 与 `single` 可选，最终由用户确认布局、镜头范围、参考资产、模型与费用范围。未展示、未确认或连线门禁未通过时禁止生成分镜图。
-6. 执行分镜图后按“生成后自我审计”检查真实产物，并展示给用户确认。新分镜直接读取 `independent` / `previous-tail`，服务端自动协调“前镜视频 → 尾帧提取 → 后镜 start-frame”；先生成前镜和当前尾帧，再提交后镜。依赖未完成、尾帧来自旧视频版本，或模型仅支持 reference 时，服务端返回 `CANVAS_VIDEO_CONTINUITY_REQUIRED`，不得改接普通参考图绕过。之后复用自动创建的 `storyboard-video-prompt`，按实际布局重写视频提示词并确认后执行 `video-generate`。镜头建议时长按正常剧情节拍、口播和动作确定，首尾保留约 1–2 秒剪辑余量；不为命中全片总时长机械扩镜。执行时按当前模型合法时长档位换算，保留原建议时长供剪辑裁切。未展示或未确认分镜图时禁止生成视频。
+6. 执行分镜图后按“生成后自我审计”检查真实产物，并展示给用户确认。新分镜直接读取 `independent` / `previous-tail`，但该字段只作为建议：服务端不自动创建尾帧节点或连线，也不阻止后镜独立生成。需要严格连续性时，在用户确认后显式执行 `--apply-ready`。之后复用自动创建的 `storyboard-video-prompt`，按实际布局重写视频提示词并确认后执行 `video-generate`。镜头建议时长按正常剧情节拍、口播和动作确定，首尾保留约 1–2 秒剪辑余量；不为命中全片总时长机械扩镜。执行时按当前模型合法时长档位换算，保留原建议时长供剪辑裁切。未展示或未确认分镜图时禁止生成视频。
 7. 配置门禁固定用一次 `canvas settings set` 写入确认字段；通过门禁后的同阶段节点与连线变更优先合并为一次 `canvas apply`，批量不可用或按“核心原则”处理后仍失败时才回退专用 node/edge 单条命令。每次执行都读取真实任务 ID 并 `task wait`，不用固定 sleep。
 8. 每批图片、视频或音频生成完成后必须先通过“生成后自我审计”，才能报告成功、请求选版或进入下一付费阶段。在进入视频生成前，必须额外依次执行：(a)“镜头级素材审计”全量清单，核对 reference 集合覆盖镜中人物/场景/道具、无跨类型错边、成对资源引用正确版本、stale 清零、道具词扫 description 兜底、资源文字设定贯穿到 shot/image；(b)“上下镜连续性审计”，按时序逐对相邻镜核对人物位置、道具状态、光影色调、动势视线、景别节奏、叙事桥接，并给有动作连续关系的镜组互加 reference、给极端特写/物证镜补入必要的人物 reference；(c)“分镜逻辑审计”，对照叙事期望逐项扫掉关键词误命中、真假道具互串、跨段同名实体误连、黑场/空镜多余连线、多版本角色（成年/童年）误连、龙套角色引用主角资源等问题，输出逐镜审计表并精确删/加边直到 wired=plan；(d) 把图像模型的已知先验 bias（数字、具象动物、实体面具、中文字样等）列入视频阶段 prompt 的 negative 约束。交付前再次确认 selected version 与下载目录，记录项目、节点、任务和资产 ID、审计结论、失败项与未决项。临时项目在所有结束路径删除；既有项目绝不擅自删除。
 
@@ -104,7 +104,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
 
 在素材连线审计通过后、生成视频前，必须再做一次**按时间线顺序**的跨镜连续性检查。这一步独立于单镜素材审计，关注的是“上一镜结尾到下一镜开头”的视觉连续性：
 
-先执行 `canvas continuity analyze --project <projectId> --json`。该命令只读取镜头、lineage、模型能力与连线，不创建任务、不产生模型费用；输出中的 `waiting-for-source-video` 表示下一镜必须等待上一镜完成，`readyFixes` 表示可用 `--apply-ready` 免费补建提帧节点与连线。视频完成后仍需按本节清单复检真实画面。
+先执行 `canvas continuity analyze --project <projectId> --json`。该命令只读取镜头、lineage、模型能力与连线，不创建任务、不产生模型费用；`waiting-for-source-video` 只表示建议的尾帧链尚不可建立，不阻止后镜独立生成；`readyFixes` 表示用户确认后可用 `--apply-ready` 免费补建提帧节点与连线。视频完成后仍需按本节清单复检真实画面。
 
 1. **检查清单**。按 shotKey 顺序逐镜对相邻两镜核对：
    - **人物身份与位置**：上一镜的主要人物下一镜是否还在；越肩/反打镜头的前景人物是否与上个对话方匹配；同一场景多镜之间服装/妆容/干湿/血迹等是否一致。
@@ -187,7 +187,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
 - 开始或恢复操作时先读取最新画布、settings 和节点 schema；用 `canvas node edit-shot` 编辑 `storyboard-shot`，用 `canvas node edit-resource` 编辑具有稳定 `operation/resourceKey/resourceType` 的剧本、人物、人物视觉、场景、子场景或道具资源。两类编辑都基于当前 `selectedOutputVersionId` 追加不可变版本，不得覆盖历史版本；资源编辑只替换完整父文档中的目标实体，兄弟节点保持原选版。
 - 在 `canvas settings get` 后让用户确认 `outputLanguage` 为自动、`zh` 或 `en`；变化只把拆镜、视频提示词、TTS 和视频节点标为 stale，不删除资产、不清除选版、不自动重跑。试听原生配音并核对语言；节点显式 `languageHints` 优先。
 - 戒指等实体必须进入镜头 `props`。肢体仅在剧情需要时出现，并在画面中可见归属于人物；纯道具镜头不得凭空增加手、手套、人物或 UI。上游变化后只按 stale 链路重跑，历史版本继续保留。
-- 视频输入按模型实时能力选择严格首尾帧、普通首帧图生视频或图片参考；模型明确声明多模态参考上限时，可把视频、音频素材分别连接到 `reference-videos`、`reference-audios`。参考音频不能作为唯一媒体输入，多模态参考不能与首尾帧混用。新分镜以规划产物的 `continuity` 为准：`previous-tail` 会自动物化“前镜视频 → 尾帧提取 → 后镜 start-frame”，CLI 不再自行猜测或手工补规划边；执行视频仍需用户确认。
+- 视频输入按模型实时能力选择严格首尾帧、普通首帧图生视频或图片参考；模型明确声明多模态参考上限时，可把视频、音频素材分别连接到 `reference-videos`、`reference-audios`。参考音频不能作为唯一媒体输入，多模态参考不能与首尾帧混用。新分镜以规划产物的 `continuity` 为准；`previous-tail` 只记录需求，需要用户确认后显式执行 `--apply-ready` 或手动连线，执行视频仍需用户确认。
 - 原始视频交付只下载每镜已选中的 MP4，按镜号命名 `S001.mp4`、`S002.mp4`……；字幕在编排/交付层单独生成，不烧录进原始视频。`manifest` 每行至少记录 `shotNumber`、`nodeId`、`assetId`、`versionId`、`fileName`，不得混入分镜图、音频中间件或烧录字幕版本。
 
 ## 安全边界

package/skills/using-vvicat-ai-short-studio-cli/references/commands.md

@@ -124,7 +124,7 @@ ai-short-studio canvas edge delete <edgeId> --project <projectId> --yes --json
 
 `canvas node edit-resource` 的文件或 stdin 内容是剧本、人物、人物视觉、场景、子场景或道具资源的 JSON 对象。命令读取最新画布版本与目标节点的 `selectedOutputVersionId`，在该版本的完整父文档中只替换 `resourceKey` 对应实体，再追加并固定当前节点的新选版；名称、资源键、ID、所属人物或场景等身份字段不可修改，兄弟资源节点保持原选版，下游递归标记 stale。缺少稳定 `operation/resourceKey/resourceType` 的旧节点只读，不能按标题猜测。该写入不属于 `canvas apply`；409 后重新读取画布与选版并确认，不得盲目覆盖。
 
-首尾帧提取使用实时目录中的 `video-frame-extract`，配置为 `{"position":"first"}` 或 `{"position":"last"}`。输入连接 `video`，输出 `image` 是独立 IMAGE 资产版本并记录来源视频版本。新分镜的 `previous-tail` 关系会自动物化尾帧拓扑；历史镜头保留只读启发式分析。节点与连线创建不会自动执行或付费。
+首尾帧提取使用实时目录中的 `video-frame-extract`，配置为 `{"position":"first"}` 或 `{"position":"last"}`。输入连接 `video`，输出 `image` 是独立 IMAGE 资产版本并记录来源视频版本。`previous-tail` 只记录连续性需求，不自动物化尾帧拓扑；用户可确认预检建议或手动建立节点与连线。创建这些节点与连线不会自动执行或付费。
 
 原始视频交付先按镜号读取视频节点的 `selectedOutputVersionId`，再逐个执行 `canvas asset download`，保存为 `S001.mp4`、`S002.mp4`……。同时生成逐行 `manifest`，每行包含 `shotNumber`、`nodeId`、`assetId`、`versionId`、`fileName`。只下载 selected 原始 MP4；字幕单独交付，不混入分镜图、音频中间件或烧录字幕版本。
 
@@ -137,7 +137,7 @@ ai-short-studio canvas continuity analyze --project <projectId> --json
 ai-short-studio canvas continuity analyze --project <projectId> --apply-ready --json
 ```
 
-该命令主要用于没有 `continuity` 的历史镜头和人工审计。新规划镜头直接读取 `independent` 或 `previous-tail`；当前后视频节点出现后，服务端自动创建稳定尾帧提取节点与 `start-frame` 连线。前镜视频或当前尾帧未完成时，运行后镜会返回 `CANVAS_VIDEO_CONTINUITY_REQUIRED`；reference-only 模型不能满足严格连续性。`--apply-ready` 仅保留给旧启发式建议，不用于新规划关系。
+该命令用于新旧镜头的连续性分析和人工审计。新规划镜头直接读取 `independent` 或 `previous-tail`，但服务端不会自动创建尾帧节点或 `start-frame` 连线，也不会因依赖未完成阻止后镜独立生成。前镜视频完成后，用户可确认建议再显式执行 `--apply-ready`。
 
 ### Meme 专属节点流程