@oh-story/dsh 0.1.15 → 0.1.16

package/lib/drama/skills/short-drama-write/references/scene-handoff-capsule.md

@@ -1,25 +1,25 @@
-# 单集跨上下文交接胶囊
+# 单集跨上下文交接摘要
 
-长单集因为上下文限制需要分批续写时，可以在**当前会话上下文**维护一份最小交接摘要。它不落盘、
-不成为第六份创作文档，也不替代 `剧本.md`。
+长单集受上下文限制、需要分批续写时，在**当前会话上下文**维护一份最小交接摘要。摘要只帮助恢复写作，
+不落盘；`剧本.md` 仍是剧本权威。
 
 ## 只记恢复下一段真正需要的内容
 
 - 当前集号和最后完成的场景 ID；
 - 上一场结束时仍会影响下一场的地点、在场人物、知识、关系、伤势、持物与风险；
-- 已建立但尚未兑现的 setup/payoff；
-- 下一场已确定的功能与 exit state；若它由争取或冲突组织，再记 agenda、opposition 与 turn；
+- 已建立但尚未兑现的铺垫与回报；
+- 下一场已确定的功能与退出状态；若它由争取或冲突组织，再记目标、反对与转向；
 - 本批仍未解决、会改变下一段写法的真实创作分叉。
 
 只记录变化和下一步依赖，不复制整段正文、角色小传、视觉设定或全部旧节拍。任何信息都要能回到
-当前 `剧本.md` 的场景 ID 核对；胶囊与正文冲突时以正文为准。
+当前 `剧本.md` 的场景 ID 核对；摘要与正文冲突时以正文为准。
 
 ## 恢复步骤
 
 1. 重新读取当前 `剧本.md` 的最后一个已完成场景及其相邻上下文；
-2. 对照胶囊中的结束状态、未兑现义务和下一场目标，丢弃已经过期的摘要；
+2. 对照摘要中的结束状态、未兑现义务和下一场目标，丢弃已经过期的信息；
 3. 只读取下一场直接依赖的分集规划与连续性事实，不预加载无关 reference；
-4. 写下一场前重新回答它的必要功能与 exit state；冲突场景再回答 agenda、opposition 与 turn，不能把候选想法当既定剧情；
-5. 场景写入正文后刷新上下文胶囊；整集完成后删除它。
+4. 写下一场前重新确认它的必要功能与退出状态；冲突场景再确认目标、反对与转向，不能把候选想法当既定剧情；
+5. 场景写入正文后刷新上下文摘要；整集完成后删除摘要。
 
-胶囊只帮助恢复注意力。它不代表创作者确认、审查通过或交付状态。
+交接摘要只帮助恢复注意力，不代表创作者确认、审查通过或交付状态。

package/lib/drama/skills/short-drama-write/references/scene-sound-dramaturgy.md

@@ -1,7 +1,7 @@
 # 场次级声音戏剧设计
 
-剧本阶段只写**故事需要听见、撤掉或留白的声音事实**，不替逐镜提示词做混音。声音要改变观众
-注意、空间感或人物压力，而不是每场复制一份环境音清单。
+剧本阶段写清**故事需要听见、撤掉或留白的声音事实**，逐镜混音交给后续提示词。声音应改变观众
+注意、空间感或人物压力；无剧情职责的环境音无需逐场罗列。
 
 ## 先问五件事
 
@@ -9,9 +9,9 @@
 2. 哪个声音代表当前秩序、人物习惯或权力；
 3. 哪句台词、哪个证据或哪个选择前需要**主动留白**，留白让路给什么；
 4. 环境声何时撤出、恢复或改变距离，变化由什么可见事件触发；
-5. 是否用 `sound bridge` 把本场结果带入下一场。
+5. 是否用 `sound bridge`（声音桥接）把本场结果带入下一场。
 
-对白、VO、OS、SFX 和必须可辨的声源继续用项目制作标签写入剧本并进入索引。没有剧情职责的
+对白、VO、OS、SFX 和必须可辨的声源用项目制作标签写入剧本，需要检查时由临时索引识别。没有剧情职责的
 空调、车流、鸟鸣不必逐项登记；真正承担证据、威胁、空间或转折的动作声音不能只留在后期想象。
 
 ## 表演与留白
@@ -20,17 +20,19 @@
 与一次吞咽，让停顿和选择获得空间。配乐也不替代场景转向；若把音乐说明删掉后人物选择不成立，
 应先修场景。
 
-多人场景中，群体声音可以分层而不是同步“安静”：靠近的人先停话，远处声源后知后觉，某个角色
+多人场景中，群体声音可以分层安静下来：靠近的人先停话，远处声源后知后觉，某个角色
 继续制造噪声以掩饰紧张。差异必须来自立场、距离或行动，不用情绪形容词解释。
 
 ## 交接边界
 
-剧本拥有逐字对白、关键声源与声音事件的故事事实；`scene_visual_plan.sound_strategy` 决定整场
-注意如何运动；video-prompts 再把已接受事实投影到逐镜进入、退出、duck、距离与时机。后两层都
-不能改写台词或凭空新增证据声。
+需要交给配音时，随剧本原句核对说话者、声源通道、对谁说、接谁的话、此刻知道什么和这句要达成什么。
+专名、多音字和数字的读法在录音前确认，必要表演提示留在对应台词旁，不另建录音表。
+
+剧本拥有逐字对白、关键声源与声音事件的故事事实；分镜阶段的场次视觉方案决定整场注意力如何转移。
+视频提示词再安排逐镜声源的进入、退出、压低、距离与时机，不能改写台词或凭空新增证据声。
 
 留白要写明对象与恢复条件，不等于漏写音轨。相邻镜与相邻场的声源若连续，说明是同一空间的持续、
