@oh-story/dsh 0.1.14 → 0.1.16

package/lib/drama/skills/short-drama-storyboard/references/production-shot-grammar.md

@@ -20,7 +20,7 @@
 本文档是生产端的转换规则和判断依据。出现的数字只有被创作者纳入项目方案
 （`craft_default`）后才是验收条件，不能只因偏离示例就判为问题。
 
-核心认知：**分镜先说明剪辑覆盖范围和可审查的起止边界，不是下游视频提示词**。
+**分镜负责剪辑覆盖范围和可审查的起止边界**。
 它说明本镜为何存在、观众能知道什么、从哪一状态到哪一状态；只有已接受的制作方案
 需要时才补充时间段意图，完整动作措辞由视频提示词环节编写。`start_boundary` 可以是
 静止关键帧，也可以是上游明确的运动中瞬间，不能把“静帧输入”误写成故事必须静止。
@@ -36,17 +36,16 @@
 4. **摄影行为有职责**（SHT-04）：运镜或有意固定机位都应能说明它如何服务注意力、
    压力、观众立场、揭示或节奏，而不是给每镜强加运镜。
 5. **连续性靠已确认边界比较**：精确绑定 `Location/View`、`start_boundary` 与
-   `end_boundary`；下游只
-   重复执行必需的局部状态，不逐镜复制整份状态表。
+   `end_boundary`；下游只重复执行必需的局部状态，不逐镜复制整份状态表。
 
 ## 二、编号与文本分工
 
-- 分镜号 = `场序-镜序`。**场序按 clip 内"地点组"顺位**：换地点才递增，同地点的
-  多个剧本场共用前缀；剧本自带集号时用三段式 `64-1-1`。
+- 正式镜头始终使用稳定 `SHOT-...` ID。项目另外接受了 `场序-镜序` 作为展示编号时，
+  才按该项目约定排列；例如按交付片段内的地点组排序，同地点多个剧本场共用前缀，或加集号写成 `64-1-1`。
+  展示编号不替代镜头 ID，重排时仍按[镜头修订身份](shot-revision-identity.md)保留稳定引用。
 - 文本分工：保留该镜覆盖的剧本原文；用简短中文纲要说明谁做什么以及镜头职责，供
   人工审阅；另记录镜头目的、起止边界和摄影意图。完整时间过程由视频提示词环节编写。
-  **纲要写差 = 人审索引
-  失效**——"开场"两个字的纲要是真实事故案例。
+  只写“开场”不能说明本镜承担的动作或信息，无法帮助审阅者定位。
 
 ## 三、拍→镜拆分规则
 
@@ -118,15 +117,15 @@
 
 ### 切点必须带来可见变化
 
-上一段拒绝的是“按情绪套景别”，不是“景别可以原地不动”。两者的分界线是**这里到底切
-不切**：
+先决定是否需要切镜，再选择景别与角度的变化：
 
 - **不切镜**：同一景别持续本身就是选择。压力累积、人物在同一构图里自己改变距离、
   观众被迫一直看着不肯变的画面，都是有效理由。
 - **已经切镜**：新镜必须在景别、机位角度或人物关系里至少改变一项。相邻两镜景别相同、
   角度相同、关系也没变时，观众读到的不是节奏，是跳切或穿帮——这个切点没有存在理由。
