@oh-story/dsh 0.1.9 → 0.1.11

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

@@ -56,8 +56,9 @@
 4. 本集可以先完成一个局部行动，而不是只负责介绍世界；
 5. 切得更早会变成准备工作，切得更晚会失去关键选择。
 
-**`craft_default · STY-11`**：先建立与当前冲突有关的前史储备，再从旧策略开始付出
-代价的时刻切入。只释放本场行动需要的证据，其余继续留在储备中。
+**`craft_default · STY-11`**：先建立与当前冲突有关的前史储备，再从压力已经启动的时刻切入；
+旧策略开始付出代价的时刻是一个候选，第 1 集还要与收益入口和冷开比较（见
+[首集入口](episode-design.md#44-首集入口)）。只释放本场行动需要的证据，其余继续留在储备中。
 
 开场安静或激烈都是 `taste_option`。钩子不是音量，而是观众能察觉的未闭合因果：
 一个人为何提前锁门、一个熟人为何不用旧称呼、一个日常物件为何出现在错误位置。

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

@@ -43,14 +43,15 @@
 不要用“加一句风格前缀”处理形态差异。前缀只改变检索标签；形态改变的是**必须出现和
 可以省略的字段**，只有后者会被执行，也只有后者能被审查。
 
-本阶段要向形态决定问三件事，答案写进创作简报，不写进剧本：
+本阶段要向形态决定问四件事，答案写进创作简报，不写进剧本：
 
 - **叙事职责**：这种形态要帮观众更快看懂什么、感到什么——不能只写“高级”“电影感”。
 - **运动预算**：哪些段落必须全动作，哪些可以靠保持姿态、局部循环、视差或剪辑完成。
   这直接决定分集地图里哪些场面写得起、哪些要换写法。
 - **未决试验**：哪些形态能力还没验证过，需要先做小样。
+- **节奏起点**：这种形态的项目节奏档案从哪组默认值起步（`STY-26`）。
 
-本阶段新增：叙事职责、形态假设、运动预算与未决试验。不产出形、材质、光或镜头层字段。
+本阶段新增：叙事职责、形态假设、运动预算、未决试验与节奏档案候选。不产出形、材质、光或镜头层字段。
 
 ## 本阶段规则
 
@@ -63,12 +64,12 @@
 | STY-03 | reviewed_invariant | A beat/episode escalation must change a story state rather than repeat the same pressure louder. |
 | STY-04 | craft_default | Enter with pressure active and deliver part of the promised payoff before the outgoing hook. |
 | STY-05 | structural_invariant | Incoming/setup/payoff references resolve to known records or are explicitly unresolved. |
-| STY-06 | taste_option | Hook, arc shape, episode count, and climax position follow the creator's format. |
-| STY-07 | reviewed_invariant | Character/scene merges preserve dramatic function, knowledge permissions, relationship position, and causal bridges. |
+| STY-06 | taste_option | Hook form, arc shape, episode count, and climax position follow the creator's format; how many seconds before the first hook and between emotional beats comes from the accepted rhythm profile, not from this rule. |
+| STY-07 | reviewed_invariant | Every adaptation treatment—merge, carrier change, compression, reordering, or addition—preserves each core source character's stance toward the protagonist and way of acting, the core relationships, and the main line, and contradicts no source fact, unless the creator has accepted that change; a proposed change of stance or relationship keeps its actual disposition, names the change in `lost_or_changed`, and stays at `creator_acceptance.status` `pending` until then. Character/scene merges also preserve dramatic function, knowledge permissions, relationship position, and causal bridges. |
 | STY-08 | craft_default | Translate exposition through consequential behavior, evidence, spatial pressure, or dialogue strategy before adding neutral explanation. |
 | STY-09 | reviewed_invariant | A reveal/reversal grows from established facts and changes a plan, explanation, relationship, or costly choice. |
 | STY-10 | craft_default | Establish the recurring-payoff promise once the opening pressure makes it legible; an opening may imply, delay, or state it according to genre and creator intent. Plan each outgoing hook from the episode's local result rather than repeating a type by quota. |
-| STY-11 | craft_default | Build only the prior-world reservoir needed to predict present choices, then enter where an established strategy begins to create visible cost. |
+| STY-11 | craft_default | Build only the prior-world reservoir needed to predict present choices, then enter where pressure is already active; the moment an established strategy begins to create visible cost is one candidate, weighed for the first episode against the payoff and cold-open entries of STY-25. |
 | STY-12 | reviewed_invariant | Claimed character progression cites a pressure test, choice or retreat, local result, cost, and changed visible strategy. It is recorded once per character in the story engine, not restated in every episode record; the episode carries only the local result and the outgoing pressure it produced. |
 | STY-13 | reviewed_invariant | Each episode produces a local dramatic result before its outgoing hook; serialization cannot rely only on pausing an unfinished action. |
 | STY-14 | craft_default | Maintain compact serial memory for character strategy/state, relationships, information permissions, setup debt, rhythm, and exact handoff. |
@@ -79,9 +80,15 @@
 | STY-19 | craft_default | For a multi-episode source, the Agent chooses each batch from this file's measured episode spans, semantic complexity, and available context, then reads only the current slices and compact accepted handoff; no fixed episode quota substitutes for that judgment. |
 | STY-20 | craft_default | Name each unit's repeating mechanism, the payoff the audience can expect from every run of it, and the condition under which the loop ends; the first run demonstrates the mechanism in full so later runs pay off on recognition, and each further run changes the opponent's knowledge, the execution difficulty, the mechanism's scope, who is now aware, or which retreat is closed. |
 | STY-21 | craft_default | Retire a loop deliberately—close it, remake one of its premises, or hand it to another character—before opening the next one, and carry the stake, deadline, and exit cost forward instead of rebuilding urgency from zero; a new loop opened alongside an unsettled one weakens both. |
-| STY-22 | craft_default | When returning to a long source for detail while writing downstream, retrieve with an event anchor—character plus place/object plus the current action or conflict—rather than a recurring concept term; read back the matched span instead of writing from the search summary; and before use, check the excerpt's knowledge state against the episode's entry state, treating anything ahead of it as reference only. Recall fills in detail for an accepted contract and never adds plot. |
-| STY-23 | reviewed_invariant | A source fact the brief registers as unchangeable is either realized on screen inside the episodes this round covers—named in the episode record and present in that episode's screenplay—or explicitly deferred to a named episode. A visible carrier an episode record declares must actually appear in that episode's screenplay; a carrier that only works as a comparison needs both of its halves staged. Registering a fact is not paying it off. The suite runs no mechanical check for this; the reviewer cites the brief and the episode record against the screenplay. |
+| STY-22 | craft_default | When returning to a long source for detail while writing downstream, retrieve with an event anchor—character plus place/object plus the current action or conflict—rather than a recurring concept term; read back the matched span instead of writing from the search summary; and before use, check the excerpt's knowledge state against the episode's entry state, treating anything ahead of it as reference only. Recall fills in detail for an accepted contract; pulling a later source beat forward is legitimate adaptation, done as a `move_earlier` or `cold_open` revision of the episode map rather than while writing an episode. |
+| STY-23 | reviewed_invariant | A source fact the brief registers as unchangeable is either realized on screen inside the episodes this round covers—named in the episode record and present in that episode's screenplay—or explicitly deferred to a named episode. A visible carrier an episode record declares must actually appear in that episode's screenplay; a carrier that only works as a comparison needs both of its halves staged. Registering a fact is not paying it off. World-setting facts in particular may be deferred to the episode where they first change a choice; the first episode owes only the rules its own conflict uses. The suite runs no mechanical check for this; the reviewer cites the brief and the episode record against the screenplay. |
 | STY-24 | reviewed_invariant | Each episode's directional turn and its payoff inside that episode name one concrete visible action -- who did what -- rather than only the function or state change it achieves; an opposing force's leverage is likewise written as something it has done or will do. The suite runs no mechanical check; the reviewer cites the function against the visible action that carries it, and a function with no such action is the defect. It does not require a full scene. |
+| STY-25 | craft_default | Choose the first episode's entry from at least three candidates, one of which moves a later climax forward as a cold open. Score every candidate on the same two counts: the single image the viewer sees in the opening frame and the question it raises on its own, without reading on-screen text or knowing who anyone is; and the episode's payoff. Prefer an entry whose opening image is itself a hook, with a strong payoff, that lets the episode establish the protagonist's identity, crisis and goal before it ends, and state the big goal early and concretely enough to check. |
+| STY-26 | craft_default | Propose a project rhythm profile (`creator_authority.rhythm_profile`) from the production form, starting from the per-form defaults in episode-design, for the creator to accept or edit. The defaults are starting points, never a suite-level threshold; later stages check only arithmetic against an accepted profile, and a missing or unaccepted profile means nothing is checked. |
+| STY-27 | craft_default | When the creator declares paywall episodes, place each before an undelivered payoff and stop one beat before the reveal, with a line hook or an image hook pointing at what the audience already awaits; the episode still delivers its own local result first. Episode numbers are the creator's and the suite supplies no default position; common ranges are offered as examples only when the creator has declared paywalls and asks for placement. |
+| STY-28 | craft_default | Compress an adaptation by keeping the source's hottest plot points first, then cutting subplots and merging duplicate-function characters; episode count follows the payoff distribution rather than one chapter per episode. |
+| STY-29 | reviewed_invariant | An adaptation mapping marked `move_earlier` or `cold_open` states the setup it depends on and where and through which carrier that setup appears first, or how the viewer is oriented in time, and what happens at the beat's original position. The reviewer checks the mapping against the episode record and screenplay; a moved beat that lands before the audience has the facts it needs is the defect. |
+| STY-30 | craft_default | Material the source does not contain—a new character, an invented scene, a new or replaced opponent—is registered as its own `add` mapping stating the function it serves, why existing source characters and events cannot carry that function, and which source facts were checked against it, and it is listed in the brief for the creator to confirm. Opposition an episode needs is drawn first from source characters and what they actually do; where the source has none, the rhythm-profile deviation is reported instead of hardening an ally or inventing an opponent. |
 
 规则分级由高到低：`structural_invariant`（结构缺陷，阻断）、
 `reviewed_invariant`（需证据判断）、`craft_default`（常用做法，可覆盖）、

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

@@ -74,8 +74,8 @@
 
 ### 回报要先有舞台，再有能力
 
-观众期待的不是"主角获得了什么"，而是"获得之后，那些人会怎样"。这决定了铺垫顺序：
-**先建立回报会被花掉的场合，再让主角拿到能力**。
+观众期待的不是"主角获得了什么"，而是"获得之后，那些人会怎样"。在关系、家庭、复仇这类
+靠积累兑现的题材里，这决定了铺垫顺序：**先建立回报会被花掉的场合，再让主角拿到能力**。
 
 顺序颠倒的典型症状是能力先到位，然后临时找一个人来被打脸——这一段无论写得多热闹，
 观众都没有攒下期待，因为在能力出现之前，他们并不知道该盼什么。
@@ -83,8 +83,12 @@
 可用的检查：在主角取得关键优势之前，观众是否已经认得**具体的人、具体的场合、具体的
 那句话**？三样里至少要有一样是先立起来的。
 
+系统流、重生穿越、逆袭这类爽文不同：观众为奖励本身而来，奖励可以先到，被打脸的人和场合
+可以在同一场里立起来。这时要保的不是先后顺序，而是对手的压迫到位，写法见对应的
+[题材卡](genre-cards.md)。
+
 **`craft_default`**：让能力、证据或身份的兑现落在此前已经建立的对象与场合上；确实需要
-新对象时，先给它一段独立的建立，不与兑现同场发生。
+新对象时，先给它一段独立的建立，不与兑现同场发生。爽文题材的建立与兑现可以同场。
 
 ### 承诺的压力测试
 

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

@@ -1,6 +1,6 @@
 ---
 name: short-drama-edit
-description: 把已经生产出来的逐镜素材按分镜装配成短剧成片：定每镜入出点、镜序、台词完整性、字幕、响度与交付规格，写成 `剧集/<EP>/剪辑单.md` 并渲染出成片。用户说“把这些镜头剪成片”“做成片/装配/套剪”“定入出点”“加字幕”“统一响度”“成片太长/太碎”“导出可继续精修的工程”时使用；不生成新素材，不改剧本、分镜或视频提示词的语义。
+description: 将已生成的短剧镜头剪成成片，记录入出点、镜序、声音、字幕与交付规格。用于套剪、加字幕、统一响度、调整节奏或导出精修素材；需要补素材或修改故事时转回对应创作阶段。
 license: MIT
 ---
 
@@ -9,9 +9,7 @@ license: MIT
 把 `剧集/<EP>/制作成果/` 里的逐镜素材装配成一条成片，取舍写进 `剧集/<EP>/剪辑单.md`。
 每段使用二级标题 `## CUT-...`，各自绑定一个 `MOTION-...` 和一个真实媒体文件。
 
-本阶段是套件里唯一同时看得见**成片**和**创作意图**的位置。上游每一份文档描述的都是「这一镜
-应该是什么」；只有到这里，才第一次能回答「生成出来的这一段，哪一部分真的能用」。这两件事经常
-不一致，而处理这个不一致正是剪辑的工作，不是缺陷。
+根据实际素材选择可用片段，按剧本与分镜核对叙事。素材与意图不一致时，记录取舍和缺口。
 
 ## Quick Start
 
@@ -24,12 +22,15 @@ license: MIT
 进入条件是**素材已经存在且可读**：`剧集/<EP>/制作成果/` 里有本次要用的视频文件。
 提示词写完、job 确认过、adapter 返回成功，都不等于素材可用；本阶段只认当前能打开的文件字节。
 
-素材不全时不要等齐。已有素材能构成一段连续可看的内容就可以先剪，把缺口写进「未采用镜头」并
-说明它缺的是文件还是质量。剪一版看得见的东西，比拿着完整清单空等更能暴露上游问题。
+素材不全时可以先剪已有连续段落；用户要求完整成片时，将这一版标为片段并列出缺口。
+在「未采用镜头」说明缺文件、质量不可用或叙事取舍。
 
 `剧集/<EP>/分镜.md` 与 `视频提示词.md` 是镜序和职责的来源。剪辑可以**取舍**它们，不能**改写**
 它们：删一镜、缩一镜、换顺序都属于本阶段；改台词、改镜头职责、改起终状态要回上游发修订请求。
 
+内置渲染直接拼接编码后的分段，输入素材的画幅与帧率须一致。`check` 在可探测媒体时核对；
+不同规格先通过外部工具按交付要求统一，保留构图并记录裁切或留边，再更新剪辑单的路径与时间。
+
 渲染与测量需要 `ffmpeg` / `ffprobe` 在 PATH 上。没有时 `edit_tool.py` 直接失败并说明，
 不用别的手段近似，也不把「没测」写成「通过」。
 
@@ -38,19 +39,18 @@ license: MIT
 1. **逐段看完整素材，先标可用带，再谈剪辑。** 每个文件从头到尾看一遍，写下它实际能用的时间
    区间，以及区间之外发生了什么（起势静止、结尾漂移、发白、动作回弹、多余的重复表演）。
    这一步的产出是事实，不是决定。做法见 [生成素材的可用带](references/generated-footage.md)。
-2. **有台词的镜先按发声定边界。** 台词完整性优先于画面取舍：先确定这句话从哪一帧开始出声、
-   哪一帧收尾，再在这个约束内选画面入出点。切在字中间是结构缺陷，不是节奏选择。
-3. **在可用带内选叙事入出点。** 入点取动作已经在进行中的那一帧，出点取信息完成之后、缺陷
+2. **有台词的镜先定位发声区间。** 保留完整字音和所需停顿。内置工具同步切画面与声音；
+   需要在连续对白上换画面时，使用外部剪辑工具分开处理。
+3. **在可用区间内选叙事入出点。** 按动作、反应或停顿的需要选择入点，出点取信息完成之后、缺陷
    开始之前。逐段写清入点理由和出点理由。做法见 [入出点与镜序](references/cut-craft.md)。
-4. **排镜序并检查相邻关系。** 相邻两段不同时具备同景别、同机位、同运动方向；重复承担同一
-   信息的段落删掉一段，而不是两段各留一半。
-5. **对一遍相邻段的画面。** 逐镜生成的素材会漂移：同一个人、同一张桌子的两条，
-   回来可能差一档曝光、半步白平衡。差得看得出来时，在那一段写一行 `画面`。
-   做法见 [接镜与色彩一致性](references/generated-footage.md#接镜与色彩一致性)。
-6. **处理声音接缝与响度。** 逐镜生成的素材各自带着自己的环境声或音乐，直接拼接会在每个剪辑
-   点留下音床硬切。做法见 [声音、字幕与音乐](references/sound-and-subtitles.md)。
-7. **写字幕。** 字幕的每一个字都取自 `剧本.md` 的台词原文，不取自转写结果；标点可按字幕惯例调整，
-   字不能改。转写只用来定位时间。
+4. **排镜序并检查相邻关系。** 检查动作、空间、揭示与声音是否连贯；重复信息没有新增作用时再删。
+5. **比较相邻段的画面。** render 会在同一场景内自动接镜；按同场景、同光态比较可比区域，
+   自动接镜不够或不该动的段写 `画面`。做法见 [接镜与色彩一致性](references/generated-footage.md#接镜与色彩一致性)。
+6. **处理声音接缝与响度。** 拼接后回听；需要混音时通过外部工具执行并记录。
+   做法见 [声音、字幕与音乐](references/sound-and-subtitles.md)。
+7. **写字幕、画面文字与音效。** 字幕的每一个字都取自 `剧本.md` 的台词原文，不取自转写结果；
+   标点照抄剧本，字不能改。转写只用来定位时间。画面留白给后期的 `[画面文字]` 写成 `画面文字` 行，
+   需要落在画面文字出现时的提示音写成 `音效` 行。
 8. **写出 `剪辑单.md`，再渲染。** 先有文档后有成片：文档是可审查、可修订、可复现的那一份，
    成片是它的产物。
 9. **按可测项验收成片，再交付。** 见 [交付与验收](references/delivery-verify.md)。
@@ -58,7 +58,7 @@ license: MIT
 ## 剪辑单要求
 
 - 正文开头写交付规格：`成片目标时长`、`画幅与帧率`、`交付响度`、`字幕`。目标时长是意图，
-  实际时长可以不等于它；差多少、为什么，写在末尾报告里，不靠删内容硬凑。
+  实际时长与目标的差写在报告里。用户明确要求固定时长时，应满足要求或报告缺少的素材。
 - 每段一个 `## CUT-<EP>-<序号> · <中文名称>`，块内逐行写：
 
   - `- 来源：<MOTION-...> · <项目相对路径>`——`MOTION-...` 必须是 `视频提示词.md` 里真实存在
@@ -66,18 +66,36 @@ license: MIT
   - `- 入点：<秒>` / `- 出点：<秒>` / `- 时长：<秒>`——三者必须自洽，`出点 - 入点 == 时长`。
     全部用秒，保留两位小数，不写时间码，不写帧号。
   - `- 取舍：入点=<理由>；出点=<理由>`——理由写画面上发生了什么，不写「节奏需要」。
-    这一行是本阶段唯一的创作记录；它解释的是为什么丢掉了没被选中的那些帧。
-  - `- 声音：<本段声音怎么处理>`——保留原声、压低、静音、交叉淡入、接住音乐落点，逐段说清。
-  - `- 画面：<接镜校正>` 或 `- 画面：无`——只在这一段与相邻段明显对不上时写，
-    格式是「亮度 <数>」「饱和 <数>」「色温 <数>」三项的任意组合，用 `；` 分隔。
-    详见 [接镜与色彩一致性](references/generated-footage.md#接镜与色彩一致性)。
+    理由应能对应实际素材与本镜叙事需要。
+  - `- 声音：<本段声音怎么处理>`——记录保留原声或外部处理。此行不驱动内置 render 的混音。
+  - `- 画面：<接镜校正>`、`- 画面：无` 或 `- 画面：不校`——校正是「亮度 <数>」「饱和 <数>」「色温 <数>」
+    三项的任意组合，用 `；` 分隔，写了就替代这一段的自动接镜；`无` 表示不另写校正；`不校` 表示连自动接镜
+    也不做。详见 [接镜与色彩一致性](references/generated-footage.md#接镜与色彩一致性)。
   - `- 字幕：<逐字台词原文>` 或 `- 字幕：无`。本段有多句台词时改用编号写法，
-    每句自带时间：`- 字幕 1：0.20-1.50 就是什么`、`- 字幕 2：2.30-4.30 就是少了点东西`……
-    编号从 1 连续，时间不得重叠。**一镜不等于一句**——一次三个来回的对话是一个过肩镜头，
-    只写一条字幕会让另外两句在成片上无声地消失。
+    每句自带时间：`- 字幕 1：0.20-1.50 请进`、`- 字幕 2：2.30-4.30 门没有锁`。
+    编号从 1 连续，时间相对本 CUT 入点，且不得重叠。句末可加 `（重点：<词>｜<词>）`，
+    这些词须出现在本句里，烧录时标黄。字色按 `剧本.md` 里这句的来源决定：对白白色，
+    `[VO] 系统：` 青色，其他 `[VO]` 浅青，剪辑单里不另写。
+  - `- 画面文字 N：<起>-<止> <样式> <项>｜<项>…`——视频模型写不对字，系统面板、倒计时、屏幕上的
+    粉丝数在画面里留白，由 render 叠上去。每一项都要能在 `剧本.md` 的 `[画面文字]` 行里找到。
+    单条可不编号；编号与时间规则同字幕。三种面板共用画面顶部，角标在右上角，同一位置不得重叠。
+
+    | 样式 | 各项的位置 |
+    |---|---|
+    | `卡片` | 每项一行：第一个词是名称，最后一个词是数值，中间的词是单位（`主号 粉丝 2｜小号 1`） |
+    | `系统面板` | 第一项是状态行，逐字打出；其余是奖励行 |
+    | `任务面板` | 标题、目标（逐字打出）；其后写成 `<数> / <数>` 的一项是进度，其余是奖励标签 |
+    | `角标` | 各项连成一行标签 |
+
+    奖励可在项末写稀有度 `（传说）` `（史诗）` `（稀有）`，不写按稀有；稀有度不是文字，不参与核对。
+    `任务面板` 和 `角标` 末尾可加 `（倒计时：<秒>）`，显示成 `4天 23:59:58` 并逐秒走动；
+    `（倒计时：接续）` 接着成片里上一个倒计时走。相邻两段写同一条角标且首尾相接时，
+    成片里是同一个角标，切镜时不重新入场。面板自带的 `【系统提示】` `【新任务】` `进度` 属于样式，不写进剪辑单。
+  - `- 音效 N：<起>-<止> <项目相对路径>（增益：<dB>）`——从声音文件开头取 `止 - 起` 秒，
+    混进本段该时刻的原声；增益可省，范围 -40 到 +6。单条可不编号。
 - 素材里没有被采用的镜头，在正文开头写一行 `- 未采用镜头：<MOTION-...>（理由：……）`，
   多项用 `；` 连接。理由区分两类：**文件缺失**（还没生产 / 生产失败）和**质量不可用**
-  （生成结果不能用）。两者在文档里长得一样，但一个要回生产、一个要回上游改提示词。
+  （生成结果不能用），也可说明叙事取舍。补素材前先判断需要重出还是修订上游。
 - 同一个 `MOTION-...` 可以拆成多个 `CUT-...`（同一段素材的两处分别使用），也可以整段不用。
   不能凭空出现没有素材来源的 `CUT-...`。
 - 一段素材被用两次时，两个 `CUT-...` 的区间不得重叠：同一批帧在成片里出现两次是重复镜头，
@@ -89,11 +107,10 @@ license: MIT
   回 `$short-drama-video-prompts` 或 `$short-drama-image-prompts`。
 - **不改上游语义。** 剪辑单可以让某句台词不出现在成片里（整镜未采用），不能改这句台词是什么。
   发现剧本层面的问题就点名报告，交回 `$short-drama-write`。
-- **不做解说旁白。** 短剧成片靠人物对白和画面推进，不加第三人称叙述音轨。需要解说式成片是
-  另一种产品形态，不在本套件的目标里。
+- **沿用剧本的声音设计。** 保留已有对白、VO 和 OS，不自行增加解说；需要新增叙述时回写作阶段。
 - **不把技术成功写成质量结论。** 渲染完成、时长对上、文件存在，都不是「这条片子能看」。
   成片质量的判断交给 `$short-drama-review`，或交给创作者本人。
-- **不替创作者决定要不要再剪一版。** 报告当前成片的可测事实和仍然存在的取舍选项，让创作者选。
+- **按已授权目标完成。** 继续修复影响交付的问题；新增创作方向或补素材需求交给创作者决定。
 
 ## 命令
 
@@ -105,24 +122,28 @@ python3 <本技能目录>/scripts/edit_tool.py render <剧集/EP001> --project-r
 python3 <本技能目录>/scripts/edit_tool.py verify <剧集/EP001> --project-root <project>
 ```
 
-`check` 只核对不渲染：素材是否比剪辑单新（重出之后字幕时间必须重测）、区间自洽、`MOTION-...` 解析、文件存在、区间不越过素材时长、
-同源区间不重叠、字幕文字能在 `剧本.md` 里找到。其中「区间不越过素材时长」需要 `ffprobe`，
-没有时这一项报「未测」并说明原因，不静默跳过。`render` 按剪辑单切段、拼接、烧字幕、统一响度，
-输出 `剧集/<EP>/制作成果/成片/`。`verify` 只测量已经渲染出来的成片并回报数字，不改文件、
-不给质量结论。
+`check` 只核对不渲染：素材是否比剪辑单新（重出之后字幕、画面文字与音效时间必须重测）、区间自洽、
+`MOTION-...` 解析、文件存在、区间不越过素材时长、同源区间不重叠、字幕文字能在 `剧本.md` 里找到、
+画面文字能在 `[画面文字]` 行里找到、「接续」之前确有倒计时、音效文件存在且落在本段内。
+其中「区间不越过素材时长」需要 `ffprobe`，没有时这一项报「未测」并说明原因，不静默跳过。
+`render` 按剪辑单切段、同场景自动接镜、拼接、混入音效、烧字幕与画面文字、统一响度，输出 `剧集/<EP>/制作成果/成片/`。
+`verify` 只测量已经渲染出来的成片并回报数字，另列出画面文字与音效在成片里的起止秒、切点亮度变化和疑似坏帧，
+供抽帧和回听；不改文件、不给质量结论。
 
-字幕默认由 ffmpeg 烧录，零依赖，长片也是秒级。`--subtitles remotion` 换成一条排版可调的
+字幕默认由带 libass 的 ffmpeg 烧录。`--subtitles remotion` 换成一条排版可调的
 路线，代价是装一次 Node 依赖，而且叠层要**逐帧过无头浏览器**渲整部成片——慢且吃内存，
-并发默认压在 2（`--remotion-concurrency` 可调，调高前先量本机）。取舍见
-[声音、字幕与音乐](references/sound-and-subtitles.md)，装法见
-[Remotion 字幕叠层](assets/remotion/README.md)。
+并发默认压在 2（`--remotion-concurrency` 可调，调高前先量本机）。画面文字只有 Remotion 一条路线：
+剪辑单里有画面文字时，无论字幕走哪条路线 render 都需要它，没装就报错并给出安装命令；
+走 ffmpeg 的字幕压在画面文字之上。取舍见 [声音、字幕与音乐](references/sound-and-subtitles.md)，
+装法见 [Remotion 叠层](assets/remotion/README.md)。
 
-`render` 会保留每段切好的中间文件。它们是下一轮微调的输入，也是「这一刀到底切在哪」的证据；
-不要在报告里用「重新渲染一次就好」代替给出这些文件。
+`render` 保留切好的中间文件。它只切段、硬拼接、混入 `音效` 行、统一字幕样式、画面文字、
+接镜校正（写明的与同场景自动的）和整片响度，不执行 `声音` 行中的混音方案，也不按交付规格自动缩放或改帧率。
+需要混音、逐镜字幕避让、转场或画幅转换时用外部工具完成并记录，验收实际交付文件。
 
 ## 按需知识
 
-默认只读本 SKILL、当前分镜和要用的素材。遇到对应问题时只打开一份：
+先读本 SKILL、当前分镜、视频提示词和素材；有字幕时读取剧本原文。按需要打开参考资料：
 
 - 阶段边界与规则分级：[阶段契约](references/stage-contract.md)
 - 可用带、生成缺陷与逐镜取舍：[生成素材的可用带](references/generated-footage.md)
@@ -130,7 +151,7 @@ python3 <本技能目录>/scripts/edit_tool.py verify <剧集/EP001> --project-r
 - 声音接缝、字幕与音乐落点：[声音、字幕与音乐](references/sound-and-subtitles.md)
 - 成片可测项与验收：[交付与验收](references/delivery-verify.md)
 - 剪辑单成稿样例：[剪辑单样例](assets/剪辑单.md)
-- 可选的 Remotion 字幕排版：[Remotion 字幕叠层](assets/remotion/README.md)
+- 画面文字样式与可选的 Remotion 字幕排版：[Remotion 叠层](assets/remotion/README.md)
 
 ## 修订
 

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

@@ -1,13 +1,15 @@
-# Remotion 字幕叠层
+# Remotion 叠层
 
-`$short-drama-edit` 的**可选**字幕渲染路线。默认路线是 ffmpeg + libass，零依赖；这一条排版
-更好，但要装 Node 依赖，而且慢得多、吃内存——先看下面的「代价」。
+`$short-drama-edit` 用它画两样东西：剪辑单里的**画面文字**（只有这一条路线），以及**可选的**
+字幕排版（默认字幕路线是 ffmpeg + libass，零依赖）。两者在同一遍里渲进一段透明叠层。
+它要装 Node 依赖，而且慢得多、吃内存——先看下面的「代价」。
 
-## 为什么会有第二条路
+## 为什么走这条路
 
 ASS 的字号是相对 `PlayRes` 的单位，渲染时再缩放一次，这层间接每次都要重推一遍，推错了
 在数字上看不出来（见[声音、字幕与音乐](../../references/sound-and-subtitles.md)）。这里字号、
 描边、行距、安全区、折行都是 CSS，写的是画面像素，改完在 `npx remotion studio` 当场能看。
+面板、发光、逐条入场和逐秒走动的倒计时是版面，不是字幕样式，ASS 画不了。
 
 ## 装一次
 
@@ -18,22 +20,47 @@ ASS 的字号是相对 `PlayRes` 的单位，渲染时再缩放一次，这层
 cd ~/.cache/short-drama-edit/remotion && npm install
 ```
 
-`node_modules` 不进项目也不进本仓库。
+`node_modules` 不进项目也不进本仓库。字体也在这一步装上：`@fontsource/noto-sans-sc`
+（思源黑体，用 700 与 900）和 `@fontsource/jetbrains-mono`（数字，用 800）。升级本技能后
+`package.json` 多了依赖时，render 会点名缺的包并给出同一条命令。
 
 ## 用
 
+剪辑单里有画面文字时，`render` 自动走这一遍。只想换字幕排版时：
+
 ```bash
 python3 <本技能目录>/scripts/edit_tool.py render <剧集/EP001> --project-root <project> --subtitles remotion
 ```
 
-它渲染出一段**透明**的字幕层（VP8 + alpha），再由 ffmpeg 叠到未经改动的画面上。画面本身
-不经过浏览器重绘，所以不多一次画质损失。
+它渲染出一段**透明**的叠层（VP8 + alpha），再由 ffmpeg 叠到未经改动的画面上。画面本身
+不经过浏览器重绘，所以不多一次画质损失；也不在浏览器里解码画面，帧时间不规整的拼接素材在那里
+会解出串进别的镜头画面的坏帧。字幕走 ffmpeg 路线时，这一遍只画画面文字，
+字幕在合成后烧在它上面。
+
+## 画面文字的样式
+
+每种样式是 `src/screen/` 里的一个组件，接收同样的 `{ text }`；颜色、入场、淡出、
+面板位置这些共用的值在 `src/screen/tokens.ts`，系统类面板共用的框与部件在 `src/screen/chrome.tsx`。换一种样式的外观只改它自己的文件，
+不碰剪辑单解析与时间换算。所有尺寸以画面高度的百分之一为单位。
+
+倒计时由帧号直接算出：同一帧每次渲染显示同样的数字。
+
+## 字体
+
+字体随叠层打包，不依赖本机。字体按字符区段拆成许多小文件，浏览器只在排到某段文字时才去取，
+那时这一帧可能已经截走了。所以叠层挂载时先按整部片子要画的字逐个字重调用
+`document.fonts.load`，全部就绪、组件树提交之后才放出第一帧；十秒内没加载完、某个字重没有声明、
+或加载后仍未就绪，渲染直接报错。这个等待按挂载注册并设了上限，不再是模块加载时那次
+`document.fonts.ready`——在带视频的渲染页里，那次等待曾挂住整个渲染直到超时。
+
+画每段字之前再测一次宽：把字体栈分别接在 `serif` 与 `monospace` 两个兜底之前，与只有兜底时的
+宽度相比，两边都一样才算字体没到位，这时同样报错，不悄悄换字体出片。
 
 ## 代价
 
 叠层**逐帧**渲，长度等于整部成片：一分钟竖屏片一千多帧 1080×1920，每帧一次无头浏览器
-截图，没字幕的帧照渲。透明还要求 PNG 抓帧加 VP8 编码，Remotion 的性能文档把这两样都列为
-慢环节。默认路线是一次滤镜的事，这条是分钟级。
+截图，没字的帧照渲。透明还要求 PNG 抓帧加 VP8 编码，Remotion 的性能文档把这两样都列为
+慢环节。默认字幕路线是一次滤镜的事，这条是分钟级。
 
 内存才是会出事的地方。Remotion 默认按 CPU 核数开浏览器实例，每个各持一整帧——10 核 8 GB
 的机器上内存打满，整机停止响应，本套件就这么卡死过一次。所以 `edit_tool.py` 固定传
@@ -47,14 +74,23 @@ cd ~/.cache/short-drama-edit/remotion && npx remotion benchmark
 
 Remotion 个人与小团队免费，超出规模需商业授权，条款以 [remotion.dev](https://www.remotion.dev/)
 为准。本套件是 MIT，不包含也不代理这项授权，也不会替你安装它——缺依赖时只报错并给出命令。
-默认路线不涉及这件事。
+剪辑单里没有画面文字、字幕走默认路线时，不涉及这件事。
+
+思源黑体（Noto Sans SC）与 JetBrains Mono 都是 SIL Open Font License 1.1：可以随成片使用、
+嵌入和再分发，不能单独出售字体文件。许可证文本在各自的 `node_modules/@fontsource/*/LICENSE`。
 
 ## 文件
 
 | 文件 | 作用 |
 |---|---|
-| `src/schema.ts` | 叠层的输入形状：cues、画幅、fps、字号与安全区比例 |
-| `src/Subtitles.tsx` | 排版本身。所有尺寸都是画面高度的比例，同一组数值对 768×1344 和 1080×1920 都成立 |
+| `src/schema.ts` | 叠层的输入形状：字幕（文字、来源、重点词）、画面文字（各项与稀有度）、画幅、fps |
+| `src/Overlay.tsx` | 合成本身：引入字体、等字体就绪，画面文字在下，字幕在上 |
+| `src/Subtitles.tsx` | 字幕排版。所有尺寸都是画面高度的比例，同一组数值对 768×1344 和 1080×1920 都成立 |
+| `src/screen/ScreenText.tsx` | 把每条画面文字放到成片时间上，按样式分派 |
+| `src/screen/tokens.ts` | 字幕与各样式共用的字体、颜色、稀有度色、入场、淡出与位置 |
+| `src/screen/chrome.tsx` | 系统类面板共用的框、角标括号、扫描线、标题行、打字机与奖励行 |
+| `src/screen/Card.tsx` 等 | 每种样式一个组件：卡片、系统面板、任务面板、角标 |
+| `src/rules.mjs` | 不需要浏览器的判断：要加载的字、加载结果是否可用、字体族是否缺失、打字进度、进度条、倒计时读数与脉冲。纯 JavaScript，测试直接用 Node 跑 |
+| `src/font.ts` | 在渲染页里执行上面的字体判断 |
 | `src/Root.tsx` | 合成注册；画幅、帧率、时长由调用方通过 `--props` 传入 |
-| `src/font.ts` | 渲染前等字体就绪，并验证字体族真的存在——装不上时报错，而不是悄悄换一款字体出片 |
 | `remotion.config.ts` | 固定成带 alpha 的输出，叠层必须透明 |

package/lib/drama/skills/short-drama-edit/assets/remotion/package.json

@@ -2,11 +2,13 @@
   "name": "short-drama-subtitles",
   "version": "1.0.0",
   "private": true,
-  "description": "Remotion subtitle layer for short-drama-edit. Renders a transparent overlay from cues.json.",
+  "description": "Remotion overlay for short-drama-edit: subtitles and screen text on transparent frames.",
   "scripts": {
-    "render": "remotion render Subtitles"
+    "render": "remotion render Overlay"
   },
   "dependencies": {
+    "@fontsource/jetbrains-mono": "5.3.0",
+    "@fontsource/noto-sans-sc": "5.3.0",
     "@remotion/cli": "4.0.418",
     "react": "19.0.0",
     "react-dom": "19.0.0",

package/lib/drama/skills/short-drama-edit/assets/remotion/src/Overlay.tsx

@@ -0,0 +1,31 @@
+import React, { useMemo } from "react";
+import { AbsoluteFill } from "remotion";
+// Only the weights drawn: Noto Sans SC 700 and 900, JetBrains Mono 800.
+import "@fontsource/noto-sans-sc/700.css";
+import "@fontsource/noto-sans-sc/900.css";
+import "@fontsource/jetbrains-mono/800.css";
+import { OverlayProps } from "./schema";
+import { useFaces } from "./font";
+import { fontLoadPlan } from "./rules.mjs";
+import { ScreenTextLayer } from "./screen/ScreenText";
+import { Subtitles } from "./Subtitles";
+
+/**
+ * One transparent pass: screen text first, subtitles on top, over empty frames.
+ * ffmpeg composites the result onto the untouched picture.
+ */
+export const Overlay: React.FC<OverlayProps> = (props) => {
+  const plan = useMemo(
+    () => fontLoadPlan(props.cues, props.screenTexts),
+    [props.cues, props.screenTexts],
+  );
+  if (!useFaces(plan)) return null;
+  return (
+    <AbsoluteFill>
+      {props.screenTexts.map((text, index) => (
+        <ScreenTextLayer key={index} text={text} />
+      ))}
+      <Subtitles cues={props.cues} />
+    </AbsoluteFill>
+  );
+};

package/lib/drama/skills/short-drama-edit/assets/remotion/src/Root.tsx

@@ -1,13 +1,13 @@
 import React from "react";
 import { Composition } from "remotion";
-import { Subtitles } from "./Subtitles";
-import { defaultProps, SubtitleProps } from "./schema";
+import { Overlay } from "./Overlay";
+import { defaultProps, OverlayProps } from "./schema";
 
 export const RemotionRoot: React.FC = () => {
   return (
     <Composition
-      id="Subtitles"
-      component={Subtitles}
+      id="Overlay"
+      component={Overlay}
       defaultProps={defaultProps}
       // The caller passes the real frame, fps and length through --props; these
       // stand in only when the composition is opened in the studio by hand.
@@ -15,7 +15,7 @@ export const RemotionRoot: React.FC = () => {
       fps={defaultProps.fps}
       width={defaultProps.width}
       height={defaultProps.height}
-      calculateMetadata={({ props }: { props: SubtitleProps }) => ({
+      calculateMetadata={({ props }: { props: OverlayProps }) => ({
         durationInFrames: Math.max(1, Math.round(props.durationInSeconds * props.fps)),
         fps: props.fps,
         width: props.width,