@oh-story/dsh 0.1.15 → 0.1.17

package/lib/drama/skills/short-drama-video-prompts/references/motion-recipe.md

@@ -5,7 +5,7 @@
 1. 目的、输入与权属
 2. 起止边界清单
 3. 运动说明的七个部分
-4. 从结构化规格到自然语言
+4. 从镜头事实到自然语言
 5. 输出、常见问题与检查
 
 ## 本文负责的规则
@@ -21,16 +21,16 @@
 
 ## 字段必须填写本镜的具体内容
 
-**`VID-08 · reviewed_invariant`**：结构化运动规格必须写出本镜准确的主体、动作、
+**`VID-08 · reviewed_invariant`**：每个 `MOTION-...` 条目必须写出本镜准确的主体、动作、
 接触和结果；本镜确有可见表演变化时，再写承担变化的演员，不能只放可复制的占位句。
 
-字段说明不是镜头内容。每个 `ordered_subject_motion` 都要写本镜准确的角色绑定、
+字段说明不是镜头内容。有序动作要写本镜准确的角色绑定、
 触发条件、可见动作、方向/路径、接触对象、阶段结果和顺序。不得在所有镜头复制
-“已确认主体”“已确认动作”“到达已确认终点”。若使用 `performance_arcs[]`，只写这次
+“已确认主体”“已确认动作”“到达已确认终点”。本镜有表演变化时，只写这次
 变化真正需要的触发、处理、选择或落点，不为字段齐全复制一套固定步骤。
 
-判断方法：若一条结构化记录原样复制到下一镜仍然成立，它多半没有写出本镜的具体内容。
-保留字段，把值换成本镜事实，并删掉无关物件和动作。
+判断方法：若一条运动说明原样复制到下一镜仍然成立，它多半没有写出本镜的具体内容。
+把内容换成本镜事实，并删掉无关物件和动作。
 
 ### 选择性变换边界
 
@@ -56,7 +56,9 @@
 观察说明才能支持像素/文字结论；只有文本引用时保持“未验证”。
 
 **`VID-12 · reviewed_invariant`**：普通母版不写覆盖清单；只有局部补拍或替代实现才在同一
-`MOTION-...` 章节下写“版本关系”。用稳定 ID 指明母版与补拍，逐项列出动作、反应、对白、揭示、
+`MOTION-...` 章节下写“版本关系”。同一 `SHOT-...` 只保留一个正式 `MOTION-...` 及一份可复制正文，
+候选差异写在普通说明中；需要独立补拍镜头时，先交分镜新增对应 `SHOT-...`，再写匹配的 `MOTION-...`。
+用已有标题指明母版与补拍，逐项列出动作、反应、对白、揭示、
 结束边界和项目要求由本版本、母版、另一补拍承担，还是必须退回分镜。运动提示词只能提出替代；
 reviewer 结合完整故事义务决定，不能让未承担内容随更短提示词消失。
 
@@ -67,7 +69,7 @@ reviewer 结合完整故事义务决定，不能让未承担内容随更短提
 
 ## 1. 目的、输入与权属
 
-视频提示词不负责“想一个更精彩的镜头”，而是把已确认镜头的变化写成能按时间执行的过程。
+视频提示词把已确认镜头的变化写成能按时间执行的过程。
 输入包括：镜头与关键帧、准确的资产引用、时长、镜头目的、起止边界、对白、画外音、音效和声音引用、
 进出连续性、视觉/声音方向和可选的制作能力配置。
 
@@ -76,7 +78,7 @@ reviewer 结合完整故事义务决定，不能让未承担内容随更短提
 
 ## 2. 起止边界清单
 
