@ninkch/dsh-infinite-canvas 0.17.10 → 0.17.11

package/assets/canvas-studio/SKILL.md

@@ -40,32 +40,74 @@ description: 用无限画布（Infinite Canvas）做短剧/视频创作时使用
    只要 `warnings` 非空：**逐条** `canvas_update_bible` 补全（名称与告警**逐字一致**、描述写实可生成），
    再生成参考图；**绝不忽略、绝不跳过、绝不只补一部分**。设定集更新后告警会自动重算
    （几秒内随文档同步刷新），以最新一次 `canvas_node_status` 为准。
-9. **汇报固定要素**：项目名 + 项目 id + 节点名/id + 成稿摘要（若已生成）；有错误如实说明。
+9. **分镜容量铁律：一个分镜节点 = 一个 10–15s 的完整场景视频，是剧本的一小部分。**
+   - 一个分镜节点只吃**一个场景**的剧本：各镜 2–5s、时长之和 **≤ 15s（上限）**；
+   - **长剧本必须按场景拆分**为多个场景剧本节点（命名「第X节-场Y剧本」…），
+     每个场景剧本作为**各自分镜表**的源端——**绝不把长剧本整根连线给一个分镜表**；
+   - 全集剧本（若有）只作总纲存档，**不作为分镜源端**；
+   - 体量感：一个 10–15s 场景 ≈ 剧本 60–150 字（含该场全部对白）；分镜表 `shots` 上限 24 镜，
+     超长剧本会被截断且触发生成告警（warnings 会出现"剧本较长…请按场景拆分"）；
+   - **镜头数量不固定**：分镜表镜头数默认「自动（按内容节拍）」——一个连续动作段落 = 一镜，
+     3–10 镜都正常，绝不凑数、绝不用固定数量；全部镜头时长之和 ≤ 15s（超限客户端会自动压缩最长镜）；
+   - 拆分操作：全集剧本已生成后，按场景把对应片段 `canvas_write_node(target:'output')`
+     写入各场景剧本节点（这是**分配已有内容**，不是代写）。
+10. **汇报固定要素**：项目名 + 项目 id + 节点名/id + 成稿摘要（若已生成）；有错误如实说明。
+11. **生成节点前置检查单（创建任何 image-gen / video-gen 前逐条确认，任一不过 = 停止创建）**：
+    ① **镜头清单来源**：这一段的镜头序列已经从分镜表节点的 `shots` 读到了吗？（`canvas_node_status`）
+       没读到 → 停止创建，先读分镜表节点；仍读不到 → **问用户要分镜内容**。绝不自己按剧本推导/编造镜头表。
+    ② **视频节点数量 = 1**：一个分镜表对应一个完整视频（多镜头一次生成）。
+       准备为不同镜头建第 2 个视频节点 → 立即停止，走错路了。
+    ③ **先建 1 个、验证、再继续**：批量预建生成节点会放大错误——先建第 1 个，
+       用 `canvas_node_status` 验证连线与产物正确，再继续下一个。
+12. **读不到就问**：必需的项目状态（分镜内容/镜头清单/设定集条目）读不到时，那是**应当向用户确认的缺口**，
+    不是可以自行绕过的障碍——绝不把"编一份"当作替代方案。
 
 ## 二、标准工作流（对话填提示词+连线+触发，生成由节点完成）
 
 0. **读/补设定集**：`canvas_get_bible` → 缺什么用 `canvas_update_bible` 补。
    创作意图、世界观、风格 → 写进设定集的 worldview/style 字段。
 1. `canvas_list_projects` —— 查重 + 拿到 projectId 与节点 id
-2. **剧本节点**：只写提示词，让节点自己生成剧本——
-   - 新项目：`canvas_create_project({ name, scriptText: 本节创作提示词, nodeName: '第X节剧本' })`
+2. **剧本节点（一集 = 成片 60–120 秒，按【场N】分场）**：只写提示词，让节点自己生成剧本——
+   - 新项目：`canvas_create_project({ name, scriptText: 本集创作提示词, nodeName: '第X节剧本' })`
    - 已有项目：`canvas_write_node({ projectId, text: 提示词, target: 'idea', name: '第X节剧本' })`
    - 触发生成：`canvas_run_node({ projectId, nodeId })` → `canvas_node_status` 轮询直到 done/error
+   - 生成契约（自动注入，无需复述）：整集 **4–10 场、每场 10–15 秒成片**；**每场以「【场N】场景名（地点·时间）」单独一行开头**
+     ——这是"铺开到场景"自动拆分的解析标记，格式不可变；对白逐行「角色：台词」；结尾附人物/场景/道具清单；
    - **【铁律】不要把成稿直接填进 output**——生成是节点的工作（用户在画布上看得到过程与结果）。
      仅当用户明确说"你直接把剧本写出来、不用节点生成"时，才允许 `target:'output'` 直接写成稿。
