@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

package/plugins/fancy-story-builder/references//351/252/250/346/236/266/346/214/207/345/257/274/04-conflict.md

@@ -0,0 +1,328 @@
+# 矛盾与结构
+
+> 骨架阶段第 4 份。在实体格局基础上，建主线矛盾、双线、死亡赌注、黏结剂。
+> 本文件只讲方法论，不讲数量（→ formulas），不讲结构（→ 模板），不讲验证（→ 脚本）。
+
+---
+
+## 一、决策路由
+
+| 你在设计什么 | 用哪节 |
+|---|---|
+| 确定主线矛盾 | §2 矛盾设计 |
+| 搭建主线结构 | §3 结构方法 |
+| 设计冲突 | §4 冲突设计 |
+| 设计对抗 | §5 对抗设计 |
+| 设计循环/核心梗 | §6 循环设计 |
+| 设计动机/困境 | §7 动机与困境 |
+
+---
+
+## 二、矛盾设计
+
+### 2.1 矛盾四重递进（可裁剪）
+
+按顺序递进：人与自我 → 人与自然 → 人与人 → 人与世界。
+
+裁剪规则：
+- 言情/职场/宅斗：跳过"人与自然"，用"人与自我 → 人与人 → 人与世界"
+- 末世/灾难：用"人与自然 → 人与人 → 人与世界"
+- 悬疑/推理：用"人与自我 → 人与人"（世界层可选）
+- 正剧/历史：四层全用
+
+### 2.2 底层矛盾建设世界
+
+从最根源、最不可调和的矛盾开始架设世界观。确保核心梗不偏离，否则中期订阅下降。
+
+示例：修行者每突破一境消耗一座灵矿，灵矿不可再生 → 高阶修行者必须争夺低阶修行者的灵矿 → 宗门战争的根本动机。这能推导出至少三个具体冲突。
+
+**判断标准**：世界本质必须能推导出至少三个具体冲突。写不出 = 世界本质太虚。
+
+### 2.3 三种动机来源
+
+| 来源 | 操作方式 |
+|---|---|
+| 世界背景 | 设定环境迫使主角变强（妖魔乱世 → 没实力就没自保之力） |
+| 金手指 | 利用金手指机制产生利益驱动（斩妖获得实力） |
+| 人物关系 | 通过亲朋遭遇制造情感驱动（被欺负/被杀 → 复仇/救人） |
+
+主角至少占两种动机来源。
+
+### 2.4 动机变化过渡
+
+- 危机解除后，立即通过配角/反派强调"更强力量才能生存"，自然过渡到下一阶段
+- 生死危机不适合所有题材——调整困难烈度匹配题材边界
+- 上一个危机解决时必须埋下下一个危机的伏笔
+
+### 2.5 矛盾来源分类
+
+| 来源 | 适用场景 |
+|---|---|
+| 资源/利益 | 通用 |
+| 阵营/种族 | 奇幻、玄幻 |
+| 超凡途径 | 诡秘类 |
+| 信仰/宗教 | 西幻、历史 |
+| 政教之争 | 中世纪、权谋 |
+| 理念/三观 | 所有题材 |
+
+### 2.6 死亡赌注（贯穿全书选一种）
+
+| 赌注类型 | 适用场景 | 操作要点 |
+|---|---|---|
+| 肉体死亡 | 恐怖诡异文 | 主角过强时赌注必须转为事业死亡，否则全书崩溃 |
+| 事业死亡 | 职场竞争、修仙门派争斗 | 失败 = 一切归零 |
+| 心理死亡 | 感情崩塌、信念毁灭 | 情绪冲击最深，优先用于感情线 |
+
+选一种作为主要赌注贯穿全书，其他辅助推动情节。
+
+### 2.7 黏结剂（对立双方无法轻易脱身）
+
+四种黏结剂：
+- **杀人理由**：序列唯一性必然冲突
+- **工作职责**：职责所在，不能退出
+- **道德责任**：亲人遇险，无法撒手
+- **实体场所**：副本密室，被困一处
+
+---
+
+## 三、结构方法
+
+### 3.1 高潮逆推法
+
+步骤：
+1. 先确定一句话结局
+2. 从结局逆推各级目标，层级由小到大：家庭 → 村 → 镇 → 县 → 市 → 省 → 国 → 世界
+3. 大主线拆为中主线，中主线拆为小主线，不断细化
+4. 小主线完成后，中主线变为新的小主线，循环推进
+
+逆推方向：结局 → 最后一战 → 决战前需要什么 → 需要什么资源/盟友/能力 → 逐个拆解
+
+### 3.2 主线 = 冲突驱动
+
+主线故事 = 解决冲突。将大冲突拆分为多个小冲突形成故事线。每个阶段必须有一个无法解决的核心冲突。
+
+### 3.3 支线 = 完成主线的手段
+
+按此逻辑组织支线：赚钱（主线）→ 怎么赚（支线）→ 用什么赚（金手指确认）。支线最终必须汇聚为主线。
+
+### 3.4 双线结构法
+
+明线与暗线：
+- **明线**：主角线（读者直接看到的行动和成长）
+- **暗线**：反派线/隐藏元素线（目的：衔接、铺垫、嵌套后续剧情）
+- 暗线后期必须与明线交汇，形成卷内高潮
+
+四象限结构：
+
+| | 明线 | 暗线 |
+|--|------|------|
+| 主线 | 主角能力升级+核心剧情推进 | 反派暗中行动/隐藏信息线 |
+| 支线 | 资源线、人脉线、地位线 | 配角暗线 |
+
+性价比最高的结构：明线有主线+支线（"二带一"），暗线只有主线。
+高潮阶段：暗线与明线融合，支线融合到主线或暂时放下。
+
+**注**：AB 交织法（升级线 + 剧情线交织）属于节奏阶段，不在骨架阶段展开。
+
+---
+
+## 四、冲突设计
+
+### 4.1 设门槛拉长剧情法
+
+| 门槛类型 | 操作方式 |
+|---|---|
+| 系统门槛 | 第一次免费升级，第二次需要资源，后续分普通/超级两档 |
+| 目标门槛 | 考进顶级院校需要气血值+灭杀战绩+比赛排名，逐个完成 |
+| 收集门槛 | 突破境界需要收集多个物品，逐个寻找 |
+| 消耗门槛 | 资源太多时提高门槛消耗掉 |
+
+### 4.2 三大驱动力反推剧情法
+
+| 驱动力 | 操作方式 |
+|---|---|
+| 戏剧性 | 设计意外收获、阴差阳错 |
+| 矛盾 | 设计无法避免的冲突/灾难 |
+| 欲望/恐惧 | 利用想得到什么/害怕失去什么 |
+
+操作步骤：先确定主角阶段性成长（金手指升级/武力提升/CP 好感/宝具/大佬人脉/金钱/地位），给每个成长尝试三种驱动力反设计剧情。
+
+### 4.3 冲突设计要点
+
+- 冲突必须升级：言语 → 行动 → 激烈对抗 → 决定胜负
+- 冲突必须有明确结果
+- 本质是"有人阻止主角得到他想要的东西"
+- **矛盾 vs 冲突**：矛盾是一级结构（全书/全卷层面），冲突是二级结构（具体场景层面）。矛盾决定主线方向，冲突是具体表现
+
+### 4.4 第一幕陷阱
+
+主角在解决第一个冲突的过程中，为导致下一个冲突爆发而埋伏笔。功能：让故事自然衔接。
+
+### 4.5 超额收获技巧
+
+经典模式：Boss 爆三样东西——1. 主角接着就能用的；2. 可以送人拉关系的；3. 暂时用不到但一看就很厉害的。
+
+---
+
+## 五、对抗设计
+
+### 5.1 压势不压人
+
+反派不针对主角个人，而是针对一个地区/阶层/群体的规划，客观上导致主角陷入困境。
+
+操作步骤：
+1. 给反派设定自己的目的（如打压某地区修行者）
+2. 让主角身处被压迫环境
+3. 主角推翻反派后，底层人依旧麻木
+4. 底层人也可能利用主角善意攫取利益 → 新冲突
+
+避免读者憋屈：给一个被帮者的正面反馈，或给主角一个私人收获（不让主角白干）。
+
+### 5.2 反派视角与信息差
+
+功能：转视角到反派密谋，制造读者知道而主角不知道的信息差：深化反派人设、拉期待感、让读者期待反派被打脸。
+
+写法：不要谜语人——大大方方写出反派计划。信息差 = 提前让读者知道部分信息，制造期待。
+
+### 5.3 主角行动力三维度
+
+| 维度 | 含义 | 示例 |
+|---|---|---|
+| 做别人不敢做的事 | 反抗权威，挑战强者 | 斩上司 |
+| 做别人做不到的事 | 死里逃生，超越极限 | 必死局面生还 |
+| 做别人没想到可以这么做的事 | 阴差阳错，曲线救国 | 用烤肠秘籍凑收藏 |
+
+戏剧性是展现行动力的方法，人设是行动的缘由。不能为了意外崩人设。
+
+### 5.4 逼格反应正反判定
+
+| 情况 | 判定 |
+|---|---|
+| 高实力轻描淡写 | 对 |
+| 高实力暴怒反击 | 掉逼格 |
+| 低实力隐忍蓄力 | 对 |
+| 低实力轻描淡写 | 装逼过度，需铺垫 |
+
+---
+
+## 六、循环设计
+
+### 6.1 循环设计
+
+核心创意点 → 挖掘核心卖点 → 定主线 → 金手指配合主线衍生。
+
+### 6.2 核心梗三分法
+
+核心梗的分类见 `01-positioning.md` §6。这里补充运行节奏：
+
+- **第一个一级结构中必须运行一次核心梗**（或完成首次铺垫）
+- 连续多个一级结构不运行 = 读者弃书
+- **双线构思法**：布两条线——一条重复运行核心梗，另一条不重复，交替推进
+
+### 6.3 按题材设计循环核心
+
+| 题材 | 循环核心 | 持续条件 |
+|---|---|---|
+| 肝熟练度/低位开局 | 地图（训练场/地头蛇/破坏者） | 地图不崩 |
+| 长生 | 社会变迁 | 社会一直在变 |
+| 无限游戏 | 副本与现实 | 副本现实不崩 |
+| 公路文 | 人际交往 | 人物不崩 |
+| 无敌流 | 敌人 | 敌人不崩 |
+| 种田/签到/囤积 | 外部环境破坏 | 外部持续被破坏 |
+| 脑洞文 | 核心卖点循环 | 核心卖点不偏 |
+
+警告：循环偏离核心卖点 = 失去差异化竞争力。
+
+---
+
+## 七、动机与困境
+
+### 7.1 给人物一个梦想
+
+| 概念 | 特征 | 示例 |
+|---|---|---|
+| 动机 | 外力推动，趋向物质 | 因为穷 → 想买大房子 |
+| 梦想 | 内在驱动，追求精神 | 想当伟大的作家 |
+
+操作：除了外在压迫/利益驱动，再给人物一个"梦想"。两个层次结合，人物自然鲜活。
+
+人物目标必须结合人设——杂役弟子梦想拯救宗门缺乏说服力，宗门圣女拯救宗门就合理。
+
+### 7.2 困境循环结构（极道流）
+
+```
+困境（环境压迫）→ 行动（运行金手指）→ 转折（更大困境）→ 行动（更强实力突围）
+```
+
+核心：不停给主角上强度，主角始终主动解决问题。搭配扮猪吃虎 + 情绪拉扯 + 装逼打脸。
+
+要点：压迫有度，让读者觉得主角有破局希望；后期压力必须高于前期。
+
+### 7.3 设定推演剧情法
+
+核心公式：环境 + 人物 = 情节。
+
+步骤：
+1. 给出环境（时间/地点/情境）
+2. 给出人物（身份/关系/动机/弱点/梦想/过往）
+3. 每增加一个设定点，扮演法做逻辑推演
+4. 筛选最符合核心情绪的设定组合
+
+### 7.4 噱头-主线-核心爽点框架
+
+| 类型 | 特点 | 开篇写法 |
+|---|---|---|
+| 事件噱头 | 书名就是事件 | 一上来就进入事件（可与黄金五章并行） |
+| 金手指噱头 | 分布在全文，前期多后期少 | 先描写主角 → 困境 → 目标 → 金手指施展 → 少许成果 |
+| 人设噱头 | 人设直接影响剧情 | 人设本身产生戏剧性 |
+
+事件结束后立马嫁接主角目标。也可以在事件进行中就铺垫目标。
+核心爽点 = 切在主线上的爽点。偏离主线的装逼是偏移爽点，不是核心爽点。
+
+---
+
+## 八、示例
+
+一本都市复仇文的矛盾设计：
+
+- **矛盾四重**：人与自我（主角是否要跨越法律）→ 人与人（主角 vs 园区）→ 人与世界（个人复仇 vs 法治秩序）
+- **底层矛盾**：缅北园区的电诈利润支撑当地军阀，军阀又反过来保护园区 → 无法通过正常渠道瓦解
+- **三种动机来源**：世界背景（园区的存在本身就是犯罪）+ 人物关系（妹妹被害）
+- **死亡赌注**：事业死亡（主角如果不复仇，他会一生无法原谅自己）
+- **黏结剂**：道德责任（妹妹的尸骨在园区里）
+
+---
+
+## 九、常见反例
+
+| 反例 | 为什么错 | 正确做法 |
+|---|---|---|
+| 矛盾只到"人与人" | 层次单一，深度不够 | 按题材裁剪，至少到"人与自我" |
+| 世界本质写"弱肉强食" | 空话，推导不出具体冲突 | 写具体规则（"灵矿不可再生"） |
+| 死亡赌注每次换 | 读者感受不到真正的威胁 | 全书贯穿一种 |
+| 黏结剂缺失 | 对立双方随时可以退出 | 补一种黏结剂 |
+| 反派没有独立目的 | 反派成为工具人 | 给反派设定自己的目标 |
+| 压人而非压势 | 读者憋屈 | 压势不压人 |
+
+---
+
+## 十、与其他文件的关系
+
+| 本文件输出 | 落到哪个字段 | 参考哪个公式 | 由哪个脚本验证 |
+|---|---|---|---|
+| 核心冲突 | `实体.json` 的 `conflicts`（type = 核心） | `fixed.conflict_elements.core_conflict_count`（固定 1） | `skeleton-validate.js` 的 `QUANTITY_MISMATCH`（warning） |
+| 阶段/交织冲突 | `实体.json` 的 `conflicts` | `conflict_elements.phase_conflict_count` / `conflict_elements.branch_conflict_count` | 同上 |
+| 冲突参与方 | `关系.json` 的 `conflict_participants` | 无公式 | `skeleton-validate.js` 的 `SKELETON_REF_MISSING` |
+| 势力间矛盾 | `关系.json` 的 `faction_relations` | `faction_elements.faction_relation_count`（理论上限） | `G_REL_ONE_WAY` / `G_REL_ASYMMETRIC` |
+| 双线结构 | 不落入骨架 JSON（属于血肉阶段的"冲突内容"） | 无公式 | 无 |
+| 死亡赌注 / 黏结剂 | 不落入骨架 JSON（属于血肉阶段的内容描述） | 无公式 | 无 |
+| 反派四层 | `实体.json` 的 `characters`（type 用 `贯穿级核心反派` / `卷级反派`） | `character_elements.core_antagonist_count` / `volume_antagonist_count` | `QUANTITY_MISMATCH`（warning） |
+
+---
+
+## 十一、版本记录
+
+| 版本 | 变更 |
+|---|---|
+| v1.0 | 从原 01-05 §1-2 精简。删除"AB 交织法"（移到节奏阶段）；删除"感情线四阶段"（比例属于节奏阶段）；删除"救赎文八法"（属血肉阶段的细化，不在骨架展开）；删除所有检查清单；新增"与其他文件的关系"节 |
+| v1.1 | 按合规检查修订：§2.2 "至少 3 个具体冲突" → "至少三个具体冲突"；"推导出至少 3 个" → "推导出至少三个" |

