@oh-story/dsh 0.1.3 → 0.1.4

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

@@ -7,17 +7,17 @@
 3. 动作、对白与生产标签
 4. 注释与未知内容
 5. 完整格式示例
-6. 稳定 ID、索引与修订
+6. 稳定 ID、临时索引与修订
 7. 现有文本的规范化入口
 8. 剧本中不应出现的内容
-9. 发布前检查
+9. 完成前检查
 
 ## 1. 设计目标与事实所有权
 
-`screenplay.md` 要能在普通 Markdown 编辑器中直接阅读，同时让下游准确引用场景、动作、对白与生产要求。
+`剧本.md` 要能在普通 Markdown 编辑器中直接阅读，同时让下游准确引用场景、动作、对白与生产要求。
 
 - 它是场景边界、动作、对白和生产指令的**唯一可编辑剧本源**。
-- `screenplay-index.jsonl` 只派生块 ID、位置、类型与内容哈希，不得反向改写正文。
+- 需要时生成的临时索引只帮助识别场景、标签和时长，不得反向改写正文，也不作为项目交付。
 - 卡片和节拍是写作推理材料，不是第二份正文。
 - 资产、分镜、图片/视频提示词与审查结论引用剧本，不在剧本中取得所有权。
 
@@ -139,7 +139,7 @@ Markdown 注释可以保存创作者的非生产备注：
 ```
 
 - 注释原样保留；
-- 派生索引标记为非生产内容；
+- 临时索引把注释标记为非生产内容；
 - 分镜覆盖不把注释当成必拍动作；
 - 生产关键事实不能只藏在注释中；
 - 未识别的 Markdown 原样保留并发出警告，不要擅自删除或“修复”。
@@ -185,9 +185,9 @@ Markdown 注释可以保存创作者的非生产备注：
 - 关键文字、声音与持物交接有明确边界；
 - 没有把摄影或提示词写进故事源。
 
-## 6. 稳定 ID、索引与修订
+## 6. 稳定 ID、临时索引与修订
 
-派生索引应记录：
+需要机器辅助检查时，临时索引应记录：
 
 - 块 ID 与类型（场景标题、动作、对白、生产标签、注释等）；
 - 源文件范围与内容哈希；
@@ -196,13 +196,13 @@ Markdown 注释可以保存创作者的非生产备注：
 - 生产标签类型；
 - 未映射或歧义说明。
 
-索引不得：
+临时索引不得：
 
 - 自动润色或规范化创作者文字；
 - 把显示名称变成另一份权威角色/资产事实；
 - 在拆分/合并歧义时重用错误块 ID；
 - 把注释当成生产动作；
-- 反向覆盖 `screenplay.md`。
+- 反向覆盖当前 `剧本.md`。
 
 邻近文字修改且语义块映射明确时保留块身份。段落拆分、合并或整场重写无法确定时，提出显式重映射选择。
 
@@ -216,7 +216,7 @@ Markdown 注释可以保存创作者的非生产备注：
 4. 展示原文和规范化预览；
 5. 分开报告语义新增、删除、改写、未映射范围与低置信映射；
 6. 让创作者选择接受、修订或取消；
-7. 接受后才发布 `screenplay.md` 与索引。
+7. 确认后才更新 `剧本.md`；索引若用于检查，只写临时目录。
 
 **`structural_invariant`**：取消或拒绝不改变规范剧本；接受前不得把预览当成权威源。
 
@@ -230,20 +230,20 @@ Markdown 注释可以保存创作者的非生产备注：
 - 镜头表、景别、镜头运动或关键帧构图；
 - 图片/视频提示词和生成参数；
 - 模型、任务或接口字段；
-- 审查结论和生命周期状态；
+- 审查结论和内部流程状态；
 - 原始参考材料位置；
 - 用统一数量、比例或篇幅冒充创作规律的说明。
 
-故事真相留在剧本，其他所有者通过块 ID 与哈希引用。
+故事真相留在剧本，其他所有者通过场景 ID、支持标签和必要短引文引用。
 
-## 9. 发布前检查
+## 9. 完成前检查
 
 ### 可机械确认
 
-- **`structural_invariant`**：集/场景 ID 唯一、标题可解析、受支持标签闭合、引用与哈希可解析；
+- **`structural_invariant`**：集/场景 ID 唯一、标题可解析、受支持标签闭合、可见引用可解析；
 - **`structural_invariant`**：明确交接状态与单集卡不冲突；
 - **`structural_invariant`**：未知 Markdown 和注释被保留，未映射范围已报告；
-- **`structural_invariant`**：`screenplay.md` 仍是唯一可编辑剧本源。
+- **`structural_invariant`**：`剧本.md` 仍是唯一可编辑剧本源。
 
 ### 需要审查
 

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

@@ -38,12 +38,22 @@
 
 - 进入时人物知道/误信什么；
 - 当前目标和阻挡者；
-- 必须发生的选择与后果；
+- 输入明确要求的选择与后果；
 - 当集承诺的兑现；
 - 结尾需要交给下一集的知识、关系、物理和行动状态；
 - 必须可读的文字、画外声音、关键音效、转场或连续性变化。
 
-这些是写作边界，不是要求照抄卡片措辞。
+这些是写作边界，不是要求照抄卡片措辞。输入明确给出的事实、`必须/禁止`、题材观看契约与退出状态优先于本手册的审查项和手艺默认；手艺只能帮助兑现题面，不能以“更具体”“更严谨”为由补造题面没有的时间数字、记录、权限、资源、程序、关系或机关。需要新增具体事实时，它必须来自题面或前文已建立的因果，而不是来自规则本身。
+
+上游事实对作者已知，不等于对观众已知。只把理解当前行动所必需的赌注带入现场，并选择符合题材的
+载体：行为后果、关系态度、空间限制、对白、物件、声音或画面文字都可以。若人物的行动在没有任务说明
+时完全失去动机，说明关键前提尚未进入剧本；反过来，观众能从行动读懂时，不必再加通知或解释。
+
+当本集确实设计高代价选择时，相关价值与限制应在行动前可感知，后续事件可以让压力落地或升级，不能
+临到决定才第一次发明“为什么只能二选一”。普通决定、直觉行动、习惯反应和单向追求不需要补成两难。
+
+“只在存在时启用”是边界，不是降低强度。输入若已把某个机制设成主要看点，剧本就应让观众通过阻力、行动和后果
+感受它，而不是只由人物把规则说出来。条件化防止每集长出同一套机关；它不允许已经承诺的机关只做背景。
 
 ### 2.2 选择场景，而不是给节拍配房间
 
@@ -76,9 +86,9 @@
 
 **`reviewed_invariant`**：即使字段可解析，场景仍可能只是时间相邻。审查者要引用前后行动说明是否存在真实因果。
 
-## 3. 场景发动机：目标、反对、转向、退出
+## 3. 冲突场景的发动机：目标、反对、转向、退出
 
-写正文前，为场景写一张临时工作卡（不必成为永久文件）：
+当场景由主动争取或对抗组织时，写正文前可写一张临时工作卡（不必成为永久文件）：
 
 ```text
 场景必要性：删掉后会损失哪项选择/证据/关系变化？
