@oh-story/dsh 0.1.15 → 0.1.16

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`；独立任务没有项目配置时沿用用户当前语言，不固定为英文。写声音职责而不是可执行声音指令，
-不做分段，不罗列画幅备选，用可见的画面关系而不是术语描述运镜。这样的正文在任何执行端上都成立，
-只是没有针对性收敛。**未声明不是缺陷**，不能作为审查阻断理由。
+不做分段，不罗列画幅备选，用可见的画面关系而不是术语描述运镜。这是未选定目标模型时的通用草稿；选定后仍须按其能力和方言复核。**未声明不是缺陷**，不能作为审查阻断理由。
 
 ## 自检
 

package/lib/drama/skills/short-drama-video-prompts/references/wan-3.0.md

@@ -79,7 +79,8 @@ Wan 3.0 用中文自然指令，素材写成 `图1`、`视频1`、`音频1`。
 不需要就写「无背景音乐」。一组小样本里写全环境声、不提配乐与加「无背景音乐」各 4 次，
 8 次都没有配乐；仍把配乐层写明，不留给模型决定。
 
-默认禁字幕时写「全程无字幕，画面中不出现任何文字」；画内获准文字另行逐字说明。
+默认禁字幕时写「全程无字幕，不生成对白文字叠加」；画内获准文字仍逐字说明承载面和位置。
+只有本镜没有画内可读文字义务时，才加全局无文字要求。
 
 ## 智能改写
 

package/lib/drama/skills/short-drama-write/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: short-drama-write
-description: 编写或修订可拍摄的中文短剧、漫剧单集 Markdown 剧本，也负责保留作者原文地规范化现成剧本。用户提出“写/改一集短剧”“把大纲写成剧本”“优化场景/对白”“去模板感”“去 AI 味润色”“续写下一集”或提供剧本要求进入后续制作时使用；不负责资产、分镜、媒体提示词或终审。
+description: 编写或修订可拍摄的中文短剧、漫剧单集 Markdown 剧本，也负责保留作者原文并规范化现成剧本。用户提出“写/改一集短剧”“把大纲写成剧本”“优化场景/对白”“去模板感”“去 AI 味润色”“续写下一集”或提供剧本要求进入后续制作时使用；不负责资产、分镜、媒体提示词或终审。
 license: MIT
 ---
 
@@ -27,13 +27,13 @@ license: MIT
 ## 工作流
 
 1. 锁定本集承诺的观看体验、谁现在要什么、阻力、当集兑现和退出状态。
-2. 只识别本集实际存在的发动机：若主打艰难选择，检查两边价值；若判断转折依赖争议证据，检查证明边界；若前景化精确死线，检查动作容量；若题面限定次数、轮次、呼吸或节拍，检查每个单位是否在边界内完成所需状态。没有时不强行补齐；输入已经以它为主发动机时，要让它真正改变行动、关系或结果，不只在台词中点名。
+2. 识别本集实际承担看点的机制：主打艰难选择时检查两边价值，判断转折依赖争议证据时检查证明边界，突出精确死线时检查动作容量，题面限定次数、轮次、呼吸或节拍时检查各单位是否在边界内完成所需状态。输入没有要求的机制不强加；已经作为主要看点的机制，要真正改变行动、关系或结果。
 3. 在上下文排“因为—行动—结果—下一股压力”，不落盘节拍表；让物件、对白、沉默、空间或声音按本集题材承担必要工作，不预设某一种载体。
 4. 逐场确定不可替代的功能、可见变化与场尾状态；由争取或冲突组织的场景再明确焦点议程与阻力。承担主要戏剧功能的配角要有自己的策略，事务性或环境性角色保持简洁即可。
 5. 把动作、对白、画外音、声音事实和画面文字写入同一份剧本。
 6. 用户要求整集就写完整集，场景批次自动续跑。
-7. 交稿前静默反查：只看剧本能否接收到本集承诺、人物行动是否有因果、题材语气是否一致；再对本集确实使用的选择、证据、有限单位或精确死线做专项检查。若自检让剧本长出输入没有要求的机关，撤掉机关而不是替它找理由。
-8. 局部修订保留无关段落；明确问题直接修正，只把真实剧情分叉交给用户。
+7. 交稿前静默反查：只读剧本，观众能否接收到本集承诺，人物行动是否有因果，题材语气是否一致；再对本集确实使用的选择、证据、有限单位或精确死线做专项检查。自检若增添了输入没有要求的机关，撤去新增机关。
+8. 局部修订保留无关段落；明确问题直接修正，会改变剧情走向的选择交给用户。
 
 ## 写作要求
 
@@ -41,13 +41,13 @@ license: MIT
 - 每场改变信息、权力、关系、情绪、物理状态或风险；无变化的场删掉或合并。核心阻力的转向要有可追溯的事实、筹码、权限、代价或人物行动，不能只靠对手停止反应。
 - 对白必须在争取、回避、试探、逼迫或重新定义关系；用可见、可听、可触的行为表现状态，不用解释替代行动，也不把已经演清的机制再说一遍。
 - 自己写的对白初稿，写完读一遍，删掉不承担动作或冲突的句子；留下的每句都要能转成演员的一个动作或表情，转不成的删掉或改成动作。创作者带来的原文不按这条删。
-- 全集第一拍自己要是钩子，见[开场第一拍](references/script-craft.md#81-开场接住进入状态)。
+- 全集第一拍应能独立形成钩子，见[开场第一拍](references/script-craft.md#81-开场接住进入状态)。
 - 观众理解当前行动所必需的赌注要进入剧本，但载体服从题材；选择、证据、有限单位、精确死线等专项规则只在输入真正以它为发动机时启用，并按需读取[剧作手艺](references/script-craft.md)，普通决定、普通物件和模糊时间压力不升级成同一套机关。
 - 压缩过程时只保留会改变策略、关系、风险或结果的节点。资源与外部反应必须来自输入或前文建立，且不能替人物完成最难的戏剧行动。
 - 承担主要冲突的角色要保持相称的目标、判断或策略；事务性、环境性角色保持简洁，不为检查表硬加秘密、反转或人物弧。
 - 已建立的代价、不可逆后果、关键持物、空间和知识状态要进入可追溯的退出状态；结尾可推进、留白、反讽、安静收束、形成余韵或让既有动作变义，不强制追加外部事件；已接受节奏档案的 `end_on_peak` 为 `true` 时，停在峰值上，不接余韵（见[项目节奏档案](references/script-craft.md#65-项目节奏档案)）。
 - `[连续性]` 只交接由前文动作已经建立、又容易在下游丢失的状态；不能用作者标签证明镜头外从未发生某事，也不复述正文已清楚呈现的结果。
-- 交稿前静默做一次经济性检查：是否增加了输入没有要求的精确数字或记录链；是否用标签/对白重复动作；是否在回报后堆了多个同方向后果。没有新作用的内容删掉，knowhow 本身不删。
+- 交稿前静默检查冗余：是否增加了输入没有要求的精确数字或记录链，是否用标签/对白重复动作，是否在回报后堆了多个同方向后果。删去没有新作用的内容，保留本集需要的选择、证据、时限、人物与连续性事实。
 - 输入给出目标时长时按真实表演、动作和停顿通读压稿，先删重复验证、解释和同义收尾；不用统一字数、镜头数或节拍数填模板。
 - 用户原文优先；“去 AI 味”是定点修订，不抹平作者个性。
 
@@ -63,7 +63,7 @@ license: MIT
 - 过去关系必须通过对白进入，或关键人物容易只剩说明功能：[对白手艺](references/dialogue-craft.md)
 - 声源、留白与 sound bridge：[场景声音戏剧](references/scene-sound-dramaturgy.md)
 - 同一故事义务的不同可拍实现：[可替代实现](references/substitutable-realization.md)
-- 长单集跨上下文时的最小交接：[场景交接胶囊](references/scene-handoff-capsule.md)，只留在上下文
+- 长单集跨上下文时的最小交接：[场景交接摘要](references/scene-handoff-capsule.md)，只留在上下文
 - 本集要用 `[VO]` 或内心独白交代信息，或有痛点要交代：[能演的不说](references/script-craft.md#44-能演的不说vo内心独白与痛点)
 - `short-drama.json` 里有 `status` 为 `accepted` 的 `creator_authority.rhythm_profile`：[项目节奏档案](references/script-craft.md#65-项目节奏档案)
 
@@ -72,9 +72,8 @@ license: MIT
 用户问时长，或项目已接受节奏档案、需要核对 VO 占比时，才把索引写入系统临时目录。先用 Python 查询跨平台临时目录，把第一条命令打印的完整
 路径原样替换进后两条命令的引号内。以下每条都是一行完整命令，不依赖 shell 变量或续行符；Windows
 没有 `python3` 命令时使用 `py -3`。`--speaker` 的示例值必须替换为本集实际说话者。
-`--project short-drama.json` **只加在第三条命令上**（`duration_estimate.py` 才接受它，
-`screenplay_index.py` 没有这个参数，加上去会直接报 `unrecognized arguments`），且只在项目
-配置确实存在时加：
+项目配置存在时，可在第三条命令末尾加 `--project short-drama.json`。只有
+`duration_estimate.py` 接受这个参数，第二条索引命令不接受：
 
 ```text
 python3 -c "from pathlib import Path; import tempfile, uuid; print(Path(tempfile.gettempdir()) / ('short-drama-' + uuid.uuid4().hex + '.jsonl'))"