-距离变化还是主动 cut；若用画外声提前建立人物，也要服从剧本的信息权限。
+距离变化还是主动切断；若用画外声提前建立人物，也要服从剧本的信息权限。
 
 ## 失效检查
 

package/lib/drama/skills/short-drama-write/references/screenplay-format.md

@@ -18,7 +18,7 @@
 
 - 它是场景边界、动作、对白和生产指令的**唯一可编辑剧本源**。
 - 需要时生成的临时索引只帮助识别场景、标签和时长，不得反向改写正文，也不作为项目交付。
-- 卡片和节拍是写作推理材料，不是第二份正文。
+- 单集契约和节拍只在上下文中帮助写作，不另建卡片或节拍文件。
 - 资产、分镜、图片/视频提示词与审查结论引用剧本，不在剧本中取得所有权。
 
 规则权限：
@@ -77,9 +77,9 @@
 - **`craft_default · SCR-18`**：动作段落**不要以「短语＋全角冒号」开头**。
   `第二格：一只手把杯子推过去。` 与 `屏幕上正在放的东西：一段没有声音的录像。` 这样的写法
   和 3.2 的对白语法（`角色名：台词`）在字面上完全一样，索引器只能报
-  `ambiguous_dialogue_or_action` 交回本阶段判断，而它每次都要人来读一遍才能消掉。
+  `ambiguous_dialogue_or_action`，交回写作阶段判断。
   改法是把冒号换成破折号、逗号或一个动词：`第二格换成一只手把杯子推过去。`
-  `屏幕上正在放的是一段没有声音的录像。` 句中的冒号不受影响，只有**行首**这一处会撞。
+  `屏幕上正在放的是一段没有声音的录像。` 句中冒号不受影响，需避免的是**行首短语后的冒号**。
 
 不要在动作段落里写镜号、景别、镜头运动、焦段、生成参数或素材位。
 