@@ -115,6 +125,8 @@
 - 表面答应但改变执行条件。
 
 有效反对会迫使焦点人物更换策略，而不是延长同一轮喊话。
+反过来，焦点人物成功时也要改变反对方的筹码或选择。“他没再说话”“她收回手”“对方转身离开”可以是有力的反应，但前提是前一动作已迫使他们付出具体代价、失去某项权限、保留可追溯的反对或改变下一步。
+若沉默只是作者不再让对手行动，转向尚未完成。
 
 ### 3.3 转向要改变下一动作
 
@@ -122,7 +134,11 @@
 
 如果答案只是“更生气”，还缺少新的事实、筹码、关系或决定。一次极小的转向也可有效，例如某人把钥匙放到桌子另一边，公开表明不再替同伴保管秘密。
 
-**`reviewed_invariant · SCR-01`**：每个场景应有当前议程、对抗力量、方向性转向和退出状态。审查者必须引用场景中的行动证据，不能仅检查是否填写了场景卡。
+**`reviewed_invariant · SCR-01`**：由主动争取或冲突组织的场景应有当前议程、对抗力量、方向性转向和退出状态；转向需有可追溯的事实、筹码、代价或选择使原策略失效，不以对手无因沉默或离场代替。审查者必须引用场景中的行动证据，不能仅检查是否填写了场景卡。
+
+氛围、仪式、蒙太奇、过渡和后果消化场景不必虚构一个对手或策略失败来套这张工作卡。它们仍需完成
+不可替代的变化，例如让知识、关系、压力、节奏或生产状态进入下一阶段；若删掉后这些都不损失，才是
+场景必要性问题。静止、重复和停顿可以就是被设计的运动，而不是自动判为“没有转向”。
 
 **`craft_default`**：在压力已活跃时进入，在有意义的变化后离开。若例行准备本身承载关系或危险，可有意保留。
 
@@ -144,6 +160,11 @@
    建立过就不算巧合；毫无铺垫的偶遇是作者伸手。
 4. **只用一次**：同一条线上第二次巧合就成了模式，观众会停止相信这个世界的因果。
 
+已建立的常规资源可以帮人物换策，但不能恰好替他付款。若道具、身份、权限或旁人的出现直接完成了原本最难的
+一步，人物自己的策略、取舍或关系反应就会被掠走。资源可以改变问题的形状，解决仍应由人物完成。
+旁人因为人物闯祸而进场时，他的反应通常应让人物更难维持原有策略，而不是无条件欣赏、宽恕或刚好送来可用资源。温情、荒诞或反常反应
+当然可以成立，但需要是作品已经建立的世界与语气，不是作者为了收场突然放过人物。
+
 **误会的失效点几乎总在解除的那一刻**。 最常见的写法是：误会产生 → 拖了几场 →
 解释清楚 → 一切照旧。这样的误会整段可删，因为它没有留下任何东西。四条判据：
 