@@ -83,19 +82,20 @@ python3 "{技能目录}/scripts/duration_estimate.py" "剧集/EP001/剧本.md" -
 ```
 
 **改稿后重跑**：第二条命令写过一次的输出路径不能直接再写一次，会以 `already holds an index` 失败。
-要保留原有块 ID 就加 `--previous-index <同一路径>`，要从头重编号就加 `--no-previous`；
-或者干脆回到第一条命令另取一个临时路径。
+要保留原有块 ID，改稿前先保存旧剧本快照，重跑第二条命令时同时加
+`--previous-index <同一路径>` 和 `--previous-source <旧剧本快照路径>`。没有旧快照或要从头重编号时，
+加 `--no-previous`，也可以回到第一条命令另取一个临时路径。
 
 估时前区分计数口径：`dialogue_characters` 包含标点，视频提示词中的参考语速按可发声字数计算。
 按语速换算时排除标点，并按实际读法处理数字和缩写；不把两个计数混用。
-项目已接受节奏档案时，输出里多一项 `vo_share`：`[VO]` 字数占全部台词字数的比例、档案上限，以及是否超过。
+项目已接受节奏档案、上限有效且本集有台词时，输出增加 `vo_share`：`[VO]` 字数占全部台词字数的比例、档案上限，以及是否超过。`[OS]` 计入全部台词，不计入 `[VO]`。
 
 估算是参考，不是门禁；没有语速或动作段速率时只报告可数事实，不猜秒数。但任务已给目标时长时，
-写作者仍须用真实朗读和动作通读判断能否容纳，并直接压缩重复节拍；“不能精确估秒”不是忽略目标的理由。
+写作者仍须用真实朗读和动作通读判断能否容纳，并直接压缩重复节拍。
 
 ## 完成
 
-点名范围已写入、场景因果连贯、对白与行动可表演、承诺有兑现或有意延迟、结尾完成本集预定的戏剧或情绪功能，即完成。最后一拍的形态按上文结尾一条；判断它是否有效，不用“是否又发生一件事”代替。
+用户点名的范围已写入，场景因果连贯，对白与行动可表演，承诺得到兑现或有意延迟，结尾完成本集预定的戏剧或情绪功能，即完成。最后一拍按本集结尾功能判断，不以新增事件作为完成条件。
 资产、分镜、审查与生产只有用户点名时开始。
 五份创作文档齐备后，可转 `$short-drama` 对跨文档结构做一次机械核对；内容质量仍由创作者审查。
 

package/lib/drama/skills/short-drama-write/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "短剧写作"
   short_description: "创作因果清楚、人物声音鲜明、动作可表演的中文短剧剧本"
-  default_prompt: "使用 $short-drama-write 创作或修订我的单集卡、因果节拍和中文 Markdown 短剧剧本。"
+  default_prompt: "使用 $short-drama-write 创作或定点修订我的单集中文 Markdown 短剧剧本，写入剧集目录的剧本.md。"

package/lib/drama/skills/short-drama-write/assets/screenplay.md

@@ -1,7 +1,7 @@
 # EP001 【填写集名】
 
 <!--
-复制到 剧集/EP001/screenplay.md 后填写并删除本注释。
+复制到 剧集/EP001/剧本.md 后填写并删除本注释。
 场景标题：## 场景ID 内/外/内外 · 地点 · 时间/天气
 动作写现在时、可见且可表演的行为。对白格式：角色（可执行提示）：台词。
 只保留剧情必需的生产标签；未使用的示意行全部删除。
@@ -28,9 +28,8 @@
 
 ## EP001-SC002 外 · 【地点】 · 【时间/天气】
 
-【以上一场退出状态为进入事实。写新的目标、反对与方向性变化；不需要的示例场景直接删除。】
+【以上一场退出状态为进入事实，写出本场必要的变化；冲突场景再明确目标、反对与方向性转向。不需要的示例场景直接删除。】
 
 【角色名】：【台词】
 
-【以可执行的决定、后果或未稳定状态结束，并与 episode-card.json 指向的权威
-handoff_state（或 `write_standalone` 自有契约）对齐。】
+【以本集需要的决定、后果、情绪落点或开放状态结束；需要接下一集时，与已确认分集规划或上下文中的交接事实对齐。】

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

@@ -17,7 +17,7 @@
 
 ## 1. 对白的工作定义与规则分级
 
-对白不是角色把剧情资料读给观众。每一句都发生在具体关系中：说话者试图改变对方的行动、判断、情绪位置或公开形象，对方用自己的目标回应。
+对白发生在具体关系中：说话者试图改变对方的行动、判断、情绪位置或公开形象，对方用自己的目标回应。
 
 四类规则：
 
@@ -26,7 +26,7 @@
 - **`craft_default`**：让信息通过争取、回避、交换和后果出现；创作者可说明理由覆盖。
 - **`taste_option`**：口语程度、方言、停顿、沉默、直白、诗性、打断和句式长短；遵从人物与作品风格。
 
-对白比例、金句数量、句长和口癖数量不能证明质量。唯一的数值核对是创作者已接受的节奏档案里的 VO 占比上限，见[剧作手艺](script-craft.md#44-能演的不说vo内心独白与痛点)。
+对白比例、金句数量、句长和口癖数量不能证明质量。项目接受节奏档案后，按其中的 VO 占比上限核对，见[剧作手艺](script-craft.md#44-能演的不说vo内心独白与痛点)；不另设通用比例。
 
 ## 2. 先写议程，再写句子
 
@@ -64,7 +64,7 @@
 
 ### 3.1 常用策略库
 
-不是模板轮换，只在符合人物目标时选用：
+按人物目标选择策略：
 
 - 要求、命令、请求、交换；
 - 试探、诱导、套话、验证；
@@ -95,8 +95,7 @@
 
 ### 3.3 每种方法的反向条件
 
-本文给出的每种方法都有它不成立的场合。只写"该怎么做"而不写"什么时候不该"，结果是
-方法被当成质量指标全场铺开——**对白最常见的坏味道不是方法用得少，是方法用得到处都是**。
+方法有各自的适用条件。修订时若发现对白别扭，可对照下表检查是否误用了某种方法：
 
 | 方法 | 它失效的条件 | 失效后读起来是什么样 |
 |---|---|---|
@@ -111,12 +110,9 @@
 | 用动作断开长发言 | 这段发言本来就没有内部转折 | 插入的动作是填充，该做的是缩短（`SCR-09`） |
 | 让每轮承担不同工作 | 场景本来只有一件事要办 | 为了不重复而制造支线，冲淡了唯一的目标 |
 
-配重的用法不是"用之前先查表"，而是**修订时反查**：一场对白读着别扭却说不出哪里错，
-多半是某个方法用在了它的反向条件上。先找方法，再看条件是否成立。
-
 ## 4. 潜台词来自已知差与风险
 
-潜台词不是人人说谜语，而是“真正想做的事不能/不愿直接说”。先找出不能直说的原因：
+潜台词来自“真正想做的事不能或不愿直接说”。先找出不能直说的原因：
 
 - 说出会暴露秘密；
 - 说出会失去体面或关系；
@@ -195,7 +191,7 @@
 **`craft_default`**：让说明带着争取目标进入；能由动作或证据表达的部分，不再由两人完整复述。
 
 动作已经让观众看懂机制时，台词优先承担新的工作：改变关系、收窄结论、隐藏态度或迫使下一步。若一句
-话只是逐项复述观众刚看到的因果，删掉后画面仍完整，就让人物回应结果而不是给画面配答案。
+话只复述观众刚看到的因果，删掉后画面仍完整，就让人物回应结果。
 
 过去事件只说当前动作需要的最小片段。若一名角色能不受阻地一口气交代时间、关系与结果，先检查这些
 信息能否被对方打断、质疑、回避或拿来交换；让背景参与当下争取，而不是暂停剧情播放资料。需要完整
@@ -219,6 +215,8 @@
 
 ### 6.2 建立轻量声音卡
 
+需要区分人物声音时，只在上下文中记录当前写作所需的信息，不另建角色文档：
+
 ```text
 角色：
 默认策略：