-写提示词前先做内部卡片：
+写提示词前可在上下文核对以下内容，不另建卡片：
 
 ```text
 镜头/关键帧：准确的 `SHOT-...`；`IMG-...` 只定位图片提示词条目，不表示已有关键帧图片
@@ -107,12 +109,12 @@ reviewer 结合完整故事义务决定，不能让未承担内容随更短提
 
 ## 3. 运动说明的七个部分
 
-### 3.1 起点 `start_anchor`
+### 3.1 起点
 
 用现在时、静态句准确写出起点，避免“她准备站起来”这种已经加入未来动作的写法。
 若关键帧与镜头起点不一致，先请求分镜环节解决，不能任选其一。
 
-### 3.2 有序动作 `ordered_subject_motion`
+### 3.2 有序动作
 
 每个动作阶段说明：谁行动、做什么、方向/路径、对象/接触、先后条件和到达状态。优先按因果关系连接：
 
@@ -132,17 +134,17 @@ reviewer 结合完整故事义务决定，不能让未承担内容随更短提
 先把起点中的持续关系翻译成动作自由度：用正向状态写清贯穿本镜的支撑、固定、接触或空间关系，
 再只安排允许的身体/物件通道。关系变化必须来自已接受动作并落到已接受终点；否则按 `VID-01`
 保持只读。可复制正文写清持续状态和允许动作，避免重复约束；必要的排除条件可以保留。
-成稿后在正文内直接改掉残留的这类否定结构，不另建检查步骤或报告。
+成稿时检查否定条件是否必要，并把可由持续状态直接说明的部分改为正向描述。
 
 **`craft_default`**：一条运动提示词优先只有一个主导的戏剧变化，必要反应、环境与摄影
 都服务这项变化；这不是固定动作数量。若同一镜必须同时完成互不依赖的交接、追逐、身份
-揭示和大范围效果，先向 storyboard 请求按注意或力学边界拆镜。反过来，也不能为了变短
+揭示和大范围效果，先向分镜负责技能请求按注意转移或动作衔接拆镜。反过来，也不能为了变短
 删掉逐字对白、关键反应或终点义务；短与长都不是质量指标，可执行的因果路径才是。
 
 若该动作包含选择性变换，按 `VID-11` 把触发、目标范围、结束几何/状态和 `preserve_set`
 写进相应动作阶段；不能让相邻非目标人物、道具或已批准文字跟随目标一起改变。
 
-### 3.3 表演过程 `performance_arcs[]`
+### 3.3 表演过程
 
 表演不是表情标签序列。找到最小变化：
 
@@ -160,7 +162,7 @@ reviewer 结合完整故事义务决定，不能让未承担内容随更短提
   常见的整体动作，剧情不压在微表情上。AI 真人剧保持生活化的克制，但峰值也要有一个读得出的表演拍，例如一次
   明显的变脸、一次猛地停住或转身，不让整集只剩静脸。形态读 `视觉设定.md` 的制作形态，或已接受节奏档案的 `form`。
 
-### 3.4 摄影机 `camera`
+### 3.4 摄影机
 
 选择有明确目的的固定机位或一条主要运动路径。移动机位要写动机、开始条件、运动方向/速度和
 终点景别；例如“当信封被推入光区时，机位做一次短促前移，停在手与印章的近景”，
@@ -184,7 +186,7 @@ reviewer 结合完整故事义务决定，不能让未承担内容随更短提
 
 确有叹气、吸气、笑声或重叠说话时，把它作为有来源的事件列入。声音不同轨时仍只写后期职责。
 
-### 3.6 时间 `timing_plan`
+### 3.6 时间
 
 默认把这几秒写成一条读得出先后的节拍链：
 
@@ -198,8 +200,7 @@ reviewer 结合完整故事义务决定，不能让未承担内容随更短提
   写「指尖碰到杯沿后停住」的 4 次全部停在杯沿。写不出终点接触什么、停在哪个地标，
   通常说明这一拍还没想清楚——先把动作想清楚，再回来写这一句。
 - **可以钉一到两个锚点秒数**：起手保持多久、终点定格多久、一次运镜走多久（“起手不动约半秒”
-  “结束姿态定住约一秒”）。锚点是写在正文里的散文标注——不拆成 `timing_plan` 分段、不把
-  `mode` 写成 `explicit`、不参与 `VID-04` 求和。所有锚点相加应当明显小于镜头时长，链条其余
+  “结束姿态定住约一秒”）。锚点是正文中的散文标注，不单独拆成显式分段，不参与 `VID-04` 分段求和。所有锚点相加应当明显小于镜头时长，链条其余
   部分留给相对先后；锚点多到要铺满整镜时，改写成下面的显式分段。
 - **并行通道由“与此同时”显式标出，一条链只给一条**，且落在串行链没占用的通道上：另一个
   角色、主体的另一处身体通道，或环境。同一只手、同一道视线不能同时走两条。
@@ -213,21 +214,20 @@ reviewer 结合完整故事义务决定，不能让未承担内容随更短提
 - **`reviewed_invariant`**：即使数学不超时，台词、动作、反应是否可完成仍由审查者结合语言、强度和物理路径判断。
 - 不设通用“每秒几字/几个动作”硬门槛。
 
-写显式秒段时按这三个字段落实：
+在同一 `MOTION-...` 条目写显式秒段时核对三件事：
 
-| 字段 | 含义 |
+| 检查项 | 含义 |
 |---|---|
-| `timing_plan.mode` | `explicit` 才做算术断言。写 `relative` 就不要再给分段标 `explicit`，两者同时出现是自相矛盾，校验器会直接报 `VID_TIMING_MODE_INCONSISTENT` 而不是替你选一个 |
-| `timing_plan.declares_overlap` | 分段区间确实要重叠时置 `true`，此时占用时间按并集计算。留空或 `false` 而区间又重叠，视为漏写重叠关系而不是默认相加 |
-| `timing_plan.declared_total_or_endpoint_seconds` | 可以写并集占用时长，也可以写终点秒数；两种读法都接受，但必须与分段实际情况对得上 |
+| 计时方式 | 明确写出各段起止时间才按显式分段求和；只写相对先后时，不声称已经按秒对齐 |
+| 重叠关系 | 区间确需重叠时写明，实际占用时间按并集计算，不能默认逐段相加 |
+| 计时范围 | 总占用时长与最后终点分别核对，避免空档与超出互相抵消 |
 
-算术由 [motion_timing_check.py](../scripts/motion_timing_check.py) 执行：超出按**终点**判断，
-不足按裁剪到镜头长度内的**并集**判断。两者分开量是因为中间留空加尾部超出会互相抵消——
+超出按**终点**判断，不足按裁剪到镜头长度内的**并集**判断。两者分开量是因为中间留空加尾部超出会互相抵消——
 `0.0-2.0` 加 `3.0-5.0` 在 4 秒镜头上"合计正好 4 秒"，实际却同时发生了截断与留白。
 
-### 3.7 结束报告 `end_report`
+### 3.7 终点核对
 
-把描述结果写回同一组起止边界字段：姿态、位置、目光、双手、持物和可见状态变化。
+在同一 `MOTION-...` 条目核对姿态、位置、目光、双手、持物和可见状态变化。
 逐项对照分镜的 `end_boundary`：
 
 ```text