@@ -162,6 +183,30 @@
 **`taste_option`**：喜剧、闹剧与仪式性重复可以刻意堆叠巧合，只要堆叠本身是被看见的
 风格选择，而不是因果链的替代品。
 
+### 3.5 把一拍写成艰难选择时，两个方向都要活着
+
+本节只用于剧本主动承诺“艰难选择”的段落，不是每集模板。“人物作出选择”不等于剧本给出两个按钮。
+如果人物在选择前已经说清一边没有价值或根本无法执行，剩下的方向只是顺序动作，不必硬包装成两难。
+
+写核心选择前分别回答：
+
+- 选择 A 此刻保住什么，立刻失去什么？
+- 选择 B 此刻保住什么，立刻失去什么？
+- 为什么人物不能先后都做？时间、资源、承诺、身份或公开代价具体封住了哪条路？
+- 人物行动后，失败的一边留下什么可见残余？
+
+代价可以是资源、关系、身份、时间、秘密、承诺或自我认知。关键是选择前双方仍有真实价值，选择后
+只计算由该行动新增或加重的损失；原本无论如何都会发生的困境仍可施压，但不能重复记作这次选择的成本。
+
+只关闭两条路径中真正互斥的部分，不为显得深刻而顺手丢掉可兼得的收益。可以做退出状态反事实：若走
+另一条路，结尾的哪项损失不会发生？答不出来时，可能只有压力没有选择代价，也可能这本来就不是两难。
+
+选择触发应来自已经活跃的价值、人物或因果，而不是一个从未建立过的便利条件恰好在犹豫瞬间出现并替
+角色决定。偶然事件可以制造问题或提供信息；最终方向仍要由人物如何回应来定义。
+
+**`reviewed_invariant · SCR-13`**：当一拍被写成重大选择时，至少两个仍可执行、仍有价值的方向保持到
+人物行动；普通决定与单向追求不启用本条。审查者引用选择前被保住和被牺牲的价值，不能只检查有没有“还是”。
+
 ## 4. 把内在意义写成可表演行动
 
 ### 4.1 区分意义与载体
@@ -245,7 +290,60 @@
 
 **`structural_invariant · SCR-05`**：剧情要求观众读清的文字、明确画外音/画外对白、关键声音、转场与易丢失连续性，必须使用支持的边界标签。校验器检查标签与字段，不判断台词好坏。
 