@@ -98,7 +98,7 @@
 ```
 
 - 角色名与说话者必须明确；
-- 建索引前由 write owner 语义确认本集说话者清单；确定性工具只核对清单，不从冒号前缀猜人物；
+- 建索引前由写作所有者确认本集说话者清单；工具只核对清单，不从冒号前缀猜人物；
 - 提示描述一个可执行策略或变化，不堆叠同义情绪词；
 - 台词跨段确有必要时保持说话者清楚；
 - 现场不可见说话者使用 `[OS]`，非现场主观/叙述声音使用 `[VO]`。
@@ -130,9 +130,9 @@
 | `[转场]` | 有叙事意义的转场要求 | 编写剪辑方案全集 |
 
 **`structural_invariant · SCR-05`**：已存在的生产标签必须使用受支持、可闭合的语法，
-并且 source reference 可解析；标签不得互相冒充。校验器只证明“已写标签是合法的”。
+来源引用可解析，标签类型与内容一致。校验器只证明已写标签的结构合法。
 
-**`reviewed_invariant · SCR-07`**：reviewer 要对照剧情意义，检查必读文字、
+**`reviewed_invariant · SCR-07`**：审查者要对照剧情意义，检查必读文字、
 VO/OS、改变行动/信息的关键声音、有叙事意义的转场与易丢连续性事实有没有
 被遗漏。这是语义判断，不能由关键词扫描代替。
 
@@ -150,8 +150,8 @@ Markdown 注释可以保存创作者的非生产备注：
 - 生产关键事实不能只藏在注释中；
 - 未识别的 Markdown 原样保留并发出警告，不要擅自删除或“修复”。
 
-**`structural_invariant`**：规范化 mapping 必须报告每个未映射 source span，不能静默丢字节。
-该 span 是否生产关键，仍由 reviewer 根据 `SCR-07` 判断。
+**`structural_invariant`**：规范化映射必须报告每个未映射的原文范围，不能静默丢字节。
+未映射内容是否影响生产，仍由审查者根据 `SCR-07` 判断。
 
 ## 5. 完整格式示例
 
@@ -247,14 +247,15 @@ Markdown 注释可以保存创作者的非生产备注：
 ### 可机械确认
 
 - **`structural_invariant`**：集/场景 ID 唯一、标题可解析、受支持标签闭合、可见引用可解析；
-- **`structural_invariant`**：明确交接状态与单集卡不冲突；
+- **`structural_invariant`**：明示的进入、退出与连续性事实不存在可机械证明的矛盾；
 - **`structural_invariant`**：未知 Markdown 和注释被保留，未映射范围已报告；
 - **`structural_invariant`**：`剧本.md` 仍是唯一可编辑剧本源。
 
 ### 需要审查
 
 - **`reviewed_invariant`**：关键心理意义有可表演载体；
-- **`reviewed_invariant`**：场景有议程、反对、转向与退出；
+- **`reviewed_invariant`**：剧本交接与已确认分集规划或上下文中的单集契约一致；
+- **`reviewed_invariant · SCR-01`**：冲突场景有议程、反对、转向与退出，其他场景完成必要的知识、关系、压力、节奏或生产状态变化；
 - **`reviewed_invariant`**：规范化没有隐藏语义变化。
 
 ### 创作者选择

package/lib/drama/skills/short-drama-write/references/script-craft.md

@@ -17,7 +17,7 @@
 
 ## 1. 剧本的任务与规则分级
 
-剧本不是故事说明书，也不是镜头提示词。它要让演员、导演和后续制作从同一份创作者文本中读出：谁在争取什么，采取什么可见行动，局面在哪里改变，哪些生产事实不能遗漏。
+剧本要让演员、导演和后续制作从同一份创作者文本中读出：谁在争取什么，采取什么可见行动，局面在哪里改变，哪些生产事实不能遗漏。
 
 四类规则：
 
@@ -34,7 +34,7 @@
 
 ### 2.1 先锁定不可丢失的事实
 
-从单集卡与因果节拍提取：
+从已确认的分集规划，或当前上下文中的单集契约与因果节拍提取：
 
 - 进入时人物知道/误信什么；
 - 当前目标和阻挡者；
@@ -43,7 +43,7 @@
 - 结尾需要交给下一集的知识、关系、物理和行动状态；
 - 必须可读的文字、画外声音、关键音效、转场或连续性变化。
 
-这些是写作边界，不是要求照抄卡片措辞。输入明确给出的事实、`必须/禁止`、题材观看契约与退出状态优先于本手册的审查项和手艺默认；手艺只能帮助兑现题面，不能以“更具体”“更严谨”为由补造题面没有的时间数字、记录、权限、资源、程序、关系或机关。需要新增具体事实时，它必须来自题面或前文已建立的因果，而不是来自规则本身。
+这些事实构成写作边界，表达可按本场需要组织。输入明确给出的事实、`必须/禁止`、题材观看契约与退出状态优先于本手册的审查项和手艺默认；新增的时间数字、记录、权限、资源、程序、关系或机关必须有题面或前文因果依据，不能由检查规则补造。
 
 上游事实对作者已知，不等于对观众已知。只把理解当前行动所必需的赌注带入现场，并选择符合题材的
 载体：行为后果、关系态度、空间限制、对白、物件、声音或画面文字都可以。若人物的行动在没有任务说明
@@ -52,8 +52,8 @@
 当本集确实设计高代价选择时，相关价值与限制应在行动前可感知，后续事件可以让压力落地或升级，不能
 临到决定才第一次发明“为什么只能二选一”。普通决定、直觉行动、习惯反应和单向追求不需要补成两难。
 
-“只在存在时启用”是边界，不是降低强度。输入若已把某个机制设成主要看点，剧本就应让观众通过阻力、行动和后果
-感受它，而不是只由人物把规则说出来。条件化防止每集长出同一套机关；它不允许已经承诺的机关只做背景。
+输入若已把某个机制设成主要看点，剧本就应让观众通过阻力、行动和后果感受它。只由人物说出规则，
+尚未兑现该机制的观看承诺；输入没有采用的机制则不必补齐。
 
 ### 2.2 选择场景，而不是给节拍配房间
 
@@ -66,7 +66,7 @@
 - 先前后果抵达并封住旧路径；
 - 必要的生产事实在剧情中自然显现。
 
-若场景只把卡片内容说一遍，尝试把信息放进一个正在发生的争夺，或合并到真正会转向的场景。
+若场景只复述规划内容，尝试让信息参与当前行动，或合并到真正会发生变化的场景。
 
 **`craft_default · SCR-02`**：主要转向优先由人物选择及其后果推动；同时选择冲突最有表达力的场域——人物必须做事、空间会限制策略、物件能成为筹码的地方，而非默认坐下聊天。偶然事件可以开启问题，但不应替人物解决核心困境。
 
@@ -88,7 +88,7 @@
 
 ## 3. 冲突场景的发动机：目标、反对、转向、退出
 
-当场景由主动争取或对抗组织时，写正文前可写一张临时工作卡（不必成为永久文件）：
+当场景由主动争取或对抗组织时，写正文前可在上下文中列出以下工作卡，不另建文件：
 
 ```text
 场景必要性：删掉后会损失哪项选择/证据/关系变化？
@@ -146,11 +146,10 @@
 
 ### 3.4 巧合与误会：什么时候可以用
 
-`SCR-02` 说重大转向优先用选择和后果，而不是巧合。这不等于巧合和误会不能用——短剧里
-两者都是高频且有效的手段，问题从来不是"用没用"，而是**用在哪一侧**。
+按 `SCR-02`，重大转向优先由选择和后果推动。巧合和误会可以制造压力，使用时要看它们怎样影响人物行动。
 
-**巧合有方向性**。 制造问题的巧合是古老且成立的（碰见不该碰见的人、快递送错门）；
-解决问题的巧合是欺骗，因为观众投入的是人物怎么应对，而不是世界怎么补偿他。判据四条：
+**巧合有方向性**。碰见不该碰见的人、快递送错门，可以把人物推进问题；若靠巧合直接解困，人物此前的
+应对可能失去作用。可从四方面检查：
 
 1. **位置**：把人推进麻烦可以，把人从麻烦里捞出来不可以。困境靠巧合解除时，前面所有
    挣扎都被追认为无关紧要。
@@ -158,7 +157,7 @@
    而拿着它就意味着必须解释自己为什么在那里，成立。
 3. **世界是否建立过**：同一栋楼、同一条通勤线、同一个熟人圈里的偶遇是**设定**，前面
    建立过就不算巧合；毫无铺垫的偶遇是作者伸手。
