@aswless_854771076/ai_short_studio_cli 0.1.37 → 0.1.38

package/README.md

@@ -90,12 +90,14 @@ CLI 通过 `/api/v1/bootstrap` 完成版本、连通性与 Supabase 公共配置
 
 `canvas node types [kind] --json` 同时兼容节点目录 schema v1/v2，并原样返回动态节点的 `source`、`definitionId` 和 `definitionVersionId`。后台发布后重新执行该命令即可读取新目录；归档节点不能新建，但已有实例仍按画布中的固定版本 schema 更新和执行。CLI 创建节点只提交 `kind` 与配置，版本由服务端固定，不能由客户端伪造。
 
-新建视频生成节点按实时模型能力执行：首尾帧模型使用 `start-frame` + `end-frame`，普通图生视频使用 `start-frame`，多图参考模型使用 `references`。历史节点未声明新版输入语义时继续按原多图参考逻辑执行，不会被读取或保存自动迁移。
+新建视频生成节点按实时模型能力执行：首尾帧模型使用 `start-frame` + `end-frame`，普通图生视频使用 `start-frame`，图片参考使用 `references`；Ark 两个 Seedance 2.0 和 StarRouter 两个内置 Dreamina Seedance 2.0 还可使用 `reference-videos` 和 `reference-audios`，上限为 9 张参考图、3 个参考视频和 3 个参考音频。其他 StarRouter 和自定义模型不会按名称猜能力。参考音频不能作为唯一媒体输入，多模态参考不能与首尾帧混用。历史节点未声明新版输入语义时继续按原多图参考逻辑执行，不会被读取或保存自动迁移。
 
 `storyboard-image` schema 现在暴露节点级 `gridSize`。CLI 继续按实时 schema 通用写入，配套 Skill 会分析每个镜头的动作、运镜、多人调度和连续性难度，向用户确认后逐镜设置；未单独设置或连接旧服务时回退到项目格数，系统默认为 6 格。
 
 专业 Markdown 剧本可在 `storyboard-breakdown` 配置中显式使用 `storyboardPipelineVersion: 2`、`sourceFormat: screenplay-markdown.v1`、`targetLanguage: en|ar`、`platform: TikTok` 和 `aspectRatio: 9:16`。CLI 通过现有通用节点配置写入这些字段。该模式只生成分镜文本和镜头资产，不自动运行声音、TTS、图片、音频或视频节点。
 
+标准短剧制作先用随包安装的 `short-drama` 生成并审校专业剧本（已有专业剧本直接复用），再选择目标集数、创建或复用项目，并只建立目标集实际出现的人物、场景、道具和可选音色设定。拆镜前必须完成资产—剧情匹配审计；拆镜后逐镜全量检查重复、无效、缺失、冲突、穿帮、连续性、道具交互朝向、语言和来源身份。P0/P1 未清零时不得进入图片、声音或视频生产。
+
 `character-visual-design` schema 暴露 `candidateCount`，范围为 1～3，默认值为 1。CLI 按实时 schema 校验和写入；多个视觉描述仍分别进入独立三视图和图片资产链。
 
 `canvas settings set` 支持项目级 `imageResolution`、`imageQuality`、`videoResolution`，未覆盖的图片、图片编辑和视频节点会继承这些默认值。候选值来自 `settings get` 对应字段的实时 `options`；节点仅在需要偏离项目默认时，按当前模型 `capabilities` 写入 `resolution`、`quality` 覆盖。

package/package.json

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

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

@@ -38,6 +38,18 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
 
 用户需要从选题、创作方案、人物、分集目录开始创作或续写微短剧剧本时，先使用 `short-drama` 完成对应阶段并取得用户确认，再把已确认的单集剧本交给本 Skill 创建 VVICAT 项目、素材和分镜。已有专业剧本时直接创建 `screenplay-resource` 并进入素材与分镜流程，不得重复执行 `novel-to-script`；只有输入仍是小说、故事梗概或需要改编的原文时才使用 `novel-to-script`。
 