package/plugins/fancy-story-builder/references//351/252/250/346/236/266/346/214/207/345/257/274/05-quota.md

@@ -0,0 +1,187 @@
+# 数量决策
+
+> 骨架阶段第 5 份。在公式区间内选定各实体数量。
+> 本文件只讲"怎么选"，不写"区间是多少"（→ `formulas-skeleton.json`），不写"JSON 怎么写"（→ `模板/骨架/框架模板.json`）。
+
+---
+
+## 一、决策路由
+
+| 你在做什么 | 用哪节 |
+|---|---|
+| 理解数量从哪来 | §2 数量来源 |
+| 在区间内选终值 | §3 选值原则 |
+| 偏离区间时写理由 | §4 偏离记录 |
+| 检查 derivations 完整性 | §5 完整性要求 |
+
+---
+
+## 二、数量来源
+
+所有数量的**区间**由 `references/formulas-skeleton.json` 定义。每条公式有：
+- `formula`：公式文本
+- `expr_low` / `expr_high`：区间上下界
+- `applies_to_field`：管哪个 JSON 字段
+- `note`：为什么是这个区间
+
+**你要做的不是"算公式"**（脚本会算），**而是"在区间内选一个终值"**，并在 `derivations` 中记录。
+
+---
+
+## 三、选值原则
+
+### 3.1 选值区间
+
+每个字段都有 `[low, high]` 区间。你需要在区间内选一个整数（或指定的小数）。
+
+- **短篇（T 小）**：倾向选下界，避免实体过多
+- **长篇（T 大）**：倾向选中间，保证有足够多样性
+- **超长篇（T 超大）**：倾向选接近上界但不超过绝对上限
+
+### 3.2 核心实体优先
+
+某些实体是"骨架必须有"的，选值时优先保证它们：
+- 主角：必须有 1 个
+- 核心冲突：固定 1 个
+- 主线：固定 1 条
+- 全书级结局：必须有 1 个
+
+其他实体（配角/反派/支线/道具/伏笔/高潮/爽点/地点）可以在区间内灵活选。
+
+### 3.3 相互依赖关系
+
+部分字段之间有依赖关系（公式里的 `V` 依赖 `volume_count`，`BC` 依赖 `branch_count`）：
+- **先选 Level 1 字段**（只依赖 T 或固定值）
+- **再选 Level 2 字段**（依赖 V）
+- **最后选 Level 3 字段**（依赖其他实体数）
+
+**顺序错乱会导致依赖链断裂**。按 `prompts/01-skeleton-prompt.md` 的 6.3 拓扑顺序逐个选。
+
+### 3.4 题材适配
+
+公式只给区间，不给终值。终值应与题材匹配：
+- **升级流**：配角数偏上界（需要大量单元对手），反派数偏上界（每个阶段一个对手）
+- **言情**：核心配角数偏下界（关系集中），反派数偏下界（聚焦感情线）
+- **群像**：配角数偏上界，势力数偏上界
+- **悬疑**：地点数偏上界（多个案发现场），反派数居中（避免"凶手太多"）
+
+这些是"选值倾向"，不是"硬性规则"。脚本只校验区间，不校验倾向。
+
+---
+
+## 四、偏离记录
+
+### 4.1 何时可以偏离
+
+如果某个字段的实际值**超出**公式区间，必须在 `derivations[公式名].note` 写明理由。超区间会产生 `QUANTITY_MISMATCH` warning（**不阻塞**）。
+
+**可以偏离的场景**：
+- 题材有特殊要求（如"无限流"天然需要更多副本=更多地点）
+- 用户硬门禁要求（如"必须 3 个主角"）
+- 叙事需要（如"每个卷 2 个反派，共 6 卷 → 12 个反派"超过上界）
+
+**不可以偏离的场景**：
+- 懒得算，随便填个数
+- 不读公式，凭感觉
+- 想让 LLM"自由发挥"
+
+### 4.2 note 的写法
+
+好的 note：
+- "题材为无限流，需要更多副本场景，地点数超出上限"
+- "用户要求三主角并列，与公式的最大值 2 不一致"
+- "共 6 卷，每卷 2 个反派，共 12 个，公式上限 15 未超"
+
+坏的 note：
+- "数字大一点好看"
+- "没算"
+- "随意"
+
+---
+
+## 五、derivations 完整性要求
+
+`derivations` 必须包含 `formulas-skeleton.json` 的**全部 30 条记录**（含 `fixed.*` 固定值），不多不少。
+
+每条记录的格式：
+```
+"derivations": {
+  "<公式名>": {
+    "formula": "<逐字复制 formulas-skeleton.json 的 formula>",
+    "range_low": <数字>,
+    "range_high": <数字>,
+    "note": "<可选字符串>"
+  }
+}
+```
+
+**关键**：
+- `formula` 必须逐字一致（`DERIVATION_FORMULA_TEXT` warning 会检查）
+- `range_low` / `range_high` 必须与公式计算结果一致（`DERIVATION_RANGE_MISMATCH` error 会检查）
+- 缺 key 报 `DERIVATION_MISSING`
+- 多 key 报 `DERIVATION_EXTRA`
+
+---
+
+## 六、示例
+
+假设 T = 300，选 V = 5。公式计算：
+
+```
+structure.volume_count：max(1, ceil(300/120)) ~ max(max(1, ceil(300/120)), min(max(1, ceil(300/40)), 30)) = 3 ~ 8
+structure.branch_count：max(1, ceil(5/2), ceil(floor(300*0.3)/30)) ~ max(max(1, ceil(5/2), ceil(floor(300*0.3)/30)), min(floor(ceil(300*0.5)/3), max(5*3, 15, ceil(floor(300*0.3)/30)))) = 3 ~ 15
+character_elements.volume_supporting_count：5*3 ~ min(5*5, 30) = 15 ~ 25
+```
+
+选值：
+- V = 5（区间 3~8，选中间）
+- branch_count = 6（区间 3~15，选偏下，因为要写紧凑）
+- volume_supporting = 18（区间 15~25，选偏下）
+
+对应 derivations：
+```
+"structure.volume_count": {
+  "formula": "max(1, ceil(T/120)) ~ max(max(1, ceil(T/120)), min(max(1, ceil(T/40)), 30))",
+  "range_low": 3,
+  "range_high": 8,
+  "note": "T=300，选 5 卷，每卷 60 章"
+},
+"structure.branch_count": {
+  "formula": "max(1, ceil(V/2), ceil(floor(T*0.3)/30)) ~ max(max(1, ceil(V/2), ceil(floor(T*0.3)/30)), min(floor(ceil(T*0.5)/3), max(V*3, 15, ceil(floor(T*0.3)/30))))",
+  "range_low": 3,
+  "range_high": 15,
+  "note": "选 6 条，每条平均 15 章"
+}
+```
+
+---
+
+## 七、常见反例
+
+| 反例 | 为什么错 | 正确做法 |
+|---|---|---|
+| derivations 缺某条 | `DERIVATION_MISSING` 报错 | 补齐全部 30 条 |
+| range 与公式不符 | `DERIVATION_RANGE_MISMATCH` 报错 | 用公式重算 |
+| formula 文本不一致 | `DERIVATION_FORMULA_TEXT` warning | 逐字复制 |
+| 偏离区间但不写 note | 读者/审阅者不知道原因 | 写清理由 |
+| 选值完全不看题材 | 产出同质化 | 按 §3.4 适配 |
+| Level 3 字段先选 | 依赖链断裂 | 按拓扑顺序选 |
+
+---
+
+## 八、与其他文件的关系
+
+| 本文件输出 | 落到哪个字段 | 参考哪个公式 | 由哪个脚本验证 |
+|---|---|---|---|
+| 数量配额 | `框架.json` 的 `quota` 各字段 | `formulas-skeleton.json` 的 30 条公式 | `skeleton-validate.js` 的 `QUANTITY_MISMATCH`（warning）/ `DERIVATION_*` |
+| 卷级章数比例 | `框架.json` 的 `volume_ratio` | 无公式（但 length 应等于 `quota.volume_count`，sum 应等于 1.0） | `VOLUME_RATIO_LENGTH` / `VOLUME_RATIO_SUM` |
+| 推导记录 | `框架.json` 的 `derivations` | `formulas-skeleton.json` | `DERIVATION_MISSING` / `DERIVATION_EXTRA` / `DERIVATION_RANGE_MISMATCH` / `DERIVATION_FORMULA_TEXT` |
+
+---
+
+## 九、版本记录
+
+| 版本 | 变更 |
+|---|---|
+| v1.0 | 从原 01-07 §2 提取重组。将"伏笔密度公式"从指导文件移出（现在在 formulas-skeleton.json）；本文件只保留"怎么选"的方法论；新增"与其他文件的关系"节 |
+| v1.1 | 修正 30 条公式的表述（原版写 27 条，与 formulas-skeleton.json v1.1 的 30 条不一致）；§五 与 §七 两处 "27 条" → "30 条" |