@@ -236,9 +236,9 @@ reported_end 不同：mismatch + 请求修改分镜
 提示词未实现某字段：unrealized + 修改运动说明
 ```
 
-`end_report` 永远不是下一镜的权威输入。不能用运动规格中的“更自然结尾”覆盖已确认终点。
+本镜的终点核对说明不是下一镜的权威输入。不能用运动规格中的“更自然结尾”覆盖已确认终点。
 
-## 4. 从结构化规格到自然语言
+## 4. 从镜头事实到自然语言
 
 ### 可复制的写法骨架
 
@@ -251,26 +251,24 @@ reported_end 不同：mismatch + 请求修改分镜
 
 ### 写完之后过一遍可执行检查
 
-判据：**执行端照着这段能不能生成，而不用自己决定任何一件事**。逐条对照，缺哪条补哪条：
+检查执行端能否从正文读出本镜必要的起点、先后、边界与终点。只补本镜实际需要的内容：
 
 | 必须写出来 | 缺了会发生什么 |
 |---|---|
 | 起手状态（这一拍从哪个姿态开始） | 执行端自选起点，接不上前一镜的终点 |
 | 串行链：接着→随后，每一步带方向，终点落到接触点或地标 | 动作糊成一团，看不出先后，也不知道停在哪 |
-| 一条并行通道，用「与此同时」标出 | 要么全片只有一个人在动，要么所有人一起动 |
+| 确有并行动作时，用「与此同时」标出其通道 | 并行关系不明，可能被误读为串行或全员同时动作 |
 | 结束状态（终点姿态定在哪） | 收尾被自由发挥，下一镜起点失效 |
 | 摄影机：锁定写死构图与保持多久，移动写触发、路径、终点景别；两种都补一句**这次要让观众看清什么** | 空着会被读成可以自由漂移；没有理由的运镜是装饰，执行端换一种也说得通，于是真换 |
 | 有台词时把台词逐字挂在它发生的那一拍上 | 口型对不上，或台词被当成画面内容渲染 |
 
-**写短**：这段是给生成器的执行指令，不是给人读的散文。上表六项在**两百字上下**就能写满，
-超过三百字基本可以确定有冗余。省字的办法是合并而不是删项——压到一百八十字以内时，
-最先掉的是台词挂载与声音这两项，把它们挤掉换来的字数不值：
-把景别、机位、角度、焦段并进一句（「固定中近景，轴线左侧平视，中焦」），把并行通道挂在它
-真正发生的那一拍后面而不另起一句。
-形容词、情绪解释、把同一个动作换个说法再说一遍都不改变生成结果，只增加成本；
-参考帧已经表达的长相、服装、场景装修一律不重复。
+**`craft_default`：删重复，不按字数裁剪。** 将景别、机位、角度和焦段合进一句，
+例如「固定中近景，轴线左侧平视，中焦」；确有并行动作时，把它接在实际发生的那一拍后面。
+优先删除重复外观、同一动作的换词复述和不能指导表演的解释，保留台词挂载、声音、
+起止条件与连续性锁面。正文长度由本镜内容和目标模型上限决定。
 
-写出来是这样（合成材料，约两百字覆盖上表全部六项）：
+以下合成片段示意动作链、并行通道和摄影机的组织方式；其中从压膝姿态到站直的起身过程仍需补足，
+不能照抄为完整终稿：
 
 ```text
 从她双手交叠压膝、视线在脚边水洼的起点开始。首先保持不动约半秒；接着右手离膝向伞柄