@@ -301,13 +299,13 @@
 
 打断后要处理未说完内容的后果；否则只是制造表面节奏。
 
-### 8.4 长发言用动作断开，而不是连排台词 (`SCR-09`)
+### 8.4 在长发言的策略转折处加入动作 (`SCR-09`)
 
-一段发言长到需要分两口气说完时，有三种处理：连排成两条同角色台词、压成一条长台词、
-或者在中间插一条可见动作行把它断开。第三种通常最划算，因为它同时解决下游两个问题：
+长发言可以连续保留、缩短，或在内部策略转折处插入可见动作。第三种适用于发言本就有转折的场景，
+可以同时帮助分镜与表演：
 
 - **给分镜一个有依据的切点**：断开处是一次可见变化，分镜可以在这里换景别或换被摄主体，
-  而不必自己在一条长台词中间猜该切哪里——猜出来的切点没有来源，审查也无从核对。
+  切点可以回到剧本中的动作核对。
 - **给表演和配音一个换气口**：说话者在断开处做了一件事，这个停顿有对象（见 8.2），
   不是为了凑节奏的空拍。
 
@@ -323,8 +321,8 @@
 【角色甲】：这事跟我没关系。再说，（看了角色乙一眼）你要找的人今晚也不会来。
 ```
 
-括号里的动作不会进入分镜的动作序列，台词也被一个括号打断了语气。改成三行，动作成为
-真正的一拍，台词各自完整：
+独立动作藏在台词括号里，分镜难以单独引用，台词语气也被打断。改成三行，动作成为
+可追踪的一拍，台词各自完整：
 
 ```text
 【角色甲】(轻描淡写)：这事跟我没关系。