-### 5.3 人多的场次：先解决"谁是谁"
+同一物件或动作可以重复出现，但每次必须有新工作：持有人变化、文字露出、用途改变、旧承诺被重新解释，
+或人物对它采取了以前不会采取的行动。重复只为提醒观众时，优先删掉解释；重复后的状态变化本身就是
+记忆。不要为了“丰富”不断引入一次性道具，让观众每场重新学习一套证据。
+
+当过去关系推动现在的行动时，尽量让它影响人物此刻的策略，而不是暂停剧情讲完往事。可通过称呼、
+回避、承诺、空间距离、习惯动作或输入已经支持的物件承载；物件只是选项之一。若一个细节只负责提示
+“这里该感动”，可以删掉或让它承担更具体的关系工作，但不要求每段关系都拥有重复道具。
+
+### 5.3 证据先改变判断，再改变关系
+
+本节只在人物的重大判断依赖**可争议证据**时启用。证据不是万能真相按钮，可以先拆开它可能涉及的四层：
+
+1. **来源/真伪**：它是不是刚刚伪造、是否来自所声称的时间和地点；
+2. **身份**：谁接触、写下、持有或留下它；
+3. **原因/动机**：那个人为何这么做；
+4. **完整真相**：事件究竟怎样发生。
+
+先问当前转折究竟依赖哪层结论，再找仍然活跃的普通反解释。需要现场验证时，把反解释改写为可观察预测：
+如果它为真，现场哪项结果应不同？测试使该预测失败，结论才可收紧；测试做不到，就保留不确定性。悬疑
+可以故意延迟验证，喜剧可以让人物因性格而误判，主观叙事也可以让错误判断持续——关键是剧本知道这是
+人物相信的事，而不是把它当世界真相。
+
+人物只更新被证明的那层判断，结果命名也不超过实际展示的范围。真正的戏剧变化通常在下一行动：撤回
+指控、改变合作方式、隐藏新发现、升级防备或承担风险，而不必统一落成一句“我信了”。
+
+若结论依赖连接、封存、原位、时间或未被触碰等状态，按动作顺序检查谁改变过它；验证可以消耗证据，
+但已被消耗的性质不能继续充当结论依据。相对日期只有在它驱动关键判断时才需要当前锚点，历史记录本身
+只能证明记录内容，不能自动证明“现在”。
+
+当证据是本集主要观看对象时，至少让一次观众可跟随的状态变化实际改变推断：它使某个解释更可能、更不可能，或明确暴露当下无法越过的证明边界，
+并因此改变人物的下一动作。拍照、拿起、收袋、编号、登记等操作只有在改变接触连续性、可用性或调查方向时才是戏剧节点；否则它们只是程序布景。
+一次验证已经改变本集需要改变的判断后就停止；只有仍然活跃的反解释会迫使人物采取不同下一动作时，才继续测试。不要为了显示严谨，把同一结论依次交给页面、原始文件、日志、时间戳和人物复述重复确认。
+这不等于每个线索都要现场鉴定；“保留不确定”也能成为可拍结果，前提是观众看得见不确定的边界发生了什么变化。
+
+**`reviewed_invariant · SCR-14`**：当重大判断依赖可争议证据时，结论不超过证据与已展示验证所支持的
+范围；作品可以排除反解释、保留不确定性或有意延迟验证。普通事实、喜剧误会、主观叙事和以歧义为目标
+的线索不强制增加取证程序。
+
+### 5.4 主要配角有策略，事务角色不硬加戏
+
+承担主要戏剧功能的配角会占用观众注意力，应有自己的目标、判断或策略，能影响主角采取何种行动；否则
+考虑合并人物或把信息交给更自然的载体。这里判断的是**角色承诺与篇幅是否匹配**，不是要求人人改变主线。
+若一个人物在开场提供核心筹码、提出主要反对或承担选择的代价，转折发生后也要继续有一次相称的行动或反应；不必获胜，但不能
+因为主角已经作出决定就突然变成可被拖走、略过或替代的功能物。
+对手在开场控制的筹码不会因为主角完成一个动作就自动归零。若对手此后确实无法继续交易、阻拦或反制，用前面已建立的空间、力量、权限、公开关系或自身选择说清它如何失效，
+而不是直接把他放到一边。
+
+事务性或环境性角色可以只完成问路、交易、播报、见证等局部功能；群像、荒诞喜剧和仪式场景也可能故意
+让个人退入集体节奏。不要为了通过检查给每个有对白者硬加秘密、反转或关系动作。
+
+当配角承载过去关系时，只说当前争取需要的最小片段，再让对方的反应补足历史；若他只是中性传达背景，
+可把说明压短或移入正在发生的冲突。删掉角色后主线完全不变并不自动是缺陷，先看作品是否承诺他是人物。
+
+### 5.5 人多的场次：先解决"谁是谁"
 
 一场里出现七八个人时，最先崩掉的不是冲突，是**辨识**。观众分不清谁在说话、谁站哪边，
 后面写得再有力也接收不到。竖屏与快节奏会放大这个问题：观众没有回看的习惯，错过一次
@@ -268,7 +366,7 @@
 仪式、群体压迫、闹剧式围攻这类场面本身就以"人多且乱"为效果时，可以有意违反本条；
 此时要让混乱是被看见的选择，并至少保留一条观众能跟住的线索。
 
-### 5.4 主角不在场的场次
+### 5.6 主角不在场的场次
 
 镜头可以整场不给主角，甚至整集不给。条件是这一场的**情绪、推进、戏剧性与期待**仍然
 挂在主角身上：观众看反派上钩，看的是主角上一场埋的那一手；观众看旁人震惊，震惊的
@@ -310,6 +408,41 @@
 
 **`taste_option`**：作品可以高压、克制、荒诞、仪式化或生活流；节奏目标随风格改变。
 