-4. **只用一次**：同一条线上第二次巧合就成了模式，观众会停止相信这个世界的因果。
+4. **重复的作用**：同一因果链若反复靠巧合推进，人物策略会被削弱；检查后续变化能否由前次巧合引出的选择与后果承担。
 
 已建立的常规资源可以帮人物换策，但不能恰好替他付款。若道具、身份、权限或旁人的出现直接完成了原本最难的
 一步，人物自己的策略、取舍或关系反应就会被掠走。资源可以改变问题的形状，解决仍应由人物完成。
@@ -235,11 +234,10 @@
 
 不要为了“可见”堆满微表情。动作的价值在于改变空间、物件、注意力或关系，而不是记录每次眨眼。
 
-**如果项目声明由生成模型承担画面**，动作还要多过一道：日常影像里罕见的精细动作
-（在运动中截住某物、以厘米计的位移、三步以上的双手编排）在实拍里完全成立，在生成
-管线里往往整镜不可用。此时优先让常见动作的**组合与时机**承担同一份戏剧信息。实拍
-项目不受此限；形态未声明时不要预先裁剪。判据与改写方法由视频提示词环节拥有，本环节
-只需知道这条约束存在，不必在剧本里提前降级。
+**如果项目声明由生成模型承担画面**，遇到日常影像里罕见的精细动作时，对照本项目已确认的生成约束：
+例如在运动中截住某物、以厘米计的位移或复杂的双手编排。确需替换时，优先让常见动作的
+**组合与时机**承担同一份戏剧信息。具体判据与改写方法由视频提示词环节负责，剧本阶段识别风险，
+不提前削弱戏剧作用；实拍项目或形态未声明时，不据此裁剪动作。
 
 弱：
 
@@ -270,14 +268,15 @@
 `[VO]` 只承担画面给不出的东西：与画面相反的判断、被隐瞒的打算、跨时间的认知。
 
 内心独白能外化就外化。大段“我穿越了”“我一定要……”换成一个动作加一句台词；让旁人把心里话说出口；
-让手机屏幕、证件、胎记这类物件在画面里交代身份；必要的回忆写成三行以内的短闪回。系统面板与提示
+让手机屏幕、证件、胎记这类物件在画面里交代身份；必要的回忆只保留当前行动所需的闪回。系统面板与提示
 交给 `[画面文字]` 或已接受的声音方案，不让系统声替主角想事情。
 
 痛点写成观众亲眼看见的一场戏。“他一直被人看不起”不是痛点；“酒席上，反派当众把酒泼在他脸上”才是。
 观众看见了被压下去的那一下，后面的回报才有落点。
 
-项目已接受节奏档案时，`[VO]` 的可发声字数占全集可发声字数的比例不超过 `vo_share_max`。时长估算
-脚本加上 `--project` 会报出这个比例。
+项目已接受节奏档案时，核对 `[VO]` 字数占全部台词字数的比例与 `vo_share_max`。时长估算脚本
+加上 `--project` 后，在上限有效且本集有台词时报告该比例；统计去掉空白与括注、保留标点，
+`[OS]` 计入全部台词但不计入 VO。这个口径用于占比核对，不能直接当作排除标点、按实际读法处理数字后的语速换算字数。
 
 **`craft_default · SCR-20`**：`[VO]` 不复述画面已经演出的信息；内心独白尽量外化为动作加一句台词、
 旁人的话或可见物件；痛点落成具体场景；项目已接受节奏档案时，VO 占比不超过 `vo_share_max`。
@@ -364,11 +363,10 @@
 
 ### 5.5 人多的场次：先解决"谁是谁"
 
-一场里出现七八个人时，最先崩掉的不是冲突，是**辨识**。观众分不清谁在说话、谁站哪边，
-后面写得再有力也接收不到。竖屏与快节奏会放大这个问题：观众没有回看的习惯，错过一次
-就一路错下去。
+多人同时争取注意力时，先保证观众分得清谁在说话、谁站哪边。竖屏与快节奏下，人物辨识不清
+容易影响观众接收后续冲突。
 
-四种可组合的办法，按代价从低到高：
+可组合使用以下办法，按本场需要选择：
 
 1. **减人**。与本场议程无关的人直接不出现。人物在场不等于有戏份，写进来却没有可执行
    动作的人，只会分走注意。
@@ -487,7 +485,7 @@
 创作者对某一集说明理由即可偏离。
 
 **`craft_default · SCR-19`**：节奏档案已接受时，剧本兑现它的单集数值：首钩时限、触点间隔上限、
-有人形对手的反转次数、停在峰值、接上一集最后一拍。
+有人物对手参与的反转次数、停在峰值、接上一集最后一拍。
 
 ## 7. 写动作段落与生产事实
 
@@ -555,11 +553,9 @@
 
 ### 8.2 收束完成本集承诺
 
-结尾可以让局部结果被看见，也可以让关系、情绪、喜剧节奏、恐惧或主题意象获得落点。连载需要交接时，
-再写清下一集继承的行动、知识、关系或物理状态；不是所有单集都必须把新压力顶到最后一秒。项目已接受的节奏档案要求停在峰值时，按 6.5 收尾。
-
-收束先回答本集承诺的功能是否完成：可以是局部结果、关系重新定义、认知变化、喜剧落点、恐惧余波、
-讽刺反照或有意保持开放。连载作品通常还需要可交接状态，但不等于最后一拍必须追加外部事件。
+结尾先完成本集承诺的功能：局部结果、关系重新定义、认知变化、喜剧落点、恐惧余波、讽刺反照、
+主题意象或有意保持开放都可成立。连载需要交接时，再写清下一集继承的行动、知识、关系与物理状态，
+不强制在最后一拍追加外部事件。项目已接受的节奏档案要求停在峰值时，按 6.5 收尾。
 
 局部回报不必清空代价。选择后仍存在的残余可留在人物行为、关系、空间、声音或物件状态里；主题已经
 能从结果读出时，不再用抽象口号解释。重复动作、静止画面或环境声也能收束，只要它因前文获得新意义。
