@oh-story/dsh 0.1.14 → 0.1.16

package/lib/drama/skills/short-drama-develop/references/genre-cards//347/224/237/346/264/273/346/265/201.md

@@ -40,7 +40,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 制作难点
 
-场景与资产成本最低，但对生活质感的要求最高：可复用的小物件、准确的消费水平和说话习惯，比场景数量更重要。承接余韵的手段随制作形态而定，见对应形态卡；不要把密集大特写、眼部推进和群体震惊当成通用提速办法。人物造型变化少，反而要靠物件状态（旧了、修过、换了一把）承担时间流逝。
+本题材可通过场景与资产复用控制成本，生活质感主要来自细节：可复用的小物件、准确的消费水平和说话习惯，比场景数量更重要。承接余韵的手段依据项目传入的制作形态选择，所需输入见[阶段契约](../stage-contract.md#制作形态需要什么)；不要把密集大特写、眼部推进和群体震惊当成通用提速办法。人物造型变化少，反而要靠物件状态（旧了、修过、换了一把）承担时间流逝。
 
 ## 禁止漂移
 

package/lib/drama/skills/short-drama-develop/references/genre-cards//347/240/264/351/225/234/351/207/215/345/234/206.md

@@ -47,9 +47,8 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 信息权限要按人分层写：谁掌握完整真相、谁只掌握一半、谁掌握真相但有理由不说、谁在
 主动散布错误版本。让第三个人握着关键事实，是这个题材最常用也最有效的延迟手段。
 
-本卡只管这一层——哪一支、谁误会谁、信息怎样分层。单场误会怎样写才成立（不解释的理由、
-观众站在哪一边、必须产生行动、解除时留下什么）属于剧本层的通用工艺，由写作技能拥有，
-本卡不复述。
+本卡负责确定误会分支、双方认知与信息分层。单场误会中的解释动机、观众立场、行动后果与
+解除后的变化，由 `$short-drama-write` 在剧本层处理。
 
 ## 观众回报与情绪落点
 
@@ -88,8 +87,8 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 ## 制作难点
 
 回忆与闪回是这个题材的成本大头：旧场景、旧造型、旧道具、更年轻的妆发，都会成套增加
-资产量。开发阶段就要定死**允许几个"当年"的时空**，并优先让当下的一件物件承担回忆的
-职责。跨时间线的同一角色需要清晰可辨的造型台阶，台阶数同样要提前定死。信物类道具会
+资产量。开发阶段就要规划**需要哪些“当年”的时空**，并优先让当下的一件物件承担回忆的
+职责。跨时间线的同一角色需要清晰可辨的造型台阶，变化层级与所需资产数量同样要提前规划。信物类道具会
 跨集反复出现并改变状态（完整、断裂、修复、转手），版本必须能在画面上区分。孩子、
 病床、婚礼、机场车站这类场面各自带着排期与群演成本，不要堆在相邻几集里。
 

package/lib/drama/skills/short-drama-develop/references/genre-cards//350/261/252/351/227/250/345/251/232/346/201/213.md

@@ -22,7 +22,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 观众回报与情绪落点
 
-回报是**不对等被具体撬动一格**：一条条款被改、一次公开承认、一次拒绝没有付出预料中的代价、一个人第一次自己签下名字。甜的落点要有前置的具体代价才成立——他为此推掉了什么、她为此放弃了什么。也可以给不圆满的落点：条件谈成了，但两个人都知道回不去了。
+回报是**权力不对等发生可见变化**：一条条款被改、一次公开承认、一次拒绝没有付出预料中的代价、一个人第一次自己签下名字。甜的落点要有前置的具体代价才成立——他为此推掉了什么、她为此放弃了什么。也可以给不圆满的落点：条件谈成了，但两个人都知道回不去了。
 
 ## 常见场面颗粒
 

package/lib/drama/skills/short-drama-develop/references/genre-cards//350/272/253/344/273/275/351/224/231/344/275/215.md

@@ -40,7 +40,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 制作难点
 
-多主体同场需要清楚的位置与观察关系，调度成本高于对白成本。若身份绑定不同外形，资产与连续性成本会翻倍——开发阶段就要决定是用"同一形象 + 行为差异"承载，还是真的做两套形象。不要每集新增身份态。身份占用状态必须逐场记录，否则后续环节无法判断此刻画面上的人是谁。
+多主体同场需要清楚的位置与观察关系，调度成本高于对白成本。若身份绑定不同外形，资产与连续性工作量会增加——开发阶段就要决定是用"同一形象 + 行为差异"承载，还是真的做两套形象。避免逐集新增身份状态。身份占用状态必须逐场记录，否则后续环节无法判断此刻画面上的人是谁。
 
 ## 禁止漂移
 

package/lib/drama/skills/short-drama-develop/references/genre-cards//351/200/206/350/242/255.md

@@ -40,7 +40,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 制作难点
 
-公开见证的场合成本最高，可以用群聊、评论区、榜单这类低成本见证者替代一部分群演；屏幕上的文字按后期叠加处理。群体反应按职责分区，避免全员同一个表情。
+公开见证的场合往往涉及群演、空间与统一造型成本，可以用群聊、评论区、榜单这类低成本见证者替代一部分群演；屏幕上的文字按后期叠加处理。群体反应按职责分区，避免全员同一个表情。
 
 ## 禁止漂移
 

package/lib/drama/skills/short-drama-develop/references/genre-cards//351/207/215/347/224/237/347/251/277/350/266/212.md

@@ -18,7 +18,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 人物策略与信息权限
 
-主角知道「会发生什么」，对手不知道主角知道。主角的常用打法是抢在对手前面一步，或者原样奉还——用对手刚用过的手段、刚说过的借口回敬。内心独白能换成动作加一句台词的就换，大段「我重生了」的独白压缩成两句。
+主角知道「会发生什么」，对手不知道主角知道。主角的常用打法是抢在对手前面一步，或者原样奉还——用对手刚用过的手段、刚说过的借口回敬。内心独白能换成动作加一句台词的就换，大段「我重生了」的独白尽量压短，两句可作起草参照，最终篇幅由本集必须交代的信息决定。
 
 ## 观众回报与情绪落点
 
@@ -40,7 +40,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 制作难点
 
-前世与今生是两套造型、场景和状态，资产量会翻倍：前世段尽量压短，能用今生的一件物件承担的就不新建场景。闪回每次控制在三行剧本以内，放在需要解释眼前危机的位置。年份字幕卡和人物名牌交给后期。
+前世与今生若使用两套造型、场景和状态，会增加资产量：前世段尽量压短，能用今生的一件物件承担的就不新建场景。闪回可先以三行以内剧本作轻量方案，再按解释眼前危机所需的信息调整；位置也由当前危机决定。年份字幕卡和人物名牌交给后期。
 
 ## 禁止漂移
 

package/lib/drama/skills/short-drama-develop/references/genre-cards.md

@@ -1,6 +1,6 @@
 # 题材卡索引
 
-这里只做**索引与召回规范**。每个题材的可执行内容拆在同目录的 `genre-cards/` 下，一次只读一张。
+题材卡的选择与召回按本索引执行。各题材的具体做法放在同目录的 `genre-cards/` 下，一次只读一张。
 
 题材卡回答"这个题材更常用哪些压力、场面和情绪落点"，不回答"这一集应该怎么写"。
 后者由创作者已接受的事实、单集契约和 [episode-design.md](episode-design.md) 决定。
@@ -18,7 +18,7 @@
 1. 先确认主题材、目标形态（实拍/漫剧）、创作者已声明的尺度与结局承诺，再来查表。
 2. 查到匹配项后**只读那一张卡**，不要把整套题材卡加载进上下文。
 3. 跨题材时：主题材读 1 张完整卡，辅题材只摘 1-2 条"常见场面颗粒"或"禁止漂移"。
-   不要把两套打法并行铺满，先说清主要矛盾是什么、观众先看到哪个结果。
+   先说清主要矛盾是什么、观众先看到哪个结果，再决定采用哪些做法。
 4. 传给下游的题材注入只保留与当前集相关的条目，短到能被完整读进上下文即可；写不满不必凑，写不下先删与本集无关的条目。可用条目：
    压力来源、人物策略与信息权限、本集要落的回报、可用的场面颗粒、钩子取向、禁止漂移、卡片置信度。
 5. **题材卡只在内部校准题材味，绝不出现在交付物里**。剧本、分集地图、创作简报中不得出现
@@ -63,8 +63,8 @@
 | 破镜重圆 | 破镜重圆 / 追妻 / 复合 / 久别重逢 / 前任 / 失忆重逢 / 重逢不相识 / 意难平 | [破镜重圆](genre-cards/破镜重圆.md) | 中 |
 | 动作任务 | 动作 / 任务 / 冒险 / 追逃 / 营救 / 押运 / 生存突围 | [动作任务](genre-cards/动作任务.md) | 中 |
 
-置信度指"该卡的压力机制在本套件内被交叉印证的程度"，不是市场表现、不是热度排名，
-也不是任何测量结果。每张卡的"证据与置信度"一节写明了它实际的来源。
+置信度表示该卡的压力机制在本套件内被交叉印证的程度，不代表市场表现、热度排名或测量结果。
+具体来源见各卡的“证据与置信度”。
 
 ## 跨题材与未覆盖题材
 

package/lib/drama/skills/short-drama-develop/references/mechanism-loop.md

@@ -32,8 +32,7 @@
 
 [story-craft.md](story-craft.md) 回答压力怎样反复生成，[episode-design.md](episode-design.md)
 回答一集怎样完成一次状态变换。中间还有一层常被跳过：**一个单元故事通常是同一套机制
-被反复运行**，观众的乐趣一半来自机制本身，一半来自"我已经知道它会怎么运作，我在等它
-再运作一次"。
+被反复运行**，观众既享受机制本身，也享受认出机制、期待它再次运作的过程。
 
 跳过这一层的典型后果是：每集都在发生事，事与事之间却没有共同的期待物。观众看完一集
 知道发生了什么，却说不出下一集自己在等什么。
@@ -49,7 +48,7 @@
 同样的动作会自动携带期待。把第一次运行压缩成和后面一样快，是这一层最常见的浪费。
 
 循环通常是**套着的**，不是排成一列：几次小循环共同构成一个更大循环的一次运行，几个
-大循环构成整部戏。下文为了说清楚只写单层，但每一条同样适用于外层——**外层的赌注要
+大循环构成整部戏。各层都需要明确机制与回报，**外层的赌注要
 更早建立**，因为观众正在跟的是小循环，而让他们留到几十集之后的是大循环。嵌套几层、
 每层多长由创作者与项目决定，本文件不给层数与集数配方。
 
@@ -116,7 +115,7 @@
 
 任何循环都会耗尽。耗尽不是写坏了，是这一层的正常寿命；写坏的是**没有察觉耗尽**。
 
-症状（出现两项以上即应处置）：
+可结合以下症状判断是否需要处置，不以命中数量设门槛：
 
 - 观众能提前说出运行结果和对手反应，猜中之后不再有期待；
 - 兑现的规模在变大（更大的场面、更高的筹码、更公开的场合），状态变化却在变小；
@@ -133,7 +132,7 @@
 **去处**。只有推进方式的循环，唯一的续命办法是不断换上更强的对手重跑同一套流程——集数
 可以很多，内容却很薄，观众第一轮就看到了头。
 
-补法不是加强机制，是给它一个能被用完的去处：主角最终要让**哪件具体的事被改变**。
+此时需要明确循环的终点：主角最终要让**哪件具体的事被改变**。
 一旦这个去处成立，每次运行就都在朝它推进，循环自带终点，也自带"还差多少"的可感刻度。
 
 去处不必宏大，但必须**具体到可以被核对**："让当年那份名单被公开更正"比"变成最强的人"
@@ -156,8 +155,8 @@
 
 ### 6.2 换代真正丢掉的是紧迫性
 
-新循环往往更新奇却更弱。原因不是它写得不好，而是它**从零开始**：旧循环攒下的三样
-东西没有交接过来。
+新循环即使更新奇，也可能因缺少紧迫性而变弱。常见原因是旧循环积累的三样东西没有
+交接过来：
 
 1. **可感的时限或到期的代价**——旧循环里"再不做会怎样"是具体的，新循环里常常只剩
    "情况不太好"；

package/lib/drama/skills/short-drama-develop/references/multi-episode-intake.md

@@ -1,8 +1,8 @@
 # 多集整稿接入与断点续跑
 
 当创作者给的是一份已经写好的多集剧本、散稿或合订稿，并希望生成或补齐
-`项目开发/episode-map.jsonl` 时使用本流程。它不是小说改编分析，也不是把整份文件塞进一次
-提示词：**Agent 判断这份文件实际怎样分集、每集讲了什么；脚本只保存精确定位并防止重复劳动**。
+`项目开发/episode-map.jsonl` 时使用本流程。**Agent 判断这份文件实际怎样分集、每集讲了什么；
+脚本保存精确定位并防止重复劳动**。小说改编走改编分析，整稿接入则按当前分集逐段读取。
 
 ## 不变边界
 
@@ -32,15 +32,12 @@ python3 <本技能目录>/scripts/episode_intake.py index \
 `unmapped_spans` 用 locator 标出**落在任何一集跨度之外**的材料——实际上就是第一个集标题
 之前的前言与目录。它标不出集间说明与尾注：分集跨度从一个集标题一直延伸到下一个集标题
 （最后一集延伸到文件末尾），两集之间不存在空隙，所以一段插在中间的制作方说明会被并进
-前一集，尾注会被并进最后一集，`problems` 仍是空的。**这不是可以靠正则补上的**：
-「这一段属于上一集还是不属于任何一集」是语义判断，扩大正则去猜作品语义正是下一段
-禁止的做法。
+前一集，尾注会被并进最后一集，`problems` 仍是空的。判断这些段落属于剧本还是说明，
+需要 Agent 阅读上下文。
 
-所以「材料不会静默丢失」这条要靠下面的边界检查来保证，而不是靠 `unmapped_spans` 报全：
-Agent 必须对每个 `unmapped_spans` 做小范围检查，**并且**按下一段的做法读每一集的首尾几行，
-确认边界落在正确的位置。
-此时根据候选中的 line span，只读取疑似边界附近的小段，判断**这份文件**使用的是
-幕标题、分隔线、混合标题、目录加正文还是别的规律。不要扩大自动正则去猜作品语义。
+Agent 必须小范围检查每个 `unmapped_spans`，并根据候选中的 line span 读取每集首尾与
+疑似边界附近的几行，确认材料没有遗漏、说明没有混入正文。由此判断**这份文件**使用的是
+幕标题、分隔线、混合标题、目录加正文还是其他规律，不扩大自动正则去猜作品语义。
 
 非标准结构由 Agent 写一个很短的 JSONL 边界文件，每行只给规范 `episode_id` 与 1-based
 `line_start`，必要时给 `line_end`；然后让工具推导精确 byte span：
@@ -60,7 +57,9 @@ python3 <本技能目录>/scripts/episode_intake.py manual-index \
 `manual-index` 仍会机械阻断重号、跳号、倒序、空跨度和非规范 ID，但不会判断一幕是否应该
 属于上一集还是下一集；这个选择仍由 Agent 结合文件内容完成。
 
-自动或手工候选通过检查后，把它发布到正式 owner 路径；不要让 intake 工具直接覆盖规范索引：
+自动或手工候选通过检查后，保存到正式 owner 路径，intake 工具始终先写候选。core 项目
+工具可用时，按下面的 `verify` → `publish` 顺序发布；独立运行时，执行 `verify` 后由
+Agent 核对并保存为 `项目开发/episode-intake-index.json`，不执行 core 的 `publish`：
 
 ```text
 python3 <本技能目录>/scripts/episode_intake.py verify \
@@ -72,11 +71,13 @@ python3 <core 技能目录>/scripts/project_tool.py publish <项目根> \
   --input 输入/<完整剧本>
 ```
 
-发布成功且下游命令已改读正式索引后再删除工作区候选。可重建索引仍通过 owner 的 `publish` 发布，以保持路径所有权和原子替换。
+确认正式索引已保存、下游命令已改读正式路径后，再删除工作区候选。集成项目的可重建索引
+同样通过 owner 的 `publish` 发布，以保持路径所有权和原子替换。
 
 ## 2. 每次只读当前集
 
-任何切片前都验证索引；原文件变化一个字节就重建，不沿用旧 locator：
+任何切片前都验证索引。`verify` 核对总长度、跨度、顺序与行/字节对应，不能发现保持这些
+结构的等长原地改写；编辑过原文件就重建索引，即使校验通过也不沿用旧 locator：
 
 ```text
 python3 <本技能目录>/scripts/episode_intake.py verify \
@@ -108,8 +109,8 @@ python3 <本技能目录>/scripts/episode_intake.py merge \
 ```
 
 它拒绝未知 ID、批内重号、超过本轮显式上限的记录和对已完成集的冲突重写；相同记录重放是
-no-op。合并成功后，通过 core 的公开生命周期把 `episode-map.next.jsonl` 作为同一 artifact
-的新候选发布，并声明它实际读取的完整剧本与索引：
+no-op。合并成功后，core 项目工具可用时，通过其公开生命周期把 `episode-map.next.jsonl`
+作为同一 artifact 的新候选发布，并声明实际读取的完整剧本与索引：
 
 ```text
 python3 <core 技能目录>/scripts/project_tool.py publish <项目根> \
@@ -119,8 +120,9 @@ python3 <core 技能目录>/scripts/project_tool.py publish <项目根> \
   --input 项目开发/episode-intake-index.json
 ```
 
-发布完成后再删除临时候选和单集切片。不要让 `merge` 直接覆盖
-`项目开发/episode-map.jsonl`，也不要绕过 `project_tool.py` 手工替换它。
+独立运行时，由 Agent 核对合并候选与当前地图的差异，再保存为 `项目开发/episode-map.jsonl`。
+确认正式文件已保存后再删除临时候选和单集切片。`merge` 始终写独立候选；集成项目不得绕过
+`project_tool.py` 手工替换正式地图。
 
 中断后先重新运行 `progress`；项目工具可用时也读取 `status`。磁盘上的当前
 `episode-map.jsonl` 是唯一完成真相；checkpoint 若需要只是由它重建的缓存，不能用

package/lib/drama/skills/short-drama-develop/references/premise-devices.md

@@ -32,7 +32,7 @@
 
 ## 共同的失效机制
 
-两类装置坏掉的方式是同一个形状，先认这个形状，再看各自的处理：
+两类装置都有以下失效方式：
 
 1. **阻力被抽空**：主角每次都提前知道或直接获得答案，段落退化成"执行已知正确操作"的
    流程演示。观众能看出结果不再由选择决定。
@@ -49,7 +49,7 @@
 
 ### 两层必须分开：创作者契约与剧中披露
 
-这是本文最容易写坏的地方。装置有两个不同的东西，混成一层会同时误伤两种正当设计：
+装置需要分别记录创作者接受的契约和剧中披露状态：
 
 - **装置契约（创作者层）**：能力范围、失效条件、代价、以及规则是否可靠。它属于创作者
   已接受的事实，**从一开始就可以是完整的**，写在故事引擎里供后续对账。它不需要、通常也
@@ -68,7 +68,7 @@
 追溯不到即为事后扩权，按缺陷处理。观众在某一刻不知道全部边界，本身从不构成缺陷。
 
 闸门是**条款级**而不是装置级：装置在第一集生效之后，仍然可以新增条款，只要走
-「先改契约表并让创作者接受 → 再在剧中披露」这个顺序。但要防住一种形式合规的滥用——
+「先改契约表并让创作者接受 → 再让条款在剧中生效或披露」这个顺序。但要防住一种形式合规的滥用——
 写不下去时补一条新条款、让它被接受、再写出来。程序上无懈可击，实质上就是上面第 4 条
 失效机制的规则通胀。可追溯性检验不到这一点，所以判断依据是**新增条款是不是由困境驱动**：
 新条款如果只在主角脱不了困的那一集出现、且不产生新的代价或新的限制，就按规则通胀处理，
@@ -127,7 +127,7 @@
 
 ### 宣告是一次披露，不是新增契约
 
-这里要用上前面那两层。装置在剧里宣告一条规则时，发生的是**披露**：契约里已有的一条
+装置在剧里宣告一条规则时，发生的是**披露**：契约里已有的一条
 被说给人物和观众听。宣告不创造契约条款——**先有契约，才能宣告**。所以宣告前要回答的
 不是"这条规则听起来好不好"，而是"契约里有没有这条，它在后面每一次相关处境是否都成立"。
 
@@ -184,7 +184,7 @@
 
 ## 与既有机制的接口
 
-装置不新建一套体系，它只是几条既有机制的特例：
+装置的契约、知情状态与后果分别由既有机制承接：
 
 | 装置带来的问题 | 交给既有机制 |
 |---|---|

package/lib/drama/skills/short-drama-develop/references/reveal-reversal-payoff.md

@@ -1,7 +1,7 @@
 # 冲突、揭示、反转与回报的条件方法
 
-这是一组按项目条件选择的工具，不是题材公式。先问作品承诺什么体验，再选择能让人物付出代价、
-让观众获得回报的机制。
+先明确作品承诺的体验，再按项目条件选择压力、揭示、反转与回报机制，让人物作出有后果的选择，
+让观众获得承诺中的回报。
 
 ## 1. 从承诺选择压力来源
 
@@ -24,8 +24,9 @@
 - **情绪回报**：承诺的恐惧、甜、爽、痛、温暖真正落到可感知结果。
 - **情节钩子**：新决定、危险、问题让状态继续运动。
 
-一次动作可以兼任，但不要混称。只展示秘密却没人改变选择，是 reveal，不一定是 turn；
-只在最后藏住一句话，是 withholding，不一定是 hook。
+同一次动作可以兼任多项功能，但判断时要分开：只展示秘密却无人改变选择，完成的是信息揭示
+（reveal），未必构成方向性反转（turn）；结尾只隐去一句话，属于信息扣留（withholding），
+未必形成让观众继续看的钩子（hook）。
 
 ## 3. 公平揭示
 
@@ -37,7 +38,7 @@
 4. 新事实排除了什么旧解释？
 5. 得知后谁必须改变行动？
 
-有效揭示常由“旧事实的新关系”产生，而不是突然加入更大的秘密。
+有效揭示常通过重新连接旧事实，让观众和人物获得新的解释。
 
 合成例：维修员早先发现签字页缺失，只知道有人藏页。她在主管桌上看到订书孔方向相反，
 才意识到被拿走的不是最后一页，而是中间一页；这让“补签”计划失效，必须先保护被点名的

package/lib/drama/skills/short-drama-develop/references/serial-character-and-memory.md

@@ -97,8 +97,7 @@ B 的反制策略与筹码：
 
 ## 4. 把人物变化写成可追踪的压力测试
 
-人物弧线不是每集增加一个“成长点”，也不是性格标签从负面换成正面。记录每次真正
-触碰旧策略的事件：
+人物弧线通过触碰旧策略的具体事件推进，记录每次压力测试：
 
 ```text
 进入策略 → 压力测试 → 仍按旧信念行动 / 尝试新行动 / 退回旧行动
@@ -159,7 +158,7 @@ B 的反制策略与筹码：
 
 ## 6. 管理信息权限与铺垫债务
 
-“故事真相”“角色相信”“观众知道”是三套状态。维护最小信息权限表：
+“世界事实”“角色认知”“观众知情”是三套状态，分别记录在最小信息权限表中：
 
 | fact_id | 世界事实 | 角色 A | 角色 B | 观众 | 当前可见证据 | 下一次改变权限的动作 |
 |---|---|---|---|---|---|---|
@@ -233,7 +232,7 @@ B 的反制策略与筹码：
 - 已完成且不再影响后续的事件压成一句或移出活跃记忆；
 - 伏笔、信息权限和未支付代价不能因摘要压缩而丢失；
 - 新一集开写前先读活跃记忆，再读最近一集正文核对证据；
-- 摘要与已接受正文冲突时，正文事实胜出，并修订摘要 owner。
+- 摘要与已接受正文冲突时，以正文事实为准，由摘要负责人修订。
 
 ## 9. 合成示例
 

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

@@ -7,12 +7,11 @@
 - [制作形态需要什么](#制作形态需要什么)
 - [本阶段规则](#本阶段规则)
 
-本文件是本技能的自包含契约：预检、所有权、形态输入与规则表都在这里，
-不需要读取其他技能的文件。
+本契约包含预检、所有权、制作形态输入与规则表，独立使用本技能时即可据此执行。
 
 ## 独立运行与项目集成
 
-本技能可以单独安装并运行；下面几条说明项目工具存在时怎样集成。
+本技能可以单独安装并运行；项目工具可用时，按以下方式集成。
 
 1. **读取直接输入**：只读取用户明确提供或当前任务实际需要的文件，不批量加载整个项目。
 2. **可选项目集成**：若存在 `short-drama.json` 且 core 项目工具可用，可以运行
@@ -32,16 +31,15 @@
 
 ## 制作形态需要什么
 
-视觉风格不是贴在提示词前面的标签。创作者已接受的视觉方向与制作形态由项目层决定并传入，
-**本技能不加载形态卡，也不自行选择形态**；本节只说明本阶段需要形态回答什么、以及拿到
-答案后投影成哪些字段。
+创作者已接受的视觉方向与制作形态由项目层决定并传入。**本技能不加载形态卡，也不自行选择
+形态**，而是据此明确叙事职责、运动预算、未决试验和节奏起点。
 
 形态决定属于 `craft_default`：创作者说明理由即可覆盖。形态不能创造新的
 `structural_invariant`，也不能改写身份、地理、持物归属与可读文字政策。审查者不得单凭
 形态偏好阻断交付。
 
-不要用“加一句风格前缀”处理形态差异。前缀只改变检索标签；形态改变的是**必须出现和
-可以省略的字段**，只有后者会被执行，也只有后者能被审查。
+形态差异要落实到**必须出现和可以省略的字段**，让后续环节能够执行和审查；只加风格
+前缀无法交代这些职责。
 
 本阶段要向形态决定问四件事，答案写进创作简报，不写进剧本：
 
@@ -51,7 +49,7 @@
 - **未决试验**：哪些形态能力还没验证过，需要先做小样。
 - **节奏起点**：这种形态的项目节奏档案从哪组默认值起步（`STY-26`）。
 
-本阶段新增：叙事职责、形态假设、运动预算、未决试验与节奏档案候选。不产出形、材质、光或镜头层字段。
+本阶段记录叙事职责、形态假设、运动预算、未决试验与节奏档案候选；造型、材质、光线和镜头字段由后续环节负责。
 
 ## 本阶段规则
 

package/lib/drama/skills/short-drama-develop/references/story-craft.md

@@ -100,7 +100,7 @@
 
 ## 3. 设计能持续运转的冲突引擎
 
-故事引擎不是“大反派不断使坏”，而是一个会对人物选择作出反应的压力回路。
+故事引擎是一个会对人物选择作出反应的压力回路。
 
 ### 3.1 写出一轮回路
 
@@ -165,10 +165,9 @@
 
 ### 4.0 观众为什么站在他这边
 
-上面八项回答的是"他会怎么选"，全部服务因果预测。它们答不出另一个问题：**观众第一次
-看见这个人时，凭什么替他着急**。一个只有压力、策略与代价的人物是**可分析的**，不是
-**可跟随的**——这是"结构正确但没人看"最常见的产地：第一集看完，观众知道发生了什么，
-却不知道该替谁紧张。
+行动模型回答“他会怎么选”，还需要补足观众跟随人物的理由：**第一次看见这个人时，
+观众凭什么替他着急**？如果第一集只交代压力、策略与代价，观众可能看懂了事件，却仍找不到
+可以投入情绪的人。
 
 为焦点人物再答四问，答案要能落到第一集的可见画面上，不是形容词：
 
@@ -184,11 +183,10 @@
 四问不必全答，但**至少要答出一条，并且它要在第一集就能被看见**。答不出来时，人物仍
 可以是精确的，只是没人会跟着他走完六十集。
 
-反面提醒：这四问不是"把人物写讨喜"。让人物一直正确、一直被善待、或者一上来就赢，
-反而会同时取消不公与欲望，观众没有可替他争取的东西。可跟随来自**他想要而尚未得到**，
-不来自他可爱。
+这些问题帮助建立可跟随的人物。人物若一直正确、一直被善待，或一开始就已得到想要的东西，
+容易失去可供观众投入的缺口；让观众看见**他想要而尚未得到什么**，比单纯写得可爱更有牵引。
 
-### 4.1 关系不是标签，而是双向压力
+### 4.1 关系中的双向压力
 
 不要只写“母女”“上司下属”“旧恋人”。写成两个方向：
 
@@ -264,7 +262,7 @@ B 需要 A 提供什么 / 害怕 A 拿走什么 / 用什么反制 A
 
 ## 7. 让主题进入选择
 
-主题不是角色替作者宣读的结论。把主题写成无法同时满足的价值：
+把主题写成难以同时满足的价值，让人物通过选择作答：
 
 - 诚实与保护是否能兼得？
 - 被看见与保持自主是否冲突？

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

@@ -22,7 +22,7 @@ license: MIT
 
 进入条件是**素材已经存在且可读**：`剧集/<EP>/制作成果/` 里有本次要用的视频文件；
 静态漫剧是已接受的关键帧和配音文件。
-提示词写完、job 确认过、adapter 返回成功，都不等于素材可用；本阶段只认当前能打开的文件字节。
+先确认本次素材文件可打开，不能仅凭提示词、生产确认或 adapter 成功回执开始剪辑。
 
 素材不全时可以先剪已有连续段落；用户要求完整成片时，将这一版标为片段并列出缺口。
 在「未采用镜头」说明缺文件、质量不可用或叙事取舍。
@@ -41,8 +41,8 @@ license: MIT
 1. **逐段看完整素材，先标可用带，再谈剪辑。** 每个文件从头到尾看一遍，写下它实际能用的时间
    区间，以及区间之外发生了什么（起势静止、结尾漂移、发白、动作回弹、多余的重复表演）。
    这一步的产出是事实，不是决定。做法见 [生成素材的可用带](references/generated-footage.md)。
-2. **有台词的镜先定位发声区间。** 保留完整字音和所需停顿。内置工具同步切画面与声音；
-   需要在连续对白上换画面时，使用外部剪辑工具分开处理。
+2. **有台词的镜先定位发声区间。** 保留完整字音和所需停顿。视频自带声音随画面同步裁切；
+   独立配音文件可用 `配音` 行跨切点播放，分离或替换原视频音轨则先用外部工具处理。
 3. **在可用区间内选叙事入出点。** 按动作、反应或停顿的需要选择入点，出点取信息完成之后、缺陷
    开始之前。逐段写清入点理由和出点理由。做法见 [入出点与镜序](references/cut-craft.md)。
 4. **排镜序并检查相邻关系。** 检查动作、空间、揭示与声音是否连贯；重复信息没有新增作用时再删。
@@ -53,8 +53,7 @@ license: MIT
 7. **写字幕、画面文字与音效。** 字幕的每一个字都取自 `剧本.md` 的台词原文，不取自转写结果；
    标点照抄剧本，字不能改。转写只用来定位时间。画面留白给后期的 `[画面文字]` 写成 `画面文字` 行，
    需要落在画面文字出现时的提示音写成 `音效` 行。
-8. **写出 `剪辑单.md`，再渲染。** 先有文档后有成片：文档是可审查、可修订、可复现的那一份，
-   成片是它的产物。
+8. **写出 `剪辑单.md`，再渲染。** 取舍、时间与后期处理先落进文档，成片按这份记录生成。
 9. **按可测项验收成片，再交付。** 见 [交付与验收](references/delivery-verify.md)。
 
 ## 剪辑单要求
@@ -70,8 +69,7 @@ license: MIT
     有静帧时交付规格必须写 `画幅与帧率`。
   - `- 入点：<秒>` / `- 出点：<秒>` / `- 时长：<秒>`——三者必须自洽，`出点 - 入点 == 时长`。
     全部用秒，保留两位小数，不写时间码，不写帧号。
-  - `- 取舍：入点=<理由>；出点=<理由>`——理由写画面上发生了什么，不写「节奏需要」。
-    理由应能对应实际素材与本镜叙事需要。
+  - `- 取舍：入点=<理由>；出点=<理由>`——说明画面上的具体变化及其叙事作用，不只写「节奏需要」。
   - `- 声音：<本段声音怎么处理>`——记录保留原声或外部处理。此行不驱动内置 render 的混音。
   - `- 画面：<接镜校正>`、`- 画面：无` 或 `- 画面：不校`——校正是「亮度 <数>」「饱和 <数>」「色温 <数>」
     三项的任意组合，用 `；` 分隔，写了就替代这一段的自动接镜；`无` 表示不另写校正；`不校` 表示连自动接镜
@@ -114,8 +112,8 @@ license: MIT
   有静帧段时也可写 `SHOT-...`；哪些镜头要有下落见 [静帧段](references/still-cuts.md#每一镜的下落)。
 - 同一个 `MOTION-...` 可以拆成多个 `CUT-...`（同一段素材的两处分别使用），也可以整段不用。
   不能凭空出现没有素材来源的 `CUT-...`。
-- 一段素材被用两次时，两个 `CUT-...` 的区间不得重叠：同一批帧在成片里出现两次是重复镜头，
-  不是复用。确需重复出现（闪回、强调）时写明它是有意重复，并说明第二次为什么仍然成立。
+- 同一视频被用两次时，两个 `CUT-...` 的源时间区间不得重叠。确需重复出现（闪回、强调）时，
+  写明重复的意图及第二次的作用；同一静帧可以用于多个 `CUT-...`。
 
 ## 边界
 
@@ -139,12 +137,12 @@ python3 <本技能目录>/scripts/edit_tool.py verify <剧集/EP001> --project-r
 ```
 
 `check` 只核对不渲染：素材是否比剪辑单新（重出之后字幕、画面文字与音效时间必须重测）、区间自洽、
-来源 ID 解析与每一镜的下落、文件存在、区间不越过素材时长、同源区间不重叠、字幕文字能在 `剧本.md` 里找到、
+来源 ID 解析与每一镜的下落、文件存在、区间不越过素材时长、同源区间不重叠、字幕去标点与空白后能在 `剧本.md` 里找到、
 画面文字能在 `[画面文字]` 行里找到、「接续」之前确有倒计时、音效文件存在且落在本段内、
 字幕与配音在整条片里不越过结尾、互不重叠。
 其中「区间不越过素材时长」需要 `ffprobe`，配音的两项需要 `ffmpeg`；缺哪个就报哪几项「未测」并说明原因，
 不静默跳过。
-`render` 按剪辑单切段、静帧按运镜出画、同场景自动接镜、拼接、混入音效与配音、烧字幕与画面文字、统一响度，
+`render` 按剪辑单切段、静帧按运镜出画、同场景自动接镜、拼接、混入音效、配音与环境声、烧字幕与画面文字、统一响度，
 输出 `剧集/<EP>/制作成果/成片/`。
 `verify` 只测量已经渲染出来的成片并回报数字，另列出画面文字、音效与配音在成片里的起止秒、切点亮度变化和疑似坏帧，
 供抽帧和回听；不改文件、不给质量结论。
@@ -156,9 +154,8 @@ python3 <本技能目录>/scripts/edit_tool.py verify <剧集/EP001> --project-r
 走 ffmpeg 的字幕压在画面文字之上。取舍见 [声音、字幕与音乐](references/sound-and-subtitles.md)，
 装法见 [Remotion 叠层](assets/remotion/README.md)。
 
-`render` 保留切好的中间文件。它只切段、静帧出画与运镜、硬拼接、混入 `音效` 与 `配音` 行、统一字幕样式、画面文字、
-接镜校正（写明的与同场景自动的）和整片响度，不执行 `声音` 行中的混音方案，也不按交付规格自动缩放或改帧率。
-需要混音、逐镜字幕避让、转场或画幅转换时用外部工具完成并记录，验收实际交付文件。
+`render` 保留中间文件；`声音` 行只记录方案，不驱动处理，也不会按交付规格自动转换视频的画幅或帧率。
+需要额外混音、逐镜字幕避让、转场或视频规格转换时，用外部工具完成并记录，再验收实际交付文件。
 
 ## 按需知识
 

package/lib/drama/skills/short-drama-edit/assets/remotion/README.md

@@ -1,15 +1,13 @@
 # Remotion 叠层
 
 `$short-drama-edit` 用它画两样东西：剪辑单里的**画面文字**（只有这一条路线），以及**可选的**
-字幕排版（默认字幕路线是 ffmpeg + libass，零依赖）。两者在同一遍里渲进一段透明叠层。
-它要装 Node 依赖，而且慢得多、吃内存——先看下面的「代价」。
+字幕排版（默认字幕路线是 ffmpeg + libass，无需 Node 依赖）。两者在同一遍里渲进一段透明叠层。
+使用前需安装 Node 依赖；逐帧渲染的时间与内存开销见「代价」。
 
 ## 为什么走这条路
 
-ASS 的字号是相对 `PlayRes` 的单位，渲染时再缩放一次，这层间接每次都要重推一遍，推错了
-在数字上看不出来（见[声音、字幕与音乐](../../references/sound-and-subtitles.md)）。这里字号、
-描边、行距、安全区、折行都是 CSS，写的是画面像素，改完在 `npx remotion studio` 当场能看。
-面板、发光、逐条入场和逐秒走动的倒计时是版面，不是字幕样式，ASS 画不了。
+这里用 CSS 调整字号、描边、行距、安全区和折行，可在 `npx remotion studio` 中预览。
+系统面板、逐条入场和倒计时分别由组件维护；两条字幕路线的尺寸口径见[声音、字幕与音乐](../../references/sound-and-subtitles.md)。
 
 ## 装一次
 
@@ -32,10 +30,8 @@ cd ~/.cache/short-drama-edit/remotion && npm install
 python3 <本技能目录>/scripts/edit_tool.py render <剧集/EP001> --project-root <project> --subtitles remotion
 ```
 
-它渲染出一段**透明**的叠层（VP8 + alpha），再由 ffmpeg 叠到未经改动的画面上。画面本身
-不经过浏览器重绘，所以不多一次画质损失；也不在浏览器里解码画面，帧时间不规整的拼接素材在那里
-会解出串进别的镜头画面的坏帧。字幕走 ffmpeg 路线时，这一遍只画画面文字，
-字幕在合成后烧在它上面。
+它渲染出一段**透明**叠层（VP8 + alpha），再由 ffmpeg 合成到画面上；浏览器只绘制叠层，不解码或重绘视频。
+字幕走 ffmpeg 路线时，Remotion 只画画面文字，字幕在合成后烧在上面。
 
 ## 画面文字的样式
 
@@ -50,8 +46,7 @@ python3 <本技能目录>/scripts/edit_tool.py render <剧集/EP001> --project-r
 字体随叠层打包，不依赖本机。字体按字符区段拆成许多小文件，浏览器只在排到某段文字时才去取，
 那时这一帧可能已经截走了。所以叠层挂载时先按整部片子要画的字逐个字重调用
 `document.fonts.load`，全部就绪、组件树提交之后才放出第一帧；十秒内没加载完、某个字重没有声明、
-或加载后仍未就绪，渲染直接报错。这个等待按挂载注册并设了上限，不再是模块加载时那次
-`document.fonts.ready`——在带视频的渲染页里，那次等待曾挂住整个渲染直到超时。
+或加载后仍未就绪，渲染直接报错。等待按挂载注册并设上限。
 
 画每段字之前再测一次宽：把字体栈分别接在 `serif` 与 `monospace` 两个兜底之前，与只有兜底时的
 宽度相比，两边都一样才算字体没到位，这时同样报错，不悄悄换字体出片。
@@ -60,11 +55,10 @@ python3 <本技能目录>/scripts/edit_tool.py render <剧集/EP001> --project-r
 
 叠层**逐帧**渲，长度等于整部成片：一分钟竖屏片一千多帧 1080×1920，每帧一次无头浏览器
 截图，没字的帧照渲。透明还要求 PNG 抓帧加 VP8 编码，Remotion 的性能文档把这两样都列为
-慢环节。默认字幕路线是一次滤镜的事，这条是分钟级。
+慢环节；实际耗时取决于成片时长、画幅和机器性能。
 
-内存才是会出事的地方。Remotion 默认按 CPU 核数开浏览器实例，每个各持一整帧——10 核 8 GB
-的机器上内存打满，整机停止响应，本套件就这么卡死过一次。所以 `edit_tool.py` 固定传
-`--concurrency`，默认 2。要提高先量本机，别凭核数拍：
+每个浏览器实例都占用内存，按 CPU 核数提高并发可能耗尽内存。`edit_tool.py` 显式传入
+`--concurrency`，默认 2；提高前先在本机测量：
 
 ```bash
 cd ~/.cache/short-drama-edit/remotion && npx remotion benchmark
@@ -72,9 +66,8 @@ cd ~/.cache/short-drama-edit/remotion && npx remotion benchmark
 
 ## 许可证
 
-Remotion 个人与小团队免费，超出规模需商业授权，条款以 [remotion.dev](https://www.remotion.dev/)
-为准。本套件是 MIT，不包含也不代理这项授权，也不会替你安装它——缺依赖时只报错并给出命令。
-剪辑单里没有画面文字、字幕走默认路线时，不涉及这件事。
+使用 Remotion 前，按其[官方许可证](https://github.com/remotion-dev/remotion/blob/main/LICENSE.md)
+核对适用授权；本套件的 MIT 许可证不覆盖 Remotion。剪辑单没有画面文字且字幕走默认路线时，无需安装 Remotion。
 
 思源黑体（Noto Sans SC）与 JetBrains Mono 都是 SIL Open Font License 1.1：可以随成片使用、
 嵌入和再分发，不能单独出售字体文件。许可证文本在各自的 `node_modules/@fontsource/*/LICENSE`。

package/lib/drama/skills/short-drama-edit/assets//345/211/252/350/276/221/345/215/225.md

@@ -41,5 +41,5 @@
 ---
 
 说明：本文件是格式样例，`制作成果/videos/...` 是示意路径。真实项目里每个「来源」的路径都必须
-指向当前可读的文件，`check` 会逐条核对。「未采用镜头」的两条理由分别示范了必须区分的两类——
-文件缺失回生产，质量不可用回上游改提示词。
+指向当前可读的文件，`check` 会逐条核对。文件缺失时回生产补齐；质量不可用时先判断是否还有可用区间，
+再按原因选择重出素材、换参考或修订提示词。