@oh-story/dsh 0.1.15 → 0.1.17

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

@@ -47,37 +47,34 @@ composition, camera/lens, frame-only staging, and exclusions.
 
 ### 写完之后过一遍可渲染检查
 
-判据是一句话：**接手的人能不能照着画出来，而不用自己发明任何事实**。逐条对照，
-缺哪条补哪条——这些不是可选修辞，缺一条执行端就得替你决定一次：
+检查接手的人能否读出当前帧必须保持的可见事实。按构图和镜头职责核对下表，
+只补本帧实际需要的内容：
 
-| 必须写出来 | 缺了会发生什么 |
+| 检查内容 | 信息缺失时的风险 |
 |---|---|
 | 每个人在哪、彼此距离多少（"站在他正前方约两步"） | 人物间距逐镜漂移，观众读成换了场地 |
-| 前景、中景、背景各有什么 | 纵深塌成一层，主体贴在背景上 |
+| 构图需要纵深时，前景、中景、背景分别承载什么 | 层次不明，主体与背景混在一起 |
 | 视线该落在哪（本镜的视觉重点） | 画面平均用力，观众不知道该看谁 |
 | 构图方式与景别 | 同一场每镜构图随机，剪不到一起 |
 | 机位在轴线哪一侧、俯仰角度、焦段意图 | 越轴；正反打方向对不上 |
 | 光从哪来、什么质感 | 同场光位逐镜跳变 |
 | 每个在场者的姿态、朝向、手部、持物 | 下一镜接不住，道具凭空易手 |
-| 哪些与上一镜相同 | 执行端把"没写"读成"可以变" |
+| 与上一镜连续的关键状态在本帧具体是什么 | 只写“同上”，当前正文无法独立说明状态 |
 
-最后一条最容易漏，也最便宜：与上一镜一致的部分**写一句"与上一镜相同"即可**，
-不必重述细节；真正变了的才展开写。这一句是连续性的承载点。
+连续性核对时可以与上一镜比较；可复制正文仍须写出当前帧的位置、持物和其他必要状态，
+不能用“与上一镜相同”代替执行端本次需要的事实。
 
-**写紧**：一件事只说一次，能并进一句就不另起一句。上表十二项写满大约五百字就够；
-写到八百字往上，多出来的通常是连接词、铺垫句和把同一件事换个说法再说一遍——它们不增加
-可渲染的事实，却按字数付费。检查办法：删掉任意一句，如果画面没有变得更不确定，那句就是
-多的。
+**`craft_default`：一件事只说一次。** 合并能自然衔接的句子，删除重复事实和不帮助确定画面的铺垫。
+不设通用字数门槛；保留当前帧所需的身份、空间、构图、光线、文字和连续性事实。
 
-写出来是这样（合成材料，四百余字覆盖上表全部十二项）：
+以下合成片段示意构图与静态事实的组织方式：
 
 ```text
 竖屏 9:16 中近景。机位在轴线左侧、高约一米二，平视略低约五度，中焦 50mm。前景是长凳
 扶手与半张湿报纸（占下缘约六分之一）；中景是两人对峙；背景是虚焦的候车牌。三分构图，
 她落在右三分线上。她：坐长凳右端，双手交叠压膝，身体朝向正前，视线落在对方鞋尖，
 无持物。人物乙：站她正前方约两步、略偏画面左，双手插袋，身体朝向她，头略偏向出口。
-光自画面右上顶棚缝隙斜下为主光（硬），左侧留暗，无补光。视觉重点在她压膝的双手——
-本镜唯一不动的东西。位置与持物与上一镜相同，只有她的视线从水洼移到对方鞋尖。
+光自画面右上顶棚缝隙斜下为主光（硬），左侧留暗，无补光。视觉重点在她压膝的双手。
 排除：无动作过程，无雨丝拖影。
 ```
 
@@ -93,13 +90,11 @@ instead of inventing a hidden candidate state.
 
 ## 尾帧：什么时候可以有，以及它换来什么代价（`SHT-17`）
 
-默认每镜一张关键帧，冻结的是 start。但首尾帧接续是 AI 视频里最常用的工作流之一：把首帧
-和尾帧一起交给执行端，中间由它补。套件此前没有尾帧的位置，于是这条路要么走不通，要么被
-私自绕过——后者更糟，因为绕过时尾帧往往是**独立画出来的**，它就成了第二个终点权威，与
-镜头 `end_boundary` 各说各话。
+默认每镜一张首帧，冻结 `start_boundary`。交付工作流需要首尾帧时，再补一张投影
+`end_boundary` 的尾帧；两帧之间的运动仍按分镜边界和运动提示词实现。
 
-**`structural_invariant`**：关键帧记录必须声明 `boundary_role`（`start` 或 `end`），
-`boundary_ref` 指向同一镜头对应的那个边界字段。**尾帧是 `end_boundary` 的投影，
+**`structural_invariant`**：《分镜.md》的首帧与收尾关键帧分别指向同一镜头已接受的起点与终点。
+**尾帧是 `end_boundary` 的投影，
 不是新的终点事实**——它与首帧对 `start_boundary` 的关系完全一样：可以决定这一帧怎么构图、
 用什么景别镜头、光怎么落，不能决定人在哪、手里有什么、看着谁。尾帧与镜头终点不一致时，
 错的是尾帧。
@@ -125,16 +120,16 @@ instead of inventing a hidden candidate state.
 from the boundary that frame declares. 首帧写进任何由运动或终点首次产生的事实是漂移；
 尾帧写进在它之前就已经消耗掉的事实同样是漂移。两帧各守各的边界，不互相借用。
 
-Keyframe 默认是 shot start，不是“本镜最有戏的时刻”。为避免把 end 提前：
+关键帧默认投影镜头起点，不能直接选取“本镜最有戏的时刻”。为避免提前写入终点事实：
 
 1. 先明确本帧冻结 `SHOT-...` 的起点，草拟正文时暂不读终点与运动描述；
-2. 只填 start 已成立的 position/pose/gaze/hands/held props/visible state；
-3. 再与 end 做“新出现事实”差集；差集中的事实不得出现在 keyframe prompt；
+2. 只填起点已成立的位置、姿态、目光、双手、持物和可见状态；
+3. 再对照终点，找出动作后才产生的事实，确保它们未进入起始关键帧正文；
 4. 写完 Markdown 后从自然语言反向提取手位、持物、目光和可见状态，与镜头起点再比一次；
    不能只看条目说明而忽略真正交付的正文。
 
 反例：start 是“右手空置、看对方”，end 是“右手握铃绳、看门”。冻结帧写
-“手已握铃绳”即使很好看，也属于 boundary drift。
+“手已握铃绳”会提前写入终点事实，属于边界漂移。
 
 ## Static test
 

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

@@ -24,7 +24,7 @@
 > 主光来自画面左侧；画面左侧脸颊较亮，另一侧留柔和阴影，眼睛仍可辨认。
 
 仅写「电影感、氛围感强」不足以决定画面。一次图片模型对照中，描述受光结果比只写
-光位更稳定；这可以作为起步写法，不能据此保证其他模型或视频同样执行。
+光位更稳定，可作为起步写法；其他模型和视频结果仍需检查。
 暗部深度、边缘亮光和背景亮度按本镜需要写，不把例子中的效果全部照搬。
 
 ## 参考板与跨镜连续性

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 根据已接受镜头和关键帧编写以运动变化为核心的视频提示词。"