@@ -280,7 +278,7 @@ reported_end 不同：mismatch + 请求修改分镜
 ```
 
 把元数据、`hash`、内部规则 ID 留在 Markdown 卡片，不放进可复制提示词。避免供应商参数、权重语法、任务指令和质量承诺。
-参考图文件名、版本号、锁定标记、草图指代和重投备注同样不进交付文本——执行端会把它们当画面内容渲染出来；完整清单与改写方法见
+参考图文件名、版本号、锁定标记、草图指代和重投备注同样留在正文外，避免与生成内容混淆；完整清单与改写方法见
 [production-prompt-grammar.md](production-prompt-grammar.md) 的“交付文本只含交付内容”。若项目声明了分段交付档案，容器算术与槽位职责见
 [delivery-profile.md](delivery-profile.md)。
 

package/lib/drama/skills/short-drama-video-prompts/references/performance-action-timing.md

@@ -2,8 +2,8 @@
 
 ## 时长门槛
 
-- `VID-04` — 显式标时的各段必须合计等于 accepted duration：超出与留下未分配余量同样违约。
-- `VID-05` — 未标时的 action load 是 `reviewed_invariant`：根据本镜头证据审查
+- `VID-04` — 显式标时的各段必须合计等于已接受的镜头时长：超出与留下未分配余量同样违约。
+- `VID-05` — 未标时的动作负载属于 `reviewed_invariant`：根据本镜头证据审查
   表演和故事变化是否仍可读，不套通用“每秒几个动词”公式。
 
 ## 目录
@@ -16,38 +16,39 @@
 
 ## 1. 动作预算不是计数器
 
-动作预算问的是：在 accepted duration 内，演员能否保持故事重点，清楚完成必要动作/反应/对白和 end state？它不是“每镜最多三个动词”或“每秒固定字数”。动作距离、接触复杂度、语言节奏、停顿、表演强度与相机是否需要等待，都比动词数量重要。
+动作预算要判断：在已接受的镜头时长内，演员能否保持故事重点，清楚完成必要动作、反应、对白并到达终点？它不是“每镜最多三个动词”或“每秒固定字数”。动作距离、接触复杂度、语言节奏、停顿、表演强度与相机是否需要等待，都比动词数量重要。
 
-**`reviewed_invariant`**：general feasibility 由审查者用 shot、motion、对白和时长证据判断。只有显式 segment 数学超时才是 `structural_invariant`。
+**`reviewed_invariant`**：整体可行性由审查者结合分镜、运动说明、对白和时长判断。显式分段超时或未覆盖完整镜长则按 `VID-04` 判为 `structural_invariant`。
 
 ## 2. 构造可演的动作链
 
-### 先找不可删的 spine
+### 先找不可删的主动作
 
-从 shot purpose 反推：
+从镜头目的反推：
 
 - 哪个动作造成信息/权力/情绪变化？
-- 哪个 reaction 让观众读懂变化？
-- 哪个动作必须完成才能到 accepted end？
+- 哪个反应让观众读懂变化？
+- 哪个动作必须完成才能到达已接受终点？
 - 哪些只是“让画面忙起来”？
 
-保留 spine，装饰动作最后加入。短镜头常见的有效结构是“一次决断动作 + 一次对方/自身 reaction”，但这只是 **`craft_default`**。
+先保留主动作，最后加入装饰动作。短镜头常见的有效结构是“一次决断动作 + 一次对方或自身反应”，但这只是 **`craft_default`**。
 
 ### 给动作以条件与结果
 
-动作 stage 至少明确 actor、方向/对象和到达结果。接触动作注意顺序：先靠近、再触碰、再施力、物体才变化；持物转手必须写清哪只手、何时释放/接住。角色不能在同一时刻用同一只手完成不相容任务。
+每个动作阶段至少明确行动者、方向或对象，以及到达结果。接触动作注意顺序：先靠近、再触碰、再施力、物体才变化；持物转手必须写清哪只手、何时释放/接住。角色不能在同一时刻用同一只手完成不相容任务。
 
-空间位移要尊重 shot start 的距离和障碍。若要穿过房间、开锁、取物、返回、说完长对白，问题通常不在 prompt 措辞，而在 shot boundary/时长，需要 revision request。
+空间位移要符合镜头起点已有的距离和障碍。若同镜要求穿过房间、开锁、取物、返回并说完长对白，
+应先核对镜头边界和时长；放不下时向分镜提出修订请求。
 
 ### 同时发生的合理用法
 
-“同时”适合可自然叠加的通道：角色说话时缓慢抬眼，环境雨声持续，camera 平稳跟随。不要用它压缩互为条件的动作，或让双手/身体执行物理冲突。
+“同时”适合可自然叠加的通道：角色说话时缓慢抬眼，环境雨声持续，摄影机平稳跟随。不要用它压缩互为条件的动作，或让双手/身体执行物理冲突。
 
 ## 3. 构造可见的表演变化
 
 ### 角色不是情绪滑块
 
-不要机械排列“平静 30% → 紧张 70% → 震惊 100%”。从角色 agenda 和触发选择外显通道：
+不要机械排列“平静 30% → 紧张 70% → 震惊 100%”。从角色目标和触发选择外显通道：
 
 - 目光：寻找、回避、锁定、短暂失焦；
 - 呼吸/声音：吸气被截断、语速变化、音量反常降低；
@@ -59,12 +60,10 @@
 
 ### 可选：表演标尺只用来校准形容词
 
-只有创作者已经声明并接受一套表演标尺时才使用它。**本文档不提议任何刻度、增量公式或
-每镜升压规则**；没有创作者标尺时就写可见表演，不写数字。
+只有创作者已经声明并接受一套表演标尺时才使用它。没有创作者标尺时直接写可见表演，不自行增加刻度、增量公式或每镜升压规则。
 
-标尺唯一的职责是**消歧一个形容词要演到多硬**。“淡然”“不安”“恐惧”之间有清楚的高低
-次序，而同一个词在不同人物、不同场合的合理落点其实相当集中——所以标尺回答的是“这里
-的‘不安’是欲言又止，还是手抖到握不住杯子”，不是“这一镜该比上一镜更用力”。这也是
+标尺用于明确**一个情绪形容词在当前角色和场合下对应什么可见表演**。例如这里的“不安”
+是欲言又止，还是手抖到握不住杯子；取值从角色、触发和后果判断，不要求后一镜比前一镜更用力。这也是
 [production-prompt-grammar.md](production-prompt-grammar.md) 里“哪些情绪形容词可删”的
 另一面：能被标尺定住落点的形容词才值得留下，定不住的应当换成可见动作。
 
@@ -83,7 +82,7 @@
 - **数字不替代表演**。标尺值旁边必须仍有可见通道（目光、呼吸、身体、语言、决断动作）；
   只有数字的表演等于没写表演。
 
-与剧本的关系：剧本的 `（情绪）` 括注是表演状态和说话方式的同一个来源。标尺值、可见
+剧本的 `（情绪）` 括注同时约束表演状态和说话方式。标尺值、可见
 表演与台词的说话方式都应当从这一个括注派生；三者互相矛盾时以剧本括注为准，需要改动
 就发修订请求，不在提示词里自行折中。
 
@@ -133,12 +132,12 @@ Seedance 2.5 样片档的同轮对照以逐段可见反应链最好，保留上
 而不是只增加情绪形容词。
 
 - **`craft_default`**：若一镜只有信息接收，宁可把变化做小而清楚，不必每镜“情绪大爆发”。
-- **`reviewed_invariant`**：表演选择应与剧本 agenda/shot purpose 相容，不能凭 prompt 改写人物立场。
+- **`reviewed_invariant`**：表演选择应与人物目标、镜头目的相容，不能通过提示词改写人物立场。
 - **`taste_option`**：停顿多寡、微表演或类型化表演由导演风格决定。
 
 ### 反应的对象
 
-明确角色对什么反应，而不是孤立写“她突然震惊”。触发必须来自 accepted shot/script/audio，或是 already-visible 环境事实。Reaction 若揭示新知识，要确认角色在这一刻确实获得它。
+明确角色对什么反应，而不是孤立写“她突然震惊”。触发必须来自已接受的分镜、剧本、声音，或已可见的环境事实。反应若揭示新知识，要确认角色在这一刻确实获得它。
 
 ## 4. 时间与对白共同预算
 
@@ -148,7 +147,7 @@ Seedance 2.5 样片档的同轮对照以逐段可见反应链最好，保留上
 
 ### 显式时间
 
-需要 timing 时，列阶段与 overlap：
+需要明确计时时，列出各阶段及重叠关系：
 
 ```text
 0.0–0.8s：保持 start，听见门闩声后目光转向门