@@ -332,13 +330,12 @@
 【角色甲】：再说，你要找的人今晚也不会来。
 ```
 
-注意括注里只剩语气（`轻描淡写`）。"抬手挡回去"是可见动作，必须待在 ▲ 行里——把它塞进
-括注就又回到了上面那个反例，只是换了个位置。括注负责怎么说，动作行负责做了什么。
+改稿的括注只保留语气（`轻描淡写`），翻名册、压住某行等独立动作留在 ▲ 行，便于追踪策略与持物变化。
+能与本句同时完成的表演提示仍可放在括注中。
 
 断开点的选择服从议程转折，不服从字数：上例断在“推开话题”转向“反过来施压”的位置。
-连排本身也不是错误——
-连续两条同角色台词在人物抢话、自我修正或对方拒绝回应时都成立；下面 SCR-06 的范围同样
-覆盖单条台词长度与断开频率，不设统一字数或比例门槛。
+连续两条同角色台词在人物抢话、自我修正或对方拒绝回应时都成立。单条台词长度与断开频率
+同样属于 SCR-06 的风格范围，不设统一字数或比例门槛。
 
 **`craft_default`**：只在动作、停顿或打断改变当前策略时写出它们。
 
@@ -377,7 +374,8 @@
 
 听不是空白。听者可以验证、隐藏、拖延、记录、改变站位、让第三人看见或不给预期反应。这样对白不会变成单人独白加人名。
 
-**`reviewed_invariant`**：对白密集场景仍需可追踪的目标、反制、转向与退出状态；“台词好听”不能替代场景运动。
+**`reviewed_invariant`**：以争取或对抗组织的对白密集场景，仍需可追踪的目标、反制、转向与退出状态；
+仪式、氛围或后果消化场景则检查其必要变化，不能只以“台词好听”证明场景成立。
 
 ## 10. 对白修订流程
 

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

@@ -20,18 +20,17 @@
 2. **交付偏好**：创作者要求按行业习惯交付时的输出格式（`taste_option`）；
 3. **写作工艺**：逐案验证可迁移的节拍作用、对峙压力、系统信息与钩子工艺。
 
-**与规则分级的关系**：旧稿中的拍数、字数和格式习惯只用于识别来源格式，不是新稿
-质量公式。数字只有被创作者纳入已接受的项目方案后才能成为验收约束；“台词在下游
+旧稿中的拍数、字数和格式习惯用于识别来源格式，不作为新稿质量公式。数字只有被创作者
+纳入已接受的项目方案后才能成为验收约束；“台词在下游
 逐字保留”“规范化不改台词”属于套件硬规则，不因格式不同而放松。
 
-核心思想：**剧本要把故事意义写成可表演、可听见或可制作的内容，而不是只给文学性
-解释**。优先用行动、证据、空间压力和对白策略承载；VO/OS、屏显文字与表演括注是
+**剧本要把故事意义写成可表演、可听见或可制作的内容**。优先用行动、证据、空间压力和对白策略承载；VO/OS、屏显文字与表演括注是
 创作者选择的表达方式，不能自动装入所有心理、设定和情绪。若暂留非拍摄性背景说明，应将
 它明确标成不进入制作稿的内容，而不是与动作行混写（SCR-03）。
 
 ## 一、格式语法
 
-以下是创作者选择这种格式时的一种结构，不是所有项目的标准答案：
+创作者选择这种制作格式时，可使用以下结构：
 
 ```text
 <集标题（仅项目使用集标题时）>