@@ -567,7 +563,7 @@
 如果前文把某项代价当作行动的核心阻力，退出状态至少要保留它的一项实质影响：能力暂时缺口、身体损伤、资源消耗、
 关系债务或必须处理的后续行动均可。不要在高潮后立即让系统、能力或局面自动复位，使原先的赌注只留一处轻微痕迹。
 
-回报落下后，逐拍问“它在加深、转义、沉淀，还是重复说明？”多项后果可以并存，不强制只留一拍；
+回报落下后，逐拍问“它加深了结果、改变了意义、留下了余韵，还是重复说明？”多项后果可以并存，不强制只留一拍；
 只有功能相同、观众已接收的内容才合并。安静余韵不是空转，机械复述才是。
 人物放下、拿起、让路、留下或离开的动作已清楚表明了意向时，后面再写一次同向决定只会稀释第一次，除非中间有新阻力使第二次付出了不同代价。
 笑点、情感或意象也一样：行动和画面已经完成的意义，不再用一句标语概括；一个生活细节已经形成隐喻时，不连续用多句人生道理翻译它。
@@ -582,7 +578,7 @@
 **`craft_default · SCR-15`**：收束留下可读的结果或余效，并服从本集观看契约；推进、留白、反讽、
 静止或开放状态都可成立，不用抽象口号替观众解释，也不为满足规则强造新事件。
 
-### 8.3 写精确出去状态
+### 8.3 写清退出状态
 
 检查：
 
@@ -593,10 +589,9 @@
 - 伤势、服装、光线、天气、时间是否延续；
 - 哪项动作已经不可撤回。
 
-**`structural_invariant`**：剧本明确写出的出去事实必须与单集卡指向的
-权威交接一致。若使用 development projection，“更好的结果”先路由给 develop
-owner 修订 episode map；若使用 `write_standalone`，才由 write 修订自有契约。
-不可让两份权威并存。
+剧本明确写出的退出事实应与已确认的分集规划或上下文中的单集契约一致。有分集规划时，
+改变既定交接结果先交 `$short-drama-develop` 修订规划；直接写作时，由写作阶段按用户要求
+修订上下文中的契约，并同步剧本，不另建卡片或第二份交接事实。
 
 ## 9. 修订方法
 
@@ -628,7 +623,8 @@ owner 修订 episode map；若使用 `write_standalone`，才由 write 修订自
 
 ### 9.4 场景遍
 
-标出每场目标、反对、策略变化、转向和退出。没有变化的场景：
+先标出每场必要的变化与退出状态；由争取或冲突组织的场景再标目标、反对、策略变化与转向。
+氛围、仪式、蒙太奇、过渡和后果消化场景按 3.3 的必要变化判断。确实没有变化的场景：
 
 - 与相邻场合并；
 - 让证据/关系/决定在此真正改变；
@@ -658,8 +654,7 @@ owner 修订 episode map；若使用 `write_standalone`，才由 write 修订自
 
 ### 9.9 扫读遍
 
-前面几遍都是慢读——逐条检查因果、可表演性、具体性。这一遍相反：**用比正常阅读快得多
-的速度把本集扫一遍**，尽量不停顿、不回看，然后只回答两个问题：
+**用比正常阅读更快的速度把本集扫一遍**，尽量不停顿、不回看，然后回答两个问题：
 
 1. 有没有需要停下来才能想明白的地方？谁说的这句、刚才那个人做了什么、这个东西是哪来的；
 2. 扫完之后，情绪上有没有起伏？还是只知道发生了一串事？
@@ -667,8 +662,7 @@ owner 修订 episode map；若使用 `write_standalone`，才由 write 修订自
 任何一处需要停顿，都记下位置——那通常意味着信息挤在一起、指代不清、或者一句台词同时
 承担了太多任务。第二问答不上来，说明这一集可能每一场都成立，但合起来没有形成运动。
 
-这一遍模拟的是真实观看条件：观众不会重看，不会推敲，注意力还被别的事分走。慢读能证明
-剧本**讲得通**，扫读才能证明它**接收得到**。
+扫读帮助发现一次观看、注意力有限时的接收困难，与慢读的因果检查互补。
 
 **`craft_default`**：交付前至少做一遍扫读，把需要停顿的位置和"没有情绪起伏"的段落
 记下来，再决定改不改。它是自检手段，不是质量门槛——刻意要求观众停下来思考的段落，
@@ -680,11 +674,11 @@ owner 修订 episode map；若使用 `write_standalone`，才由 write 修订自
 
 ### 9.10 经济性遍
 
-最后静默扫掉四类规则展示：输入没有要求的精确数字或记录；为同一结论叠加的验证链；复述动作的标签或对白；回报后多个同方向决定、解释或后果。先问能否保留一个主要因果载体完成同样的戏，再删除没有新作用的载体。删的是冗余展示，不是选择、证据、时限、人物或连续性 knowhow。
+最后静默检查四类冗余：输入没有要求的精确数字或记录，为同一结论叠加的验证链，复述动作的标签或对白，回报后多个同方向决定、解释或后果。保留承担必要因果与后果的载体，删除没有新作用的内容；本集需要的选择、证据、时限、人物与连续性仍须完整。
 
 ### 9.11 所有权遍
 