+任务明确给出目标时长时，先按真实表演通读：台词要说完，人物要移动、寻找、验证、反应，观众也要
+看清关键文字。项目没有声明语速时不能伪造精确秒数，但仍可发现明显装不下的节拍；优先删重复日期、
+第二次同义验证、已被动作说明的台词和回报后的同义收尾，而不是把所有动作默认为瞬间发生。
+
+### 6.3 倒计时先算动作，不要只写数字
+
+本节只用于被前景化、可由观众逐项核对的**字面精确死线**。这类压力来自“来不及”，动作链要经得起
+最粗的现实检查：移动、寻找、操作、等待和说话都占时间，每次显示新时间应与其间完成的工作大致相称。
+蒙太奇、跳时、梦境、主观拉伸或明确风格化的计时不自动接受现实秒表审查，先按作品建立的约定判断。
+“快点”“赶不上”“快迟到”“所剩不多”等定性压力不是精确死线；若题面没有给出可核对数字，不要擅自把它升级成分钟、秒数、时间戳、通知或系统记录。具体性应落在人物行动与后果上，不靠新增数字证明紧迫。
+
+压缩专业过程时，保留会改变局面的节点，不保留操作说明书：诊断、受阻、换策、分工、取舍或可见结果
+中只选本场真正需要的部分。可互换步骤可合并；能改变人物关系、风险或方案的步骤才值得展开。
+
+短时长高潮通常承受不住连续多种同质障碍与多轮解释。优先保留最能改变策略的一项；观众已从动作看懂
+机制后，让后续关系或行动承担结论，不再由对白逐步复述同一过程。
+
+同一种压力出现多个计时或信息载体时，检查它们是否各自承担节奏、误导、反讽、主观体验或后果；只有
+纯粹重复播报时才合并。关键验证也优先形成一条观众跟得上的连续动作，而不是为显得严谨重复展示。
+
+若目标确实来不及，人物可以缩小目标、换熟悉方法、调用已建立资源或接受部分失败。新的解法仍须穿过
+输入已经建立的核心阻力；临到高潮才新增此前无迹可循的资源、权限或能力直接抹掉困境，不是换策略。
+
+**`reviewed_invariant · SCR-16`**：当作品前景化字面精确死线时，时间标记与动作容量大致一致；不一致时，
+剧本让压缩约定、换策、目标变化或失败可读。蒙太奇、跳时、主观时间和明确风格化计时按既有约定判断。
+
+时间事实还必须单调：`20:59:47` 后的十秒倒数只能在 `20:59:57` 左右结束；整点报时发生后，不再出现
+`20:59:58`。宁可少写一个数字，也不要让精确数字互相拆台。
+
+### 6.4 有限单位按完成状态计数
+
+题面若把“三次机会”“两轮演示”“倒数中的每一拍”等有限单位设为观看约束，先从要求的完成状态倒推每个单位必须留下什么可见结果。只有该单位结束时目标状态已经完成，才算消耗一个单位；命名单位、报数、提出请求、获得授权、开始准备或在边界之后补做，都不能冒充完成。作品可以故意让某个单位失败或只完成一部分，但要把失败/部分完成作为该单位的可读结果，而不是让所需完成动作悄悄移到计数之外。
+
+有限单位不是新的模板：题面没有此类结构时不要主动分拍、报数或增加倒计时；题面使用诗性、主观或仪式化计数时，按它已经建立的完成约定判断，不擅自改成现实秒表。
+
 ## 7. 写动作段落与生产事实
 
 ### 7.1 动作段落
@@ -344,7 +477,7 @@
 - `[SFX]`：会改变注意、行动或信息的关键声音；
 - `[画面文字]`：观众必须读清的载体与精确内容；
 - `[转场]`：有叙事意义的转场要求；
-- `[连续性]`：很容易在后续丢失、且影响故事的明确状态变化。
+- `[连续性]`：由前文可见动作已经建立、很容易在后续丢失且影响故事的明确状态变化；它只能交接状态，不能以作者断言证明镜头外“从未发生”“始终无人接触”等负面事实。
 
 **`structural_invariant`**：生产关键事实不能只藏在作者注释或模糊形容里。标签内容应有明确边界，并与普通动作/对白区分。
 
@@ -367,12 +500,34 @@
 
 **`taste_option`**：冷开场、缓慢观察、先果后因、平静日常都可以选择；它们必须服务作品的观看契约。
 
-### 8.2 收束完成两个动作
+### 8.2 收束完成本集承诺
 
-1. 让当集的局部结果被看见：取得、失去、承认、拒绝、关系变化或证据意义；
-2. 把新压力变成下一集可执行的决定、后果或未稳定状态。
+结尾可以让局部结果被看见，也可以让关系、情绪、喜剧节奏、恐惧或主题意象获得落点。连载需要交接时，
+再写清下一集继承的行动、知识、关系或物理状态；不是所有单集都必须把新压力顶到最后一秒。
 
-结尾不必总靠打断一句台词。人物完成一次行动后形成的新局面，也能有持续力。
+收束先回答本集承诺的功能是否完成：可以是局部结果、关系重新定义、认知变化、喜剧落点、恐惧余波、
+讽刺反照或有意保持开放。连载作品通常还需要可交接状态，但不等于最后一拍必须追加外部事件。
+
+局部回报不必清空代价。选择后仍存在的残余可留在人物行为、关系、空间、声音或物件状态里；主题已经
+能从结果读出时，不再用抽象口号解释。重复动作、静止画面或环境声也能收束，只要它因前文获得新意义。
+
+如果前文把某项代价当作行动的核心阻力，退出状态至少要保留它的一项实质影响：能力暂时缺口、身体损伤、资源消耗、
+关系债务或必须处理的后续行动均可。不要在高潮后立即让系统、能力或局面自动复位，使原先的赌注只留一处轻微痕迹。
+
+回报落下后，逐拍问“它在加深、转义、沉淀，还是重复说明？”多项后果可以并存，不强制只留一拍；
+只有功能相同、观众已接收的内容才合并。安静余韵不是空转，机械复述才是。
+人物放下、拿起、让路、留下或离开的动作已清楚表明了意向时，后面再写一次同向决定只会稀释第一次，除非中间有新阻力使第二次付出了不同代价。
+笑点、情感或意象也一样：行动和画面已经完成的意义，不再用一句标语概括；一个生活细节已经形成隐喻时，不连续用多句人生道理翻译它。
+
+已经声明不可逆的后果不应被后续动作无意写回轻易可挽回。作品若有意展示缓和、反转或仍存余地，让新的
+因果清楚可读，而不是靠含混连续性同时声称“路径关闭”和“其实没关系”。
+
+承担关系转折的主要人物应有相称反应，但反应可以是撤回、回避、沉默、策略变化或延迟爆发，不要求统一
+改持物或立刻表态。结尾连续性则要求关键持物、空间和知识状态能从前文动作追溯；氛围性钩子、黑场、
+声音和静止画面都可使用，只要它们完成作品的期待，而不是替代一个本该写出的结果。
+
+**`craft_default · SCR-15`**：收束留下可读的结果或余效，并服从本集观看契约；推进、留白、反讽、
+静止或开放状态都可成立，不用抽象口号替观众解释，也不为满足规则强造新事件。
 
 ### 8.3 写精确出去状态
 