@@ -45,7 +44,7 @@
 【场景 2：…】
 ```
 
-符号分工（同一项目内恒一致）：
+符号分工在同一项目内保持一致：
 
 - `△` **只用于环境陈述与空镜**：`△红烛高燃，喜堂内一片死寂。`
 - `▲` **只用于人物动作**：`▲李威一把捏住随从甲的手腕，将密奏强行抽走，随从甲手腕被拧得发红。`
@@ -62,9 +61,8 @@
 
 ### 兼容变体（读旧稿须识别，写新稿不用）
 
-规范化入口面对的旧稿远比一份变体清单杂。**不要假定存在一种行业标准形式**，也不要因为
-来稿不符合上面的规范格式就判它有问题——先识别，再对应，格式差异本身不是缺陷。按槽位
-逐项识别，比匹配整行模板可靠：
+规范化旧稿时，先逐项识别场次、地点、时段、内外、人物和台词，再对应到本套件格式。
+格式差异本身不构成缺陷，不能用一种模板判定所有来稿：
 
 | 槽位 | 常见形态 | 较少见形态 | 识别要点 |
 |---|---|---|---|
@@ -73,19 +71,19 @@
 | 时段 | 单字 `日`/`夜` | 晨、黄昏、傍晚、深夜、凌晨等细分词 | 光线词有时被当时段用 |
 | 内外 | 单字 `内`/`外` | `内景`/`外景` | 与地点连写时需切分 |
 | 人物行 | `人物：A、B、C`，顿号分隔 | `出场人物：`、`人：`、`角色：`；空格或逗号分隔；整行缺失 | 常紧跟场景头，但并非总在第二行 |
-| 动作行 | 行首三角符号，**不编号**；或无任何符号、动作直接写成段落（约每六份来稿一份） | 其他符号（`*`、`◆`/`◇`）；逐拍编号 `1▲…15▲`，是个别项目的私有习惯，不要用它做位置引用 | 有人物行或 `名：台词` 行时，剩下的段落就是动作行；找不到符号不等于这份稿子没有结构 |
+| 动作行 | 行首三角符号，**不编号**；或无任何符号、动作直接写成段落 | 其他符号（`*`、`◆`/`◇`）；逐拍编号 `1▲…15▲`，是个别项目的私有习惯，不要用它做位置引用 | 对照人物行和 `名：台词` 行识别其余段落的职责；找不到符号不等于没有动作结构 |
 | 台词行 | `角色名：台词`（无括注）与 `角色名（情绪）：台词` 都很常见 | `角色名：（情绪）台词`（括注在冒号后）；`【角色名】` 方括号形式 | 括注在冒号前后都要能吃；很大一部分台词根本没有括注，不能把缺括注当成信息缺失 |
-| 独白标记 | 角色名后紧跟 `OS`/`VO`，括号可有可无——约六成不带括号 | 小写 `os`/`vo`；带点 `V.O.`/`O.S.`；`（画外音）`、`（内心）`；句尾标记；与情绪词逗号并列写在同一括注里 | 先把名字末尾的 OS/VO 剥掉再比对本场人物——不分大小写、不论有无括号；剥掉后能对上的（`邬砚青os` → 邬砚青）是同一角色的画外通道，不是新角色 |
+| 独白标记 | 角色名后紧跟 `OS`/`VO`，括号可有可无 | 小写 `os`/`vo`；带点 `V.O.`/`O.S.`；`（画外音）`、`（内心）`；句尾标记；与情绪词逗号并列写在同一括注里 | 先把名字末尾的 OS/VO 剥掉再比对本场人物，不分大小写、不论有无括号；剥掉后能对上的（`邬砚青os` → 邬砚青）归入同一角色的画外通道 |
 
-场次编号、时段、内外这三槽各有约六分之一的来稿整槽缺失；缺哪一槽就空着哪一槽，
-不要按上下文补——补出来的时段会直接变成整场的布光依据。
+旧稿可能缺少场次编号、时段或内外字段。识别时将缺失项留空，交创作者确认，不按上下文猜补；
+补出的时段会直接影响整场布光。确认后再补齐规范制作稿所需字段。
 
-三角符号的具体分工（△ 环境、▲ 人物）是**本套件写新稿的约定**，不是旧稿的普遍规律：
+三角符号的具体分工（△ 环境、▲ 人物）是**创作者选用本制作方言时的约定**，不是旧稿的普遍规律：
 旧稿常常整篇只用一种符号承担全部动作行。识别时按内容判断这一行写的是环境还是人物，
 不要按符号反推。
 
 情绪括注不要按封闭词表校验。旧稿里的括注既有一两个字的情绪词，也有整句的微表情与调度
-描写，两者都是有效输入；把它当自由文本读，只在它无法对应任何可演内容时才提修订。
+描写，两者都是有效输入。按自由文本阅读，只在括注无法对应可演内容时提修订。
 
 ### 集标题（仅项目需要时）
 
@@ -108,7 +106,7 @@
 使用 OS）；多个独立行动按可读性与制作需要拆拍，不按固定动作数；
 形容词若不能写成可表演或可制作的内容，应补证据或删除。
 
-**单词行当拍用**是悬疑/惊悚段落的停顿控制手法：
+**单独成行的短句**可以控制悬疑/惊悚段落的停顿：
 
 ```text
 △ 嗒。手电筒打开。