@@ -156,18 +155,19 @@ Seedance 2.5 样片档的同轮对照以逐段可见反应链最好，保留上
 2.6–4.0s：说完后停住，右手仍握笔，落到 accepted end
 ```
 
-区间不可无意重叠；显式非重叠总量/最大终点不得超 duration。总量小于 duration 时也要处理：把余量分配给已有阶段（原因见 [motion-recipe.md](motion-recipe.md) 3.6）。不要为了塞进数学窗口而静默删掉 exact dialogue。
+区间不可无意重叠；显式分段不得超出已接受镜长，其时间并集须完整覆盖本镜。存在余量时，
+将余量分配给已有阶段，原因见 [motion-recipe.md](motion-recipe.md) 3.6。不得为凑时长删掉逐字对白。
 
 ### 对白预算
 
-评估：句长与语言、人物语速、情绪造成的停顿/吞吐、是否需要听见对方/环境 cue、口型要求、动作是否能与说话叠加、结尾是否有 reaction landing。固定每秒字数只能作为 production profile 的可覆盖估算，不能成为通用规则。
+评估：句长与语言、人物语速、情绪造成的停顿/吞吐、是否需要听见对方或环境中的触发声音、口型要求、动作是否能与说话叠加、结尾是否需要反应落点。固定每秒字数只能作为制作档案中可覆盖的估算，不能成为通用规则。
 
 **`craft_default`**：先读取分镜「声音」的预算依据。有同句同表演录音时用实测发声区间；没有时按完整原文、
 语言和表演方式给出「文本估计」区间，以较慢一端检查容量，不假称朗读或 TTS 实测。对白可用窗口要扣除
 开口前等待、不能同时进行的动作、轮流说话的其他发声与末尾反应；句内停顿已经计入时不再重复扣除。
 并行动作可以共享时间，顺序事件必须累加。把依据简写在当前镜头说明里，不放进可复制正文当成模型指令。
 
-例如 accepted duration 为 7 秒，开场与收尾各占 0.5 秒，实际只剩 6 秒发声；若完整台词估计需要
+例如已接受镜长为 7 秒，开场与收尾各占 0.5 秒，实际只剩 6 秒发声；若完整台词估计需要
 8–10 秒（含句内停顿），即使写成「0–7 秒」也不成立。请求分镜按至少 11 秒重新安排，或按语义拆镜，
 待上游修订后同步本镜时长、正文时序和生成设置。不要用更快语速、截断标记或静默删词让算术看起来成立。
 
@@ -186,29 +186,29 @@ Seedance 2.5 样片档的同轮对照以逐段可见反应链最好，保留上
 对白太长时选项：
 
 1. 简化非必要动作，让对白成为主事件；
-2. 若 script 允许，把动作与对白合理重叠；
-3. 请求 storyboard 延长/拆镜；
-4. 若要改台词，请求 write owner。
+2. 若剧本允许，把动作与对白合理重叠；
+3. 请求分镜负责技能延长或拆镜；
+4. 若要改台词，请求写作负责技能修订。
 
-Video-prompts 不能自行删字、改词或把对白变 VO。
+视频提示词阶段不能自行删字、改词或把对白变为 VO。
 
 ## 5. 超载修订与审查
 
 ### 超载征兆
 
 - 一个角色完成多次远距离往返和复杂物件操作；
-- 多个角色都有独立大动作，但 shot purpose 只需要一次揭示；
-- 长对白、强情绪转折、精细手部动作和复杂 camera move 争夺同一几秒；
-- 结尾没有时间落住，end state 只被一句“最后到达”宣告；
+- 多个角色都有独立大动作，但镜头目的只需要一次揭示；
+- 长对白、强情绪转折、精细手部动作和复杂运镜争夺同一几秒；
+- 结尾没有时间落住，终点状态只被一句“最后到达”宣告；
 - 为了赶时长，动作顺序违反接触因果或表演没有接收过程。
 
 ### 修订优先级
 
 1. 删除无故事功能的环境/手势活动；
 2. 合并可自然连续的动作，保留因果节点；
-3. 选择一个主要注意中心，其他角色用必要 reaction；
-4. 保留对白与 accepted end；
-5. 仍超载则发 storyboard revision request（split/extend/reblock），不越权执行。
+3. 选择一个主要注意中心，其他角色只保留必要反应；
+4. 保留对白与已接受终点；
+5. 仍超载时，向分镜提出拆镜、延长或调整走位的修订请求，不越权执行。
 
 ### Reviewer 证据格式
 
@@ -220,4 +220,4 @@ Classification：reviewed_invariant
 Owner：video-prompts（精简）/ storyboard（改边界）
 ```
 
-不要只写“动作太多”。也不要因 prompt 有四个动词就自动报错。
+不要只写“动作太多”。也不要因提示词有四个动词就自动报错。

package/lib/drama/skills/short-drama-video-prompts/references/production-prompt-grammar.md