-列出语义变化、未改部分与受影响下游。创作者确认后更新 `剧本.md`；所有者不能给自己签发终审通过。
+按用户授权修正明确问题，保护未点名部分；会改变剧情走向的方案或规范化预览，先列出语义变化、未改部分与受影响下游，确认后更新 `剧本.md`。修订本身不代表终审通过。
 
 ## 10. 现有剧本的最小规范化
 
@@ -754,7 +748,7 @@ owner 修订 episode map；若使用 `write_standalone`，才由 write 修订自
 
 ### 失败征兆
 
-- 场景只传递信息，没有任何议程受阻或策略变化；
+- 冲突场景只传递信息，没有议程受阻或策略变化；非冲突场景也没有必要的状态变化；
 - 角色轮流说出作者想让观众知道的内容；
 - 内心状态没有行为、证据、空间或声音载体；
 - 对手只会拒绝，主角只会重复要求；
@@ -779,13 +773,13 @@ owner 修订 episode map；若使用 `write_standalone`，才由 write 修订自
 
 审查者引用场景标题、动作或对白回答：
 
-1. 本场谁想让什么发生，反对者用什么筹码阻止？
-2. 哪个动作/事实改变方向，转向后下一动作为何不同？
+1. 冲突场景中，谁想让什么发生，反对者用什么筹码阻止？其他场景承担哪项必要变化？
+2. 哪个动作/事实改变方向或状态，变化后下一动作为何不同？
 3. 哪些关键内在意义没有可表演载体？
 4. 空间和物件是否参与冲突，而非只作装饰？
 5. 重大信息之后，受影响者的行为怎样改变？
 6. 生产关键事实是否有正确边界，是否混入其他层内容？
-7. 本集的进入与出去状态能否精确交接？
+7. 本集的进入与退出状态能否准确交接？
 8. 修订是否保护了创作者的风格选择与未改部分？
 9. 若本集承诺艰难选择，各方向在行动前是否仍有价值，哪项代价由选择新增？若没有此承诺，是否避免硬造两难？
 10. 若重大判断依赖可争议证据，结论是否与证明范围相称；作品是验证、保留还是有意延迟？

package/lib/drama/skills/short-drama-write/references/stage-contract.md

@@ -3,8 +3,10 @@
 本阶段只拥有 `剧集/<EP>/剧本.md`：场景、动作、对白、画外音、声音事实、画面文字、连续性提示与转场。
 它继承项目/分集决定，但不决定人物视觉身份、镜头构图、提示词或媒体生产。
 
-所有来源都用文档中可见的集号与场景 ID 定位；不建立第二份节拍、block、审批或状态文件。格式标签
-只负责区分生产语义，不借格式补造剧情。输入明确给出的事实、必须/禁止、题材观看契约与退出状态优先于本表；规则不能补造题面没有的精确数字、记录、资源、程序或机关。
+来源用文档中可见的集号与场景 ID 定位；项目内不另建节拍、块索引、审批或状态文件。按需检查使用系统临时索引。
+格式标签
+只区分生产语义。输入明确给出的事实、必须/禁止、题材观看契约与退出状态优先于本表，
+规则不能补造题面没有的精确数字、记录、资源、程序或机关。
 
 ## 本阶段规则
 
@@ -21,7 +23,7 @@
 | SCR-07 | reviewed_invariant | Story-critical text, VO/OS, SFX, transition, and continuity requirements are not left indistinguishable from ordinary prose. |
 | SCR-08 | craft_default | When abstract emotion obscures performance, translate it into character-specific behavior, object handling, distance, silence, or delivery. Dialogue turn length and tactic follow the scene agenda rather than a universal attack-defense cadence. |
 | SCR-09 | craft_default | Break a long speech with a visible action beat that changes the speaker's tactic, giving downstream a sourced cut point and the performance a breath; a speech with no internal turn is shortened rather than split. |
-| SCR-10 | reviewed_invariant | When the creator marks a beat's realization as replaceable under later pressure, the record separates the dramatic function from the current depiction and names a fallback depiction that delivers the same function: same person proven or changed, downstream payoff refs and next-episode entry state still satisfied, cost not erased, no new setup required. Deleting the beat is never a fallback. An unmarked beat leaves the rule inactive—the suite carries no platform standard, predicts no outcome, and pre-emptive sanding is the more expensive mistake. |
+| SCR-10 | reviewed_invariant | When the creator marks a beat's realization as replaceable under later pressure, separate its dramatic function, current depiction, and fallback depiction. The fallback delivers the same function: the same person is proven or changed, downstream payoffs and next-episode entry state remain satisfied, the cost remains, and no new setup is required. Deleting the beat is never a fallback. The rule is inactive for unmarked beats; the suite carries no platform standard and predicts no approval outcome. |
 | SCR-11 | craft_default | When sound carries story information, spatial pressure, off-screen presence, a deliberate silence, or a scene bridge, the screenplay identifies the necessary source/event and its dramatic target; it does not prescribe per-shot mixing, add decorative sound to every scene, or use music to replace performance. |
 | SCR-12 | craft_default | A crowded scene first makes clear who is contending with whom—by cutting non-essential presence, staggering entrances, splitting the scene so one opponent holds the focus at a time, or handing attention from one character to the next—rather than naming every present character in action paragraphs. Deliberately chaotic ritual, siege, or farce may override this once the disorder is a visible choice and one followable thread remains. |
 | SCR-13 | reviewed_invariant | When a beat is framed as a consequential choice, at least two executable values remain live until the character acts, and the screenplay makes the relevant stakes and newly caused cost perceptible. This rule is inactive for ordinary decisions, habits, or single-path pursuits; it must not manufacture a dilemma the episode does not need. |