@@ -121,8 +119,7 @@
 插入无后果动作，也不要为缩短文本删除必要的表演处理。
 
 表演括注不只写情绪，也可以写动作（冷笑、点头、低声、打断、挑眉、一字一顿、摆手）、
-微动作（`(上前握住她的手)`）或语音
-方式（`(声音洪亮，带着回音)`、`(方言)`）。括注只保留能与本句同时完成的表演提示；
+微动作（`(上前握住她的手)`）或语音方式（`(声音洪亮，带着回音)`、`(方言)`）。括注只保留能与本句同时完成的表演提示；
 若包含独立动作、道具接触或新的状态结果，拆为独立 ▲ 拍，而不是按字数机械截断。
 台词中段可插动作括号：`回国？……（抬眼看向身旁）这三百年……`（SCR-08）。
 
@@ -200,11 +197,11 @@
 1. 每个动作行删掉后是否丢失一个**可拍摄画面**？（丢形容词→删对了；丢画面→写对了）
 2. 非拍摄性解释是否与制作稿分开？需要进入本集的信息是否选择了最合适的行动、证据、
    对白、声音或文字呈现方式，而不是自动塞进 OS、VO 或字幕？
-3. 开场是否已经有压力、行动或本剧承诺的具体画面？集尾是否先有局部结果，再产生新的压力？
+3. 开场是否已有压力、行动或本剧承诺的具体画面？集尾是否完成本集约定的结果、情绪落点或开放状态，连载需要时能否接住下一集？
 4. 每轮升级是否改变筹码、策略、距离、信息或关系？承担后果的人有可见接收吗？
 5. 台词、动作与反应是否都承担职责，并能在目标时长和语速内执行？
 6. 抽象情绪是否已落为可表演行为、语音或选择，而不是只堆形容词？
