@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

package/plugins/fancy-story-builder/prompts/01-skeleton-prompt.md

@@ -0,0 +1,563 @@
+# 01 骨架阶段产物契约
+
+> 本文件是骨架阶段的**产物契约**：每个文件长什么样、哪些规则不能破。
+>
+> 怎么派活、怎么校验、错了怎么改、下一批做什么，全部由插件负责：
+> 插件按批次把活派给你，校验脚本判定通过与否，
+> 错误清单由插件整理后回喂给你。**你只负责按指令生成文件。**
+>
+> 本阶段是第一层，无上游依赖。
+
+@meta-only
+
+---
+
+<!-- contract:overview -->
+## 一、本阶段目标
+
+产出 4 个 JSON 文件到 `设定/raw/sources/骨架/`：
+
+1. `框架.json` —— 定数量（quota）、定卷比例（volume_ratio）、记录公式推导（derivations）
+2. `实体.json` —— 12 类常规实体清单（id + name + 枚举）+ 可选的 `other_entities` 题材扩展实体
+3. `关系.json` —— 9 类常规关系清单（ID 引用）+ 可选的 `other_relations`
+4. `层级.json` —— 卷/幕/主线/支线的卷级归属
+
+**本阶段回答**：有哪些实体、实体如何连接、有多少、分几卷几幕。
+**本阶段不回答**：实体长什么样（血肉阶段）、什么时间发生（节奏阶段）、具体怎么写（写作阶段）。
+
+### 生成顺序（有硬依赖，插件按这个顺序派活）
+
+| 序 | 文件 | 依赖 | 为什么 |
+|---|---|---|---|
+| 1 | 框架.json | 无 | quota 是实体与层级数量的唯一来源 |
+| 2 | 实体.json | 框架.json | 每类实体写几条，按框架的 quota 写 |
+| 3 | 关系.json | 实体.json | 关系里填的 id 只能来自实体清单 |
+| 4 | 层级.json | 框架 + 实体 | 卷数按 quota.volume_count；span 引用主线/支线 id |
+
+**不得并行，不得预生成下游文件。**
+
+---
+
+<!-- contract:input -->
+## 二、任务输入
+
+> 本节由插件注入，只读，不得修改。
+> 骨架阶段没有上游，这输入就是选题时的原始输入。
+
+${input_snapshot_block}
+
+**注**：
+
+- **目标章节**是全部数量公式的输入（T）。先算 T，后面所有数量都从 T 推。
+- **选题方向 + 11 项方向设计**是扫榜报告里选定方向的设计（一句话定位、读者与情绪价值、金手指、核心设定、爽点模式、情绪价值曲线、开篇切入点、节奏规划、人物设定、差异化策略、风险与验证）。**逐项原样抄进 `input_snapshot`**：血肉、节奏阶段都从这份快照读它，不必也不得自行重设计。
+- **一句话故事**决定主角是谁、核心冲突是什么；**核心冲突**决定要配几个核心冲突、几个核心反派。
+- **硬门禁**与**反套路**是硬约束：配实体类型、势力性质、结局走向时不得违背。
+
+---
+
+<!-- contract:output-list -->
+## 三、本阶段产出清单
+
+| # | 文件 | 路径 | 前置依赖 |
+|---|---|---|---|
+| 1 | 框架.json | `设定/raw/sources/骨架/框架.json` | 无 |
+| 2 | 实体.json | `设定/raw/sources/骨架/实体.json` | 框架.json 已产出 |
+| 3 | 关系.json | `设定/raw/sources/骨架/关系.json` | 实体.json 已产出 |
+| 4 | 层级.json | `设定/raw/sources/骨架/层级.json` | 框架.json + 实体.json 已产出 |
+
+---
+
+<!-- contract:rules -->
+## 四、核心铁律（违反任意一条都会校验失败）
+
+> 1. **不得出现任何章节号**（`chapter` / `ch` / `start` / `end` / `appearance_chapters` / `chapter_range` / `buried_chapter` / `recovered_chapter` / `key_nodes` 等，完整清单见 glossary 第六节）。骨架脚本会拦截 `SKELETON_CHAPTER_FORBIDDEN`。
+>
+> 2. **常规实体的枚举必须遵守 glossary**。例如 `character_type` 只允许"主角/贯穿级核心配角/卷级重要配角/贯穿级核心反派/卷级反派"，不能自创。题材特有存在不要硬塞进 `characters`，改写进可选的 `other_entities`（`kind` 是自由文本，如 灵魂/神魂/器灵/妖灵/概念体）。ENUM 校验会拦截常规枚举。
+>
+> 3. **引用关系只允许 id，不允许编名字**。关系.json 的 `from`/`to`/`character`/`faction`/`item`/`location`/`ending`/`main_line`/`branch` 必须是 `C001`/`X001`/`F001` 这种 id，不是名字。`SKELETON_REF_MISSING` 会拦截。
+>
+> 4. **不得自创字段**。每个文件的字段必须严格在 `模板/骨架/<文件名>模板.json` 的 `structure.properties` 中定义。`EXTRA_FIELD` 会拦截。
+>
+> 5. **公式推导（`derivations`）必须 30 条齐全**，每条 `{formula, range_low, range_high, note}`，且 `formula` 逐字与 `formulas-skeleton.json` 一致。`DERIVATION_MISSING` / `DERIVATION_RANGE_MISMATCH` 会拦截。
+>
+> 6. **关系类型只能取第 8.2 节各自那套词表**。`character_relations[].relation_kind` 取 13 值（血缘/师徒/雇佣/服从/提携/合作/利益交换/利用/对立/敌对/竞争/中立/其他）；用 `其他` 时必须填 `relation_label` 写清具体关系（如 附身/寄生/契约/共生）。非人物实体的关系写 `other_relations`；`faction_membership[].member_relation` 取 8 值（利益交换/合作/对立/利用/师徒/雇佣/血亲/无）；`faction_relations[].relation_type` 取 4 值（合作/对立/利用/中立）；`main_line_branch_relation[].relation_kind` 取 6 值（促成/阻碍/并行/揭示/收束/依存）。不要写"盟友""对手""上下级""血亲"——它们不在对应词表里，ENUM 会拦截。
+>
+> 7. **实体名要是真名字，内容要是真内容**。名字写"陆子仲"而不是"主角1"；`input_snapshot` 的 `positioning` / `core_conflict` 要写清一个具体处境，而不是"核心概述。"。`NAME_PLACEHOLDER` / `TEXT_TOO_SHORT` / `TEXT_PLACEHOLDER` 会拦截。
+>
+> 8. **实体条数必须与框架的 quota 完全一致**。框架里声明 `character_counts.protagonist = 2`，实体清单里就恰好要有 2 个 `type=主角` 的角色；多一个少一个都会报 `QUOTA_MISMATCH`。
+
+---
+
+<!-- contract:refs -->
+## 五、参考文件
+
+### 必读（每次任务开始时读一次，之后不再重读）
+
+- `references/glossary.md` —— 术语、ID 前缀、枚举、章节号字段清单
+- `references/formulas-skeleton.json` —— 30 条数量公式（框架.json 生成时用）
+
+### 按本轮文件选读
+
+| 本轮生成文件 | 读 |
+|---|---|
+| 框架.json | `references/骨架指导/01-positioning.md`（读者定位）、`references/骨架指导/05-quota.md`（数量） |
+| 实体.json | `references/骨架指导/01-positioning.md`、`references/骨架指导/03-entities.md`（实体卡） |
+| 关系.json | `references/骨架指导/02-packaging.md`（势力包装）、`references/骨架指导/03-entities.md`、`references/骨架指导/04-conflict.md` |
+| 层级.json | `references/骨架指导/02-packaging.md`、`references/骨架指导/04-conflict.md` |
+| 全部 | `references/骨架指导/00-index.md`（阶段入口，强烈推荐） |
+
+${benchmark_refs_block}
+
+### 规则
+
+- 必读文件不可读时，停下来上报（原因：参考文件缺失）。
+- 选读文件不可读时，记 warning，继续。
+- 读后不重读。
+- 不得声称"已读取"参考文件。
+
+---
+
+<!-- contract:file:框架 -->
+## 六、框架.json 的字段契约
+
+**顶层**：纯对象（没有顶层数组）　**模板**：`模板/骨架/框架模板.json`
+
+| 顶层键 | 写什么 |
+|---|---|
+| `capacity` | `{target_chapters, target_words, avg_words_per_chapter}` |
+| `input_snapshot` | 任务输入 17 项（书名/题材/一句话定位/核心冲突/选题方向/11 项方向设计/硬门禁/反套路），原样照抄 |
+| `quota` | 每类实体要多少个（见下） |
+| `volume_ratio` | 每卷占多少章，数组 |
+| `derivations` | 30 条公式推导，对象 |
+
+### 6.1 capacity
+
+- `target_chapters`：任务输入的 T
+- `target_words`：任务输入
+- `avg_words_per_chapter`：`round(target_words / target_chapters)`
+
+`CAPACITY_MISMATCH` 会核对三者。
+
+### 6.2 quota（数量配额）
+
+28 个字段，每个字段的值就是**实体清单里该类型的条数**：
+
+| quota 路径 | 对应实体数组 | 统计口径 |
+|---|---|---|
+| `character_counts.protagonist` | characters | type=主角 |
+| `character_counts.core_supporting` | characters | type=贯穿级核心配角 |
+| `character_counts.volume_supporting` | characters | type=卷级重要配角 |
+| `character_counts.core_antagonist` | characters | type=贯穿级核心反派 |
+| `character_counts.volume_antagonist` | characters | type=卷级反派 |
+| `conflict_counts.core` | conflicts | type=核心 |
+| `conflict_counts.phase` | conflicts | type=阶段 |
+| `conflict_counts.branch` | conflicts | type=交织 |
+| `faction_count` | factions | 全部 |
+| `location_count` | locations | 全部 |
+| `ending_count` | endings | 全部 |
+| `main_line_count` | main_lines | 全部 |
+| `branch_count` | branches | 全部 |
+| `foreshadow_counts.small` | foreshadows | type=小伏笔 |
+| `foreshadow_counts.medium` | foreshadows | type=中伏笔 |
+| `foreshadow_counts.large` | foreshadows | type=大伏笔 |
+| `climax_counts.small` | climaxes | type=小高潮 |
+| `climax_counts.medium` | climaxes | type=中高潮 |
+| `climax_counts.large` | climaxes | type=大高潮 |
+| `pleasure_counts.small` | pleasures | scale=小爽点 |
+| `pleasure_counts.medium` | pleasures | scale=中爽点 |
+| `pleasure_counts.large` | pleasures | scale=大爽点 |
+| `item_counts.core` | items | category=核心道具 |
+| `item_counts.branch` | items | category=支线道具 |
+| `item_counts.symbolic` | items | category=象征道具 |
+| `world_rule_counts.core` | world_rules | category=核心规则 |
+| `world_rule_counts.information` | world_rules | category=信息规则 |
+| `world_rule_counts.social` | world_rules | category=社会规则 |
+| `volume_count` | 层级.json 的 volumes | 全部（另见 `faction_relation_count`） |
+| `faction_relation_count` | 关系.json 的 faction_relations | 无向关系对数（行数 = 它，或对立关系写双向时 = 它的 2 倍） |
+
+**quota 的值决定后面每一批要写多少条**。写错了，后面每一批都会跟着错。
+
+### 6.3 数量公式（30 条，按拓扑顺序算）
+
+读 `references/formulas-skeleton.json` 拿到 30 条公式（含 `fixed.*` 固定值），按下面的拓扑顺序逐层计算区间：
+
+```
+Level 0（基础量）：
+  T = target_chapters
+
+Level 1（只依赖 T 或固定值）：
+  structure.volume_count
+  fixed.character_elements.protagonist_count
+  fixed.character_elements.core_supporting_count
+  fixed.character_elements.core_antagonist_count
+  fixed.conflict_elements.core_conflict_count
+  fixed.structure.main_line_count
+
+Level 2（依赖 V；也可以用 T）：
+  V = quota.volume_count
+  structure.branch_count
+  character_elements.volume_supporting_count
+  character_elements.volume_antagonist_count
+  conflict_elements.phase_conflict_count
+  faction_elements.faction_count
+  location_elements.key_location_count
+  foreshadow_elements.small_foreshadow_count
+  foreshadow_elements.medium_foreshadow_count
+  foreshadow_elements.large_foreshadow_count
+  climax_elements.small_climax_count
+  climax_elements.medium_climax_count
+  climax_elements.large_climax_count
+  pleasure_elements.small_pleasure_count
+  pleasure_elements.medium_pleasure_count
+  pleasure_elements.large_pleasure_count
+  ending_elements.ending_count
+  world_rule_counts.core
+  world_rule_counts.information
+  world_rule_counts.social
+
+Level 3（依赖实体数）：
+  conflict_elements.branch_conflict_count（依赖 BC = branch_count）
+  faction_elements.faction_relation_count（依赖 faction_count 作为输入）
+  item_elements.core_item_count（依赖 CC = core_conflict_count）
+  item_elements.branch_item_count（依赖 BC = branch_count）
+  item_elements.symbolic_item_count（依赖 P + CS + CA）
+```
+
+`faction_elements.faction_relation_count` 必须在 `faction_count` 之后算（依赖它作为输入）。
+
+### 6.4 derivations（30 条，一条不多一条不少）
+
+- key：公式名（如 `structure.volume_count`），必须与 `formulas-skeleton.json` 完全一致
+- value：`{formula, range_low, range_high, note}`
+- `formula`：逐字复制 `formulas-skeleton.json` 对应条目的 `formula` 字段
+- `range_low` / `range_high`：6.3 算出的数字
+- `note`：可选字符串；**终值超出区间时必须写明理由**（超出会产生 `QUANTITY_MISMATCH` warning，不阻塞）
+
+**30 条公式名**（与 `formulas-skeleton.json` 一一对应）：
+
+| # | 公式名 |
+|---|---|
+| 1 | `structure.volume_count` |
+| 2 | `structure.branch_count` |
+| 3 | `character_elements.volume_supporting_count` |
+| 4 | `character_elements.volume_antagonist_count` |
+| 5 | `conflict_elements.phase_conflict_count` |
+| 6 | `conflict_elements.branch_conflict_count` |
+| 7 | `faction_elements.faction_count` |
+| 8 | `faction_elements.faction_relation_count` |
+| 9 | `location_elements.key_location_count` |
+| 10 | `foreshadow_elements.small_foreshadow_count` |
+| 11 | `foreshadow_elements.medium_foreshadow_count` |
+| 12 | `foreshadow_elements.large_foreshadow_count` |
+| 13 | `climax_elements.small_climax_count` |
+| 14 | `climax_elements.medium_climax_count` |
+| 15 | `climax_elements.large_climax_count` |
+| 16 | `pleasure_elements.small_pleasure_count` |
+| 17 | `pleasure_elements.medium_pleasure_count` |
+| 18 | `pleasure_elements.large_pleasure_count` |
+| 19 | `item_elements.core_item_count` |
+| 20 | `item_elements.branch_item_count` |
+| 21 | `item_elements.symbolic_item_count` |
+| 22 | `world_rule_counts.core` |
+| 23 | `world_rule_counts.information` |
+| 24 | `world_rule_counts.social` |
+| 25 | `ending_elements.ending_count` |
+| 26 | `fixed.structure.main_line_count` |
+| 27 | `fixed.character_elements.protagonist_count` |
+| 28 | `fixed.character_elements.core_supporting_count` |
+| 29 | `fixed.character_elements.core_antagonist_count` |
+| 30 | `fixed.conflict_elements.core_conflict_count` |
+
+### 6.5 volume_ratio
+
+- 长度等于 `quota.volume_count`
+- 每个 `volume_id` 格式 `V001`、`V002`……连续不跳号
+- `chapter_ratio` 之和等于 1.0（容差 0.01）
+
+---
+
+<!-- contract:file:实体 -->
+## 七、实体.json 的字段契约
+
+**顶层**：12 个常规数组 + 可选的 `other_entities`　**模板**：`模板/骨架/实体模板.json`
+
+### 7.1 每类实体的字段
+
+| 数组 | id 前缀 | 字段 |
+|---|---|---|
+| `characters` | C | `id` `name` `type` `gender` `age_group` |
+| `conflicts` | X | `id` `name` `type` `scale` |
+| `factions` | F | `id` `name` `type` |
+| `locations` | L | `id` `name` `type` `narrative_function` |
+| `items` | P | `id` `name` `category` |
+| `endings` | E | `id` `name` `level` `type` |
+| `foreshadows` | FS | `id` `name` `type` |
+| `climaxes` | CL | `id` `name` `type` |
+| `pleasures` | PL | `id` `name` `scale` `kind` |
+| `world_rules` | R / I / SR | `id` `name` `category` |
+| `main_lines` | M | `id` `name` |
+| `branches` | B | `id` `name` `type` |
+| `other_entities`（可选） | O | `id` `name` `kind`（`note` 可选） |
+
+**id 规则**：`C001`/`X001`/`F001`/`L001`/`P001`/`E001`/`FS001`/`CL001`/`PL001`/`M001`/`B001`，三位数从 001 连续递增，不跳号。可选扩展实体用 `O001` 起单独编号。
+**同一个数组里的 id 必须两两不同 —— 不管 `type` / `scale` / `kind` 是不是同一类。**
+一个数组只有一个 id 前缀时，**不同类别也共用同一个编号空间**，必须合在一起连续编号：`climaxes` 的小高潮 / 中高潮 / 大高潮共用 `CL`，要写成 `CL001`…`CL079` 这样一路排下来，**不能按类型各编一套**（各编一套必然撞号，`ID_DUP` 会拦截 —— 2026-10-24 实测就是这么失败的）。
+世界观的规则按分类用不同前缀：**R** = 核心规则、**I** = 信息规则、**SR** = 社会规则
+（`WORLD_RULE_CATEGORY_MISMATCH` 会核对前缀与所属数组）；这三个前缀各自独立编号，互不冲突。
+
+### 7.2 枚举取值（只能从词表里选，ENUM 会拦截）
+
+| 字段 | 取值 |
+|---|---|
+| `characters[].type` | 主角 / 贯穿级核心配角 / 卷级重要配角 / 贯穿级核心反派 / 卷级反派 |
+| `characters[].age_group` | 少年 / 青年 / 中年 / 老年 |
+| `conflicts[].type` | 核心 / 阶段 / 交织 |
+| `conflicts[].scale` | 全局性 / 区域性 / 个人 |
+| `factions[].type` | 官方组织 / 民间组织 / 商业组织 / 其他 |
+| `locations[].type` | 主要场景 / 次要场景 / 过渡场景 / 其他 |
+| `locations[].narrative_function` | 对话 / 冲突 / 情感 / 转折 / 伏笔 / 其他 |
+| `items[].category` | 核心道具 / 支线道具 / 象征道具 |
+| `endings[].level` | 全书级 / 卷级 |
+| `endings[].type` | 开放式结局 / 闭合式结局 / 悲剧结局 / 喜剧结局 |
+| `foreshadows[].type` | 小伏笔 / 中伏笔 / 大伏笔 |
+| `climaxes[].type` | 小高潮 / 中高潮 / 大高潮 |
+| `pleasures[].scale` | 小爽点 / 中爽点 / 大爽点 |
+| `pleasures[].kind` | 打脸 / 收获 / 身份 / 情感 / 智力 / 探索 / 团战 |
+| `world_rules[].category` | 核心规则 / 信息规则 / 社会规则 |
+| `branches[].type` | 角色成长型 / 身份揭示型 / 背景揭示型 |
+| `other_entities[].kind` | **自由文本**：灵魂 / 神魂 / 器灵 / 妖灵 / 鬼魂 / 概念体 / 其他题材特有类别 |
+
+### 7.3 关键约束
+
+- **全书级结局恰好 1 个**（`level=全书级`），其余是卷级（`BOOK_ENDING_COUNT` 会查）
+- **每类实体的条数严格等于框架 quota 里对应字段的值**（`QUOTA_MISMATCH` 会查）
+- **id 与 name 都不能重复**（`ID_DUP` / `NAME_DUP`）；**角色 / 势力 / 冲突 / 地点**四类之间也不能同名（`CROSS_TYPE_NAME_DUP` warning）
+- **同一实体只建一条**：本名/正式名优先。称呼（哥哥/父亲/老师/老板）、绰号、简称、集团/公司/大学等后缀不要另建实体；归一化后重名会报 `NAME_ALIAS_SUSPECT` warning
+- **名字是真名**：写"陆子仲"不写"主角1"（`NAME_PLACEHOLDER` 会查）
+- **常规实体只写 id + name + 枚举**；`other_entities` 只写 `id` / `name` / `kind`（可带一句 `note`）。描述属于血肉阶段（`EXTRA_FIELD` 会查）
+- **不许出现章节号**（`SKELETON_CHAPTER_FORBIDDEN` 会查）
+- **不许同质化**：不同实体的同一字段不能几乎一字不差（`TEXT_DUPLICATE` 会查）
+
+---
+
+<!-- contract:file:关系 -->
+## 八、关系.json 的字段契约
+
+**顶层**：9 个常规数组 + 可选的 `other_relations`　**模板**：`模板/骨架/关系模板.json`
+
+### 8.1 每类关系的字段
+
+| 数组 | 一行代表什么 | 字段 |
+|---|---|---|
+| `character_relations` | 两个角色之间的关系 | `from` `to` `relation_kind`；`relation_kind=其他` 时加 `relation_label` |
+| `other_relations`（可选） | 非人物实体参与的关系 | `from`（O 开头）`to`（C/O 开头）`relation_label`（必填）`description`（可选） |
+| `faction_membership` | 一个角色属于一个势力 | `character` `faction` `member_relation` `position_level` |
+| `faction_relations` | 两个势力之间的关系 | `from` `to` `relation_type` |
+| `conflict_participants` | 一个冲突的参战方 | `conflict` `protagonist_side` `main_antagonist` `secondary_antagonist` `third_party` |
+| `branch_protagonist` | 一条支线的主角 | `branch` `character` |
+| `item_owner` | 一件道具的归属者 | `item` `owner_id` `owner_kind` |
+| `location_conflict` | 一个地点牵涉哪些冲突 | `location` `conflicts` |
+| `ending_character` | 一个结局牵涉哪些角色 | `ending` `character` |
+| `main_line_branch_relation` | 一条支线怎么挂到主线上 | `main_line` `branch` `relation_kind` |
+
+### 8.2 关系类型词表
+
+**`character_relations[].relation_kind`** —— 只从这 13 个值里选：
+
+| 词表值 | 什么时候用 |
+|---|---|
+| 血缘 | 有亲属关系 |
+| 师徒 | 有师承（师父在前，徒弟在后） |
+| 雇佣 | 有雇佣（雇主在前） |
+| 服从 | 一方服从另一方 |
+| 提携 | 一方提携另一方 |
+| 合作 | 平等合作 |
+| 利益交换 | 以利益为纽带 |
+| 利用 | 一方利用另一方 |
+| 对立 | 立场对立 |
+| 敌对 | 敌视仇视 |
+| 竞争 | 争夺同一目标 |
+| 中立 | 无特殊立场 |
+| 其他 | 词表外的题材特有角色关系（附身/寄生/契约/共生…）；**必须同时填 `relation_label`**，能归入前 12 类的不要滥用 |
+
+**不要写的**（不在词表，ENUM 拦截）：`盟友`→写 `合作`；`对手`→写 `对立` 或 `敌对`；`上下级`→写 `师徒` / `雇佣` / `服从`；`血亲`→写 `血缘`；`附身` 不是词表值，人物之间写 `其他` + `relation_label: 附身`，灵魂/神魂等非人物存在写进 `other_relations`。
+
+**`other_relations[].relation_label`** —— 自由文本，但必须具体：`附身` / `寄宿` / `共生` / `契约` / `镇压` / `吞噬` / `前世` 等。`from` 必须是 `other_entities` 的 id，`to` 可指人物或其他实体。
+
+**`main_line_branch_relation[].relation_kind`** —— 只从这 6 个值里选：`促成` / `阻碍` / `并行` / `揭示` / `收束` / `依存`。
+
+**`faction_membership[].member_relation`** —— 只从这 8 个值里选：`利益交换` / `合作` / `对立` / `利用` / `师徒` / `雇佣` / `血亲` / `无`。
+
+**`faction_relations[].relation_type`** —— 只从这 4 个值里选：`合作` / `对立` / `利用` / `中立`。
+
+> ⚠️ **这是四套互不相同的词表，别串用**：
+> `relation_kind`（角色关系，13 值，含扩展出口 `其他`）/ `member_relation`（成员关系，8 值）/ `relation_type`（势力关系，4 值）/ `main_line_branch_relation[].relation_kind`（支线挂主线，6 值）。
+> 拿 `relation_kind` 的值去填 `member_relation` 或 `relation_type` 一律报 ENUM
+> （tt5 实测 2026-10-27：9 条 ENUM 错误，2 个批次重写，理由全是"从角色关系词表里取值"）。
+
+### 8.3 关键约束
+
+- **所有 id 字段填 id，不填名字**；id 必须来自实体清单（`SKELETON_REF_MISSING` 会查）
+- **同一对角色，正反两个方向的关系要相容**：不能一边 `合作` 一边 `敌对`，也不能互相 `服从`（`REL_ASYMMETRIC_INCOMPATIBLE` 会查）
+- **同一有序对不能写两种关系类型**（`REL_KIND_CONFLICT` 会查）
+- **不能自环**：`from` 与 `to` 不能是同一个 id（`NO_SELF_RELATION` 会查）
+- **对立势力关系必须写双向两行**：`A→B` 与 `B→A` 都要写，且关系类型一致（`G_REL_ONE_WAY` / `G_REL_ASYMMETRIC` 会查）。合作/利用/中立写一行即可（校验器只对"对立"强制双向）
+- **每个实体都要连上**：`G_ISOLATED` 会查孤立节点 —— 角色、冲突、势力都得有关系
+- **`faction_relations` 的行数 = `quota.faction_relation_count`（每对关系一行）或它的 2 倍**（对立关系写双向两行时）。`quota.faction_relation_count` 记的是**无向关系对数**，不是行数
+- **每条支线都要挂到主线上**：`main_line_branch_relation` 一行代表"一条支线挂到主线上"，每个支线 id 都要出现（`BRANCH_MAINLINE_UNLINKED` 会查）；反过来每条主线也要挂到支线（`MAINLINE_BRANCH_UNLINKED` 会查）
+- **只写 ID 引用 + 关系类型/标签**，不写大段描述（描述属于血肉阶段，`EXTRA_FIELD` 会查）
+- **`other_relations` 不能自环**：`from` 与 `to` 不能是同一个 id；每个 `other_entities` 至少要有一条关系，不能是孤立设定（`G_ISOLATED` 会查）
+
+---
+
+<!-- contract:file:层级 -->
+## 九、层级.json 的字段契约
+
+**顶层**：4 个数组　**模板**：`模板/骨架/层级模板.json`
+
+| 数组 | 一行代表什么 | 字段 |
+|---|---|---|
+| `volumes` | 一卷 | `id` `name` `theme_short` |
+| `acts` | 一卷里的一幕 | `volume` `act_index` `theme_short` |
+| `main_line_span` | 一条主线跨哪几卷 | `main_line` `volume_ratio` |
+| `branch_span` | 一条支线跨哪几卷 | `branch` `volume_ratio` |
+
+### 关键约束
+
+- **`volumes` 的条数 = `quota.volume_count`**（`VOLUME_COUNT_MISMATCH` 会查）
+- **`volumes[].id` 格式 `V001`、`V002`……连续不跳号**，与框架的 `volume_ratio[].volume_id` 一一对应
+- **`acts[].volume` 必须是 volumes 里已有的卷 id**（`SKELETON_REF_MISSING` 会查）
+- **同一卷内 `act_index` 不能重复**（`ACT_INDEX_DUP` 会查）
+- **`main_line_span[].main_line` / `branch_span[].branch` 必须是实体清单里的 id**（`SKELETON_REF_MISSING` 会查）
+- **`main_line_span` 的条数 = 主线数，`branch_span` 的条数 = 支线数**（与实体清单一致）
+- **`volume_ratio` 是数组，元素在 [0,1] 内**（`SPAN_RATIO_RANGE` 会查）
+- **不许出现章节号**（`SKELETON_CHAPTER_FORBIDDEN` 会查）
+
+---
+
+<!-- contract:consistency -->
+## 十、本阶段全量校验清单
+
+全量模式（插件在四个文件都产出后跑一次）检查以下项目：
+
+| 检查 | 错误代码 | 类型 |
+|---|---|---|
+| 章节号越界 | `SKELETON_CHAPTER_FORBIDDEN` | error |
+| 模板结构 | `EXTRA_FIELD` / `REQUIRED` / `TYPE` / `PATTERN` / `ENUM` / `ENUM_MISSING` | error |
+| 字符集 | `CHARSET_KO` / `CHARSET_JP` | error |
+| 占位符 | `PLACEHOLDER` | error |
+| ID 唯一 | `ID_DUP` | error |
+| 名称唯一 | `NAME_DUP` | error |
+| 名称软重复 | `NAME_ALIAS_SUSPECT` | warning |
+| derivations 完整性 | `DERIVATION_MISSING` / `DERIVATION_EXTRA` | error |
+| derivations 区间 | `DERIVATION_RANGE_MISMATCH` | error |
+| derivations 公式文本 | `DERIVATION_FORMULA_TEXT` | warning |
+| 数量偏离 | `QUANTITY_MISMATCH` | warning |
+| capacity 一致性 | `CAPACITY_MISMATCH` | error |
+| volume_ratio 长度/总和/取值 | `VOLUME_RATIO_LENGTH` / `VOLUME_RATIO_SUM` / `VOLUME_RATIO_RANGE` | error |
+| span 长度 | `SPAN_LENGTH_MISMATCH` | error |
+| span 比例范围 | `SPAN_RATIO_RANGE` | error |
+| 关系引用 | `SKELETON_REF_MISSING` | error |
+| 图孤立 | `G_ISOLATED` | error |
+| 核心子图连通 | `G_DISCONNECTED` | warning |
+| 势力关系对称 | `G_REL_ONE_WAY` / `G_REL_ASYMMETRIC` | error |
+| **quota 一致性** | **`QUOTA_MISMATCH`** | **error** |
+| **全书级结局数量** | **`BOOK_ENDING_COUNT`** | **error** |
+| **卷数量一致** | **`VOLUME_COUNT_MISMATCH`** | **error** |
+| **act_index 唯一** | **`ACT_INDEX_DUP`** | **error** |
+| **关系组合重复** | **`ID_DUP`** | **error** |
+| 关系类型语义 | `REL_KIND_CONFLICT` / `REL_ASYMMETRIC_INCOMPATIBLE` | error |
+| 关系自环 | `NO_SELF_RELATION` | error |
+| 内容质量 | `NAME_PLACEHOLDER` / `TEXT_PLACEHOLDER` / `TEXT_TOO_SHORT` / `TEXT_DUPLICATE` | error |
+| 规则分类与前缀 | `WORLD_RULE_CATEGORY_MISMATCH` | error |
+| 下游节奏可行性 | `RHYTHM_INFEASIBLE_PRECHECK` | error |
+
+**注**：加粗的 5 项是核心检查项，生成时必须保证通过。
+
+---
+
+<!-- contract:errors -->
+## 十一、常见错误代码速查（详见 glossary 与脚本）
+
+| code | 含义 | 修复方向 |
+|---|---|---|
+| `EXTRA_FIELD` | 模板外字段 | 删除该字段 |
+| `REQUIRED` | 必填为空 | 补值 |
+| `TYPE` | 类型错误 | 按模板改 |
+| `PATTERN` | 正则不匹配 | 按 ID 规范改 |
+| `ENUM` | 枚举值非法 | 查第七、八节的枚举表 |
+| `ENUM_MISSING` | 枚举未定义 | 查 glossary |
+| `SKELETON_CHAPTER_FORBIDDEN` | 骨架出现章节号 | 删除，移到节奏阶段 |
+| `SKELETON_REF_MISSING` | 关系引用的 id 不存在 | 改成实体清单里已有的 id |
+| `BRANCH_MAINLINE_UNLINKED` | 有支线没挂到任何主线 | 给每条支线补一行 `main_line_branch_relation` |
+| `MAINLINE_BRANCH_UNLINKED` | 有主线没挂任何支线 | 给这条主线补支线关系 |
+| `ID_DUP` | 同文件 ID 重复 / 关系组合重复 | 重新编号 / 删重复 |
+| `NAME_DUP` | 名称重复 | 改名 |
+| `NAME_ALIAS_SUSPECT`（warning） | 归一化后同名，疑似同一实体的全称/简称/别名 | 确认后只保留正式名，合并另一条 |
+| `CHARSET_KO` / `CHARSET_JP` | 含韩文/日文 | 删除 |
+| `PLACEHOLDER` | 含占位符 | 改为具体值 |
+| `DERIVATION_MISSING` | 缺推导记录 | 补 derivations |
+| `DERIVATION_EXTRA` | 多写推导记录 | 删除多余 key |
+| `DERIVATION_RANGE_MISMATCH` | 区间与公式不符 | 按公式重算 |
+| `DERIVATION_FORMULA_TEXT`（warning） | formula 文本不符 | 逐字复制 formulas-skeleton.json |
+| `DERIVATION_EVAL` | 公式表达式本身求值失败 | 这是公式定义的问题，不是你写的数字；照抄公式即可（若仍报错说明插件内置公式有误） |
+| `CAPACITY_MISMATCH` | 平均字数与总字数/章数不符 | 改 avg_words_per_chapter |
+| `VOLUME_RATIO_LENGTH` | volume_ratio 长度与 volume_count 不符 | 补齐或删除 |
+| `VOLUME_RATIO_SUM` | volume_ratio 之和不为 1.0 | 调整比例 |
+| `VOLUME_RATIO_RANGE` | volume_ratio 里某项的 chapter_ratio 不在 [0,1] 内（负数会让节奏阶段算出负的期望章数） | 按各卷实际章数重新分配比例 |
+| `VOLUME_COUNT_MISMATCH` | 层级 volumes 长度与 quota.volume_count 不符 | 补齐或删除 |
+| `SPAN_LENGTH_MISMATCH` | span 长度与主线/支线数不符 | 补齐 |
+| `SPAN_RATIO_RANGE` | span 的 volume_ratio 元素不在 [0,1] 内 | 调整 |
+| `ACT_INDEX_DUP` | 同卷内 act_index 重复 | 改为唯一值 |
+| `QUOTA_MISMATCH` | quota 声明值与实体数组实际数量不符 | 调整 quota 或实体 |
+| `BOOK_ENDING_COUNT` | 全书级结局数量不是恰好 1 个 | 调整结局的 level |
+| `G_ISOLATED` | 孤立节点 | 补引用 |
+| `G_DISCONNECTED`（warning） | 核心子图不连通 | 补角色/冲突/势力关系 |
+| `G_REL_ONE_WAY` | 势力对立单向 | 补另一方向 |
+| `G_REL_ASYMMETRIC` | 势力关系不对称 | 统一双向 |
+| `QUANTITY_MISMATCH`（warning） | 数量偏离公式区间 | 在 note 写理由，或调回区间 |
+| `WORLD_RULE_CATEGORY_MISMATCH` | 规则 id 前缀与 `category` 字段不匹配 | R→核心规则，I→信息规则，SR→社会规则（骨架只有 `world_rules` 一个数组） |
+| `CROSS_TYPE_NAME_DUP`（warning） | 跨类型同名（含归一化后的全称/简称） | 改名，避免跨类型歧义 |
+| `EMPTY_HARD_CONSTRAINTS` | 硬门禁为空 | 至少写一条硬约束，或确认任务输入本就没有 |
+| `NO_SELF_RELATION` | 关系两端相同 | 删掉自环 |
+| `REL_KIND_CONFLICT` | 同一有序对写了两种关系类型 | 保留一种 |
+| `REL_LABEL_REQUIRED` | `relation_kind=其他` 或 `other_relations` 缺 `relation_label` | 补具体关系名（附身/寄生/契约/共生） |
+| `REL_ASYMMETRIC_INCOMPATIBLE` | 同一对角色正反两个方向的关系语义冲突 | 统一成一个意思 |
+| `REL_KIND_META_DRIFT` | 关系词表与元数据不同步 | 脚本/词表不同步，停下来上报 |
+| `NAME_PLACEHOLDER` | 实体名是"主角1"这类占位名 | 换成有辨识度的专名 |
+| `TEXT_PLACEHOLDER` | 字段内容是"待补充/TBD/xxx"这类占位 | 写实内容 |
+| `TEXT_TOO_SHORT` | 字段内容过短 | 补成一句具体的事实 |
+| `TEXT_DUPLICATE` | 两个实体的同一字段几乎一字不差 | 各写各的具体内容 |
+| `RHYTHM_INFEASIBLE_PRECHECK` | 卷数/分支数组合下游节奏阶段无解 | **看错误里的方向**：支线数太少就调大 `branch_count`，太多就调小；不要凭感觉改 |
+| `NEED_ALL_CHECK`（warning） | 单检通过，但还缺全量校验 | 四个文件单检都通过后跑一次 `--all` |
+
+---
+
+<!-- contract:forbidden -->
+## 十二、本阶段禁令（13 条）
+
+1. **不得出现任何章节号**（`chapter` / `ch` / `start` / `end` / `appearance_chapters` / `chapter_range` / `buried_chapter` / `recovered_chapter` / `key_nodes` 等，完整清单见 glossary 第六节）。骨架脚本会报 `SKELETON_CHAPTER_FORBIDDEN`。
+
+2. **不得出现模板外字段**（`EXTRA_FIELD` 会拦截）。数据文件顶层只允许模板 `structure.properties` 中定义的字段。
+
+3. **实体清单只写 `id` + `name` + 枚举字段**（描述属于血肉阶段）。`EXTRA_FIELD` 会拦截。
+
+4. **关系清单只写 ID 引用 + 关系类型枚举**（描述属于血肉阶段）。`EXTRA_FIELD` 会拦截。
+
+5. **本阶段只输出 4 个 JSON**，不预先编写血肉/节奏/写作的任何字段。
+
+6. **`derivations` 必须包含 formulas-skeleton.json 的全部 30 条记录**，不多不少。每条 value 为 `{formula, range_low, range_high, note}`，`formula` 逐字一致。
+
+7. **数量偏离公式区间时在 note 写明理由**（会产生 warning，不阻塞）。不得默默偏离。
+
+8. **不声称"已读取"参考文件**；引用了哪份文件就说明它的路径与作用。
+
+9. **JSON 语法符号用英文**（`{` `}` `[` `]` `:` `,` `"`），字符串内容用中文标点。
+
+10. **不输出"通过/完成/PASS/✅"等结论词**。只有插件校验通过后才会有结论，那是插件说的，不是你说的。
+
+11. **不得修改 `模板/` 和 `references/` 下的任何文件**。`模板/` 是骨架阶段的结构来源，`references/` 是规则/公式/枚举/glossary 来源，两者都是**只读输入**。脚本若存在缺陷，停下来上报（原因：脚本缺陷）；**严禁为了"通过校验"而修改 scripts 下的 validator 或 references 下的规则文件**。所有脚本与参考文件的修改由项目维护者通过 plugin 升级路径完成。**本阶段的输出目录 `设定/raw/sources/骨架/` 是你要写的产物**，不是只读输入。
+
+12. **关系类型只取第八节的两套词表**；实体名用真名，叙述字段写实内容。
+
+13. **只写本轮指令指定的那一个分片文件**。不要写别的文件，不要改已经产出的文件 —— 插件会负责把分片合并成最终产物。