@@ -29,12 +31,12 @@
 | SCR-15 | craft_default | A local payoff leaves a legible result or aftereffect without replacing the episode's meaning with a slogan. A cost framed as central pressure has a material exit-state effect rather than automatically resetting once the action succeeds. The result may be plot change, relationship response, irony, stillness, tonal afterimage, or an intentionally open state; a new external event is not mandatory. |
 | SCR-16 | reviewed_invariant | When a literal precise deadline is foregrounded and audience-auditable, its action chain fits the stated time and established resources, or the screenplay makes compression, failure, or a changed objective legible. Qualitative urgency is not upgraded into invented minutes, timestamps, notifications, or records. Montage, ellipsis, subjective time, and declared stylization follow their own established convention rather than an automatic real-time test. |
 | SCR-17 | reviewed_invariant | When the brief defines a limited number of attempts, turns, breaths, beats, or other units, each unit is counted by its visible end-state. A label, count, request, authorization, preparation step, or cleanup after the boundary does not substitute for the required completion; intentional partial completion or failure remains valid when it is the legible result of that unit. |
-| SCR-18 | craft_default | An action paragraph does not open with a noun phrase followed by a full-width colon. `第二格：一只手把杯子推过去。` is byte-for-byte the dialogue form `角色名：台词`, so the indexer can only return `ambiguous_dialogue_or_action` and hand it back for a human read; every such line costs one round trip for nothing. A dash, a comma, or a verb removes the collision. Colons inside a sentence are unaffected — only the start of the line collides. |
+| SCR-18 | craft_default | An action paragraph does not open with a noun phrase followed by a full-width colon. `第二格：一只手把杯子推过去。` has the same syntax as `角色名：台词`, so the indexer reports `ambiguous_dialogue_or_action` for the writer to resolve. A dash, comma, or verb removes the collision. Colons inside a sentence are unaffected; the ambiguity occurs after a phrase at the start of a line. |
 | SCR-19 | craft_default | When `creator_authority.rhythm_profile` has status `accepted`, the screenplay realizes its episode values: the first hook lands within `first_hook_seconds`; no gap between emotional touchpoints (a conflict line, a situation-changing action, or new information) exceeds `beat_interval_seconds_max`; at least `opposed_reversals_per_episode_min` reversals are driven or suffered by a human opponent with an agenda—in an adaptation, a source character first; where the source has none, the deviation is reported and any new opponent is a creator-confirmed addition from `$short-drama-develop`; with `end_on_peak` the episode stops on or just before its peak; with `reprise_previous_last_beat` it opens by replaying the previous episode's last beat. The values are bounds, not a beat template. A missing or proposed profile leaves the rule inactive; this stage reads the profile and never sets it. |
 | SCR-20 | craft_default | Show rather than narrate: `[VO]` does not restate what the picture has already performed; inner monologue is externalized into an action plus one line, another character's words, or a visible object wherever possible; a pain point the episode trades on is staged as a concrete scene rather than reported. Under an accepted rhythm profile the `[VO]` share of spoken characters stays within `vo_share_max`. |
 | SCR-21 | craft_default | The writer reads back its own dialogue draft and cuts every line that carries neither action nor conflict; every line kept converts to an action or expression an actor can play. Creator-supplied text is not trimmed under this rule. |
 | SCR-22 | craft_default | The episode's first beat stands alone as a hook, since it is what the viewer sees in the opening frame: a visible conflict, an anomalous image, an open question, or the last beat of a peak. A still image qualifies when it raises the question by itself; information that works only after reading on-screen text, knowing who someone is, or hearing the next line is not staged alone as the first beat. |
 
-规则分级由高到低：`structural_invariant`（结构缺陷，阻断）、
+规则分级由高到低：`structural_invariant`（可机械证明的结构缺陷，可阻断）、
 `reviewed_invariant`（需证据判断）、`craft_default`（常用做法，可覆盖）、
 `taste_option`（创作者选择，不作缺陷）。创作者已接受的事实优先于本表。

package/lib/drama/skills/short-drama-write/references/substitutable-realization.md

@@ -1,9 +1,9 @@
-# 可替换实现：让「要改」的时候改的是实现方式，不是戏
+# 可替换实现：更换呈现时保留戏剧功能
 
 ## 目录
 