-7. 编号拍是否连号无重号？格式全集恒一致？
+7. 项目使用编号拍时，是否连号且无重号？全集格式是否一致？
 8. 系统信息的声音、字幕与面板是否服从已接受的文字与声音方案，且没有无来源重复？
 
 ## 八、范例
@@ -254,11 +251,12 @@
 【萧尘渊】(目光坚定)：放心，我此生定不负她。
 ```
 
-（变换：人物动作 △→▲；台词加【】归属；补微表演括注；台词逐字保留。）
+本例将人物动作 △ 改为 ▲，台词加【】归属，并补表演括注；台词逐字保留。
+新增括注也可能改变人物态度，实际规范化时须与结构调整分开展示，由创作者确认。
 
 ## 九、反模式（定性案例中暴露的失效机制）
 
-1. 小说原文直贴当剧本（含"他笑得合不拢嘴"类不可拍心理叙述）。
+1. 小说原文直贴当剧本，未区分可表演的反应与纯心理说明；“他笑得合不拢嘴”可表演，不能仅因它来自小说就判成不可拍。
 2. 换行破碎/全角空格污染（PDF 粘贴事故，"灰 雾 降 临"）。
 3. 场景头、人物行、动作行挤成一个巨型段落。
 4. 同质拍只替换人物或道具名，没有改变筹码、策略、信息、空间或关系状态。