-  修法只有三种：让收放跟着注意重点走（最常见是沿阶梯相邻一格一收一放：
-  中景↔中近景↔近景↔特写），换轴线侧或视点，或者干脆并成一镜、用调度在镜内改变关系。
+  可按注意重点调整收放（最常见是沿阶梯相邻一格一收一放：
+  中景↔中近景↔近景↔特写），也可改变机位角度或视点，或者并成一镜，用调度在镜内改变关系。
+  确需越轴时，按[群体与轴线](blocking-playbooks.md#4-群体与轴线)重新建立方位。
 - **新空间的第一镜**通常先给得开一些，让观众定位后再逐步收进去；但前镜已经建立地理，
   或上游有意延迟识别时，不为“第一镜要宽”自增镜头（见第三节）。
 
@@ -146,9 +145,9 @@
 
 | 维度 | 词表 | 它在故事里回答什么 | 记在哪 |
 |---|---|---|---|
-| **水平角度** | `正面 / 斜侧（四分之三）/ 正侧 / 后斜侧 / 背面` | 观众被允许读到多少表情，以及站在谁的一侧 | 镜头 `framing.angle`，同时说明在轴线哪一侧 |
-| **机位高度** | `地平 / 低（仰）/ 平视 / 高（俯）/ 顶视` | 谁在这一刻大于谁；平视是**主动**表示势均力敌，不是"没选" | 镜头 `framing.camera_height` |
-| **焦段意图** | `广（空间关系优先）/ 标准（接近肉眼）/ 长（压缩纵深、隔离主体）` | 人与人的距离该显得更远还是更近 | 关键帧 `camera.lens_intent`（**帧级选择**） |
+| **水平角度** | `正面 / 斜侧（四分之三）/ 正侧 / 后斜侧 / 背面` | 观众被允许读到多少表情，以及站在谁的一侧 | 《分镜.md》当前镜头的角度，同时说明在轴线哪一侧 |
+| **机位高度** | `地平 / 低（仰）/ 平视 / 高（俯）/ 顶视` | 谁在这一刻大于谁；平视是**主动**表示势均力敌，不是"没选" | 《分镜.md》当前镜头的机位高度 |
+| **焦段意图** | `广（空间关系优先）/ 标准（接近肉眼）/ 长（压缩纵深、隔离主体）` | 人与人的距离该显得更远还是更近 | 《分镜.md》当前首帧或收尾画面的焦段意图（**帧级选择**） |
 
 前两栏是镜头拥有的调度事实，关键帧只投影不覆盖；焦段意图是关键帧自己的选择，因为它
 决定的是这一帧怎么被看，不改变人在哪、谁大于谁。不要在镜头记录里再写一次焦段——
@@ -187,31 +186,29 @@
 | 台词如何分配 | 先保证一次可表演语气与口型负载；过长时按行动转向拆分，而非机械按字数。 |
 | 单镜还是镜头组 | 先把每个镜头写成可单独审查的记录，再按目标交付方式编组；编组不改变镜头身份。本环节只负责镜头本身：定清每个镜头的目的、起止边界与已接受时长。编组之后由谁承担时长加总与成员资格，属于交付环节的事，不在这里决定，也不因为将来会编组就提前合并镜头。 |
 | 子镜密度 | 按 [镜长从哪来](shot-craft.md#镜长从哪来-sht-28) 由声音事件与已接受的目标平均镜长推出；没有已接受节奏档案时不设数值带宽，把算出的平均镜长报给创作者。每次切换仍要有注意、压力或状态理由。项目把生成单元固定在更长的一档时，切镜密度由镜内调度承担——一镜里要有景别或视点的实际变化、或一次完整的动作与反应交接，否则无论单帧多好，观众读到的都是幻灯片。 |
-| 单元时长 | 先从必须保留的动作、反应、对白与最终状态反推这一镜需要多久；放不下就删减、拆镜或请求改边界。项目已经定下可用的生成长度档位时，取容得下它的最短一档；没定就按反推出的秒数写，并把用到的档位报给创作者。超过约五到八秒后，一张冻结关键帧只描述了镜头开头，其余部分实际上没有规格：更长的镜头要么按精确状态边界拆开，要么由创作者明确接受它是一个宽规格镜头。 |
+| 单元时长 | 先从必须保留的动作、反应、对白与最终状态反推这一镜需要多久；放不下就精简非必要调度、拆镜，或请求写作技能修订来源内容。项目已经定下可用的生成长度档位时，取容得下它的最短一档；没定就按反推出的秒数写。单张冻结关键帧只说明起点，镜头中的动作过程仍须由运动提示词写清；若关键动作无法在同镜内清楚实现，就按精确状态边界拆镜，不用通用秒数决定是否拆。 |
 
 ## 七之二、单集时长加总（`SHT-16`）
 
 创作者在项目里写下的每集目标时长，如果全流程没有一处消费它，它就只是一个愿望。
-真实的失效是这样发生的：分镜逐镜看都合理，每一镜的时长也都是有理由的，直到全集镜头
-装到一起才发现比目标长出三分之一——而此时台词、资产、关键帧提示词都已经按这些镜头
-做完了，唯一还能改的只剩硬删。
+分镜逐镜成立，整集仍可能超出目标，因此应在进入生产前加总，避免后续被迫删掉必要内容。
 
-`structural_invariant`：覆盖记录带一个 `episode_duration`，它的 `shot_seconds_total`
-必须是本集镜头 `duration_seconds` 的**算术和**，且覆盖里列出的每个镜头要么贡献一个数字，
-要么出现在 `unresolved_durations` 里。这条只管账目对不对：**不允许有镜头无声地不进总和**。
+直接加总《分镜.md》的镜长，在末尾报告总时长、未定镜头和目标差值，不另建覆盖记录。
+
+`structural_invariant`：总时长必须是本集已确定镜长的**算术和**；每个镜头要么计入一个时长，
+要么明确列入未定清单，**不允许有镜头无声地不进总和**。
 时长未定的镜头显式挂起是正常状态，静默漏掉不是。
 
-项目声明了 `target_seconds_per_episode` 时，记录还要绑定该字段并写出带符号的
-`delta_seconds` 与一个 `disposition`：
+项目声明了 `target_seconds_per_episode` 时，在同一处注明目标来源、带符号的差值与处理结论：
 
-| disposition | 含义 |
+| 处理结论 | 含义 |
 |---|---|
-| `no_target_declared` | 项目没有声明目标，本项只留总和 |
-| `within_creator_tolerance` | 差值在创作者可接受范围内 |
-| `creator_accepted_overrun` | 超出但创作者明确接受，附理由 |
-| `to_revise` | 需要回到内容层处理 |
+| 未声明目标 | 只报告总和 |
+| 在创作者接受范围内 | 报告差值 |
+| 创作者接受超出 | 报告差值与接受理由 |
+| 需要修订 | 回到内容层处理 |
 
-`craft_default`：差值本身**不阻断交付**。目标时长是计划，不是质量门槛；`to_revise` 的
+`craft_default`：差值本身**不阻断交付**。目标时长是计划，不是质量门槛；需要修订时的
 处理手段是回到内容层（合并同质节拍、把说明改成传递、拆集），不是按数字均匀删镜头或
 砍台词——后者砍掉的往往正是兑现。
 

package/lib/drama/skills/short-drama-storyboard/references/review-and-fixtures.md

@@ -1,13 +1,14 @@
 # 分镜完成前检查
 
-这份清单只检查 `分镜.md` 能直接证明的结构事实，把审查注意力留给真正需要读懂戏的判断。
+先核对 `分镜.md` 中可直接检查的结构事实，再审查镜头内容。
 检查发现问题就修正文档，不另建 coverage、QA 或校验结果文件。
 
 ## 可直接核对
 
 - 每个 `SHOT-...` ID 唯一，来源场景 ID 能在 `剧本.md` 找到；
 - 每个制作相关的动作、对白、VO/OS、SFX、画面文字与连续性要求都由镜头承载，或有明确创作理由；
-- 同一来源动作只有一个主要落实镜头，其他镜头只增加反应、细节或重新解释；
+- 同一来源动作默认由一个主要镜头落实，其他镜头增加反应、细节或重新解释；明确声明的峰值冲击
+  可按 `SHT-08` 有意重复；
 - 每镜时长是正数，全剧时长等于可见镜头时长之和；目标时长只用于报告差值，不是质量门槛；
 - 起点和终点都写绝对事实，不使用“同上”“保持不变”代替；
 - 相邻镜头的站位、朝向、视线、持物、伤势、光态与可读文字连续；
@@ -18,19 +19,19 @@
 - 冻结关键帧只投影所声明的边界：默认起点；外部工作流确实需要时才增加终点帧；
 - 可复制关键帧正文不含 ID、文件路径、工作流状态或工艺说明。
 
-结构检查失败时点名文件、场景或镜头 ID、冲突事实和负责 owner，不回显整段私有文本。
+结构检查失败时点名文件、场景或镜头 ID、冲突事实和负责技能，不回显整段私有文本。
 
 ## 需要语义审查
 
 下列问题不能靠字段数量或脚本替代：
 
 - 镜头是否守住来源原意和观众知情时机；
-- 重复覆盖是否真的增加新的反应、证据或理解；
+- 重复覆盖是否增加新的反应、证据或理解，或属于已声明的峰值冲击重复；
 - 景别、机位、运动和切点是否由注意、压力、关系、空间或节奏变化驱动；
 - 多人调度是否让主要关系和注意交接可读；
 - 证据文字、决定性手部动作、脸与眼神是否会被遮挡；
 - 关键帧是否既可冻结，又保留镜头下一步需要发生的动作空间；
 - 画面里没有被名字点到、但仍需要认出身份的小比例或背景人物，是否也进了「视觉依据」——机械核对只抓被点名的那一类。
 
-关键帧数量、镜头数量、景别比例和目标时长差值都不是通用质量门槛。审查 finding 必须给出位置、
+关键帧数量、镜头数量、景别比例和目标时长差值都不是通用质量门槛。审查问题必须给出位置、
 证据、影响和必须达到的修订结果，不能只说“镜头不够电影感”或“看起来像 AI”。

package/lib/drama/skills/short-drama-storyboard/references/scene-visual-plan.md

@@ -1,7 +1,7 @@
 # 场次视觉戏剧计划
 
 场次视觉计划是正式分镜前的可选思考层，回答整场怎样改变观众位置、空间压力、观看节奏和声音注意。
-它不是第二份剧本，也不拥有镜头边界。
+计划继承剧本事实，镜头边界仍由正式分镜决定。
 
 ## 什么时候使用
 
@@ -18,7 +18,7 @@
 4. **视觉推进**：什么时候让信息、反应或空间先于特写落地；
 5. **摄影节奏**：固定、移动、切近和停留分别由什么变化触发；
 6. **反应落点**：结尾画面由谁的选择或空间后果承担；
-7. **声音策略**：主导声源、主动留白、距离变化、撤出/恢复和 sound bridge。
+7. **声音策略**：主导声源、主动留白、距离变化、撤出/恢复和声音桥。
 
 只有真正不同的方案才比较；不固定方案数、宫格、景别或镜头数。选定后直接把结果投影进
 `分镜.md` 的镜头职责、景别/机位、起止边界与声音，不另存 audition、plan 或接受记录。

package/lib/drama/skills/short-drama-storyboard/references/screenplay-to-keyframe-example.md

@@ -53,7 +53,7 @@ A02（摊手与蓝线头）。
 - 构图：纵向双人中景，柜台横线分隔双方。
 - 摄影机：固定机位，让“不递”这个选择持续存在。
 
-来源：`剧本.md / EP004-SC002` 中“沈禾把拳压在台沿但不递牌”的动作和对应对白。正式镜头在
+来源：`剧本.md / EP004-SC002` 中“沈禾把一张写着“17”的取衣牌压在掌心，没有递给柜台后的蒋姨。”的动作和对应对白。正式镜头在
 `分镜.md` 直接写这个场景 ID 与必要短引文。
 
 若为了增加动作而让沈禾把取衣牌交出去，就改写了故事，必须拒绝这种改动。
@@ -100,7 +100,7 @@ A02（摊手与蓝线头）。
 关键帧写完才知道这一格里到底有谁、有什么。按成稿正文逐项读出来，再写进 SHOT-03 的字段：
 
 ```markdown
-- 图片提示词项：IMG-SHENHE-SHEET《沈禾角色板》（控制：身份、手部特征）；IMG-CLAIM-TAG《取衣牌道具板》（控制：牌形、编号面、边缘磨损）
+- 图片提示词项：IMG-SHENHE-SHEET《沈禾角色板》（控制：身份、手部特征）；IMG-CLAIM-TAG《取衣牌道具板》（控制：牌形、背面材质、边缘磨损）
 - 输入参考图：无（待补参考图：沈禾手部、取衣牌背面、本镜起始帧）
 - 视觉依据：《视觉设定.md》·人物「沈禾」（控制：身份、右手特征）；人物「蒋姨」（控制：身份、视线方向）；道具「取衣牌」（控制：牌形、背面材质、蓝线头位置）；地点「社区洗衣房」（控制：柜台横线、冷白顶光）。
 ```
@@ -117,8 +117,8 @@ A02（摊手与蓝线头）。
 |---|---|---|---|
 | 沈禾右手 | 握牌 | 握牌 → 摊掌 | 摊掌 |
 | 牌朝向 | 背面不可见 | 背面转向蒋姨 | 背面可见 |
-| 蒋姨目光 | 沈禾脸 | 右手 | 牌背 |
-| 烘干机 | 转 | 停 | 停 |
+| 蒋姨目光 | 沈禾脸 | 沈禾脸 → 右手 | 牌背 |
+| 烘干机 | 转 | 转 → 停 | 停 |
 | 观众知道什么 | 她拒绝交牌 | 她决定展示 | 看见带血蓝线头 |
 
 运动规格只能实现表中的箭头，不能让蒋姨夺牌、让牌正面突然朝向摄影机，或让机器重新启动。

package/lib/drama/skills/short-drama-storyboard/references/shot-craft.md

@@ -26,7 +26,7 @@
 `SHT-01` 要求每个与制作有关的剧本段都有明确处理：由镜头落实、有理由地省略，或因
 新的观众体验而有意重复。
 
-先把剧本段与镜头对应起来，再设计镜头。原文落实表是责任清单，不是“一段一镜”公式。
+先在上下文中把剧本段与镜头对应起来，再设计镜头；这份对应只用于检查责任，不另建产物，也不要求“一段一镜”。
 连续表演和空间关系能守住原意时，几段原文可以合在一镜；揭示、反应、证据细节或空间
 变化很重要时，一段原文也可以由几镜承担。
 
@@ -43,7 +43,7 @@
 见下文。
 
 原文落实数量只能证明“某段原文被引用”，不能证明动作没有提前、重复或遗漏。对转手、
-开门、受伤、揭面、拿出证物等动作，另记：
+开门、受伤、揭面、拿出证物等动作，在设计时核对以下关系；最终决定落实到对应镜头：
 
 | 来源动作 | 主要落实镜头 | 动作前事实 | 动作后事实 | 其他镜头的作用 |
 |---|---|---|---|---|
@@ -153,11 +153,11 @@
 
 上面那张表是横平竖直的电影景别谱系。**竖屏不是把它裁窄，是让其中两档变得难用**。
 
-机制很简单：远景和全景靠的是**横向铺开的信息**——谁站在谁旁边、队伍有多长、这个人
-离出口有多远。9:16 的横向只有 16:9 的三分之一强，同样的信息铺进去要么挤成一条，
-要么小到读不出。所以竖屏短剧的实际用法以中景、近景、特写为主，远景与全景出现得少。
+远景和全景常用**横向铺开的信息**交代关系：谁站在谁旁边、队伍有多长、这个人
+离出口有多远。在相同画面高度下，9:16 的宽度约为 16:9 的三分之一。同样的信息横向排开，容易挤在一起，
+或因缩小而难以读清。所以竖屏短剧的实际用法以中景、近景、特写为主，远景与全景出现得少。
 
-但这**不是禁令，是换一种排法**：竖屏的空间要靠**纵深**而不是横向来交代——前景、中景、
+竖屏可优先用**纵深**交代空间——前景、中景、
 后景分层，用门框、桌沿、台阶、人的前后遮挡把关系立起来（见
 [竖屏多人调度](blocking-playbooks.md#1-竖屏多人调度)）。做到了这一点，竖屏一样能给全景；
 做不到就不要用这一档去承担交代空间的职责，改用一个更近的镜头单独给一次。
@@ -191,7 +191,7 @@
 说不出是上表哪一行，等于没有选。例如「运镜：缓推，他说出『给我五天』时开始，停在眼睛；这是他第一次把赌注
 压在自己身上」「运镜：固定；插入镜只要看清数字」「运镜：固定；这句话没有落到谁身上」。
 
-强调手段只有三种：短促推近、定格、闪白，只留给情绪爆发和重大反转，用在普通台词上，真正的峰值就
+强调手段包括短促推近、定格、闪白，只留给情绪爆发和重大反转，用在普通台词上，真正的峰值就
 显不出差别。跟随动作的跟拍、揭示信息的摇、压力落下时的缓推不是强调手段，任何一场都按上表使用。
 写完回读全集的「运镜」：有奔跑、有揭示、有峰值的一集，不会每镜都是固定。
 
@@ -257,7 +257,7 @@
 
 - **一句台词一个镜头**：说话者的镜头承载这一句；一句话里有转折时，可以在转折处切。
 - **默认给听者**：重要的一句落下时，切到听的人，让观众看见它打中了谁。
-- **来回对话用正反打**：两人交锋沿同一条轴线两侧对切，过肩或单人都可以。
+- **来回对话用正反打**：两人交锋保持摄影机在同一轴线工作侧，对切相向的说话者与听者，过肩或单人都可以。
 - **景别顺序**：先给一个带着人物和动作的交代镜，对话落到中景或中近景，只在一句话需要落地时切到特写。
 - **删空镜**：既没有台词也没有动作的镜头删掉。
 - **插入镜是便宜的节奏工具**：手机屏幕、手、戒指、证件这类插入镜不需要表演，可以插在长台词或等待中间，

package/lib/drama/skills/short-drama-storyboard/references/shot-revision-identity.md

@@ -1,13 +1,13 @@
 # 镜头修订与稳定身份
 
 镜头 ID 表示同一个编辑/导演决定的连续身份，不等于列表位置，也不等于外部制作任务编号。
-修订时先判断镜头的叙事职责是否仍是同一个，再决定保留、创建或 retire。
+修订时先判断镜头的叙事职责是否仍是同一个，再决定保留、创建或停用 ID。
 
 ## 身份规则
 
 - **重排**：只改变顺序，镜头目的与边界职责不变时保留原 ID；刷新依赖顺序与相邻边界。
 - **插入**：新增一个独立注意或戏剧职责时创建新 ID；不要给后续所有镜头重新编号。
-- **内容修订**：同一镜头目的下调整构图、blocking 或边界，保留 ID 并更新当前文档。
+- **内容修订**：同一镜头目的下调整构图、走位或边界，保留 ID 并更新当前文档。
 - **拆分**：原镜头被两个或更多独立职责取代时，停用旧 ID，为每个新镜头创建新 ID；在修订说明中
   写清前身，不把旧 ID 偷给其中一个子镜头。
 - **合并**：多个旧镜头被一个新决定取代时，停用全部旧 ID，创建新 ID，并列出来源集合。
@@ -21,5 +21,5 @@
 重新核对原文落实、场次视觉计划、关键帧、`MOTION-...`、多镜分组、相邻起止边界、总时长与审查
 结论。旧 ID 只在修订说明中解释历史，不能继续被当前镜头或交付分组引用。
 
-脚本可以检查引用、集合和算术；“是否仍是同一个导演决定”由 agent 根据镜头目的、信息变化、
+脚本可以检查引用、集合和算术；“是否仍是同一个导演决定”由智能体根据镜头目的、信息变化、
 表演所有权和边界职责判断，不能用文本相似度或数组位置硬判。

package/lib/drama/skills/short-drama-video-prompts/SKILL.md

@@ -36,9 +36,8 @@ license: MIT
 创作者可读说明跟随项目语言。开始前读取目标模型档案里的版本、执行模式、提示词方言、原生时长和
 参考方式；这些选择同时约束上游分镜和下游 adapter，不能只在正文阶段临时猜。创作者在本次请求里点名
 目标模型（例如“按 MiniMax H3 写”）而项目档案还没有这一项时，先转 `$short-drama` 把这个选择写进
-`short-drama.json` 的 `production_profile`，再回到本阶段；一句会话里的点名如果没有落到档案上，
-下一轮就会退回通用路径，方言、原生时长和参考方式又要重猜。没有项目配置的独立任务把点名的模型
-和已解析的方言写在本文档开头一行，供下游核对。视频可复制正文优先跟随
+`short-drama.json` 的 `production_profile`，再回到本阶段，供后续请求复用方言、原生时长和参考方式。
+没有项目配置的独立任务，把点名的模型和已解析的方言写在输出的《视频提示词.md》开头，供下游核对。视频可复制正文优先跟随
 `short-drama.json#/creator_authority/production_profile/choices/video_prompt_language`；未声明时回退到
 `short-drama.json#/format/prompt_language`。没有 `short-drama.json` 时，根据用户点名的目标视频模型
 确认正文语言；目标模型也未声明时沿用用户当前语言，不固定为英文。对白、VO、OS 的口语语言仍由
@@ -68,14 +67,14 @@ license: MIT
    「制作成果」和文档已指向媒体中查找真实图片。内容和用途核对后才自动绑定；不靠相似文件名猜图。
 2. 已有匹配图片时，在当前请求内先让分镜 owner 原地刷新受影响镜头的 `REF-...` 槽位，再回到本阶段；只绑本镜真正需要保持的图，不按资产数量凑槽位。
    同一次刷新里，如果这些镜头还缺「视觉依据」这个必写字段（旧文档常常没有），一并按已成稿的冻结关键帧回填——
-   两者读的是同一格画面，分开两轮只会让绑了图的镜头仍然说不清画面里有谁。
+   「视觉依据」与参考绑定都依据该镜冻结画面，应在这次刷新中一起补齐。
    新槽位必须逐字使用 `REF-<slot>（顺序：<n>）· <项目相对路径>《<中文名称>》（用途：<用途>；控制：<范围>；不得控制：<范围>）`；`用途` 取 `身份|造型状态|地理|构图|尺度|效果|起始帧|结束帧|风格` 之一，不得自创斜杠分隔写法。多图只用 `；` 连接，写完后先按格式回读，再复制到视频文档。
 3. 仍有必要图片缺失时，一张都没有就把分镜写成「无（待补参考图：……）」；只缺一部分则保留已核对的 `REF-...`，并在末尾追加「；待补参考图：……」。一次列出缺失镜头、图片用途和对应的 `IMG-...` /冻结关键帧，然后停在视频提示词之前。
    不伪造路径，不把图片提示词当成图，不静默降级为文生视频。
    报告缺口时把创作者真正有的三条路一起说清楚，不要只给「生成参考图」和「改成文生视频」：
    把已有图片放进项目绑成 `REF-...`；由创作者在自己的工具里出图、本轮先写成 `PLAN-...` 挂图计划；
    或者明确改走文生视频。缺口清单本身就是那份挂图计划的草稿，逐镜写清要哪几张、每张管什么。
-4. 只有创作者明确选择不用参考图时，才把分镜记为「无（创作者已明确选择文生视频）」。准备闭合后原样抄入分镜的「输入参考图」，据此标明
+4. 只有创作者明确选择不用参考图时，才把分镜记为「无（创作者已明确选择文生视频）」。参考图准备完成后，原样抄入分镜的「输入参考图」，据此标明
    「生成方式：图生视频」或「生成方式：文生视频」。该字段只写这两个精确值，不追加模型名、方言或 full-reference 等说明；模型说明留在正文结构中。
    具体走首帧、首尾帧还是多槽参考，由各槽位的 `用途` 组合读出：只有一张 `起始帧` 走首帧，`起始帧` 加 `结束帧` 走首尾帧，
    `起始帧` 与人物/地点/道具图同时存在或只有这些图时走多槽参考。命中的模型方言负责把这个组合翻成它自己的素材 role 与正文结构；
@@ -84,7 +83,7 @@ license: MIT
    adapter 报错，也不能在正文里暗自改变时长。
    有对白、VO 或 OS 时，同时核对分镜「声音」中的估时依据与实际可用发声窗口；缺少依据就按
    [对白预算](references/performance-action-timing.md#对白预算) 补做判断。秒段加总正确不代表台词说得完。
-6. 写不能动的边框：图生视频以参考帧和视觉设定锁定；文生视频把必要静态事实写入「静态视觉锚点」和可复制正文。
+6. 写明本镜必须保持的状态：图生视频以参考帧和视觉设定锁定；文生视频把必要静态事实写入「静态视觉锚点」和可复制正文。
 7. 原样读取分镜的「起点 → 唯一动作 → 终点」，确认人物、双手和持物的状态转换都发生在镜内。
 8. 写“静态锚点 → 起点 → 唯一动作（触发、接触、落点）→ 次级反应 → 运镜 → 声音 → 终点”，运镜按分镜的「运镜」一行写，
    必要时用秒数分段；下一镜从这个终点继续，不另造镜外转换。
@@ -95,7 +94,7 @@ license: MIT
    且逐字对白在单镜可复制正文中只出现一次。视觉动作段只按时间和说话人引用该声音事件，不再抄一遍
    台词。事件外回到已声明的环境声或静默。Brief、剧本或声音方向已经明确禁止外语前导、语气词、
    额外人声或重复时，把这些**已确认的发声边界**在完整时间线末尾合并写一次；不靠“只包含”让执行端
-猜，也不自行扩充新的禁用类别。时间线总结只列本镜实际有的声音层。
+   猜，也不自行扩充新的禁用类别。时间线总结只列本镜实际有的声音层。
    无对白镜写清底声或静默及其覆盖区间；嘴部动作按剧本表演，不默认强制闭嘴。
    非画内配乐按目标方言声明，有需要时明确写空。
 13. 成稿时检查动作、声音和限制条件是否清楚且相容。正面状态有助于表达目标，必要的否定条件
@@ -112,6 +111,10 @@ license: MIT
     降级成独立文生视频，也不用计划尾帧、关键帧提示词或文字描述冒充接力输入。逐镜 `MOTION-...`
     仍是成员边界和内容依据，不是与正式容器路由并列的另一套提交方案。
 
+续接还要求执行端能绑定上述两项真实输入。当前 `$short-drama-produce` 的 creator-first 来源选择器只
+解析图片与角色参考音频，不能绑定续接视频；使用这条内置生产路径时，续接段保持“不可提交”，
+待执行接口支持双输入后再预览。不能省略来源选择器或改用文生视频绕过这个缺口。
+
 ## 提示词要求
 
 - 从可见起点开始，以可验证终点结束。

package/lib/drama/skills/short-drama-video-prompts/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "短剧视频提示词"
-  short_description: "基于镜头边界编写动作、表演、运镜、声音与节奏视频提示词"
+  short_description: "依据镜头边界编写动作、表演、运镜、声音与节奏的视频提示词"
   default_prompt: "使用 $short-drama-video-prompts 根据已接受镜头和关键帧编写以运动变化为核心的视频提示词。"

package/lib/drama/skills/short-drama-video-prompts/references/camera-audio-continuity.md

@@ -2,27 +2,24 @@
 
 ## 摄影机合同
 
-- `VID-06` — locked 与 moving 指令不得同时统治同一区间，除非明确的
-  transition 将两段分开。
-- `VID-07` — locked/moving 的选择，以及 audio/lip-sync 细节量，都是从
-  production profile 继承的 `taste_option`。
+- `VID-06` — 固定与移动指令不得在同一区间同时生效；两种行为之间须有明确过渡。
+- `VID-07` — 固定或移动的选择，以及声音和口型的细节要求，属于 `taste_option`，按已接受的制作档案执行。
 
 ## 相连边界 (`CON-01`)
 
-Motion end report 与下一 accepted shot start 必须一致，否则指明用于协调的
-上游 owner revision。不要用流畅的动态措辞把连续性矛盾正常化。
+运动说明的结束报告须与下一镜已接受的起点一致；不一致时，指明需要上游负责技能协调的修订。不要用流畅的动态措辞把连续性矛盾正常化。
 
 ## 目录
 
 1. 摄影机为什么动或不动
-2. Camera contradiction
+2. 摄影机指令冲突
 3. 环境运动
 4. 对白、口型与声音
 5. 只读边界与修订路由
 
 ## 1. 摄影机为什么动或不动
 
-Camera behavior 要回答“观众注意为什么在此刻改变”。常见动机：
+摄影机行为要回答“观众注意为什么在此刻改变”。常见动机：
 
 - **reveal**：新信息进入视野；
 - **pressure**：距离收紧让压力增大；
@@ -38,9 +35,9 @@ Camera behavior 要回答“观众注意为什么在此刻改变”。常见动
 
 ### 描述 lock-off
 
-锁定和 movement 一样要被写出来。一次 lock-off 至少写：
+固定与移动都要明确写出。固定机位至少说明：
 
-1. 写死的 framing：景别、机位高度、轴线哪一侧；
+1. 固定的构图：景别、机位高度、轴线哪一侧；
 2. 这段时间里画面内还有什么在动——通常只剩表演和环境，明确列出来；
 3. 保持多久。
 
@@ -48,41 +45,41 @@ Camera behavior 要回答“观众注意为什么在此刻改变”。常见动
 比只写“固定机位”可执行，也比什么都不写安全：摄影机一栏空着会被执行端读成可以自由漂移，
 于是本该稳住的镜头长出一次没人要过的推近或环绕。
 
-### 描述 movement
+### 描述移动
 
-一次 movement 至少写：
+一次移动至少说明：
 
-1. 起始 framing/相对位置（来自 shot/keyframe）；
+1. 起始构图与相对位置（来自分镜或关键帧）；
 2. 何时、因何开始；
 3. 路径/方向与节奏；
 4. 跟谁/揭示什么；
-5. 结束 framing 或空间关系（必须在 storyboard 边界内）。
+5. 结束构图或空间关系（须符合分镜边界）。
 
 “轻微推近”若不说明触发和落点，仍然含糊。“镜头在他把钥匙放上桌时开始短促推近，钥匙落下后停在双手与钥匙的近景”才有可执行注意路径。
 移动不能重置地理：若机位沿同一场景移动，仍要保持已接受的工作侧、入口—主体—出口关系
-和屏幕方向；确需越轴时沿用 storyboard 已接受的重新建立方法，不把一次漂亮移动写成新的空间。
+和屏幕方向；确需越轴时沿用分镜已接受的重新建立方法，不把一次漂亮移动写成新的空间。
 
-- **`craft_default`**：一个 authored shot 优先一个主要 camera idea；细小修正服务同一 idea。
-- **`reviewed_invariant`**：move 必须与 shot purpose、表演和 blocking 相容，不能穿过墙体或错过关键动作。
-- **`taste_option`**：locked、handheld、dolly、pan/tilt、角色跟随或静观均可，由 visual direction 决定。
+- **`craft_default`**：一个已接受镜头优先使用一种主要运镜意图；细小修正服务同一意图。
+- **`reviewed_invariant`**：移动须与镜头目的、表演和走位相容，不能穿过墙体或错过关键动作。
+- **`taste_option`**：locked、handheld、dolly、pan/tilt、角色跟随或静观均可，由视觉方向决定。
 
-## 2. Camera contradiction
+## 2. 摄影机指令冲突
 
 ### 同一区间的显式冲突
 
 - `locked-off` 同时又要求 pan/dolly/handheld 漂移；
 - “机位完全不动”同时“跟随角色穿过房间”；
 - 同一时间既向左 pan 又向右 pan，且没有反向 transition；
-- camera endpoint 与 accepted shot framing/end boundary 显式不相容。
+- 摄影机终点与已接受的构图或结束边界明确不相容。
 
-这些可在规格的 interval/behavior 中确定比较，属于 **`structural_invariant`**。修复是选择一个行为或写清时间 transition：
+这些冲突可在规格的 `intervals` 和 `behavior` 中比较，属于 **`structural_invariant`**。修复时选择一种行为，或写清过渡区间：
 
 ```text
 0.0–1.2s locked：等待她抬眼；
 1.2–4.0s slow push-in：从双人中景收至她的头肩，终点保持既定轴线。
 ```
 
-这里不是同时 lock 和 move。若 transition 改变 shot 已接受的 camera design，仍需 storyboard 同意。
+该例先固定再推进，两个区间不重叠。若过渡会改变已接受的运镜设计，仍需分镜负责技能确认。
 
 ### 摄影机与主体的相对运动
 
@@ -103,29 +100,32 @@ Camera behavior 要回答“观众注意为什么在此刻改变”。常见动
 
 ### 非冲突但可能过载
 
-pan 同时微调焦点、handheld 带自然呼吸、dolly 配合轻微 tilt 未必矛盾；是否太复杂由 reviewer 结合 purpose 判断，不能靠 camera 动词计数硬挡。
+pan 同时微调焦点、handheld 带自然呼吸、dolly 配合轻微 tilt 未必矛盾；是否太复杂由审查者结合镜头目的判断，不能靠运镜动词数量阻断。
 
 ### 切镜边界
 
-“切到门外、再切回特写”是新的 editorial cut，不是 camera movement。保持各 authored shot 独立：把多个已接受镜头按来源顺序装进同一个交付容器是允许的排布方式，把它们融成一个边界不明、无法逐镜审查的 motion 不是。判据在于每个 source shot 是否仍能被单独引用、单独比对终点。容器分层见 [delivery-profile.md](delivery-profile.md)。
+“切到门外、再切回特写”构成新的剪辑切换。多个已接受镜头可以按来源顺序装进同一个交付容器，
+但每个镜头仍须能单独引用、单独比对终点，不能融成一段边界不明、无法逐镜审查的运动说明。
+容器分层见 [delivery-profile.md](delivery-profile.md)。
 
 ## 3. 环境运动
 
-环境 motion 应来自连续性与 shot purpose：风、雨、蒸汽、布料、机械、群演、光影变化、液体/尘埃对主体动作的物理响应。
+环境运动应符合连续性与镜头目的：风、雨、蒸汽、布料、机械、群演、光影变化、液体/尘埃对主体动作的物理响应。
 
 选择规则：
 
-- 与主体接触或提供 cue 的优先；
+- 优先选择与主体接触或提供触发的元素；
 - 能加强焦点但不抢戏的保留；
-- 已由 reference frame 静态承载、且不会变化的省略；
-- 未在 accepted state 出现的天气、火、破坏、群众事件不得为“丰富画面”发明。
+- 已由参考帧静态承载、且不会变化的省略；
+- 未在已接受状态中出现的天气、火、破坏、群众事件不得为“丰富画面”发明。
 
-**`craft_default`**：每镜只写少量 story-relevant environment motion**。`reviewed_invariant`**：环境变化不能造成新的故事事实或 continuity teleport。
+**`craft_default`**：每镜只写与故事有关的必要环境运动。
+**`reviewed_invariant`**：环境变化不得发明故事事实，或让连续性状态无故改变。
 
 ## 4. 对白、口型与声音
 
 若分镜已经明确整场声音策略，先把主导声源、撤出/恢复、距离变化、
-主动留白与 sound bridge 分配到准确镜头，再写本镜 audio。逐镜实现必须能与相邻镜接上，不能
+主动留白与声音桥分配到准确镜头，再写本镜声音。逐镜实现必须能与相邻镜接上，不能
 让每镜各自重新启动一套环境音。场次计划没有登记的故事声源不得由本层发明；音乐仍服从下文的
 时间线边界，也不能替代表演或转向。
 
@@ -138,7 +138,7 @@ pan 同时微调焦点、handheld 带自然呼吸、dolly 配合轻微 tilt 未
 被打断还是到此结束；不得在前镜声称已经说完，后镜又让同一句继续。没有逐字原句时只保留
 准确引用和延续关系，不为填满节奏补写台词。
 
-若 source 写 `[VO]`、`[OS]`、`[SFX]`，保持声源性质：
+若来源写 `[VO]`、`[OS]`、`[SFX]`，保持声源性质：
 
 - dialogue：画内说话者与口型/表演相关；
 - VO：声音不要求当前画面口型；
@@ -157,11 +157,11 @@ pan 同时微调焦点、handheld 带自然呼吸、dolly 配合轻微 tilt 未
 
 ### 配乐属于时间线层 (`VID-14`)
 
-先分清两件常被混在一起的事：
+配乐意图与配乐音轨分别处理：
 
-- **标注配乐意图**：在规格里写清这一镜需要什么情绪的音乐、从哪里进、到哪里出、压在
-  对白之上还是之下。这是**应该写**的——它是给时间线层的输入，写清了才可能对齐。
-- **让单镜产物自带配乐音轨**：交付出来的单镜素材内部已经烧进了一段音乐。这是缺陷。
+- **标注配乐意图**：在《视频提示词.md》写清这一镜需要什么情绪的音乐、从哪里进、到哪里出、压在
+  对白之上还是之下。这些说明供时间线层安排配乐。
+- **让单镜产物自带配乐音轨**：单镜素材内部已经混入一段音乐。除项目已接受的做法或画内声源外，这与默认交付方式不符。
 
 **`craft_default`**：配乐意图可以逐镜标注，但配乐的**实现**归时间线层；单镜产物默认
 只承载同期对白、画外声源、环境底声与事件音效，不自带配乐音轨。
@@ -179,6 +179,9 @@ pan 同时微调焦点、handheld 带自然呼吸、dolly 配合轻微 tilt 未
   把三者一起否掉会让本该有的现场感也消失。
 - 音乐的密度、风格与情绪仍是 `taste_option`（见下），本条只规定它归哪一层，不规定它多不多。
 
+主题曲只使用创作者提供并确认可用的逐字歌词；纯配乐不写歌词，不让执行端改写已确认歌词。
+时间线音乐章节写明作用范围、进入/退出、对白让位、循环与淡化意图，生成源音轨不代表已完成剪辑落点。
+
 ### 环境底声跨镜相接
 
 配乐的推理同样适用于底声，只是结论不同：底声**留在单镜产物里**，但它必须能和相邻镜接上。
@@ -187,50 +190,49 @@ pan 同时微调焦点、handheld 带自然呼吸、dolly 配合轻微 tilt 未
 Location/View 才允许变化，并写清变化来自什么。写法与配乐标注对称——延续、在此进入、
 在此退出。
 
-不这样做的后果比配乐更隐蔽：每个单镜各自生成一段自己的房间底噪，剪在一起每个切点都
-"呼"一声换空间。配乐至少有上一条兜着，底噪没有；而单镜文本里永远看不出问题，只有素材
-相接时才暴露。
+每镜独立设计房间底噪，剪在一起容易让切点听起来像换了空间。写作时串读相邻镜头的底声说明，
+生成后再回听素材接点，检查成分和层级是否相接。
 
-### Delivery 与 lip-sync
+### 说话方式与口型
 
 可以描述速度、音量、气息、停顿、打断、称呼重音、口型意图，但不得修改台词文本来配动作。
 
-- **`craft_default`**：对白主导镜头减少竞争性动作/camera，让 reaction 有落点。
-- **`reviewed_invariant`**：delivery 必须符合角色 agenda 和表演弧；不能把威胁台词提示成真诚道歉，除非剧本有反讽依据。
-- **`taste_option`**：严格口型、近似同步、VO 优先、现场感/配乐密度由 production profile 决定。
+- **`craft_default`**：对白主导镜头减少竞争性动作和运镜，让反应有落点。
+- **`reviewed_invariant`**：说话方式须符合角色目标和表演过程；不能把威胁台词提示成真诚道歉，除非剧本有反讽依据。
+- **`taste_option`**：严格口型、近似同步、VO 优先、现场感/配乐密度由制作档案决定。
 
-若 Character 已有 `voice_direction`，运动规格分别绑定角色身份引用、逐字台词引用与声音
-方向引用；本场的气息、音量、停顿和情绪仍写在 delivery，不能覆盖持续音色/发音锚点。
+若角色条目已有 `voice_direction`，运动规格分别绑定角色身份引用、逐字台词引用与声音
+方向引用；本场的气息、音量、停顿和情绪仍写在本镜说话方式中，不能覆盖持续音色/发音锚点。
 声音参考只在创作者授权且有可解析的本地产物记录时进入，缺失时保持文字方向，不编造服务
 ID 或网址。即使引用齐全，本套件也只证明文本绑定一致，不能承诺真实音色、配音或音画同步。
 
 ### 音频矛盾
 
-- exact dialogue 同时要求“全程无人说话”；
+- 逐字对白同时要求“全程无人说话”；
 - 同一 SFX 既在动作前触发又由该动作产生；
-- source 是 VO，却要求清楚同步画内口型；
-- accepted quiet scene 被新增爆炸声改变故事；
+- 来源是 VO，却要求清楚同步画内口型；
+- 已接受的安静场景被新增爆炸声改变故事；
 - 相邻镜头各自声明了互不衔接的配乐进入/退出，或单镜自带配乐床却没有已接受的依据。
 
-Resolvable ref/显式否定可结构检查；delivery 是否语义背离则要 reviewer 证据。
+引用能否解析、指令是否显式冲突可做结构检查；说话方式是否偏离语义则需审查者提供证据。
 
 ## 5. 只读边界与修订路由
 
-### Motion 可以改
+### 本阶段可以改
 
 - 同一边界内动作的可执行路径与细节；
-- accepted emotional change 的外显方式；
-- 既定 camera idea 的节奏/触发实现；
-- accepted audio 的 delivery、空间化和层级；
+- 已接受情绪变化的外显方式；
+- 既定运镜意图的节奏与触发实现；
+- 已接受声音的说话方式、空间关系与层级；
 - 不改故事事实的环境微动；
-- prompt 的语言经济性。
+- 提示词的措辞与冗余。
 
-### Motion 不可以改
+### 本阶段不可以改
 
-- shot duration、start/end pose/position/gaze/hands/held props；
-- location/View、asset variant、axis/next-shot state；
-- screenplay action fact、dialogue/VO/SFX 文本或说话人；
-- 增删 editorial cut；
+- 镜头时长，以及起止姿态、位置、目光、双手与持物；
+- 地点、视图、资产变体、轴线与下一镜状态；
+- 剧本动作事实、对白、VO、SFX 文本或说话人；
+- 增删剪辑切换；
 - 连续性中谁知道什么、谁拥有物件、伤势/天气/光线状态。
 
 ### 当上游为本镜同时交出首帧和尾帧
@@ -250,7 +252,7 @@ Resolvable ref/显式否定可结构检查；delivery 是否语义背离则要 r
 - 终点报告仍然逐字段对照分镜的 `end_boundary`，**不对照尾帧**。尾帧只是该边界的投影，
   画面对上了不等于终点事实到达了——尤其是持物归属和目光对象，两者最容易只在构图上成立。
 
-### Revision request
+### 修订请求
 
 ```markdown
 - **请求 owner**：`storyboard | write | assets`
@@ -262,10 +264,10 @@ Resolvable ref/显式否定可结构检查；delivery 是否语义背离则要 r
 - **未执行**：列明本轮没有修改的 owner 文件
 ```
 
-Video-prompts 可以提议，不能替 owner 应用。若实际终点不同于分镜终点：先判断是提示词没实现
+视频提示词阶段可以提议，不能替上游负责技能执行修订。若实际终点不同于分镜终点：先判断是提示词没实现
 （video-prompts 修）还是创作确需新边界（storyboard 修）；无论哪种都不把观察到的终点当成下一镜权威。
 
-### Handoff 核对
+### 交接核对
 
 逐字段比较运动终点与镜头终点；下一镜仍直接读取分镜拥有的起点。匹配才是实现证据，不能用一句
 “保持连续”代替位置、目光、双手、持物等关键事实核对。