@@ -406,7 +561,19 @@ owner 修订 episode map；若使用 `write_standalone`，才由 write 修订自
 
 删除可互换顺序且无后果的重复。
 
-### 9.2 场景遍
+### 9.2 选择遍
+
+仅当本集把某一拍写成艰难选择时启用。标出仍可执行的方向，暂时盖住任务说明，只读剧本，检查观众
+能否指出各自价值、人物为何不能兼得，以及哪项损失由这次行动新增。若题面本来是单向追求或普通决定，
+不要为了完成本遍而补出第二条路径。
+
+### 9.3 证据遍
+
+仅当重大判断依赖可争议证据时启用。写“证明了什么 / 没证明什么 / 仍有哪些活跃解释”，再决定本集是
+现场验证、保留不确定性还是有意延迟。不要为了完成本遍给普通事实加取证程序，也不要破坏喜剧误会、
+主观叙事或悬疑线索有意保留的歧义。
+
+### 9.4 场景遍
 
 标出每场目标、反对、策略变化、转向和退出。没有变化的场景：
 
@@ -414,11 +581,11 @@ owner 修订 episode map；若使用 `write_standalone`，才由 write 修订自
 - 让证据/关系/决定在此真正改变；
 - 或删去，把必要信息移到正在发生的冲突。
 
-### 9.3 可表演遍
+### 9.5 可表演遍
 
 圈出只存在于作者说明中的认知和情绪。为关键项选择行为、证据、空间、关系动作或有意声音；不要为每个形容词补微表情。
 
-### 9.4 具体性遍
+### 9.6 具体性遍
 
 替换不产生行动的泛词：
 
@@ -428,15 +595,15 @@ owner 修订 episode map；若使用 `write_standalone`，才由 write 修订自
 
 只补对识别、因果、表演或连续性有用的细节。
 
-### 9.5 生产事实遍
+### 9.7 生产事实遍
 
 检查可读文字、声音、画外对白、转场和连续性标签。去掉模型、镜头和资产说明，把它们留给各自所有者。
 
-### 9.6 声音与潜台词遍
+### 9.8 声音与潜台词遍
 
 使用 [dialogue-craft.md](dialogue-craft.md)。朗读角色台词，检查删掉角色名后是否仍能凭策略、关系和措辞辨认，而不是靠口癖标签。
 
-### 9.7 扫读遍
+### 9.9 扫读遍
 
 前面几遍都是慢读——逐条检查因果、可表演性、具体性。这一遍相反：**用比正常阅读快得多
 的速度把本集扫一遍**，尽量不停顿、不回看，然后只回答两个问题：
@@ -454,9 +621,17 @@ owner 修订 episode map；若使用 `write_standalone`，才由 write 修订自
 记下来，再决定改不改。它是自检手段，不是质量门槛——刻意要求观众停下来思考的段落，
 可以在说明理由后保留。
 
-### 9.8 所有权遍
+若作品使用可由观众逐项核对的字面精确死线，扫读后再做一次**可行性快查**：把时间标记之间的动作
+顺序读出来。只能靠“默认很快”才能塞入时，按 SCR-16 让压缩约定、换策、目标变化或失败可读。蒙太奇、
+跳时、主观时间和明确风格化计时不做现实秒表换算。
+
+### 9.10 经济性遍
+
+最后静默扫掉四类规则展示：输入没有要求的精确数字或记录；为同一结论叠加的验证链；复述动作的标签或对白；回报后多个同方向决定、解释或后果。先问能否保留一个主要因果载体完成同样的戏，再删除没有新作用的载体。删的是冗余展示，不是选择、证据、时限、人物或连续性 knowhow。
+
+### 9.11 所有权遍
 
-列出语义变化、未改部分与受影响下游。创作者接受后发布；所有者不能给自己签发终审通过。
+列出语义变化、未改部分与受影响下游。创作者确认后更新 `剧本.md`；所有者不能给自己签发终审通过。
 
 ## 10. 现有剧本的最小规范化
 
@@ -470,7 +645,7 @@ owner 修订 episode map；若使用 `write_standalone`，才由 write 修订自
 4. 输出并列预览；
 5. 分别列出语义新增、删除、改写、未映射段落和低置信映射；
 6. 让创作者接受、修订或取消；