package/plugins/fancy-story-builder/references//351/252/250/346/236/266/346/214/207/345/257/274/06-audit.md

@@ -0,0 +1,160 @@
+# 骨架验证
+
+> 骨架阶段最后一份。横向验证流程与问题记录。**所有验证由脚本执行，本文件不写检查清单。**
+
+---
+
+## 一、验证流程
+
+骨架阶段的验证分两级：
+
+1. **单文件校验**：每个文件生成后立即跑（见提示词的"七、每文件生成循环"）
+2. **全量校验**：4 个文件全部单检通过后跑
+
+本文件不重复单文件校验的流程（那在 `prompts/01-skeleton-prompt.md` 的"七"），只讲**全量校验失败后怎么处理**。
+
+---
+
+## 二、全量校验后的处理
+
+全量校验返回 `status: 1` 时，按以下流程：
+
+### 2.1 按文件分组
+
+`errors[]` 每条有 `path` 字段，指向骨架内部的字段路径。按"根因文件"分组：
+
+| 错误的根因 | 应回改的文件 |
+|---|---|
+| `EXTRA_FIELD`（框架相关字段） | 框架.json |
+| `DERIVATION_*` | 框架.json |
+| `VOLUME_RATIO_*` | 框架.json |
+| `CAPACITY_MISMATCH` | 框架.json |
+| `PATTERN` / `ENUM` / `TYPE` / `REQUIRED` | 看 `path` 前缀 |
+| `SKELETON_REF_MISSING`（关系.json 的引用） | 关系.json |
+| `G_ISOLATED`（某节点） | 实体.json（补实体）或 关系.json（补关系） |
+| `G_DISCONNECTED` | 关系.json（补核心子图连接） |
+| `G_REL_ONE_WAY` / `G_REL_ASYMMETRIC` | 关系.json |
+| `SPAN_LENGTH_MISMATCH` | 层级.json |
+
+### 2.2 改根因文件
+
+一次只改一类错误：
+- 先修 error，再修 warning
+- 同类错误一起修
+- 不顺手改其他字段（防止修 A 破坏 B）
+
+### 2.3 重跑受影响文件的单检
+
+改完某个文件后，只跑该文件的单检：
+
+```bash
+node references/skeleton-validate.js \
+  --input=设定/raw/sources/骨架/<文件名>.json \
+  --template=模板/骨架/<文件名>模板.json \
+  --file=<类型> \
+  --upstream=设定/raw/sources/骨架
+```
+
+**单检的返回怎么判**（返回是 JSON，判定看 `status`，**没有 `ok` 字段**）：
+
+| status | 含义 | 怎么办 |
+|---|---|---|
+| `0` | 这个文件过了 | 接着做下一个文件；4 个都过了才重跑全量 |
+| `1` | 这个文件的内容有问题 | 看 `errors[]`：按 `path` 定位字段、按 `hint` 改，**只改 `errors` 指出的字段**，改完重跑这条单检 |
+| `2` | **脚本自己没跑完，不是这个文件的问题** | 看 **stdout** 的 `errors[0].message`（**stderr 是空的**）：多半是 `--template` 路径错、`--upstream` 目录不存在。**改命令，不要改文件** |
+
+**`status:2` 的原因不在 stderr** —— 这是最容易踩的坑：
+stderr 里什么都没有，模型就容易以为自己写错了文件，
+去改本来正确的产物，越改越坏。
+
+**`--upstream` 不能省**：省掉的话，关系引用完整性、支线挂主线的覆盖度、
+层级卷数与引用这三项跨文件检查会被**静默跳过**（拿不到上游就直接返回），
+而脚本**照样报 `status:0`** —— 那是一次**假通过**。
+
+单检通过后，才重跑全量。**单检过 ≠ 阶段过**：单检只查这一个文件，
+跨文件的问题要全量校验才查得出来。
+
+### 2.4 重跑全量
+
+```bash
+node references/skeleton-validate.js \
+  --stage-dir=设定/raw/sources/骨架 \
+  --template-dir=模板/骨架 \
+  --all
+```
+
+### 2.5 最多 3 轮
+
+全量最多跑 3 轮。第 3 轮仍失败时，按 `prompts/01-skeleton-prompt.md` 的 BLOCKED 格式输出，附第 3 轮完整 errors。
+
+---
+
+## 三、跨文件错误的特殊处理
+
+### 3.1 图连通性错误
+
+`G_ISOLATED` 表示某实体在骨架图里没有入边或出边。修复方向：
+
+- **角色孤立**：没有 `faction_membership`、没有 `conflict_participants`、没有 `character_relations` → 补关系，或从 `实体.json` 删掉这个角色
+- **冲突孤立**：没有 `conflict_participants` 引用它 → 补参与方，或删冲突
+- **势力孤立**：没有 `faction_membership` 或 `faction_relations` → 补成员/关系，或删势力
+- **地点孤立**：没有 `location_conflict` → 补关联冲突，或删地点
+- **道具孤立**：没有 `item_owner` → 补归属，或删道具
+- **支线孤立**：没有 `branch_protagonist` → 补主角，或删支线
+
+### 3.2 势力关系单向/不对称
+
+`G_REL_ONE_WAY`：A→B 是"对立"但 B→A 没声明 → 补 B→A。
+`G_REL_ASYMMETRIC`：A→B 是"对立"但 B→A 是"合作" → 统一为同一关系，或改一侧。
+
+### 3.3 卷比例不匹配
+
+`SPAN_LENGTH_MISMATCH`：`main_line_span[i].volume_ratio` 长度不等于 `volume_count` → 补或删数组元素。
+
+`VOLUME_RATIO_SUM`：`volume_ratio[].chapter_ratio` 之和不等于 1.0 → 调整各卷比例。
+
+`VOLUME_RATIO_LENGTH`：`volume_ratio` 数组长度不等于 `volume_count` → 增删条目。
+
+`VOLUME_RATIO_RANGE`：`volume_ratio[].chapter_ratio` 不在 [0,1] 内（负数或大于 1）→ 按各卷实际章数重新分配比例。
+
+---
+
+## 四、问题记录
+
+全量校验失败时，用以下模板记录（**不对外展示，只作为工作记录**）：
+
+| # | 错误代码 | path | 问题描述 | 根因文件 | 修改动作 | 状态 |
+|---|---|---|---|---|---|---|
+| 1 | G_ISOLATED | C005 | 角色 C005 孤立 | 关系.json | 补 faction_membership | open |
+| 2 | G_REL_ONE_WAY | F001→F002 | 势力 F001→F002 单向 | 关系.json | 补 F002→F001 | open |
+
+全部 `open` 转 `resolved` 后，重跑全量。
+
+---
+
+## 五、输出确认
+
+全量校验返回 `status: 0` 后，按 `prompts/01-skeleton-prompt.md` 的"九、输出交付格式"输出交付摘要。
+
+**这是唯一允许报告"完成"的场景**。其他场景（单文件通过、中间轮次）不得输出"通过/完成/PASS"。
+
+---
+
+## 六、与其他文件的关系
+
+| 本文件作用 | 引用 |
+|---|---|
+| 全量校验失败后的处理流程 | `prompts/01-skeleton-prompt.md` 的"七、7.8" |
+| 错误代码的修复方向 | `prompts/01-skeleton-prompt.md` 的"十二、常见错误代码速查" |
+| 输出确认 | `prompts/01-skeleton-prompt.md` 的"九、输出交付格式" |
+
+**本文件本身不直接输出到任何 JSON**，它是验证阶段的工作手册。
+
+---
+
+## 七、版本记录
+
+| 版本 | 变更 |
+|---|---|
+| v1.0 | 从原 01-08 精简。删除所有 `- [ ]` 检查清单（验证归脚本）；删除 §2-§8 的验证项（转化为脚本的检查逻辑）；保留验证流程、问题清单模板、输出确认；新增"与其他文件的关系"节 |
+| v1.1 | §2.3 补单检的返回判定：`status` 0/1/2 各自的含义与判据；补 `status:2` 的处置（原因在 stdout 的 `errors[0].message`，stderr 是空的，**改命令不要改文件**）；补 `--upstream` 不能省的理由（不带会静默跳过三类跨文件检查仍报 status:0 假通过）；补"单检过 ≠ 阶段过" |