-- [这条规则不做什么](#这条规则不做什么)
-- [真正的失效形状](#真正的失效形状)
+- [适用边界](#适用边界)
+- [替换为何会牵连整集](#替换为何会牵连整集)
 - [功能与实现分开写](#功能与实现分开写)
 - [什么样的备选算数](#什么样的备选算数)
 - [哪些位置值得看一眼](#哪些位置值得看一眼)
@@ -11,28 +11,24 @@
 - [合成示例](#合成示例)
 - [自检](#自检)
 
-## 这条规则不做什么
+## 适用边界
 
 **本套件不内置任何平台的审核标准，不预测任何内容能否通过，也不给出题材禁令**。
-标准随平台、地区、时间和分发方式变化，写进技能只会同时做到两件坏事：过时，以及把
-创作者本可以拍的东西提前劝退。
+具体要求由平台、地区、时间和分发方式决定。本规则仅在创作者主动标注时启用：为某个兑现记录
+可替换的呈现方式，让后续更换仍能保住原有戏剧功能。是否标注、标注哪些，由创作者判断。
 
-它只做一件事：当某个兑现**只有一种实现方式**、而这种实现方式后来必须更换时，让更换
-发生在**实现层**而不是**戏剧层**。要不要标、标哪些，由创作者判断；套件负责的是——
-标了之后，改动是有备而来的。
+## 替换为何会牵连整集
 
-## 真正的失效形状
-
-昂贵的返工不是「某个镜头被要求换掉」，而是**换掉它之后这集不成立了**。
+更换某个镜头后，整集依赖的兑现可能随之失效。
 
 具体过程：某个兑现依赖一个特定呈现（一件证物上的字、一次身体接触的力度、一个场所的
 性质、一段自白的具体内容）。这个呈现被下游一路消费——资产变体按它建、关键帧按它冻结、
-运动规格按它写、相邻集的进入状态按它接。等到必须更换时，能改的只剩最后一环，于是
-唯一可行的操作变成**把这场删了**。删掉之后，它承担的功能没有别处兑现，前面所有铺垫
+运动规格按它写、相邻集的进入状态按它接。等到必须更换时，如果只改最后一环，就可能只能
+**把这场删了**。删掉之后，它承担的功能没有别处兑现，前面所有铺垫
 变成空转。
 
-改动窗口的关键性质是**它会关闭**：呈现刚写下时替换成本接近零，被下游消费之后成本
-指数上升。所以标注要发生在剧本层，事后补标没有意义。
+呈现刚写下、尚未进入下游时，替换牵连较少；进入资产、关键帧与运动规格后，相关内容都要重新核对。
+因此应在剧本阶段记录备选；下游已采用后再补标，只能帮助说明修订范围。
 
 ## 功能与实现分开写
 
@@ -44,15 +40,14 @@
 | 当前实现 | 现在**用什么呈现**兑现它 | 与功能混写成一句，导致换实现就得换功能 |
 | 备选实现 | 换一种呈现，**同样兑现该功能** | 写成"改温和些"，这是削弱不是替换 |
 
-分开写本身就有诊断价值：如果一个节拍的功能写不出来，问题不在合规，在这个节拍本来
-就没兑现什么。
+若无法说清一个节拍兑现了什么，先检查这个节拍的必要性。
 
 ## 什么样的备选算数
 
 备选必须**兑现同一个功能**，判据是：
 
 1. **同一个人被证明或被改变**。换了受影响的人，就是另一个节拍。
-2. **后续依赖仍然成立**。看这个节拍的 `payoff_refs` 与下一集的进入状态：备选执行后，
+2. **后续依赖仍然成立**。核对这个节拍后续要兑现的回报与下一集的进入状态。备选执行后，
    它们是否仍然被满足？有一条落空就不是备选。
 3. **代价没有消失**。兑现通常带着代价（暴露、失去、欠下）。备选把代价抹掉时，后面的
    压力也就没了来源。
@@ -74,10 +69,8 @@
 
 ## 两种更常见的错误做法
 
-**提前自我阉割**。 把所有可能敏感的地方统一磨平。代价是确定的（戏没了），收益是不确定的
-（并不针对任何具体标准）。短剧的兑现本来就建立在越界、失衡和代价上，统一磨平之后剩下的
-是一集没有人会看完的合格品。标注的意义恰恰是**保住当前实现**——先按最想要的拍法写，
-备选只在真的需要时启用。
+**提前磨平冲突**。没有具体要求，就先把可能引发争议的呈现统一削弱，会损失当前已经成立的戏剧作用。
+标注是为了**保住当前实现**：先按创作者选择的拍法写，备选只在确实需要时启用。
 
 **假备选**。 备选栏写"视情况调整""改得含蓄一点""删减部分内容"。这类写法在需要时提供不了
 任何可执行的东西，等于没标。备选必须具体到能直接改写成场景动作。
@@ -91,7 +84,8 @@
 - **当前实现**：她当众把手写排班本摊开，指出被涂改的那一行，说出被保护者的名字。
 - **备选实现**：她把排班本交给指控者本人翻，指控者读到那一行时停住不念——名字由**反应**
   交代而不由台词交代。功能相同：改动被证明、动机被暴露、可信度同时受损；被保护者的
-  身份仍然进入后续依赖，只是载体从台词换成了他人的反应。
+  身份对指控者已暴露。这个备选只在后续依赖需要指控者知情、并不要求公众或观众当场认出姓名时成立；
+  若后续必须知道具体是谁，还需由已建立的线索明确身份。
 - **不算备选**：把这场改成她私下解释（受影响的人变了，公开暴露的代价消失）；把这场
   删掉（功能无处兑现）。
 
@@ -100,7 +94,7 @@
 只在创作者标注过的节拍上执行；未标注时本节不生效，也不要因为没标注而提缺陷。
 
 1. 功能是否写成了「谁的什么被证明或被改变」，而不是情绪词？
-2. 备选执行后，本节拍的 `payoff_refs` 与下一集进入状态是否仍然成立？
+2. 备选执行后，本节拍后续要兑现的回报与下一集进入状态是否仍然成立？
 3. 代价是否仍在？还是被备选一起抹掉了？
 4. 备选是否需要一个前面没有建立的事实？
 5. 备选是否具体到可以直接写成场景动作，而不是一句"酌情处理"？