-7. 只有接受后才发布 `screenplay.md` 与派生索引。
+7. 只有确认后才更新 `剧本.md`；需要时临时生成索引做格式与时长检查，不把索引作为项目产物。
 
 **`structural_invariant`**：拒绝或取消不得改变现有规范剧本；未映射的生产关键内容不得静默丢失。
 
@@ -541,6 +716,11 @@ owner 修订 episode map；若使用 `write_standalone`，才由 write 修订自
 - 主角缺席的场次替配角讲了他们自己的故事，主角的处境与观众的期待都没有变化；
 - 扫读时反复需要停下来确认谁说了什么、某样东西是哪来的；
 - 用篇幅或数量替代场景必要性判断。
+- 题目并未承诺两难，却为了显得深刻硬加第二条路径；或反过来，声称是艰难选择却提前让一边失效；
+- 可争议证据让人物接受远超证明范围的完整真相，且作品未把它标成误判；
+- 事务性角色被硬加秘密、反转或关系动作，只为满足“每个人都要推动主线”；
+- 字面精确死线只能靠未说明的瞬间完成成立；或把蒙太奇、主观时间误审成实时连续；
+- 结尾用主题口号解释已清楚的意义，或为了“必须有钩子”硬加与本集无关的新事件。
 
 ### 审查问题
 
@@ -554,5 +734,12 @@ owner 修订 episode map；若使用 `write_standalone`，才由 write 修订自
 6. 生产关键事实是否有正确边界，是否混入其他层内容？
 7. 本集的进入与出去状态能否精确交接？
 8. 修订是否保护了创作者的风格选择与未改部分？
+9. 若本集承诺艰难选择，各方向在行动前是否仍有价值，哪项代价由选择新增？若没有此承诺，是否避免硬造两难？
+10. 若重大判断依赖可争议证据，结论是否与证明范围相称；作品是验证、保留还是有意延迟？
+11. 局部回报是否留下本集所需的结果或余效，同时没有用口号抹掉意义？
+12. 若前景化字面精确时限，动作链是否可信；若采用蒙太奇、跳时或主观时间，约定是否清楚？
+13. 私人动机通过何种符合题材的行为、关系、对白、沉默、空间或物件载体进入当前行动？
+14. 若证明依赖连接、封存、原位、时间或无触碰状态，该性质是否被前序动作破坏？
+15. 结尾形式是否服务本集观看契约，而不是机械满足“必须新增事件”或“必须安静”的单一配方？
 
 写作所有者依据证据修订；审查动作负责记录结论，不能把修订产物本身冒充 verdict。

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

@@ -1,74 +1,10 @@
 # 剧本阶段契约
 
-## 目录
+本阶段只拥有 `剧集/<EP>/剧本.md`：场景、动作、对白、画外音、声音事实、画面文字、连续性提示与转场。
+它继承项目/分集决定，但不决定人物视觉身份、镜头构图、提示词或媒体生产。
 