-3. **分镜表节点**：**用连线从剧本节点取内容，绝不复制剧本全文**——
-   - `canvas_create_node({ projectId, type: 'storyboard', name: '第X节分镜表', connectFrom: 剧本节点id })`
-     （connectFrom 创建即连线；不要传 prompt——内容来自连线的上游剧本节点）
-   - 触发：`canvas_run_node({ projectId, nodeId })` → 轮询（画布基于连线的剧本拆解镜头）
-   - **【多镜头铁律】一个分镜表 = 一次视频生成**：分镜是"一次多镜头生成"的镜头脚本
-     （每镜 2-5 秒、各镜时长之和 = 目标视频总时长），不是"一镜一视频"。
-     现代视频模型支持多镜头模式：全部镜头按顺序+时长写进一条提示词，一次性生成整段视频，
-     镜头间由模型硬切。**绝不要为一个镜头单独建视频生成节点再拼接**。
-4. **视频生成节点**：多镜头提示词来自上游分镜表（连线取，不要复制）——
-   - `canvas_create_node({ projectId, type: 'video-gen', name: '第X节多镜头视频', connectFrom: 分镜表节点id, duration: 各镜时长之和 })`
-     （不传 connectFrom 且项目里已有分镜表时会自动连线；prompt 留空）
+3. **铺开到场景（每场 = 场景文本节点 + 分镜表节点，连线一次生成场景分镜）**：
+   - 画布：剧本节点的**「铺开到场景」按钮**一键完成（按【场N】自动分段）；
+   - Agent 等价操作：`canvas_node_status` 读成稿 → 按【场N】分段 → **逐场**：
+     `canvas_create_node({ type: 'text', name: '第X节-场Y文本' })` +
+     `canvas_write_node({ projectId, nodeId: 文本节点id, target: 'output', text: 该场原文 })` +
+     `canvas_create_node({ projectId, type: 'storyboard', name: '第X节-场Y分镜表', connectFrom: 该场文本节点id })`；
+   - **【铁律】每个分镜表的源端 = 对应场景文本（连线取）**；整集剧本节点**绝不**直接连分镜表（体量超限，见硬约束 9）。
+4. **逐场生成视频（多镜头一次生成）**：
+   - `canvas_run_node({ 分镜表 })` → `canvas_node_status` 读 `shots`（镜头清单以此为准，绝不编造镜头表）；
+   - `canvas_create_node({ projectId, type: 'video-gen', name: '第X节-场Y视频', connectFrom: 分镜表节点id, duration: 各镜时长之和 })`
+     （不传 connectFrom 且项目里有已拆解镜头的分镜表时会自动连线；prompt 留空）；
+   - **【禁止逐镜建节点】**一段 10–15 秒的视频**不需要逐镜的图片节点或"镜头图→镜头视频"链路**：
+     多镜头一致性靠角色/场景/道具**参考图资产**（@引用自动挂载）保证，视频模型在一次调用里完成全部镜头。
+     最多为**开场首帧或 1–2 个关键镜头**补定帧图（接同一视频节点的 frame/ref 端口）。
+     一旦发现自己在批量创建"第X节-场Y-镜Z"这类镜头图片/视频节点 = 走错路，**立即停止**并回到本条。
    - 参考图：把角色/场景/道具参考图资产连到视频生成节点的 `ref` 端口（`canvas_connect`）；
      提示词里的 `@引用` 命中的资产也会自动挂上
+   - **【跨段连贯：尾帧 → 首帧】**每个视频节点生成完成后会**自动提取尾帧**并挂到 `last` 输出端口。
+     多场视频按顺序串联：上一视频节点的 `last` 端口 → 下一视频节点的 `frame` 端口
+     （`canvas_connect({ projectId, fromNode: 上一段, toNode: 下一段, fromPort: 'last', toPort: 'frame' })`），
+     下一段就会以上一段的最后一帧为开场，保证段间画面连贯。
+     第一段的 `frame` 用开场定帧图（若生成了首帧关键图）或留空。
+     **按顺序触发**：上一段 `canvas_node_status` 为 done 后再连线、再触发下一段
+     （连线可以提前建好——frame 在下一段真正运行时才解析）。
+   - **【声音一致（可选）】**视频接口配置里的「生成同步音频」勾选后才发送 `generate_audio:true`——
+     模型生成**自带音轨**的视频（对白/环境声与画面同步）；不勾 = 无声视频（声音另行 TTS 配音）。
+     要让同一角色**跨视频保持音色**：用视频/成片节点的「提取声音参考」按钮——
+     **输入角色名即可**：系统自动按分镜 `dialogue` 台词标注定位该角色的全部时间窗，
+     逐窗取音轨**拼接为一个声音参考文件**（`角色-<名> 声音`，自动绑定实体），
+     之后该角色的视频提示词里 `@<名称>` 会自动把这条声音参考放进 `audios[]`，
+     模型生成的对白将向参考音色对齐（携带声音参考时会自动强制开启同步音频）。
+     时间窗归属靠分镜的 `dialogue` 标注（对白逐字来自剧本、按镜头分配，一镜尽量单说话人）；
+     分镜缺少台词标注时按钮会降级为手动模式并提示重新生成分镜。
    - 触发：`canvas_run_node` → 轮询；整段视频一次生成完成
 5. **生成角色/场景/道具参考图**：为设定集里的每个条目
    `canvas_create_node({ projectId, type: 'image-gen', name: '角色-张山 多视图', prompt: '按设定集写外观关键词' })`