@cloud411716/fancy-webnovel 1.0.45 → 2.2.0

package/plugins/fancy-story-builder/prompts/03-rhythm-prompt.md

@@ -0,0 +1,504 @@
+# 03 节奏阶段产物契约
+
+> 本文件是节奏阶段的**产物契约**：它定义每个文件长什么样、哪些写法会被判错。
+>
+> **流程由插件驱动**：插件会分批派活，每轮告诉你写哪个文件、哪些章/哪些条目、
+> 写到哪里；插件自己跑校验脚本、判定通过与否，并把判定出来的错误清单回喂给你。
+> 你**不需要**自己调校验脚本，**不要**自己判断"通过没通过"，**不要**输出"已完成"之类的结论。
+>
+> 本阶段依赖骨架 + 血肉两个上游，任一未完成不得启动。
+
+@meta-only
+
+---
+
+<!-- contract:overview -->
+## 你的职责
+
+你只做一件事：**按插件每轮给的指令，把指定的条目写成指定格式的 JSON**。
+
+- 每轮指令会明确给出：要写的文件路径、要写的章号/条目、字段要求。
+- 你把结果**写进指令指定的那个文件**，不要写别的文件，不要改别的文件。
+- 插件会校验你写的内容。如果没过，插件会把错误清单发回给你，让你**只改被点名的那几条**。
+- 写完就停。不要附带解释、不要输出总结、不要宣布完成。
+
+**不要做的事**：
+
+- 不要自己运行校验脚本（插件会跑，跑了也没有意义）。
+- 不要修改 `模板/`、`references/` 下的任何文件。
+- 不要修改 `设定/raw/sources/骨架/`、`设定/raw/sources/血肉/` 下的任何文件（只读上游）。
+- 不要写指令范围之外的文件。
+
+---
+
+<!-- contract:input -->
+## 一、任务输入
+
+> 本节由插件注入，只读，不得修改。
+> 数据源：骨架阶段 `设定/raw/sources/骨架/框架.json` 的 `input_snapshot`（目标章节/目标字数取自同文件的 `capacity`）。
+
+${input_snapshot_block}
+
+**注**：
+
+- 节奏阶段的**实体信息**从骨架 + 血肉的上游产物读（校验脚本实际读 6 个：骨架 `框架.json`/`实体.json`/`层级.json` + 血肉 `角色.json`/`地点.json`/`关键道具.json`），不从任务输入读。
+- **目标章节 T** 和 **目标字数**是节奏阶段的硬约束：章节数、高潮/爽点/伏笔的数量配额都必须对得上。
+- **硬门禁**和**反套路**同样适用于节奏阶段：例如"每 8 至 12 章必须完成一个案件单元闭环"这类硬门禁，直接决定章节切分粒度。
+- 书名 / 题材 / 一句话故事 / 核心冲突只用于确认"读的是同一个项目"以及把握全剧走向。
+
+---
+
+<!-- contract:output-list -->
+## 二、本阶段产出清单
+
+| # | 文件 | 路径 | 顶层键 |
+|---|---|---|---|
+| 1 | 章节规划.json | `设定/raw/sources/节奏/章节规划.json` | `chapters` |
+| 2 | 节奏参数.json | `设定/raw/sources/节奏/节奏参数.json` | 纯对象（无顶层数组） |
+| 3 | 时序映射.json | `设定/raw/sources/节奏/时序映射.json` | 11 个 `*_timeline` 数组 |
+| 4 | 章节细纲.json | `设定/raw/sources/节奏/章节细纲.json` | `outlines` |
+
+**生成顺序（严格按依赖，不可跳）**：章节规划 → 节奏参数 → 时序映射 → 章节细纲。
+
+原因：**时序映射受节奏参数约束**——`main_line_timeline.key_nodes` 的实际章数必须等于 `main_progress_chapter_count`；`branch_timeline` 的实际章数之和必须等于 `branch_chapter_total`。先定参数，再写时序映射，可以**一次填对**。
+
+章节规划与节奏参数**无依赖关系**，可以互换顺序。
+
+**本阶段是唯一允许出现章节号的阶段。**所有章节号集中在 4 个 JSON 中，尤其是 `时序映射.json`。
+
+---
+
+<!-- contract:rules -->
+## 三、核心铁律（6 条，违反任意一条都会校验失败）
+
+1. **章节号必须在 `[1, T]` 内**（`T = target_chapters`）。`RHYTHM_CHAP_RANGE` 会拦截越界。
+
+2. **不得引用不存在的实体 id**。所有 `char_id` / `conflict_id` / `fs_id` / `climax_id` / `pleasure_id` / `main_id` / `branch_id` / `loc_id` / `item_id` / `ending_id` / `volume` 必须存在于骨架或血肉。`RHYTHM_REF_MISSING` 会拦截。
+
+3. **`branch_chapter_total` / `overlap_chapter_count` / `main_progress_chapter_count` 三参数必须联合满足 7 条约束**（见「节奏参数」那一节的步骤 1-7）。`RHYTHM_INFEASIBLE` 会拦截。
+
+4. **节奏参数 `derivations` 的 key 必须是"约束名"**（`branch_chapter_feasible` 等 7 条），不是"参数名"（`branch_chapter_total` 等 3 个）。`RHYTHM_DERIVATION_MISSING` / `RHYTHM_DERIVATION_EXTRA` 会告警（warning，不阻塞）。
+
+5. **钩子数必须 ≥ `ceil(T * rate)`**（如果 `is_minimum` 为 true）。`RHYTHM_HOOK_MIN` 会拦截。
+
+6. **所有引用 id（角色/冲突/伏笔/高潮/爽点/主线/支线/地点/道具/结局）必须来自前两阶段产物**。严禁自创实体或新编号。
+
+---
+
+<!-- contract:refs -->
+## 四、参考文件
+
+### 4.1 必读
+
+- `references/glossary.md` —— 术语、枚举、**章节号字段清单（第六节）**
+- `references/formulas-rhythm.json` —— 共 10 个数据节（1 个 `constraints` + 1 个 `arc_phase_ratio` + 8 个 `*-guides`）；`constraints` 里的 **7 条约束名见第六节**，那里是 `derivations` 的 key 清单
+- 本轮要写的那个文件的模板（`模板/节奏/*.json`）
+
+### 4.2 按本轮文件选读
+
+| 本轮生成文件 | 读 |
+|---|---|
+| 章节规划.json | `references/节奏指导/01-upgrade-rhythm.md` |
+| 时序映射.json | `references/节奏指导/02-arc-rhythm.md`、`references/节奏指导/05-foreshadow-density.md` |
+| 节奏参数.json | `references/节奏指导/04-satisfaction.md`、`references/节奏指导/02-arc-rhythm.md` |
+| 章节细纲.json | `references/节奏指导/03-highpoint-hooks.md`、`references/节奏指导/06-chapter-outline.md` |
+| 全部 | `references/节奏指导/00-index.md` |
+
+${benchmark_refs_block}
+
+### 4.3 规则
+
+- 必读文件不可读时，停止本轮，把原因写进 `设定/raw/sources/节奏/.rhythm-build/备注.md`。
+- 选读文件不可读时，跳过它继续写。
+- **不要整文件读取上游 JSON**（上下文会爆炸）。插件已经把本批要用的 id+name 和相关关系列在指令里了。
+- 需要某个上游实体的完整档案时，用只读查询脚本精确取：
+
+```bash
+node references/upstream-query.js --stage=骨架 --file=实体 --id=FS042
+node references/upstream-query.js --stage=血肉 --file=角色 --id=C001
+```
+
+- 不得声称"已读取"参考文件。
+
+---
+
+<!-- contract:file:章节规划 -->
+## 五、章节规划.json 的字段契约
+
+**顶层数组**：`chapters`　**模板**：`模板/节奏/章节规划模板.json`
+
+**核心要求**：`chapters` 数组必须**覆盖 1..T 的每一章**，每章一行。
+
+| 字段 | 写什么 |
+|---|---|
+| `ch` | 章节号，1..T 连续，不跳号不重复 |
+| `volume` | 卷 id（骨架 `层级.json` 的 `volumes[].id`） |
+| `act` | 该卷内的幕序号（1..该卷幕数） |
+| `scene_focus` | 一句话，描述该章的核心场景 |
+
+**怎么填**：
+
+1. 从骨架读 T 和卷列表
+2. 从 `框架.json` 的 `volume_ratio` 读每卷的章节比例
+3. 按比例分配每卷的章数（容差 ±1 章）
+4. 为每章填 `volume`（从卷列表选）和 `act`（1..卷内幕数，幕数从骨架 `层级.json` 的 acts 数推断）
+5. 为每章填 `scene_focus`
+
+**关键约束**：
+
+- 所有 `ch` 从 1 到 T 连续，不跳号，不重复（`RHYTHM_CHAPTER_DUP` / `RHYTHM_CHAPTER_MISSING`）
+- `volume` 必须是骨架 `层级.json` 中的卷 id（`RHYTHM_REF_MISSING`）
+- `act` 必须在骨架 `层级.json` 的该卷的幕集合中（`RHYTHM_ACT_INVALID`）
+- 每卷的章数与 `volume_ratio` 的容差 ±1 章（`RHYTHM_VOLUME_DIST` warning）
+
+**示例**（T=10，V=1）：
+
+```json
+{
+  "chapters": [
+    { "ch": 1, "volume": "V001", "act": 1, "scene_focus": "灭门当夜" },
+    { "ch": 2, "volume": "V001", "act": 1, "scene_focus": "逃出城" },
+    { "ch": 10, "volume": "V001", "act": 4, "scene_focus": "终局" }
+  ]
+}
+```
+
+---
+
+<!-- contract:file:节奏参数 -->
+## 六、节奏参数.json 的字段契约
+
+**顶层**：纯对象（没有顶层数组）　**模板**：`模板/节奏/节奏参数模板.json`
+
+**这是节奏阶段最关键的文件**。三个参数必须联合满足 `formulas-rhythm.json` 的 `constraints` 节中的 7 条约束。
+
+**必须按以下顺序反推可行区间，不得随便填再试错**：
+
+**步骤 1**：读骨架的 T、BC（`branch_count`）
+
+**步骤 2**：计算 `branch_chapter_total` 的可行区间：
+
+```
+lower = max(BC * 3, floor(T * 0.3))
+upper = min(BC * 30, ceil(T * 0.5))
+```
+
+**必须在 `[lower, upper]` 内选一个值**。如果 `lower > upper`，说明骨架参数矛盾（BC 太大或太小），应回骨架阶段修复，不在节奏阶段硬凑。
+
+**步骤 3**：从 `[lower, upper]` 内选一个值 → `branch_chapter_total`
+
+**步骤 4**：计算 `overlap_chapter_count` 的可行区间：
+
+```
+lower = max(0, branch_chapter_total - T + 1)
+upper = branch_chapter_total
+```
+
+**必须在 `[lower, upper]` 内选一个值**。
+
+**步骤 5**：从区间内选一个值 → `overlap_chapter_count`
+
+**步骤 6**：计算 `main_progress_chapter_count`：
+
+```
+main_progress_chapter_count = T - branch_chapter_total + overlap_chapter_count
+```
+
+**这个值由前两个参数唯一确定，不得手动指定**。
+
+**步骤 7**：验证 7 条约束（`rhythm-validate.js` 会自动检查，所以步骤 2-6 的算法已自动满足全部 7 条）：
+
+- `branch_chapter_feasible`：`branch_chapter_total ∈ [BC*3, BC*30]`
+- `branch_chapter_ratio`：`branch_chapter_total ∈ [floor(T*0.3), ceil(T*0.5)]`
+- `overlap_le_branch`：`overlap <= branch_chapter_total`
+- `overlap_le_main`：`overlap <= main`（由 `branch <= T` 自动满足）
+- `main_progress_ge_1`：`main >= 1`
+- `main_progress_consistency`：`main = T - branch + overlap`
+- `main_progress_le_T`：`main <= T`
+
+**注意**：`overlap` 可等于 `branch_chapter_total`（即所有支线章都是主线关键节点）。这是合法但极端——相当于所有主线都集中在支线区间，节奏上不推荐。脚本不拦截，由你按题材自定。
+
+**步骤 8**：`chapter_hook_rate`：
+
+- `rate`：通常 0.8~1.0（每章都有钩子率），按题材微调
+- `is_minimum`：通常 `true`（钩子数不低于 `ceil(T * rate)`）
+
+**步骤 9**：`derivations`：
+
+- **key 为 `formulas-rhythm.json` 的 `constraints` 节中的 7 条约束名**（不是参数名）：
+
+  - `branch_chapter_feasible`
+  - `branch_chapter_ratio`
+  - `overlap_le_branch`
+  - `overlap_le_main`
+  - `main_progress_ge_1`
+  - `main_progress_consistency`
+  - `main_progress_le_T`
+
+- **value 为一段 `note`**，说明该约束是如何被满足的
+- 示例（T=300, BC=6）：
+
+  ```json
+  "derivations": {
+    "branch_chapter_feasible": "选 120 章，落在 [18, 180] 内",
+    "branch_chapter_ratio": "120 落在 [90, 150] 内",
+    "overlap_le_branch": "overlap=60 <= branch=120",
+    "overlap_le_main": "overlap=60 <= main=240",
+    "main_progress_ge_1": "main=240 >= 1",
+    "main_progress_consistency": "300 - 120 + 60 = 240",
+    "main_progress_le_T": "240 <= 300"
+  }
+  ```
+
+- **不要用参数名作 key**（如 `"branch_chapter_total": "..."`）——会报 `RHYTHM_DERIVATION_EXTRA`（多余 key）和 `RHYTHM_DERIVATION_MISSING`（缺约束名 key）
+
+**如果校验报 `RHYTHM_INFEASIBLE`**，按以下方向调整：
+
+| 失败的约束 | 调整方向 |
+|---|---|
+| `branch_chapter_feasible` | `branch_chapter_total` 不在 `[BC*3, BC*30]`，重算步骤 2 |
+| `branch_chapter_ratio` | `branch_chapter_total` 不在 `[floor(T*0.3), ceil(T*0.5)]`，重算步骤 2 |
+| `overlap_le_branch` | `overlap > branch`，调小 overlap 或调大 branch |
+| `overlap_le_main` | 通常不会失败（自动满足），若失败说明 `branch > T`，检查步骤 3 |
+| `main_progress_ge_1` | `main < 1`，调大 overlap（不要超过 branch） |
+| `main_progress_consistency` | 公式不满足，重算 `main_progress_chapter_count`（不能手动指定） |
+| `main_progress_le_T` | `main > T`，调小 overlap |
+
+---
+
+<!-- contract:file:时序映射 -->
+## 七、时序映射.json 的字段契约
+
+**顶层**：11 个 `*_timeline` 数组　**模板**：`模板/节奏/时序映射模板.json`
+
+**核心要求**：11 类时序映射必须**引用骨架/血肉中真实存在的 id**，且**布局严格匹配节奏参数**。
+
+**步骤 1：character_timeline**
+
+为每个角色填：
+
+- `char_id`：从骨架取
+- `appear_start` / `appear_end`：出场区间（含）
+- `exit_chapter`：有退场的填（血肉 `角色.json` 的 `exit.type !== "未退场"` 时填），必须在 `[appear_start, appear_end]` 内
+- `arc_stages`：从血肉 `角色.json` 的 `arc_change_descriptions` 取 stage 名，为每个 stage 分配章节号。**章节号必须递增**（`start < turning < midpoint < end`），且必须在 `[appear_start, min(exit_chapter, appear_end)]` 内
+
+**步骤 2：conflict_timeline**
+
+为每个冲突填：
+
+- `conflict_id`：从骨架取
+- `escalation_nodes`：从血肉 `冲突.json` 的 `escalation_path` 取每个节点的 `node_type`，为每个节点分配章节号。**章节号必须递增**（升级路径不允许回退）
+- `resolution_chapter`：`>=` 最后一个升级节点章
+- `info_gaps`：从血肉 `冲突.json` 的 `information_gaps` 取每条 `info_name`，分配 `created` / `resolved`。**`created < resolved`**
+
+**步骤 3：foreshadow_timeline**
+
+为每个伏笔填：
+
+- `fs_id`：从骨架取
+- `buried_chapter` / `recovered_chapter`：**`buried_chapter < recovered_chapter`**
+- 伏笔类型的回收窗口参考（小伏笔跨几章，中伏笔跨十几章，大伏笔跨卷），由血肉指导的方法论决定
+
+**步骤 4：climax_timeline / pleasure_timeline**（id 字段分别是 `climax_id` / `pleasure_id`；`character_timeline[].arc_stages[]` 的阶段名字段是 `stage_name`）
+
+为每个高潮/爽点填 `chapter`。
+
+**步骤 5：hook_timeline**
+
+为每章填一行（至少覆盖 `ceil(T * rate)` 章，如果 `is_minimum`）：
+
+- `ch`：1..T 中的某些章
+- `hook_head`：从 glossary 的 `hook_form_head` 选
+- `hook_tail`：从 glossary 的 `hook_form_tail` 选
+- `hook_strength`：从 glossary 的 `hook_strength` 选
+- **连续 2 章章尾同类会报 warning**，连续 3 章及以上会报 error（高潮期可豁免，在细纲中注明）
+
+**步骤 6：main_line_timeline —— 必须严格匹配节奏参数**
+
+为每条主线填 `key_nodes` 数组：
+
+- **`key_nodes` 的长度必须等于 `main_progress_chapter_count`**（节奏参数的第二个字段）
+- 每个 `chapter` 必须在 `[1, T]` 内
+- **不能有重复章节**（`RHYTHM_NODE_DUP` 检查）
+- `event_ref`：引用某个血肉实体的 `description` 或 `escalation_path` 的节点（自由文本，建议带上下文，如 `"打脸赵天宇（参见 X002 escalation 第 3 节点）"`）
+
+**示例**（T=300, `main_progress_chapter_count = 240`）：
+
+```json
+"main_line_timeline": [{
+  "main_id": "M001",
+  "key_nodes": [
+    { "chapter": 1, "event_ref": "灭门当夜" },
+    { "chapter": 300, "event_ref": "终局对决" }
+  ]
+}]
+```
+
+**共 240 个节点**（不重复章节），`chapter` 值从 1..300 中选 240 个。
+
+**步骤 7：branch_timeline —— 必须严格匹配节奏参数**
+
+为每条支线填：
+
+- `branch_id`：从骨架取
+- `start` / `turning` / `resolution`：**`start <= turning <= resolution`**
+- **所有支线的 `(resolution - start + 1)` 之和必须等于 `branch_chapter_total`**
+- **任意两条支线的区间不能重叠**（`RHYTHM_BRANCH_OVERLAP` 检查）
+- `interweaves`：交织点数组，每个 `chapter` 必须在 `[start, resolution]` 内
+
+**步骤 8：location_timeline / item_timeline**（id 字段分别是 `loc_id` / `item_id`）
+
+为每个地点/道具填 `appear_start` / `appear_end`。
+
+**步骤 9：ending_timeline**
+
+为每个结局填：
+
+- `ending_id`：从骨架取
+- `chapter`：**必须在主线 `key_nodes` 的章节中**（`RHYTHM_COVERAGE` 检查）
+- `foreshadow_recovery`：每个 `fs_id` 从骨架取，`chapter` 为该伏笔的回收章
+- **全书级结局必须回收所有大伏笔**（`RHYTHM_LARGE_FS_NOT_RECOVERED` 检查）
+
+---
+
+<!-- contract:file:章节细纲 -->
+## 八、章节细纲.json 的字段契约
+
+**顶层数组**：`outlines`　**模板**：`模板/节奏/章节细纲模板.json`
+
+**核心要求**：为**重点章**写细纲。非重点章可省略（`word_target` 由写作阶段根据 `avg_words_per_chapter` 现场生成）。
+
+**重点章定义**（插件按这套规则算，并在指令里把本批的重点章号列出来）：
+
+- 第 1 章
+- 每卷第 1 章和最后 1 章
+- 大高潮章（骨架 `climaxes[].type = "大高潮"` 对应的章节）
+- 结局章（`ending_timeline` 里出现的章）
+- 钩子章（`hook_timeline` 里出现的章 —— 细纲的 hook 字段必须与它对齐）
+
+**只写指令里列出的章**，不要自己加章，也不要漏。
+（主线 `key_nodes` 的"转折"节点不单独算重点章：它们是自由文本，插件无法可靠识别；
+  转折章如果同时是卷首/卷尾/高潮/结局/钩子章，本来就会出现在上面的清单里。）
+
+**每行细纲填**：
+
+| 字段 | 写什么 |
+|---|---|
+| `ch` | 章节号 |
+| `function_main` | 主功能（"推进主线"/"埋伏笔"/"爽点兑现"/"过渡"/"人物塑造"） |
+| `function_aux` | 辅功能 |
+| `emotion_value` | 1-10（情绪值） |
+| `emotion_phase` | 调动/释放/蓄力 |
+| `satisfaction_type` | 爽点类型（如果本章有爽点），取 glossary `pleasure_kind` |
+| `satisfaction_scale` | 爽点规模，取 glossary `pleasure_scale` |
+| `satisfaction_audience` | 爽点面向谁 |
+| `foreshadow_action` | 本章埋/推/收哪些伏笔（如 `"埋 FS003"`） |
+| `faction_appearance` | 本章出场哪些势力 |
+| `hook_head` / `hook_tail` / `hook_strength` | 钩子（与 `hook_timeline` 中该章的钩子对应） |
+| `word_target` | 字数目标，偏离 `avg_words_per_chapter` 超过 ±20% 会报 warning |
+
+---
+
+<!-- contract:consistency -->
+## 九、跨文件一致性（本阶段最容易翻车的地方）
+
+节奏阶段的多数校验是**全量口径**的——单看一个文件查不出来，必须四个文件对得上。
+
+| 一致性 | 检查代码 | 类型 |
+|---|---|---|
+| 主线 key_nodes 数 = `main_progress_chapter_count` | `RHYTHM_NODES_COUNT` | error |
+| 支线章数之和 = `branch_chapter_total` | `RHYTHM_BRANCH_TOTAL` | error |
+| 支线章集 ∩ 主线 key_node 章集 = `overlap_chapter_count` | `RHYTHM_OVERLAP_COUNT` | error |
+| 结局章 ∈ 主线 key_nodes | `RHYTHM_COVERAGE` | error |
+| 全书级结局回收所有大伏笔 | `RHYTHM_LARGE_FS_NOT_RECOVERED` | error |
+| 伏笔埋 < 收 | `RHYTHM_TIMING` | error |
+| 冲突升级递增 | `RHYTHM_TIMING` | error |
+| 弧光顺序递增 | `RHYTHM_TIMING` | error |
+| 弧光章在出场区间内 | `RHYTHM_ARC_OUT_OF_SPAN` | error |
+| 退场章在出场区间内 | `RHYTHM_EXIT_IN_SPAN` | error |
+| 章节号在 [1, T] 内 | `RHYTHM_CHAP_RANGE` | error |
+| 区间 start <= end | `RHYTHM_CHAP_ORDER` | error |
+| 主线节点重复 | `RHYTHM_NODE_DUP` | error |
+| 支线重叠 | `RHYTHM_BRANCH_OVERLAP` | error |
+| 章节重复 / 缺失 / 孤立 | `RHYTHM_CHAPTER_DUP` / `RHYTHM_CHAPTER_MISSING` / `RHYTHM_CHAPTER_UNREF` | error |
+| 钩子下限 / 连续同类 | `RHYTHM_HOOK_MIN` / `RHYTHM_HOOK_DUP` | error |
+| 卷章数分布 | `RHYTHM_VOLUME_DIST` | warning |
+| 钩子同类（2 章） | `RHYTHM_HOOK_DUP_WARN` | warning |
+| 字数目标 | `RHYTHM_WORD_TARGET` | warning |
+| derivations | `RHYTHM_DERIVATION_MISSING` / `RHYTHM_DERIVATION_EXTRA` | warning |
+
+**记住三条最容易忘的**：
+
+1. **时序映射必须严格匹配节奏参数的三个值**（`key_nodes` 数、支线章数之和、交集大小）。
+2. **结局章必须在主线 `key_nodes` 里**——如果结局章不在，先改 key_nodes 或改结局章。
+3. **钩子数不能低于 `ceil(T * rate)`**——`is_minimum` 为 true 时这是硬下限。
+
+---
+
+<!-- contract:errors -->
+## 十、常见错误代码速查
+
+插件回喂给你的错误清单里的 `code` 对应下表。**只改被点名的字段**，其余不要动。
+
+| code | 含义 | 修复方向 |
+|---|---|---|
+| `RHYTHM_INFEASIBLE` | 3 个参数不满足 7 条约束 | 按「节奏参数」那节的步骤 2-6 重算 |
+| `RHYTHM_CONSTRAINT_EVAL` | 约束求值失败 | 检查 formulas-rhythm.json |
+| `RHYTHM_CHAP_RANGE` | 章节号越界 | 改到 `[1, T]` |
+| `RHYTHM_CHAP_ORDER` | 区间 start > end | 交换或调整 |
+| `RHYTHM_TIMING` | 时序错误 | 调整章节号 |
+| `RHYTHM_ARC_OUT_OF_SPAN` | 弧光章不在出场区间 | 调整 `arc_stages[].chapter` |
+| `RHYTHM_EXIT_IN_SPAN` | 退场章不在出场区间 | 调整 `exit_chapter` |
+| `RHYTHM_REF_MISSING` | 引用的 id 不存在 | 改 id 或补上游实体 |
+| `RHYTHM_ACT_INVALID` | 章节规划的 act 不在骨架幕集合中 | 改为骨架该卷的幕 index |
+| `RHYTHM_CHAPTER_DUP` | 章节号重复 | 去重 |
+| `RHYTHM_CHAPTER_MISSING` | 缺章节 | 补章节规划 |
+| `RHYTHM_CHAPTER_UNREF` | 章节没有引用 | 补时序映射或细纲 |
+| `RHYTHM_NODES_COUNT` | key_nodes 数 ≠ 参数 | 改时序映射或改参数 |
+| `RHYTHM_BRANCH_TOTAL` | 支线章数之和 ≠ 参数 | 改时序映射或改参数 |
+| `RHYTHM_OVERLAP_COUNT` | 交集大小 ≠ 参数 | 改时序映射或改参数 |
+| `RHYTHM_NODE_DUP` | 主线 key_node 章重复 | 改章节 |
+| `RHYTHM_BRANCH_OVERLAP` | 支线章集重叠 | 调整区间 |
+| `RHYTHM_COVERAGE` | 结局章不在 key_nodes | 改结局章或补 key_nodes |
+| `RHYTHM_LARGE_FS_NOT_RECOVERED` | 全书级结局缺大伏笔 | 补 `foreshadow_recovery` |
+| `RHYTHM_HOOK_MIN` | 钩子数不足 | 补钩子 |
+| `RHYTHM_HOOK_DUP` | 连续 3 章同类钩子 | 换钩子类型 |
+| `RHYTHM_VOLUME_DIST`（warning） | 卷章数分布偏离 | 调整章节规划的 volume 分配 |
+| `RHYTHM_HOOK_DUP_WARN`（warning） | 连续 2 章同类钩子 | 换一章的钩子 |
+| `RHYTHM_WORD_TARGET`（warning） | 字数目标偏离 | 调整 word_target |
+| `RHYTHM_DERIVATION_MISSING`（warning） | 缺约束名 key | 用 7 条约束名作 key |
+| `RHYTHM_DERIVATION_EXTRA`（warning） | 多了参数名 key | 删掉，只留 7 条约束名 |
+| `RHYTHM_COVERAGE_SKIPPED`（warning） | 覆盖检查被跳过 | 不是你的错 |
+| `NEED_ALL_CHECK`（warning） | 本文件单检通过，跨文件一致性要等全量校验 | 不用管，插件会自己跑全量校验 |
+| `REL_KIND_META_DRIFT` | 关系类型词表与元数据不同步 | 同样是参考文件/脚本的一致性问题，不是你写错了。照 glossary 第五节的词表填，并把这个码原样报给用户 |
+| `ENUM_VALUE_MISSING`（warning） | 业务常量缺失 | 不是你的错 |
+| `EXTRA_FIELD` / `REQUIRED` / `TYPE` / `PATTERN` / `ENUM` / `ENUM_MISSING` | 模板结构不符 | 按 `模板/节奏/` 模板与 `references/glossary.md` 改 |
+| `CHARSET_KO` / `CHARSET_JP` / `PLACEHOLDER` | 字符集 / 占位符 | 删除 |
+| `UPSTREAM_MISSING` / `UPSTREAM_NOT_READY` / `UPSTREAM_NOT_PASSED` | 上游骨架或血肉没准备好 | 不是你写错了。停下这一轮，把这三个码原样报给用户，让用户先修上游阶段 |
+
+---
+
+<!-- contract:forbidden -->
+## 十一、本阶段禁令（11 条）
+
+1. **章节号必须在 `[1, T]` 内**。`RHYTHM_CHAP_RANGE` 会拦截越界。
+
+2. **不得引用不存在的实体 id**。所有 `char_id` / `conflict_id` / `fs_id` / `climax_id` / `pleasure_id` / `main_id` / `branch_id` / `loc_id` / `item_id` / `ending_id` / `volume` 必须存在于骨架/血肉中。`RHYTHM_REF_MISSING` 会拦截。
+
+3. **`branch_chapter_total` 必须与支线实际章数之和一致**。全量 `RHYTHM_BRANCH_TOTAL` 会检查。
+
+4. **`main_progress_chapter_count` 必须与主线 key_nodes 实际数一致**。全量 `RHYTHM_NODES_COUNT` 会检查。
+
+5. **`overlap_chapter_count` 必须与支线章集 ∩ 主线 key_node 章集的实际交集大小一致**。全量 `RHYTHM_OVERLAP_COUNT` 会检查。
+
+6. **结局章必须在主线 key_nodes 中**。`RHYTHM_COVERAGE` 会检查。
+
+7. **全书级结局必须回收所有大伏笔**。`RHYTHM_LARGE_FS_NOT_RECOVERED` 会检查。
+
+8. **钩子数必须 ≥ `ceil(T * rate)`**（如果 `is_minimum` 为 true）。`RHYTHM_HOOK_MIN` 会检查。
+
+9. **derivations 的 key 必须是 7 条约束名，不是 3 个参数名**。`RHYTHM_DERIVATION_MISSING` / `RHYTHM_DERIVATION_EXTRA` 会告警（warning，不阻塞）。
+
+10. **不得输出"通过/完成/PASS/✅"等结论词**。阶段成败由插件判定。
+
+11. **不得修改 `模板/` 和 `references/` 下的任何文件**。`模板/` 是节奏阶段的结构来源，`references/` 是规则/公式/枚举/glossary 来源，两者都是**只读输入**。严禁为了"通过校验"而修改 validator 或规则文件——所有脚本与参考文件的修改由项目维护者通过 plugin 升级路径完成。**骨架阶段产物 `设定/raw/sources/骨架/` 和血肉阶段产物 `设定/raw/sources/血肉/` 的 JSON 是只读上游**，你**只能引用**，不能修改。**本阶段的输出目录 `设定/raw/sources/节奏/` 是你要写的产物**。