-- [独立运行与项目集成](#独立运行与项目集成)
-- [所有权边界](#所有权边界)
-- [单集契约与题材边界](#单集契约与题材边界上游输入)
-- [本阶段规则](#本阶段规则)
-
-本文件是本技能的自包含契约：预检、所有权、形态输入与规则表都在这里，
-不需要读取其他技能的文件。
-
-## 独立运行与项目集成
-
-本技能可以单独安装并运行；下面几条说明项目工具存在时怎样集成。
-
-1. **读取直接输入**：只读取用户明确提供或当前任务实际需要的文件，不批量加载整个项目。
-2. **可选项目集成**：若存在 `short-drama.json` 且 core 项目工具可用，可以运行
-   `python3 <core>/scripts/project_tool.py status <project>`，使用返回的目录布局和语言设置；
-   core 不可用时，直接基于已提供输入产出本阶段文件。
-3. **可选发布生命周期**：项目工具可用时，用 `publish` 原子发布并用 `--input <path>`
-   声明直接输入；`accept`、`review` 与 `package` 继续承担确认、复核与交付。
-4. **保持职责分离**：创作者确认、内容修订和复核是不同动作；reviewer 提修改要求，负责人改文件。
-
-## 所有权边界
-
-- **本阶段拥有**：场景执行计划、节拍、剧本正文；场景/动作/对白/生产标签；已实现的
-  知识、信念、目标、关系与情绪变化；块 ID、类型与跨度。
-- **本阶段继承**：已接受的单集契约与已接受事实。开发环节拥有已规划契约时，本阶段只投影
-  它、不复制它；没有开发环节记录时，本阶段可拥有独立单集契约，后续若引入开发记录须显式
-  迁移权威。
-- **本阶段不越权**：不决定景别、机位与镜头时长，不建立或改写资产身份与变体，不指定提示词
-  构成。需要这些变化时发修订请求。
-
-## 单集契约与题材边界（上游输入）
-
-本阶段执行的是**已接受的单集契约**，不重新设计分集，也不给项目归类题材。下面写清这两样
-东西进入本阶段时必须包含什么、缺失时怎么办——写作时按这份清单核对即可，不去读开发环节
-的文件。
-
-### 单集契约必须提供的字段
-
-| 字段 | 本阶段拿它做什么 | 缺失时 |
-|---|---|---|
-| 进入状态 | 首场从哪个已经成立的处境开始 | 向 develop owner 发修订请求 |
-| 当集追求与阻力 | 每场的议程与反对力量从哪来 | 同上；不自行发明动机 |
-| 因果升级 | 哪几步必须在本集内被看见 | 同上 |
-| 方向性转折 | 哪一次选择改变了局面 | 同上 |
-| 当集兑现 | 集尾钩子之前必须落地的局部结果 | 同上 |
-| 出去的压力与交接事实 | 末场留下什么、下一集要继承什么 | 同上 |
-| 信息权限 | 谁知道什么、观众知道什么 | 同上 |
-
-本阶段只把这些字段**落实成可表演的场景**：补场景发动机、节拍顺序、对白策略与生产标签。
-不得在剧本里改写契约字段——需要改就发修订请求，不在执行层偷改。
-
-### `write_standalone`：没有开发记录时
-
-项目没有 develop 拥有的单集契约时，本阶段可以自己拥有一份独立契约，但它必须包含上表
-同样的字段，并明确标为 standalone。后续若引入 develop 记录，先做语义 diff，让创作者明确
-选择权威迁移，把 standalone 契约标记 superseded，再换成指针；同一集不得同时激活两种模式。
-
-### 题材：本阶段执行，不分类
-
-题材机制会影响压力来源、可用证据、场面颗粒与集尾取向，但**选择哪个题材、用哪套钩子取向
-属于开发阶段**。本阶段的做法是：
-
-- 已有已接受的题材与钩子取向时，按它执行，并以单集契约为准；
-- 没有已接受取向时（例如从想法直接写作），**不要贴题材标签给自己造公式**。改为向创作者
-  确认本集要兑现什么承诺、观众该获得什么回报，然后按第 5 节的叙事工艺决策规则写；
-- 任何情况下都不把题材词直接当成剧情答案，也不因为"这个题材通常这样"就新增契约里没有的
-  事件、人物或代价。
+所有来源都用文档中可见的集号与场景 ID 定位；不建立第二份节拍、block、审批或状态文件。格式标签
+只负责区分生产语义，不借格式补造剧情。输入明确给出的事实、必须/禁止、题材观看契约与退出状态优先于本表；规则不能补造题面没有的精确数字、记录、资源、程序或机关。
 
 ## 本阶段规则
 
@@ -76,11 +12,11 @@
 
 | ID | Class | Knowledge |
 |---|---|---|
-| SCR-01 | reviewed_invariant | Every scene has a current agenda, opposing force, directional turn, and exit state. |
+| SCR-01 | reviewed_invariant | When a scene is organized around active pursuit or conflict, it has a current agenda, opposing force, directional turn, and exit state. A traceable fact, leverage change, cost, authority, or choice makes the prior strategy fail; an opponent's unexplained silence, inaction, or departure does not substitute for the turn. Atmospheric, ritual, montage, transition, and consequence-processing scenes may instead justify themselves through a necessary change in knowledge, relationship, pressure, rhythm, or production state; they must not manufacture an opponent merely to satisfy this rule. |
 | SCR-02 | craft_default | Prefer choices and consequences over coincidence for major turns. |
 | SCR-03 | reviewed_invariant | Private thought is expressed through behavior, evidence, or deliberate VO/OS. |
 | SCR-04 | craft_default | Dialogue carries agenda, relationship, subtext, and a change—not only information. |
-| SCR-05 | structural_invariant | Existing production tags use supported, closed syntax and resolvable references. |
+| SCR-05 | structural_invariant | Existing production tags use supported, closed syntax and resolvable references. A continuity tag records a state established by shown action; it cannot establish that an unseen event or contact never occurred. |
 | SCR-06 | taste_option | Silence, slang, interruption, narration, and sentence rhythm remain character/style choices. |
 | 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. |
@@ -88,6 +24,11 @@
 | 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-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. |
+| SCR-14 | reviewed_invariant | When a belief change hinges on contested evidence, the conclusion stays within what the evidence and any shown test support. If that evidence is a primary episode engine, at least one audience-followable state change changes which explanations remain live or changes the next action; routine photographing, bagging, numbering, or logging does not count by itself. The scene may test the strongest live counter-explanation, preserve uncertainty, or intentionally delay verification; this rule does not require a forensic procedure for uncontested facts, comic misunderstanding, subjective narration, or clues whose ambiguity is the point. |
+| 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. |
 
 规则分级由高到低：`structural_invariant`（结构缺陷，阻断）、
 `reviewed_invariant`（需证据判断）、`craft_default`（常用做法，可覆盖）、