@oh-story/dsh 0.1.14 → 0.1.16

package/lib/drama/skills/short-drama-assets/references/voice-direction.md

@@ -11,10 +11,10 @@
 - [写出区分度](#写出区分度)
 - [专名发音](#专名发音)
 - [变体：伪装、年龄与跨段变化](#变体伪装年龄与跨段变化)
-- [voice-casting.md 的渲染规则](#voice-castingmd-的渲染规则)
+- [写入视觉设定](#写入视觉设定)
 
-`voice_direction` 是 Character 记录的一部分（`AST-07`），跨集稳定。本场怎么说属于表演，
-由 `$short-drama-write` 的配音本逐句决定。
+声音方向（`voice_direction`）写在 `视觉设定.md` 的人物条目中，记录跨集稳定的声音身份
+（`AST-07`）。本场怎么说属于表演，由已接受剧本中的台词与表演要求决定，再交分镜和视频提示词实现。
 
 ## 参考音频是载体
 
@@ -24,23 +24,22 @@
 1. **选型与验收**：用什么判据挑一条参考、判一次克隆结果算不算这个角色；
 2. **专名发音**：参考音频里没有的那些名字该怎么念。
 
-所以 `voice_direction` 以 `reference` 为主字段。没有参考音频时，记录保持
-`reference: null` 并写明「待选型」——**不要用一段文字描述冒充音色身份**。
-下游拿着一段形容词去找声音，找回来的每次都不一样，而记录看起来是完整的。
+参考音频是声音身份的主要载体。没有参考时写 `- 声音参考：待选型`，文字只保留选型判据
+与待确认项，不把判据当作已选音色，也不要求建立独立声音规格文件。
 
 ### 参考可以是合成出来的
 
 使用声音库时，确认所选音色及其使用范围符合供应商提供的许可。
-项目没有配音演员、也不打算克隆谁的时候，这条路是让 `reference` 从 `待选型` 变成实际路径的
-办法——**挑一个预置音色，合成一条，绑上去**。合成由 `$short-drama-produce` 的 `tts` 模态执行。
+项目没有配音演员、也不打算克隆谁时，可以选择预置音色，提出一条试音任务，再绑定合成结果。
+合成由 `$short-drama-produce` 的 `tts` 模态执行，必须先展示精确任务预览并取得创作者明确确认。
 
 合成出来的参考和录音来的参考在本文档里受同样的约束：它一样要写用途边界，一样要有
 `admission_status`，一样不能用形容词代替。差别只有一处——**它的选型判据是拿来挑预置音色的，
 不是拿来判克隆像不像的**，所以「与谁最易混」这条要在同一批预置音色里回答，而不是在角色之间
 凭空回答。预置库里两个音色听起来就是同一个人时，换一个，不要靠判据文字假装区分。
 
-音色 ID 本身写进 `reference` 那一行，和路径、用途边界一起。它是创作决定：同一个角色在两集之间
-换 ID 就是换人说话，这件事必须在文档里看得见、diff 里查得出。
+所选音色 ID 记在人物条目的参考来源说明中，实际音频路径仍放在唯一的 `声音参考` 行开头。
+更换音色是创作决定，须记录前后选择，供跨集核对。
 
 ## 身份与表演的界线
 
@@ -58,13 +57,14 @@
 界线画错的代价不对称：把表演写进身份，角色每一集都会被要求带着上一集的伤势说话；
 把身份漏进表演，配音者每一场都要重新猜这个人是谁。
 
-`not_voice_identity` 与身份字段必须同时写。只写身份，下游无从判断某个特征是被遗漏
-还是被有意排除。
+人物条目同时说明声音身份及排除项（`not_voice_identity`），让下游分清哪些特征需要保持，
+哪些临时表演或录音特征不得继承。
 
 ## 一段参考音频可以决定什么
 
 参考绑定必须自带用途边界：写清这次参考它的**什么**，以及哪些内容**不能**跟着来
-（`AST-08`）。同一段录音承担多个用途时拆成多条绑定分别审查。
+（`AST-08`）。同一段录音承担多个用途时，分别说明各用途的控制范围并逐项审查；人物条目
+仍只登记一条 `声音参考` 路径，不复制成多条同名参考行。
 
 | `role` | 可以借用 | 默认不可借用 |
 |---|---|---|
@@ -80,7 +80,8 @@
 - **录音空间**：混响、房间声、话筒距离属于那次录音，不属于这个人；
 - **背景内容**：底噪、伴奏、另一个说话人。
 
-一条参考同时要定音色和口音时，写两条绑定分别审查，不要把 `may_control` 加长。
+同一参考兼顾音色与口音时，在同一人物条目下分列这两项用途及各自允许/不得控制的内容。
+用途不能互相扩大；下游视频的 `参考音频` 仍按其音色用途绑定。
 
 ## 绑定不等于听过
 
@@ -102,8 +103,8 @@
 
 ## 选型判据
 
-`selection_criteria` 是三到五条可听的判据，用来**挑**一条参考、或**判**一次克隆结果
-算不算这个角色（`AST-12`）。它不生成声音，也不替代参考。
+选型判据（`selection_criteria`）用来**挑**一条参考、或**判**一次克隆结果是否符合角色
+（`AST-12`），不生成声音，也不替代参考。通常可从三到五条起草，数量不作为验收门槛。
 
 从六类里挑，不要写满：音区（相对位置而非 Hz——「比同剧其他成年男性低半档」）、
 质感、年龄与体量印象、节奏、口音与语域、可重复的标记性习惯（至多一条）。
@@ -124,9 +125,8 @@ CHAR-A 与 CHAR-B 最易混：两条参考同为中低音区、语速偏慢。
 区分判据：A 句尾收住不拖长；B 句尾常带一段下滑的余音。
 ```
 
-这条写不出来，说明两条参考实际上是同一个声音——观众会分不清谁在说话，
-而这个问题在文本审查里看不出来，只在成片里被听见。回到创作者那里换一条参考，
-不要靠堆形容词假装区分。
+写不出时，说明尚未找到可听的区分依据。回查创作者的听感说明或已获授权的试听记录，
+必要时请创作者更换参考；文字判据本身不能证明两条声音有区分。
 
 角色多时按易混组分批选型，而不是按出场顺序。
 
@@ -161,13 +161,13 @@ CHAR-A 与 CHAR-B 最易混：两条参考同为中低音区、语速偏慢。
 短暂的一场变化不建变体，交给表演。判据和 Look 一样：跨多个场次持续、会重复使用、
 需要独立参考、或下游必须精确绑定时才升为变体。
 
-## 写入 `视觉设定.md`
+## 写入视觉设定
 
 需要跨集保持声音身份时，在对应人物条目下增加“声音方向”，只保留：
 
 1. **参考**：一行 `- 声音参考：<项目相对路径>（用途：…；控制：…；不得控制：…；状态：<admission_status>）`，
    路径打头；没有参考时写 `- 声音参考：待选型`；
-2. **选型判据**：三到五条可听判据，每条带反例；
+2. **选型判据**：少量可听判据，每条带反例；
 3. **对比角色**：最容易混淆的是谁，以及靠什么可听差异区分；
 4. **专名发音**：唯一确认读法；
 5. **变体**：跨多场持续的伪装、年龄跨度或音色变化，写原因与有效范围。
@@ -177,5 +177,5 @@ CHAR-A 与 CHAR-B 最易混：两条参考同为中低音区、语速偏慢。
 
 参考音频落地之后，它在下游有两个去处：作为视频模型的音色参考绑定（《视频提示词.md》该镜的
 `参考音频` 行照抄这条路径，由 `$short-drama-video-prompts` 写），
-以及作为配音本的实际人声。配音使用同一已选音色逐句合成；参考音频用于选型或模型绑定，不能直接充当不同台词的成品音轨。
+以及作为逐句配音的选型依据。配音使用同一已选音色逐句合成；参考音频用于选型或模型绑定，不能直接充当不同台词的成品音轨。
 是否保持角色声音，仍需在生成后回听确认。

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

@@ -6,7 +6,7 @@ license: MIT
 
 # 短剧开发
 
-把创作者的意图变成能持续制造**选择、代价与状态变化**的故事系统。保留创作者的题材、结局和尺度选择；不要把流行套路当成剧情答案。
+把创作者的意图变成能持续制造**选择、代价与状态变化**的故事系统，保留创作者对题材、结局和尺度的选择。流行套路只能作为候选方法。
 
 ## Quick Start
 
@@ -19,9 +19,9 @@ python3 {技能目录}/scripts/episode_intake.py index <多集整稿> --out <epi
 
 ## 开始前
 
-本技能可独立安装和执行。先读取用户明确提供的材料与本任务直接输入；若当前目录是
-`short-drama` 项目且项目工具可用，可以读取 `status` 并使用其发布生命周期，但缺少 core
-或任何其他技能都不是开发工作的阻断条件。[阶段契约](references/stage-contract.md) 给出
+本技能可独立安装和执行。先读取用户明确提供的材料与本任务的直接输入；若当前目录是
+`short-drama` 项目且项目工具可用，可以读取 `status` 并使用其发布生命周期。缺少 core
+或其他技能时，仍可基于现有输入完成开发。[阶段契约](references/stage-contract.md) 给出
 本阶段边界、制作形态输入与规则表，无需读取其他技能的文件。
 
 ## 先判断入口
@@ -57,7 +57,7 @@ python3 {技能目录}/scripts/episode_intake.py index <多集整稿> --out <epi
 
 每个候选都说明：戏剧承诺、主角追求、对抗机制、反复回报、可升级的状态、长线终止条件、主要制作负担。让创作者选择或组合，并记录取舍理由；未选方案不进入既定事实。
 
-需要完整方法时读取 [story-craft.md](references/story-craft.md)。题材已经确定时，可从
+需要深化戏剧承诺或冲突机制时，读取 [story-craft.md](references/story-craft.md)。题材已经确定时，可从
 [genre-cards.md](references/genre-cards.md) 按索引取**一张**题材卡，用来校准该题材更常用的
 压力来源、场面颗粒与制作负担；它是可被创作者一句话覆盖的参考，不替代方向选择，也不进入交付物。
 
@@ -100,7 +100,7 @@ python3 {技能目录}/scripts/episode_intake.py index <多集整稿> --out <epi
 - 候选确实改变机制，选定方向贯穿简报、引擎与分集地图；
 - 每次升级能指出权力、信息、关系、暴露、资源、时间或代价的变化；
 - 每集先兑现一部分当集承诺，再留下具体的决定、危险或问题；
-- 改编项目里核心人物的立场、核心关系和主线没有被改写；原著没有的新增内容都登记为 `add`，并列在简报里；
+- 改编项目保留核心人物的立场、核心关系和主线，创作者已接受的改动除外；原著没有的新增内容都登记为 `add`，并列在简报里；
 - 没有把格式偏好冒充普遍规律。
 
 这些是所有者自检，不是终审。展示创作者可读的新增/修改摘要，请创作者接受后再作为下游来源；

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

@@ -1,4 +1,4 @@
 interface:
   display_name: "短剧开发"
-  short_description: "把原创想法或长篇小说发展为故事引擎、系列弧线和逐集交接结构"
+  short_description: "把原创想法或长篇小说发展为故事引擎、系列弧线和分集地图"
   default_prompt: "使用 $short-drama-develop 把我的短剧想法或长篇小说发展成故事引擎和分集地图；方向不清时再给少量可选择方案。"

package/lib/drama/skills/short-drama-develop/assets/creative-brief.md

@@ -1,6 +1,6 @@
 # 短剧创作简报
 
-> 复制到 `项目开发/creative-brief.md` 后填写。保留未知项为“待确认”，不要替创作者猜答案。方括号说明填写后删除。
+> 复制到 `项目开发/creative-brief.md` 后填写，未知项保留为“待确认”。填完后删除方括号说明。
 
 ## 1. 项目意图
 
@@ -49,7 +49,7 @@
 
 **一句工作陈述**：
 
-【用自然语言连接以上决策；不是宣传语，也不强求固定句式。】
+【用自然语言连接以上决策，便于核对人物、追求、阻力与回报；句式自定。】
 
 ## 5. 方向候选与选择
 

package/lib/drama/skills/short-drama-develop/assets/story-engine.md

@@ -78,8 +78,8 @@
 
 - **可靠性**列决定装置的宣告能否被当真。标为「会误述」的条款，后续揭穿时观众要能回看出
   线索；这属于已设计的不可靠，不是失约。
-- 需要新增条款时走修订：先改本表并让创作者接受，再在剧中披露。**不得先在某一集写出来，
-  事后再回填条款。**
+- 需要新增条款时走修订：先改本表并让创作者接受，再让条款在剧中生效或披露；披露节奏按
+  信息权限安排。**不得先在某一集写出来，事后再回填条款。**
 - 装置只调整信息与能力的分配，不改写题材的压力来源、观众回报与结局承诺。
 
 ## 4. 人物行动模型

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

@@ -14,9 +14,8 @@
 - [登记不等于兑现](#5b-登记不等于兑现)
 - [分级审查](#6-规则分级与审查)
 
-改编不是把原文按顺序缩短，也不是为短剧补一套原著没有的流行结构。先找出原著里观众为之
-而来的爽点，把它们排到观众最早能拿到的位置；再保住让这些爽点成立的戏剧功能，为屏幕、
-单集边界和制作条件寻找新的载体。
+改编先找出原著吸引观众的爽点，把它们排到观众能尽早获得回报的位置，再保住让爽点成立的
+戏剧功能，为屏幕、单集边界和制作条件寻找合适载体。压缩顺序服从因果与创作者的改编边界。
 
 ## 1. 先建立改编契约
 
@@ -43,9 +42,9 @@
 development，避免交付包把输入材料带出边界。
 
 分集候选按局部戏剧结果和准确交接组织，不按章节号、字数或关键词机械切分。创作者接受
-改编与分集决定后，write owner 才写/规范化 canonical `screenplay.md`，assets owner 再从
-接受剧本生成可发布 occurrence 与资产决策。导入阶段可以展示人物/场景/物品**候选预览**，
-但它只是 develop-owned proposal，必须带来源与 `unresolved`，不能写入资产 设定集，也不能在
+改编与分集决定后，write owner 才写入 `剧集/<EP>/剧本.md`，assets owner 再从
+已接受剧本建立该集的 `视觉设定.md`。导入阶段可以展示人物/场景/物品**候选预览**，
+但它只是 develop-owned proposal，必须带来源与 `unresolved`，不能写入资产设定集，也不能在
 角色合并、删场或道具换载体之前冒充最终资产库。
 
 ### 写下游内容时定点回原文
@@ -106,9 +105,10 @@ development，避免交付包把输入材料带出边界。
 
 ### 先按爽点取舍
 
-压缩分两步：先只留热度最高的情节点——爽点、糖点、虐点，排名来自原著分析的爽点表；
+压缩分两步：先保留观众收益最高的情节点——爽点、糖点、虐点，排名来自原著分析的爽点表；
 再删掉不服务这些点的支线，合并功能重复的人物。一个改编实例只保留了原著约六成情节。
-核心人物通常 3–5 人，全剧不超过 20 人，高潮集新增的人物不超过 2 个。
+若需要控制制作规模，可把核心人物 3–5 人、全剧不超过 20 人、高潮集新增不超过 2 人作为
+可覆盖的工艺参考；这些数量与六成比例都不构成保留目标或质量门槛。
 
 集数与章数的关系由爽点分布决定，不按章 1:1 切：没有爽点的长段并进相邻集或删掉，
 一章里有两个大爽点时可以拆成两集，后文的高光可以提前。按原著顺序一章一集往下切，
@@ -253,15 +253,16 @@ development，避免交付包把输入材料带出边界。
 
 ## 5b. 登记不等于兑现
 
-被自己登记为不可更改的来源事实，最容易的失败方式不是写错，是**写进简报之后再也没有回来**。
-它在文件里，所以每次审查都读到它、每次都算数；而观众一次都没有看到。
+来源事实登记为不可更改后，还要安排它在分集中的落点；只写进简报而不再核对，容易让文档
+反复提及同一事实，观众却始终看不到。
 
 判据是一句话：**这条事实，观众在本轮要写的集里从哪一个画面能得到它**？逐条回答，答案只有两种：
 
 - **落在第几集、可见载体是什么**——那个载体必须真的被写进那一集的分集记录与剧本；
 - **显式延后到第几集**——写下集号，本轮不欠。
 
-两种都答不出来的，它就不是“不可更改的事实”，是一句备注，按备注处理。
+两种都答不出来时，这条事实仍是不可更改的约束，只是落点尚未规划完成；补齐可见载体或
+延后集号，不能把它降为备注。
 
 世界设定尤其适合延后。第 1 集只需要观众看懂眼前这场冲突用到的那一条规则，其余设定登记到
 它第一次改变人物选择的那一集。把整套设定塞进首集，只会换来大段说明和旁白。
@@ -279,7 +280,7 @@ development，避免交付包把输入材料带出边界。
 
 - `structural_invariant`：来源与功能对应表、授权边界、铺垫、兑现和交接引用都能解析。
 - `reviewed_invariant`：合并没有造成知情穿帮，压缩没有删断因果，新的表现方式保留核心含义，
-  人物立场、核心关系和主线没有被改写（STY-07）。
+  人物立场、核心关系和主线没有被改写，创作者已接受的改动除外（STY-07）。
 - `craft_default`：优先用选择、证据和空间后果承载说明；有明确风格理由时可以调整。
 - `taste_option`：保留旁白、倒叙、多声部人物、慢场或开放结尾均是创作者选择。
 

package/lib/drama/skills/short-drama-develop/references/creative-reference-intake.md

@@ -1,6 +1,7 @@
 # 创作参考作品的安全摄取
 
-用户提供对标剧、小说、分镜样例或提示词时，学习它解决问题的机制，不召回它的表达外壳。
+用户提供对标剧、小说、分镜样例或提示词时，提炼它解决问题的机制，避免把原句、独特桥段或
+风格组合带入新作品。
 本流程只读取用户在当前会话明确提供或授权的材料；不自行连接外部、非公开项目库。
 
 ## 1. 先声明本次参考职责
@@ -14,7 +15,7 @@
 
 材料过长时先按用户问题选择相关段落和完整因果窗口，不能用关键词命中代替阅读上下文。
 
-## 2. 从观察写到机制，不从表面写到仿写
+## 2. 从直接观察提炼机制
 
 先区分“原材料里直接发生了什么”“agent 如何解释”“仍不知道什么”，再写去引用的
 机制摘要，把表层桥段压缩成“观众状态 → 戏剧问题 → 可选机制 → 可见效果 → 失效边界”：
@@ -40,12 +41,11 @@ reference_mechanism:
 
 ## 3. 下游只读取去引用候选
 
-原材料与 observation 留在非公开 `输入/` 边界；develop/write 只消费经创作者接受的
+原材料与直接观察记录留在非公开 `输入/` 边界；开发与写作只读取经创作者接受的
 机制候选：当前问题、适用条件、可选机制、可见效果、失效边界与禁止复制项。不要把原文、
 “语感片段”、整段对话、独特反转顺序或多部作品的风格摘要塞进写作 prompt。
 
-一次只召回与当前场景或分集问题直接相关的少量机制。需要另一维度时再读取另一张卡，
-而不是按“参考越多越好”扩大上下文。
+一次只召回与当前场景或分集问题直接相关的少量机制，需要补足另一维度时再读取相应卡片。
 
 ## 4. 做迁移检验再交给创作者
 
@@ -53,5 +53,5 @@ reference_mechanism:
 效果、何时失效，才算完成抽象。随后比较至少一个替代机制，说明各自制作负担与潜在副作用，
 让创作者选择、组合或拒绝。
 
-参考作品不是质量证明。当前项目的剧本与提示词仍要凭自身因果、可表演性、连续性和制作
-文本接受审查；“与参考相似”既不能批准，也不能单独否决。
+当前项目的剧本与提示词仍按自身因果、可表演性、连续性和制作可执行性接受审查；
+“与参考相似”既不能证明质量，也不能单独作为否决理由。

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

@@ -7,9 +7,9 @@
 - [反模式](#反模式)
 - [拆分参数](#拆分参数配套)
 
-来自对导演阐述如何约束完整生产链的定性案例阅读，示例均为合成改写。导演阐述是
-整条流程里影响很大的人工输入：写在拆分/分镜之前，约束全剧后续工作——分镜
-格式、摄影职责、节奏方向和已知能力条件。在本套件中，它落入
+本方法来自对导演阐述如何约束完整生产链的定性案例阅读，示例均为合成改写。导演阐述由
+创作者在拆分/分镜之前确认，明确全剧后续工作的分镜格式、摄影职责、节奏方向和已知能力条件。
+在本套件中，它落入
 `short-drama.json#/creator_authority` 中的 `visual_direction` 与 `production_profile`，
 由本技能在 `项目开发/director-brief.md` 中起草候选并展示语义差异。创作者接受后，
 由 `$short-drama` 路由提升到 creator authority 才生效；本技能不直接写 creator-owned
@@ -27,9 +27,8 @@
 
 ### 可验收约束型（项目需要稳定规格时）
 
-每条规则都应能对交付文本和后续制作结果追溯，但“可验收”不等于先填一套镜头数量、
-景别比例或秒数。先说明当前项目为何需要这条约束、它保护哪项上游必保内容、
-什么证据允许例外，再由创作者接受：
+每条规则都应能在交付文本和后续制作结果中找到验证依据。先说明当前项目为何需要这条约束、
+它保护哪项上游必保内容、什么证据允许例外，再由创作者接受：
 
 ```text
 【本项目接受的约束】
@@ -71,7 +70,7 @@
 
 - **可观察表演**：情绪词可保留为意图，但至少用与人物和触发相符的准备动作、面部
   微动作、肢体联动或重心变化承载；不要求每镜填满固定维度；
-- **记录失败原因而非词表**：写清哪种表达在什么镜头、参考条件和制作方案下不可执行，
+- **记录失败条件与替代方式**：写清哪种表达在什么镜头、参考条件和制作方案下不可执行，
   以及当前采用的可观察替代；不把形容词或生理细节汇成跨题材禁词清单；
 - 权力反转先确认旧权力如何成立、什么证据使其失效、谁必须接收后果，再选择同镜、
   反应镜或群体状态变化；不把题材标签翻译成固定阶段和固定景别；
@@ -107,7 +106,7 @@
 - 按集拆分：明确本集局部戏剧结果、代价与后续压力；文字量从目标时长、
   台词语速、动作和停留空间反推。
 - 按字数拆分容易切断场景目标、行动转向或反应职责；项目若仍选择这种方案，必须在
-  切点复核场景与交接内容。需要明确制作信息时，优先先改成剧本格式再拆。
+  切点复核场景与交接内容。需要明确制作信息时，优先改成剧本格式再拆。
 
 若创作者选择量化制作方案，数值只在其已接受范围内成为验收约束。“禁改台词”与
 相邻镜已确认边界的核对属于套件硬规则，不因写法流派而放松。

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

@@ -17,7 +17,7 @@
 
 ## 1. 分集的工作定义
 
-一集不是被时长切下来的一段情节，而是一次有边界的状态变换：
+一集完成一次有边界的状态变换：
 
 ```text
 可验证的进入状态
@@ -28,7 +28,7 @@
 → 可验证的出去状态
 ```
 
-分集设计的重点是“这一集为什么必须在这里发生”，不是把事件均匀分配。
+分集设计要回答“这一集为什么必须在这里发生”，让分集边界对应必要的状态变化。
 
 ## 2. 规则分级
 
@@ -138,7 +138,7 @@ C 让状态 D 改变，迫使人物放弃旧策略或付出更大代价；
 
 ### 3.8 每集只写这一集独有的东西
 
-分集记录**不是把这一集的所有信息抄一遍**。判据只有一条：
+分集记录只保留写作与交接所需的约束，逐项判断：
 
 > 删掉这个字段，写剧本的人会不会失去一个重要的创作约束？
 
@@ -148,9 +148,9 @@ C 让状态 D 改变，迫使人物放弃旧策略或付出更大代价；
 - **可以从别的字段推导出来的**。单步因果链就是"目标 → 反对 → 结果 → 出去的压力"，
   把它再写一遍不产生新约束；只有一集里确实有两步以上、后一步依赖前一步的结果时，
   才需要单独写因果链。
-- **整部戏只发生一次的**。人物的跨集转变属于故事引擎的
-  [人物行动模型](../assets/story-engine.md)，信息权限模型属于同一份文件的信息与证据设计。
-  在每一集重写一遍，只会让同一句话出现在八个地方。
+- **跨集共用且已有统一记录的**。人物跨集变化统一记录在故事引擎的
+  [人物行动模型](../assets/story-engine.md)，信息权限模型记录在同一文件的信息与证据设计。
+  分集记录保留本集实际发生的结果与权限变化，不重复整套模型。
 - **解释性的**。"为什么这个钩子连着本集目标""为什么这股压力由本集产生"是**理由**，
   不是约束。理由由审查者从已有字段判断，不需要作者逐集自证。
 - **给字段本身分类的**。钩子属于哪一型、节奏是强是弱，这些标签不改变任何一句剧本。
@@ -158,12 +158,10 @@ C 让状态 D 改变，迫使人物放弃旧策略或付出更大代价；
 留在分集记录里的，是**只有这一集才知道的事实**：进入状态、本集目标与反对、转折的触发、
 局部结果、出去的压力、交接状态，以及本集要用到的资产与连续性变化。
 
-一集只有一步因果时，它没有独立的因果链字段，单集卡里的实现块也就没有步骤可指——
-此时直接写三个可见载体（选择、反制、状态变化），不写指向某一步的指针。真的有两步以上、
-后一步依赖前一步结果时，才写因果链，实现块再逐步对应。
+一集只有一步因果时，分集记录直接写可见的选择、反制和状态变化，不另设因果链字段或步骤指针。
+有两步以上、后一步依赖前一步结果时，才单列因果链，剧本按各步落实。
 
-一个副作用值得知道：字段越多，越容易被"填满"而不是被"想清楚"。同一句话被抄进六个槽位
-时，记录看起来完整，实际只作了一个决定。
+同一句话抄进多个槽位不会增加创作约束，反而容易掩盖尚未完成的决定。
 
 ## 4. 钩子、兑现与出去的压力
 
@@ -350,8 +348,8 @@ C 让状态 D 改变，迫使人物放弃旧策略或付出更大代价；
 | 裁决权从立场转移到作品本身 | 刚才喊举报的那个人点开了视频 |
 | 上级选择维持现状 | 上级把申请表推回来，说等有了成绩再谈 |
 
-左栏读起来都对，而且**审查时不会被任何门拦下**——它们是对的功能描述。但把左栏交给剧本层，
-写作者拿到的是一个待发明的结论；把右栏交给剧本层，写作者拿到的是一场戏。
+左栏的功能描述本身可以成立，结构校验也无法据此判断动作是否具体；这一缺口仍须由
+`STY-24` 的语义审查指出。只交左栏会让剧本层重新发明行动，右栏则提供了可继续场景化的依据。
 
 判据是一句话：**这一拍，观众看见的是谁做了什么**？答不上来的，说明记录停在了功能层。
 不要求分集记录写完整场次——那是剧本的活；要求的是**转折与本集结果各自都能指出一个具体的
@@ -468,9 +466,8 @@ C 让状态 D 改变，迫使人物放弃旧策略或付出更大代价；
 
 ### 9.4 容量可行性预算 (`STY-16`)
 
-第 1 节说一集不是被时长切下来的一段情节——这仍然成立，戏剧边界决定一集在哪里结束。
-但一集写完之后要被拆成镜头、再变成有时长的画面，所以它**同时**占用一份制作容量。
-这两件事不冲突：戏剧边界决定内容，容量预算只回答“这份内容装不装得下”。
+戏剧边界决定一集在哪里结束，制作容量决定这份内容能否在已选时长与预算内完成。
+分集地图上的选择最终要成为镜头与有时长的画面，因此在场景化前先做量级估算。
 
 不做这个检查的失效方式很具体：分集地图上每集看起来都合理，直到剧本交到分镜环节才发现
 某几集的镜头数是别人的两三倍，于是要么临时砍戏（砍掉的往往正是兑现），要么让这几集
@@ -487,8 +484,8 @@ C 让状态 D 改变，迫使人物放弃旧策略或付出更大代价；
 3. 与创作者已接受的集长和产物预算比较，只关注**量级偏差**（例如某集是同项目均值的两倍
    以上），不关注小幅波动。
 
-**这不是质量门槛**。 比值来自项目自己的历史，不是跨项目标准；换题材、换制作形态或换
-交付容器方式，比值都会变。所以：
+比值来自项目自身的历史；题材、制作形态或交付容器改变时需要重估，不能把它当作跨项目
+质量门槛：
 
 - 偏差是**提示**，交给创作者判断，不阻断任何交付；
 - 处理偏差优先用 9.1–9.3 的手段（把超载集拆成两集、把说明改成传递、合并同质节拍），
@@ -496,10 +493,9 @@ C 让状态 D 改变，迫使人物放弃旧策略或付出更大代价；
 - 项目还没有已接受集可取样时（例如只写第一集），跳过这一步，等有了基准再回来算。它的
   价值来自项目自身的一致性，用别处的数字代入反而会误导。
 
-**跳过估算不等于第一集没有时长兜底**。 这里做的是**预测**：用已接受集的比值推算还没写的
-集，所以第一集拿不到。等第一集的镜头真的存在了，另有一次**测量**——把本集镜头的已接受
-时长直接加总，与项目声明的每集目标时长比对。测量不需要基准，第一集同样成立，它属于分镜
-环节的账目责任（见该环节的单集时长加总规则），不在本节重复。
+上述估算用已接受集的比值**预测**待写集；第一集没有历史基准时先跳过。镜头时长确定后，
+分镜环节还会把本集已接受的镜头时长直接加总，与项目目标集长比对。这次**测量**不依赖
+历史样本，第一集同样适用。
 
 **`taste_option`**：单集长度、集数、每集镜头量级由创作者的格式与发行方案决定。
 
@@ -520,7 +516,7 @@ C 让状态 D 改变，迫使人物放弃旧策略或付出更大代价；
 | `opposed_reversals_per_episode_min` | 每集至少几次有具体对手参与的反转 | 1 | 1 |
 | `end_on_peak` | 集尾停在峰值上直接收，不在峰值后再缓一段 | `true` | `true` |
 | `reprise_previous_last_beat` | 下一集开头先接上一集最后一拍 | `true` | `true` |
-| `vo_share_max` | `[VO]`（旁白与内心独白）占全集台词可发声字数的比例上限；`[OS]` 画外对白不算 | 0.3（未实测） | 0.3（未实测） |
+| `vo_share_max` | `[VO]`（旁白与内心独白）占全集口播字符的比例上限，按时长脚本去空白与括注、保留标点统计；`[OS]` 计入总口播，不计入 VO | 0.3（未实测） | 0.3（未实测） |
 | `target_avg_shot_seconds` | 目标平均镜长（秒） | 2.5 | 3.0（未实测） |
 | `close_shot_share_min` | 近景类镜头——近景、特写、大特写与细节镜头——合计占全集镜头数的比例下限 | 0.45 | 0.45（未实测） |
 | `first_major_payoff_by_episode` | 全书第一个大爽点最迟在第几集 | 1 | 1 |
@@ -579,7 +575,7 @@ C 让状态 D 改变，迫使人物放弃旧策略或付出更大代价；
 
 ### 审查问题
 
-审查者引用 `episode-map.jsonl`、单集卡或节拍记录回答：
+审查者引用 `episode-map.jsonl` 和对应的 `剧本.md` 回答：
 
 1. 本集从什么进入状态运动到什么出去状态？
 2. 哪个选择触发了哪项反制，证据在哪里？

package/lib/drama/skills/short-drama-develop/references/genre-and-hook-playbook.md

@@ -1,13 +1,13 @@
 # 题材条件与钩子手册
 
-这份参考资料来自对不同题材完整“剧本—资产—分镜—提示词修订”链的定性阅读。
-它只保留可以用在新项目里的故事推进方法和常见问题，不保留项目名、原台词、内部 ID、原提示词、媒体
-地址、供应商字段或题材频次。这里没有热度排名，也没有按标签自动套用的剧情公式。
+本手册从不同题材完整“剧本—资产—分镜—提示词修订”链的定性阅读中，提炼可迁移的故事
+推进方法和常见问题。原项目名、台词、内部 ID、提示词、媒体地址与供应商字段不进入本手册；
+题材选择依据压力机制与项目条件，案例频次不代表市场热度。
 
 本手册负责**跨题材的比较**：同一条轴线上，不同题材怎样分岔。单个题材的执行细节
 （场面颗粒、集尾钩子取向、前中后期打法、该题材特有的制作成本）拆在
 [genre-cards.md](genre-cards.md) 索引下的题材卡里，一次只读一张。
-两层的分工是：先用本手册确认压力机制选对了，再用题材卡校准这个题材更常用的落点。
+先用本手册比较压力机制，再用题材卡校准相应的场面与情绪落点。
 
 ## 目录
 
@@ -130,8 +130,8 @@
 权力，让旧解释失效。突然出现一位旁人报出头衔，只能传递信息，不能替代前置行为和选择。
 
 “华丽”“破旧”“威严”都要落到当前故事职责，不把固定材质、身材、肤色或布光当
-阶级或性别判断。群体调度和代表性反应见
-由分镜环节按可见的站位、视线与阻挡关系落实；本阶段只写谁必须在场、谁必须看见。
+阶级或性别判断。群体调度和代表性反应由分镜环节按可见的站位、视线与阻挡关系落实；
+本阶段只写谁必须在场、谁必须看见。
 
 ## 职场与喜剧：用流程证明能力，用反差制造笑点
 
@@ -165,7 +165,7 @@
 - 多主体同场时先交代位置和观察关系，让观众知道误认如何成立；
 - 任务取得局部结果后，身份错位才作为反应、关系后果或收尾按钮再次发力。
 
-若删去身份设定后这一段没有欲望、阻力和结果，说明设定梗正在取代故事。身份形态的制作
+若删去身份设定后这一段没有欲望、阻力和结果，说明设定梗正在取代故事。
 本阶段需要从制作形态取得哪些输入，见 [阶段契约](stage-contract.md) 的“制作形态需要什么”。
 
 ## 生活流与小人物：让小目标留下真实余波

package/lib/drama/skills/short-drama-develop/references/genre-cards//344/272/262/345/255/220/351/232/220/347/247/230.md

@@ -31,9 +31,9 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 常见策略：转移话题、用第三人代答、抢先给出一个次要真相、拿孩子的利益要挟、主动做检验
 以夺取解释权、把决定权交给孩子。
 
-信息权限至少分四层，开局就要写死：**孩子知道多少、隐瞒方知道多少、被瞒方知道多少、
+开局先写清四组人的知情状态：**孩子知道多少、隐瞒方知道多少、被瞒方知道多少、
 周围人以为的版本是什么。** 尤其要定清孩子在哪一层——孩子全知、半知、误信三种写法通向
-完全不同的戏，中途改层等于换一部剧。
+完全不同的戏；之后的知情变化要由具体信息释放推动，不能无因跳变。
 
 **孩子必须有自己的目标**。 他要的东西具体且与成年人的目标不完全重合：想留在这所学校、
 想要那个人来开家长会、想弄清楚妈妈为什么哭、想保护一个大人不被另一个大人欺负。没有
@@ -76,9 +76,8 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 制作难点
 
-**这是本套件覆盖的题材里对儿童演员依赖最重的一个，也是制作限制最硬的一个**。
-未成年演员的可工作时长、可拍时段与可承担的情绪强度都受限，且这些限制在开发阶段就必须
-进入分集地图，不能等到分镜再发现。具体做法：
+真人拍摄时，本题材对儿童演员的依赖较重。未成年演员的可工作时长、可拍时段与可承担的
+情绪强度都受限，相关制作边界在开发阶段就必须进入分集地图，不能等到分镜再发现。具体做法：
 
 - 把孩子必须在场的场次**集中**，不要均匀撒在每一集；
 - 高情绪场次尽量让孩子承担**动作**而不是长台词与崩溃表演；

package/lib/drama/skills/short-drama-develop/references/genre-cards//344/273/231/344/276/240/344/277/256/347/234/237.md

@@ -14,7 +14,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 压力来源与冲突发动机
 
-力量要花钱：寿元、根基、心魔、反噬、材料稀缺。等级制度决定谁能拿到资源；承诺与因果具有约束力，说出去的话追得回来；对手同样在修炼，差距会自己变化。发动机：想要的东西被规则挡在外面 + 突破规则要付看得见的代价 + 有人正在用同样的规则追上来。
+力量的成本可以落在寿元、根基、心魔、反噬或稀缺材料上。等级制度决定谁能拿到资源；承诺与因果具有约束力，说出去的话追得回来；对手同样在修炼，差距会自己变化。发动机：想要的东西被规则挡在外面 + 突破规则要付看得见的代价 + 有人正在用同样的规则追上来。
 
 ## 人物策略与信息权限
 
@@ -40,7 +40,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 制作难点
 
-特效是本题材最大的成本黑洞。把"力量差"更多落到可复用的画面语言上：位置、界线、持物、损伤状态、旁人退让的距离，而不是每集新增法术形态。境界若绑定造型、发色或衣饰，台阶数必须在开发阶段定死。飞行、群战、天地异象做成少数几次高价值场面，其余用余波（碎裂的地面、被吹开的门、旁人的伤）承载。法器与丹药要按资产管理版本与消耗。
+特效是本题材的主要成本项。把"力量差"更多落到可复用的画面语言上：位置、界线、持物、损伤状态、旁人退让的距离，而不是每集新增法术形态。境界若绑定造型、发色或衣饰，变化层级与所需资产数量要在开发阶段规划清楚。飞行、群战、天地异象做成少数几次高价值场面，其余用余波（碎裂的地面、被吹开的门、旁人的伤）承载。法器与丹药要按资产管理版本与消耗。
 
 ## 禁止漂移
 

package/lib/drama/skills/short-drama-develop/references/genre-cards//345/212/250/344/275/234/344/273/273/345/212/241.md

@@ -40,7 +40,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 制作难点
 
-动作量是短剧里最贵的东西。把力学阶段拆清楚：一个镜头只承担一个明确的起止状态，不要一镜塞进多个阶段。优先用"结果与损耗"承载强度——喘息、伤口、拖行痕迹、掉在地上的工具——而不是靠出手次数。夜戏、车戏、群体追逐是成本峰值，尽量集中在少数几集，其余用余波承接。伤势、持物、人数必须逐场记录，跨集不能自愈。空间要在开发阶段定好轴线与出入口，否则分镜阶段会反复返工。
+复杂动作会显著增加制作负担。把力学阶段拆清楚：一个镜头只承担一个明确的起止状态，不要一镜塞进多个阶段。优先用"结果与损耗"承载强度——喘息、伤口、拖行痕迹、掉在地上的工具——而不是靠出手次数。夜戏、车戏、群体追逐是成本峰值，尽量集中在少数几集，其余用余波承接。伤势、持物、人数必须逐场记录，跨集不能自愈。开发阶段明确出入口与行动路线，分镜阶段再据此确定拍摄轴线，减少返工。
 
 ## 禁止漂移
 

package/lib/drama/skills/short-drama-develop/references/genre-cards//345/217/244/350/243/205/346/235/203/350/260/213.md

@@ -10,7 +10,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 题材核心与观众为什么看
 
-观众看的是**在一套所有人都承认的规矩里，用规矩本身改变谁能决定事**。位分、名分、程序、人证物证是这个世界的货币，主角的每一次胜利都必须换成规矩认得的形式才算数。看点在于"她说的话现在有人必须听"这一格的移动，而不是辞藻的华丽程度。
+观众看的是**在一套所有人都承认的规矩里，用规矩本身改变谁能决定事**。位分、名分、程序、人证物证是这个世界的货币，主角的每一次胜利都必须换成规矩认得的形式才算数。看点在于"她说的话现在有人必须听"所体现的权力变化。
 
 ## 压力来源与冲突发动机
 
@@ -40,7 +40,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 制作难点
 
-古装是资产最贵的题材之一：服饰层级、发式、场景朝向都要成体系，一旦开场立错就会全剧返工。用"少而准"承载等级——一件配饰、一个座次、一条界线，胜过大殿群像。群戏尽量分区拍摄，避免大量群演同框；一次公开场合尽量承载多项状态变化。文书上的字若决定结果，必须在开发阶段就决定它是清楚可读、只保留图形，还是以念白承担。夜间灯下的戏对光源连续性要求高，要提前记录。
+古装对服饰和场景资产的要求较高：服饰层级、发式、场景朝向都要成体系，一旦开场立错就会全剧返工。用"少而准"承载等级——一件配饰、一个座次、一条界线，胜过大殿群像。群戏尽量分区拍摄，避免大量群演同框；一次公开场合尽量承载多项状态变化。文书上的字若决定结果，必须在开发阶段就决定它是清楚可读、只保留图形，还是以念白承担。夜间灯下的戏对光源连续性要求高，要提前记录。
 
 ## 禁止漂移
 

package/lib/drama/skills/short-drama-develop/references/genre-cards//345/244/215/344/273/207/346/211/223/350/204/270.md

@@ -40,7 +40,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 制作难点
 
-公开场合（宴会、股东会、听证、颁奖）是成本峰值：群演、统一造型、大空间同时到位。可用"半公开小场"承担同样的见证功能——走廊、电梯口、地库、玻璃隔断外的工位区——保留目击者而大幅降本。证据类道具要跨集复用并保持版本可辨：同一份文件的原件、复印件、被涂改件必须能在画面上区分。地位变化常带造型与配饰台阶，台阶数要在开发阶段定死，否则资产量会失控。闪回会新增旧场景与旧造型；能由当下的一件物件承担的，就不要新建场景。
+公开场合（宴会、股东会、听证、颁奖）是成本峰值：群演、统一造型、大空间同时到位。可用"半公开小场"承担同样的见证功能——走廊、电梯口、地库、玻璃隔断外的工位区——保留目击者而大幅降本。证据类道具要跨集复用并保持版本可辨：同一份文件的原件、复印件、被涂改件必须能在画面上区分。地位变化常带来造型与配饰变化，需要在开发阶段规划其层级与所需资产数量。闪回会新增旧场景与旧造型；能由当下的一件物件承担的，就不要新建场景。
 
 ## 禁止漂移
 

package/lib/drama/skills/short-drama-develop/references/genre-cards//345/256/266/345/272/255/345/205/263/347/263/273.md

@@ -40,7 +40,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 制作难点
 
-家庭戏是场景成本最低、表演与调度要求最高的题材。少数几个日常空间反复使用，靠时段、餐桌上的人数、门的开合承载变化。最大的风险是退化成室内长对话——开发阶段就要给每一场安排一个可见的物件动作（分药、添饭、翻账本、收行李）。借条、截图、录音这类证据道具要决定可读性与版本；不能让"大家都看见了"建立在看不清的画面上。
+家庭戏可以复用日常场景，制作难点更多落在表演与调度上。少数几个日常空间反复使用，靠时段、餐桌上的人数、门的开合承载变化。最大的风险是退化成室内长对话——开发阶段就要给每一场安排一个可见的物件动作（分药、添饭、翻账本、收行李）。借条、截图、录音这类证据道具要决定可读性与版本；不能让"大家都看见了"建立在看不清的画面上。
 
 ## 禁止漂移
 

package/lib/drama/skills/short-drama-develop/references/genre-cards//346/202/254/347/226/221/350/247/204/345/210/231.md

@@ -18,7 +18,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 人物策略与信息权限
 
-策略是一条链：观察—试探—记录—复用。信息权限必须严格划分——谁亲眼看见，谁只是听说，谁在撒谎，谁的记忆已经不可靠。懂行的人不能一次讲透规则，他也只有半张地图。观众可以比人物多知道一条（门后有人）或少知道一条（他为什么坚持不进那扇门），选定后不要中途换。
+策略是一条链：观察—试探—记录—复用。信息权限必须严格划分——谁亲眼看见，谁只是听说，谁在撒谎，谁的记忆已经不可靠。懂行的人不能一次讲透规则，他也只有半张地图。观众可以比人物多知道一条（门后有人）或少知道一条（他为什么坚持不进那扇门）；知情差的变化要有可追溯的信息释放。
 
 ## 观众回报与情绪落点