+## 短剧项目制作门禁（强制顺序）
+
+1. **确认专业剧本**：没有已确认剧本时，必须先调用 `short-drama`，完成创作方案、角色、分集目录、目标单集剧本及 `/review`；已有专业剧本直接复用。剧本未确认时不得创建付费生产节点。
+2. **选择目标集数后建项目**：先让用户确认本次目标集数，再创建或复用无限画布项目并完成项目配置门禁。只提取目标集实际出现的人物及形象版本、场景及子场景、关键道具及叙事版本；不得为未选集数提前创建资产。
+3. **按模型决定音色资产**：项目存在有效配音模型且本次需要声音制作时，为出场角色创建音色描述或音色资产。音色设定与 TTS 分离；没有用户授权不得执行声音设计、TTS、图片、音频或视频生成。
+4. **执行资产—剧情匹配审计**：逐项输出“剧本出现项 / 已创建资源 / selected version / 拆镜连线 / 结论”，检查缺失、多余、同名、真假、年龄、服装、状态、所有权、场景版本、音色偏差、stale、重复和跨类型连线。缺失未清零、版本冲突未确认、必要资源没有 selected version，或实际连线集合不等于目标集需求时，拆镜前门禁失败，禁止运行 `storyboard-breakdown`。
+5. **每集独立拆镜**：每个拆镜节点只能连接一条目标集专业剧本，并连接该集全部已确认人物、场景和道具。任务完成后必须按集号、`parentAssetId` 和 `producerNodeId` 回查产物归属，不能按任务提交顺序推断，也不能重复创建服务端自动生成的镜头节点。
+6. **执行镜头质量审计**：拆镜后按镜号全量检查，不抽样。至少检查剧本动作、台词、旁白、反应和转场是否覆盖，重复/无效/缺失镜头，人物与资产误配，真假和年龄版本冲突，服化道穿帮，人物位置、视线、轴线、动作和道具状态连续性，景别与机位异常，以及目标语言、台词归属、集号和来源身份。人物使用手机等道具时还要确认主体朝向交互面，不能默认让屏幕正对观众。
+7. **按严重级别闭环**：报告逐镜列出 P0/P1/P2、证据、问题类型和最小修复。P0/P1 未清零时不得进入分镜图、声音或视频生产；只精确修改受影响镜头或连线，并重跑同一资产审计和镜头审计，禁止用全量重建掩盖局部问题。
+
+本节只规定阶段顺序与通过条件。具体连线覆盖、相邻镜连续性、内容误匹配和生成后验收，继续执行下文“分镜素材连线门禁”“镜头级素材审计”“上下镜连续性审计”“分镜逻辑审计”和“生成后自我审计”。
+
 ## 标准创作流程
 
 1. 明确原始故事或剧本、目标受众与平台、语言、成片画幅、总时长与镜头目标时长、风格参考、人物/场景/道具约束，以及交付是否包含剧本、设定、分镜图、视频和音频；除本文明确的素材画幅与视频生成时长默认值外，缺项先问。
@@ -175,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 链路重跑，历史版本继续保留。
-- 视频输入按模型实时能力选择严格首尾帧、普通首帧图生视频或多图参考。新分镜以规划产物的 `continuity` 为准：`previous-tail` 会自动物化“前镜视频 → 尾帧提取 → 后镜 start-frame”，CLI 不再自行猜测或手工补规划边；执行视频仍需用户确认。
+- 视频输入按模型实时能力选择严格首尾帧、普通首帧图生视频或图片参考；模型明确声明多模态参考上限时，可把视频、音频素材分别连接到 `reference-videos`、`reference-audios`。参考音频不能作为唯一媒体输入，多模态参考不能与首尾帧混用。新分镜以规划产物的 `continuity` 为准：`previous-tail` 会自动物化“前镜视频 → 尾帧提取 → 后镜 start-frame”，CLI 不再自行猜测或手工补规划边；执行视频仍需用户确认。
 - 原始视频交付只下载每镜已选中的 MP4，按镜号命名 `S001.mp4`、`S002.mp4`……；字幕在编排/交付层单独生成，不烧录进原始视频。`manifest` 每行至少记录 `shotNumber`、`nodeId`、`assetId`、`versionId`、`fileName`，不得混入分镜图、音频中间件或烧录字幕版本。
 
 ## 安全边界