@@ -13,10 +13,9 @@
 - [自检](#八自检清单)
 
 来自对剧本、分镜边界、参考帧与视频任务之间完整链路的定性案例阅读，示例均为合成
-改写。本套件的运动说明格式见 [motion-recipe.md](motion-recipe.md)；本文档是
-生产端语法的对照参考：写通用提示词时借用其成熟约定，但套件产物仍以该文档规定的
-结构为准，且**不调用任何生成服务、不出现供应商与模型产品名**——
-模型相关规则一律写成"按目标模型确认"的条件规则。
+改写。本套件的运动说明格式见 [motion-recipe.md](motion-recipe.md)；本文档提供
+不绑定供应商的写法；套件产物结构以运动说明格式为准，目标模型语法则读取对应版本的方言文件。
+本阶段只交付文本，不调用生成服务。
 
 核心认知：
 
@@ -63,8 +62,8 @@
 动作的方向、终点接触与锚点秒数属于另一类：它们是本环节自己写的这一拍的组成部分，正常写——
 “指尖碰到杯沿后停住”“起手不动约半秒”说明的是这个动作往哪去、停在哪、停多久，是本次的动作
 决定，不需要上游先给数字；终点用接触点或地标而不用厘米、度数（见
-[motion-recipe.md](motion-recipe.md) 3.6）。摄影机的角度与轴线侧属于镜头
-记录，按 `framing.angle` 已接受的值写。越权只发生在这些量替上游做决定的时候：改写已接受
+[motion-recipe.md](motion-recipe.md) 3.6）。摄影机的角度与轴线侧取自《分镜.md》当前镜头
+已接受的记录。越权只发生在这些量替上游做决定的时候：改写已接受
 时长、改掉镜头已接受的机位角度或轴线侧、声称一个未被接受的空间尺寸、给参考帧里没有的
 地理定尺。
 
@@ -104,8 +103,7 @@
 
 - 位置写**相对参照**（"病床右侧""右肩上"），不写绝对坐标；
 - **裸写的"左/右"一律指画面左右**（观众看到的左右）；指人物自身的左右必须带主体
-  （"他的左手""她的右肩"）。两种读法混用是正反打方向翻转的主要来源，而单看每一句
-  都成立，所以文字审查抓不到——必须在写的时候就分清；
+  （"他的左手""她的右肩"）。写作和审查时都要核对这两种参照，避免正反打方向翻转；
 - 场景资产用方位变体逐镜选用（`探视室（北）`/`篝火（近）`），正反打双方各绑
   各的背景资产防穿帮；
 - 普通连续时间中的位移要有上游动作或过渡；已声明的省略、蒙太奇、梦境或
@@ -116,7 +114,7 @@
 
 ### 参考绑定纪律
 
-每条结构化参考先有稳定 `slot_id` 和显式唯一 `order`。若创作者档案使用位置式参考（把角色、
+每个 `REF-...` 或 `PLAN-...` 槽位先写明稳定 ID 和显式唯一顺序。若创作者档案使用位置式参考（把角色、
 道具、场景绑到稳定编号），编号顺序是确定性记账，
 不是审美选择：
 
@@ -162,13 +160,11 @@
 | 不稳定区 | 仍在允许范围内，但需要反复重试才拿到可用结果 | **在写的时候就收窄**：减少同镜并发主体、拆镜、把复合动作分到两镜 |
 | 超出范围 | 说明明确不支持 | 回上游改边界，不靠措辞绕过 |
 
-中间这一区最容易被漏掉，因为落在这里的请求**仍然是合法请求**：允许范围的上界回答的是
-“能不能提交”，稳定区的上界才回答”提交一次大概率可用”。两者之间的差额由重试补齐，
-而重试的代价由项目承担，不由文字承担。所以它是一个**写作阶段的决策点**，不是提交之后
-再观察的现象——交出去之后，收窄的机会就没有了。
+不稳定区内的请求仍可提交，但通常需要更多重试。写作阶段应先减少可避免的并发负载，
+或向上游提出拆镜请求；生成后仍按实际结果判断是否可用。
 
 判断方法不依赖任何具体数字：凡是能力说明里出现“效果较好”“稳定性下降”“可能需要多试几次”
-这类措辞的地方，就是两条线之间的位置。把它当成本镜的并发预算读，而不是当成质量描述读。
+这类措辞的地方，就是不稳定区的线索。用这些说明评估本镜并发负载，并保留其原有适用范围。
 
 若创作者的说明只给了允许范围、没有区分稳定区，就按只有允许范围处理，**不自行推断一个更
 保守的数字当成事实**；可以据此提出“是否先小规模试一次再铺开”的问题，由创作者决定。
@@ -216,11 +212,12 @@
    或请求修订；若同一表演目的需要声画同在，不为分类把它们机械拆开。
 3. **人物反应**：权力、关系、信息或代价落到听者身上时必须给可见反应；是否独立成
    特写和停留多久由后果与剪辑节奏决定，不按台词句数配额插镜。
-4. **台词负载**：从所选时长、语速、表演动作和口型能力反推；放不下就删减、拆镜或
-   请求剧本修订，不用固定字数替代试听。
+4. **台词负载**：从所选时长、语速、表演动作和口型能力反推；放不下就精简非必要动作，或请求分镜拆镜、写作技能修订台词；
+   不在本阶段删改对白，也不用固定字数替代试听。
 5. **收到生产反馈后的修订要可解释**：只改变当前诊断所需变量（拆元素、补关键状态
    或换措辞）；必须联动的变量一起记录。若形成补拍或替代版，在 `视频提示词.md` 中写明它与母版
-   的关系、修改前后差异，以及每项原文义务由哪一版承担；普通母版不增加版本账目。本技能不负责重投。
+   的关系、修改前后差异，以及每项原文义务由哪一版承担。候选差异写在普通说明中，同一镜头仍只有
+   一个正式 `MOTION-...` 和一份可复制正文；独立补拍先由分镜建立相应 `SHOT-...`。普通母版不增加版本账目，本技能不负责重投。
 6. **生产预算不由本技能猜**：可读取创作者提供的项目观察来收窄文本，但不移植
    无来源的通用成本比例，也不从文字规格声称模型效果。
 
@@ -243,7 +240,7 @@
 ## 交付文本只含交付内容
 
 **`VID-22 · reviewed_invariant`**：交给执行端的那段文本里，只能出现要被拍出来的画面内容。
-任何描述“我们内部怎么做这件事”的流程词都不得进入。本条同样管关键帧的交付文本。
+内部流程说明留在正文外。本条同样适用于关键帧的交付文本。
 
 可复制正文只保留生成所需的画面、动作、声音和限制条件。
 内部流程备注留在正文外，避免与生成内容混淆；不假定出现某个词就一定被模型画出来。
@@ -268,9 +265,8 @@
 画面：角色甲从长桌旁站起，走向门口。
 ```
 
-前三行没有一句是要拍的画面：执行端会尝试把文件名与版本号渲染成画面上的字、把“第 2 格”
-读成分格构图、把“多人”“变形手”“文字”当作应当出现的物件；真正的动作只剩最后一行，
-起点姿态、触发和终点全部缺失。改写成只含交付内容：
+前三行混入文件名、版本号、格号和失败记录，难以区分参考说明与生成要求；真正的动作只有最后一行，
+起点姿态、触发和终点都缺失。改写时直接给出本镜的可见状态和动作，必要限制仍可保留：
 
 ```text
 角色甲坐在长桌右侧，双手平放桌面，目光落在对面的空椅上。听见门外一次落锁声后，

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

@@ -11,9 +11,9 @@
 ## 1. 审查顺序
 
 先核对可见 ID、显式时长、摄影机区间、声音来源和终点一致，再由审查者判断表演可执行性、动作负载、
-运镜动机与语义发明。Reviewer 写 finding，不替 motion、shot 或 screenplay owner 修改来源。
+运镜动机，以及是否新增了无来源的剧情内容。审查者记录问题，不替运动说明、分镜或剧本的负责技能修改来源。
 
-Finding 必须含文件与 `MOTION-...` / `SHOT-...`、必要短引文、影响、修订结果、owner、严重程度和状态。
+每条问题记录须包含文件与 `MOTION-...` / `SHOT-...`、必要短引文、影响、所需修订结果、负责技能、严重程度和状态。
 禁止用提示词长度、动词数量、固定动作/秒或“AI 味”替代证据。
 
 ## 2. 证据量表
@@ -34,7 +34,7 @@ Finding 必须含文件与 `MOTION-...` / `SHOT-...`、必要短引文、影响
 | Delivery grouping | 多镜分组是否连续、同场、同一地理/资产链，时长是否等于成员之和？ | 分组章节与成员时长 |
 | Deliverable text | 可复制正文是否只剩要生成的内容？ | 提示词正文 |
 
-语义 finding 的修复应指出删/改哪一段运动，或该向哪个 owner 提出什么修订，不笼统说“动作自然一点”。
+内容问题须指出应删改哪段运动，或应向哪个负责技能提出什么修订，不能只写“动作自然一点”。
 
 ## 3. 完成前结构检查
 
@@ -48,7 +48,7 @@ Finding 必须含文件与 `MOTION-...` / `SHOT-...`、必要短引文、影响
 - 可复制正文不含文件名、版本号、ID、状态、哈希或任务备注。
 
 未分组的散镜和时长尚未确定的镜头只报告为当前状态，不伪装成质量缺陷。动作可行性、隐藏剪辑、
-语义发明和无动机运镜仍需 reviewer 结合剧情判断。
+无来源的剧情新增和缺乏动机的运镜，仍需审查者结合剧情判断。
 
 ## 4. 合成正例
 
@@ -66,7 +66,8 @@ Finding 必须含文件与 `MOTION-...` / `SHOT-...`、必要短引文、影响
 
 > 从参考帧的坐姿开始：她的左手仍按在翻开的登记簿上，右手握笔，目光落在页上，右后方是安全门。门外先传来一次短促的试锁声；她的笔尖立刻停住，目光先移向安全门，但身体没有起身。画外男声问“里面有人吗？”，她屏住一拍，没有回答，左手才把登记簿平稳滑入旁边工具盒下方，动作克制，避免纸页发声；右手始终握笔，最后停在桌沿。表演由专注工作转为警觉，再落到压住恐惧后的主动隐瞒。摄影机开头保持固定，在她决定藏起登记簿时做一次很短、很慢的推进，终点仍保持既定轴线，将她的左手、工具盒和望向安全门的视线纳入同一画面。维修间底噪持续，试锁声和画外问话清楚置于门的方向，无音乐突入。5 秒内完成，结尾保持她仍坐着、左手把登记簿压在工具盒下、右手握笔停在桌沿、目光锁向右后侧安全门。
 
-为何有效：开端只重复运动关键事实；动作按声音→接收→决定→隐藏排列；OS 不要求口型；camera 在选择时启动；结尾逐字段落到 accepted boundary，没有写下一镜。
+该例只重复运动所需的起点事实，动作按声音→接收→决定→隐藏排列；OS 不要求口型，摄影机在角色作出选择时启动，
+结尾逐字段落到已接受边界，并保留下一镜的独立起点。
 
 ## 5. 合成反例
 
@@ -104,16 +105,14 @@ Reviewer 应引用房间距离、物件操作、对白和 landing 说明不可
 再回到她的侧脸，眉心收紧。
 ```
 
-技能正文已经规定单个镜头内部只保持一个剪辑边界，但违规通常不出现在 `camera` 字段冲突里，
-它藏在**一个计时段内部**的连续叙述中，读起来只是“镜头很有节奏”。量表要能抓到它，
-而不只是禁止它：逐段列出空间锚点、被摄主体和机位关系，段内出现没有过渡的空间或主体
-跳变，就是一次未申报的剪辑。修复是向 storyboard 请求拆成两个 authored shots，或删掉插入的
-外景段落；不能靠补一个转场词把它说圆。
+这条反例把切镜藏进**一个计时段内部**，`camera` 字段可能并无显式冲突。审查时逐段核对空间锚点、
+被摄主体和机位关系；出现无法由连续运动解释的视角跳变，就检查是否新增了未申报的剪辑。
+修复时向分镜负责技能请求拆为独立镜头，或删去插入的外景段落，不能只加一个转场词。
 
 注意与多镜容器区分：容器内**成员镜头之间**的空间与主体跳变是已申报的剪辑，不是缺陷。
 判据是跳变落在哪里——落在成员镜头边界上，且该边界能追溯到一个已接受镜头，就成立；落在
 某个成员镜头的计时段内部，就是段内藏切。容器时长与成员时长之和不符时另记一条容器算术
-缺陷，不要把两者混成同一条 finding。
+缺陷，不要把两类问题混在同一条记录里。
 
 ### 反例 F：不可执行的微计量
 

package/lib/drama/skills/short-drama-video-prompts/references/seedance-2.0.md

@@ -13,7 +13,7 @@
 }
 ```
 
-这是正文方言，不是固定模板。仍以分镜的起点、唯一动作和终点为内容权威。
+正文按本方言组织，内容仍以分镜的起点、唯一动作和终点为准。
 
 ## 正文组织
 

package/lib/drama/skills/short-drama-video-prompts/references/seedance-2.5.md

@@ -78,8 +78,8 @@
 若提示词写的是编辑而 job 标成参考，或反过来，2.5 仍会根据语义复判并报任务类型不匹配；因此任务
 类型是创作选择，不由 adapter 从若干关键词猜。
 
-**它写在哪里**：creator-first 的 `MOTION-...` 条目里加一行 `- 任务类型：reference | edit | extend`，
-写在 `生成方式` 之后。这两个字段回答的不是同一个问题，谁也不能代替谁：
+在 creator-first 的 `MOTION-...` 条目里加一行 `- 任务类型：reference | edit | extend`，
+写在 `生成方式` 之后。两个字段分别记录输入方式和任务意图：
 
 | 字段 | 回答什么 | 取值 | 谁决定 |
 |---|---|---|---|

package/lib/drama/skills/short-drama-video-prompts/references/target-model-profile.md

@@ -11,10 +11,7 @@
 
 ## 这份档案解决什么
 
-本套件的模型相关规则一律写成“按目标模型确认”，但“确认”在实践中经常没有落点：没人知道要确认
-哪几件事，于是提示词按最保守的写法交出去，执行端再靠自己补——补出来的往往就是漂移。
-
-本文只做一件事：把**需要确认什么**列成有限的几条。通用档案不猜供应商能力；已核对官方契约的
+目标模型档案记录会影响提示词写法的能力与限制，供分镜、提示词和生产阶段共同读取。通用档案不猜供应商能力；已核对官方契约的
 模型可以由本技能的版本化方言文件提供推荐值。每一条取值都由创作者按自己接入的执行端声明一次，
 本集共用。生产端具体接哪个供应商、用什么字段，属于 `$short-drama-produce` 的 adapter 档案，不进入创作文档。
 
@@ -57,14 +54,13 @@
 ## 声音同轨生成
 
 有些执行端只产出画面，声音在后期补；有些执行端在同一次生成里同时产出对白、环境声与音乐。
-两者对正文的要求不同，而且**这是本套件里最容易被忽略的一条**：
+两者对正文的要求不同，应先分清：
 
 - **不同轨**（默认假设）：声音段落写本镜的声音**职责**——谁说话、什么环境声承担信息、
   转场声落在哪里。它服务于后期与审查，不需要写成可执行指令。
-- **同轨**：声音段落变成会被真的生成出来的东西。可复制正文写完本镜的完整声音时间线：需要的
+- **同轨**：声音段落直接参与生成。可复制正文须写出本镜完整的声音时间线：需要的
   对白、VO、OS、非语言发声、SFX 与相对时机，以及各事件之间承接的 ambience 或静默。逐字对白
-  仍按 [交付形态](delivery-profile.md) 的围栏处理。没有定义的时间与通道会被执行端自行填满，
-  和没写终点的动作会被自行补动作是同一件事。
+  仍按 [交付形态](delivery-profile.md) 的围栏处理。未定义的时间与通道可能由执行端自行补声。
 
 有对白、VO 或 OS 时，把本镜所有允许的发声列成封闭事件集合，每句带口语语言和逐字起止边界，
 事件间及首尾明确回到已声明环境声或静默。必要的叹气、笑声、拟声或重叠也必须有来源并进入集合。
@@ -79,8 +75,7 @@ Brief、剧本或声音方向若已经点名排除外语前导、语气词、额
 屏幕等表面确有 `exact_readable` 义务时，正文逐字保留准确字符、语言、承载面和位置，同时继续关闭
 字幕层；没有画内可读文字义务时，才使用全局无文字要求（`VID` 与 `IMG` 的文字策略优先级不变）。
 
-本套件不规定这些排除写成什么字样。字样属于本镜和项目已声明的提示词语言；不要跨项目搬运一句
-固定后缀，也不要把它当成质量分。
+排除条件按本镜需要和项目提示词语言表达，不跨项目套用固定后缀，也不据此打分。
 
 ## 参考条件方式
 
@@ -116,8 +111,7 @@ Brief、剧本或声音方向若已经点名排除外语前导、语气词、额
 
 按已接受的镜头边界写完整、自足、不依赖任何执行端特性的正文：视频正文语言回退到项目
 `format.prompt_language`；独立任务没有项目配置时沿用用户当前语言，不固定为英文。写声音职责而不是可执行声音指令，
-不做分段，不罗列画幅备选，用可见的画面关系而不是术语描述运镜。这样的正文在任何执行端上都成立，
-只是没有针对性收敛。**未声明不是缺陷**，不能作为审查阻断理由。
+不做分段，不罗列画幅备选，用可见的画面关系而不是术语描述运镜。这是未选定目标模型时的通用草稿；选定后仍须按其能力和方言复核。**未声明不是缺陷**，不能作为审查阻断理由。
 
 ## 自检