# 小说素材拆解方法论

## 目录

1. [拆解流程 5 阶段](#拆解流程-5-阶段)
2. [原子提取六大铁律](#原子提取六大铁律)
3. [输出目录结构](#输出目录结构)
4. [质量阈值体系](#质量阈值体系)
5. [散落情节兜底](#散落情节兜底)
6. [Claude Code 执行指引](#claude-code-执行指引)

---

## 拆解流程 5 阶段

### 阶段 1：章节解析

- 识别章节分隔符（第X章、Chapter X、数字编号等）
- 提取章节标题，记录每章字数

### 阶段 2：原子提取（并行 Agent 处理每章）

优先使用 chapter-extractor agent 并行处理。每章 spawn 一个 agent，每次 5-8 个并发。
Agent 不可用时退回主线程串行处理。

Agent 输出格式严格对齐本阶段 A/B/C 三部分的合并输出，详见 output-templates.md 的 Stage 2 模板。

#### A. 章节摘要

- 一句话概括（100-300 字，因果链叙事）
- 关键事件（3-5 个，按时间顺序）
- 出场人物、主题标签、章节基调
- 剧情推进度（大转折/日常过渡/铺垫伏笔）

#### B. 情节点提取（每章 10-40 个，按字数动态调节）

密度公式：字数÷200（下限）到 字数÷150（上限），即 150-200 字/个情节点。当公式计算超出 [10, 40] 范围时，以硬约束为准。

| 字数 | 目标范围 | 说明 |
|------|---------|------|
| ≤1000 | 10 个 | 短章按硬下限拆足关键步骤（公式建议 5-7，硬下限 10） |
| 3000 | 15-20 个 | 标准密度 |
| 5000 | 25-34 个 | 中长章 |
| 8000+ | ≤40 个 | 长章上限 |

写入章节摘要 .md 的情节点子章节（不单独输出 .json）。每个情节点：

| 字段 | 说明 |
|------|------|
| 序号 | 严格时间顺序 |
| 类型 | 转折点/信息揭示/冲突/解决/铺垫/行动/对话/状态变化 |
| 描述 | 客观白描，只记录发生了什么（禁止叙事框架词） |
| 原文引用 | <=400 字直接引用 |
| 涉及人物 | 全名，不用代词 |
| 地点 | 地理位置信息 |
| 关键物品 | 与剧情相关的物品 |
| 时间标记 | 相对时间（次日、半月后、同时） |

#### C. 关键信息与扩写技法提取

每章必须额外输出 `关键信息与扩写技法` 表，作为后续 `剧情/节奏.md` 和 `剧情/情绪模块.md` 的基础数据。它不是主观点评，而是把“本章必须传递的剧情信息”与“作者如何把它扩写成可读场景”拆开。

| 字段 | 提取方式 |
|------|----------|
| 关键信息/剧情走向 | 从关键事件与情节点中归纳本章必须让读者知道、误判、期待或确认的信息 |
| 原文如何扩写 | 记录作者用了哪些事件、对话、反应层、细节、误导、回扣把信息扩成场景 |
| 扩写技法 | 从铺垫后置/反应层放大/信息差/对比锚点/延迟揭示/身体反应/小目标嵌套/其他中选择或补充 |
| 对读者情绪的作用 | 标注该扩写制造的好奇、期待、压抑、爽、心疼、紧张、甜、热血等效果 |
| 可复用提醒 | 只抽象情绪逻辑和功能位，明确禁止照搬具体桥段、台词、专名、独特设定 |

质量要求：每章至少 1 条；标准章节通常 2-5 条。若本章只是过渡，也要说明它维持了什么期待或冷却了什么情绪，而不是写“无”。

#### D. 角色提取

每个角色提取：外在表现（身份/言行/外貌）、本章功能、别名。
只记录新出场角色或已有角色的新发展。

**角色重要性分级**（按本章戏份）：

| 等级 | 标准 |
|------|------|
| **major** | 本章核心：台词 ≥3 句 OR 推动本章主线 OR 有重要决策 |
| **supporting** | 本章配角：台词 1-2 句 OR 参与互动但非核心 |
| **minor** | 本章次要：仅被提及 OR 无台词但有名字 |

### 阶段 3：聚合分析（跨章节）

> **语料读取**：本阶段及阶段 4a/4c、散落情节兜底里的「全部章节摘要 / 全部情节点」统一从 `_章节摘要汇总.md`（Stage 2 收尾按章号无损拼接的全书摘要，见 SKILL.md「Stage 2 收尾：合并章节摘要」）**一次性读取、在上下文中复用**，不逐文件 glob 重扫——同一份语料的 4-5 次冷读降为 1 次。汇总文件缺失或语料超上下文时，回退原「扫描全部章节摘要」逐文件方式 / 分块策略，行为不变。

#### 0. 故事框架识别（聚合前置）

在剧情聚合之前，先识别全书的故事框架。框架决定聚合策略：

| 框架类型 | 特征 | 聚合策略 |
|----------|------|----------|
| 升级流 | 等级体系清晰，按境界分段 | 按等级阶段划分剧情条 |
| 复仇线 | 核心矛盾明确，目标驱动 | 按复仇对象/阶段划分 |
| 日常/单元 | 每卷独立故事，弱连续性 | 按卷/单元划分 |
| 多线交织 | 多视角/多时间线 | 按线索划分，交叉点单独标记 |
| 蜕变成长 | 主角内在变化为主线 | 按成长阶段划分 |

识别方法：扫描概要.md（Stage 0 thin first-pass 足够，无需等 Stage 5 全书概要）+ 前3章摘要 + 后3章摘要，判断核心驱动模式。
输出写入 `剧情/故事线.md` 的框架识别部分。

**预期剧情数量引导**（强制参考，非建议）：

| 总章数 | 预期独立剧情数 | 依据 |
|--------|--------------|------|
| <30 章 | 3-6 个 | 短篇结构紧凑 |
| 30-100 章 | 5-15 个 | 每条剧情 5-20 章 |
| 100-300 章 | 10-25 个 | 含主线+支线+补充 |
| >300 章 | 15-40 个 | 多卷多线结构 |

偏差超过 ±30% 需重新检查粒度。首要原则：保证核心戏剧目标叙事弧的完整性。

**粒度层级混乱检测**（框架识别后自检）：

| 混乱模式 | 检测方法 | 修正方式 |
|---------|---------|---------|
| 包含关系 | 剧情A 章节范围完全包含剧情B | 保留粒度适中的B，拆分过粗的A |
| 重叠率 >50% | 两剧情共享章节超过一半 | 检查是否混淆「剧情」和「剧情阶段」 |
| 剧情仅为另一剧情的开端/结尾 | 剧情A 只占剧情B 的首/尾几章 | 合并为同一剧情，B 的阶段 |
| 剧情无独立目标 | 目标描述是另一剧情的子目标 | 降级为该剧情的阶段 |

**框架识别后自检**（聚合前必须通过）：
1. 覆盖率检查：所有剧情覆盖的章节数（去重）是否达到 85% 以上
2. 粒度检查：是否存在过细（单一事件）或过粗（宏观主题）的剧情，执行粒度层级混乱检测
3. 独立性检查：每条剧情是否满足 4 项独立性标准
4. 数量检查：剧情总数是否在预期范围内

#### A. 剧情聚合（两步法）

将剧情聚合拆为两步：先从摘要识别剧情大纲，再按大纲分配情节点。

**第一步：剧情大纲识别（从章节摘要）**

扫描全部章节摘要，识别每条独立剧情的大纲。每条大纲包含：

| 字段 | 说明 |
|------|------|
| 标题 | 简洁有力，15字以内 |
| 概要 | 150-300字因果链，含核心角色、关键地点、事件发展 |
| 核心目标 | 具体、可衡量的戏剧目标 |
| 核心冲突 | 具体冲突对象+冲突事件 |
| 类型 | 主线/爱情/成长/复仇/寻宝/悬疑/战斗/权谋/修炼/危机/谜团/日常/其他 |
| 主题 | 不超过3个 |
| 章节范围 | 起止章节号 |

识别完成后执行框架识别自检（4项检查）。

**第二步：情节点分配（按剧情大纲）**

对每条剧情大纲，扫描全部情节点，将直接服务该目标的节点分配进来。

**分配执行逻辑**（4 步）：
1. **主题溯源与节点收集**：针对每条剧情大纲的核心目标，扫描全部情节点，将直接服务、推动或阻碍该目标的事件节点挑出
2. **边界识别**：识别剧情的起点（触发事件/前置条件）和终点（完成/失败标志），以及连接两者的关键过渡节点
3. **索引构建与验证**：将筛选出的情节点按时间顺序排列，验证覆盖完整性
4. **画像数据补充**：基于最终节点集合，补充完善概要、结构分布等字段

**情节点筛选标准**（判定归属时使用）：
- **主题相关**：情节点内容与剧情概要、主题一致
- **角色匹配**：情节点涉及的角色与剧情核心角色相关
- **因果关系**：情节点与剧情发展有因果或逻辑延续
- **目标导向**：情节点推动或阻碍剧情目标实现
- **章节范围**：优先选择剧情章节范围内的情节点

**剧情粒度标准（核心要求）**：

| 粒度 | 示例 | 问题 |
|------|------|------|
| 过细（单一事件） | "获得神器"（1-2章）、"首次修炼"（第3章） | 这些是事件，不是独立剧情 |
| 过粗（宏观主题） | "主角的成长之路"（1-100章） | 这是主题，不是具体剧情 |
| **合适** | "家族觉醒与传承认知"（1-6章）、"神器获得与导师相遇"（7-13章） | 有独立目标、冲突、角色群和完整叙事弧 |

**剧情独立性判断标准**（必须同时满足）：
1. **独立的核心目标**：有明确的、可衡量的戏剧目标（不是宏观主题或抽象概念）
2. **独立的主要冲突**：有具体的对抗力量和冲突事件（不是某个大冲突的子阶段）
3. **相对独立的角色群**：有该剧情特有的核心角色（可以与其他剧情共享部分角色）
4. **独立的叙事节奏**：有自己的紧张-缓和节奏

**三层覆盖策略**：
1. **主线剧情**（优先级最高）：推动整体故事发展，通常占 60-70% 章节
2. **支线剧情**：感情线、成长线、战斗线等，通常占 20-30% 章节
3. **补充剧情**：过渡剧情、日常剧情，确保覆盖率 ≥85%

**剧情类型**：
- 主线（推动整体故事发展的核心剧情）
- 爱情（感情关系发展）
- 成长（角色能力/心智/地位提升）
- 复仇（复仇相关）
- 寻宝（争夺物品或目标）
- 悬疑（推理、真相揭露）
- 战斗（战争、比武、对决）
- 权谋（政治斗争、权力争夺）
- 修炼（修炼、突破、传承）
- 危机（危机应对、解救、逃脱）
- 谜团（世界观未解之谜、身世秘密、隐藏真相）
- 日常（日常生活、过渡性内容）
- 其他（无法归入以上类型）

每条剧情提取：标题、概要（150-300字因果链）、核心目标、核心冲突、类型、章节范围。
标记结构分布：铺垫期/发展期/高潮期/收尾期 各包含哪些章节。

**核心目标类型参考**：
- 获得型："赢得大比冠军""获得关键道具/传承""攻占要塞"
- 解决型："解除家族危机""偿还巨额债务""摆脱追杀"
- 创造型："创立新宗门""研发新招式""开创一个流派"
- 探索型："调查父母失踪真相""探索上古遗迹""揭露阴谋"

#### B. 故事线提取

将多条剧情聚合为「故事线」：标题、描述（300-600字发展阶段划分）、主要人物、主题关键词、包含的剧情列表（至少1个剧情）。

**故事线类型**：主线/感情线/成长线/复仇线/夺宝线/冲突线/谜团线/其他

**故事线描述要求**：
- 划分 3-8 个发展阶段（periodization），寻找关键转折点或里程碑事件作为阶段边界
- 每个阶段含：核心冲突、关键角色及作用、能力/资源/地位演进、主题母题
- 独立追踪伏笔与回收关系链（前后呼应的伏笔-回收对）
- 标注与其他故事线的交织关系（并行/交织/依赖）
- 包含剧情按时序排列，每条故事线至少包含1个剧情

#### C. 节奏索引与情绪模块生成

Stage 3 聚合后必须生成两个权威产物，供 Stage 5 报告摘要和 `story-long-write` 直接读取：

1. **`剧情/节奏.md`（节奏权威）**
   - 输入：全部章节摘要的情节点、`关键信息与扩写技法` 表、剧情大纲、故事线。
   - 输出：关键信息推进表、爽点循环索引、情绪触动点索引、爆发节奏总结。
   - 生成法：按章节顺序扫描关键事件与关键信息，标出“信息进入读者视野 → 被延迟/误导/验证 → 情绪爆发 → 余波/新钩子”的链条。
   - 校验：每条爽点/触动点必须能回指章节或情节点；每个长间隔（连续 3 章以上无触动点）必须说明作者如何用小钩子或信息推进维持期待。

2. **`剧情/情绪模块.md`（模块权威）**
   - 输入：故事框架识别、剧情条、`剧情/节奏.md`、读者需求判断、桥段标签。
   - 输出：读者需求 / 情绪引擎、故事框架与套路运行图、可复现模块卡、重组与复现指南。
   - 生成法：先抽象“读者想看什么”，再把具体剧情抽成情绪链和功能位；模块卡必须包含可替换项和不可照搬项。
   - 校验：best-effort 为模块标注来源（关联 `剧情/节奏.md` 的 RH/TR 条目或章节情节点），无把握时留空、不硬凑、不删模块；禁止把原文专名、独特事件顺序、标志性台词写成可复用模板。

**权威关系**：`剧情/节奏.md` 管节奏/触动点，`剧情/情绪模块.md` 管读者需求/模块复现。`拆文报告.md` 与 `剧情/故事线.md` 只能摘要或引用这两个文件，不能成为并列权威。

#### D. 小说概要生成（在 Stage 5 落盘，覆盖 Stage 0 thin first-pass）

整体故事框架识别 + 500-1000字高密度全书概要（涵盖主要剧情线阶段性发展、核心人物作用、关键转折点、因果关系）。

> **落盘时机**：聚合阶段（Material 阶段 3 ≈ pipeline Stage 3）产出概要文本，但**写入 `概要.md` 的动作放在 pipeline Stage 5 汇总报告**——届时 Stage 3 / 4 全部完成、信息最完整。Stage 5 覆盖 Stage 0 的 thin first-pass 段，章节索引和卷段表保留。

### 阶段 4：世界观与设定提取

Stage 2 的角色轻量提及数据在此阶段升级为完整档案。

#### 角色两阶段模型

**阶段 A：轻量提及（Stage 2 输出）**
- 每个 agent 返回出场人物表（姓名/重要性/别名/本章表现）
- 不做跨章分析，只记录本章可见信息

**阶段 B：完整档案（Stage 4 构建）**
- 合并所有章节的角色提及数据
- 跨章节别名解析
- 构建完整角色档案

#### 一人一实体原则

- **绝对禁止**将不同人物的信息合并到同一个实体中
- 每个角色实体必须对应唯一的一个人物
- 如果无法确定两个称呼是否指向同一人物，必须分开创建实体

#### 别名解析规则

**别名类型**：

| 类型 | 定义 | 可合并 | 示例 |
|------|------|--------|------|
| proper_name | 专名/全名/常用名 | 是 | "希尔曼""林雷·巴鲁克" |
| nickname | 绰号/外号，须有同指证据 | 是（置信度≥0.85） | "龙血战士林雷" |
| descriptor | 描述性称谓 | 否 | "红发壮汉""随从""队长" |
| title | 头衔/职务 | 否 | "护卫队长""家主""族长" |

**合并约束**：
- 仅 proper_name 和 nickname（置信度 ≥0.85）可用于合并
- descriptor 和 title **永不**触发实体合并
- nickname 须提供同指证据：同位说明、括号别名、上下文指代、明确改名

**Archetype 量化判断**：

| 类型 | 标准 |
|------|------|
| **主角** | 出现章节 ≥50% 总章节 + 推动主线 + 有完整成长轨迹 |
| **反派** | 与主角对立 + 推动核心冲突 + 有明确动机 |
| **核心配角** | 出现章节 ≥20% OR 推动重要支线 OR 有独立人格和成长 |
| **功能角色** | 出现章节 <20% + 作用有限（提供信息/道具/一次性互动） |

**特殊**：前期 minor 后期 supporting → 判为 supporting。重要导师/伙伴即使出现少也可判为 supporting。

**角色档案结构**（200-500字）：
1. 身份背景（1-2句）
2. 核心经历（3-5句，按时序）
3. 性格特质（1-2句，从行为归纳）
4. 能力特长（1-2句）
5. 人际关系（1-2句）
6. 成长轨迹（如有，1句）

#### 金手指合并规则

- 相互关联、共同作用的元素**合并为一个**（如"戒指+导师灵魂"是一个整体）
- 同一事物的不同描述角度**不拆分**
- 只有完全独立、互不依赖的能力来源才拆分为多个
- 长篇特点：金手指可能复杂多样，需详尽描述演化过程和多重能力
- 无金手指时注明

**金手指类型**：system（系统）/ space（空间）/ rebirth（重生）/ transmigration（穿越）/ special_physique（特殊体质）/ artifact（神器）/ bloodline（血脉）/ other（其他）

#### 世界观（按主题拆分到多个文件）

字段与落盘位置：

| 字段 | 说明 | 落盘文件 |
|------|------|----------|
| 类型 | 奇幻/现实/平行世界 | 各文件 frontmatter 或开头注明 |
| 力量体系 | 名称、等级、晋升方式（文本描述） | `设定/世界观/力量体系.md`（>=200字独立，否则并入 背景设定） |
| 地理 | 分布、主要区域、关键地点（文本描述） | `设定/世界观/地理.md`（同上，>=200字独立） |
| 势力 | 门派/组织/家族/国家 | **每个势力一个文件** `设定/势力/{势力名}.md`（>=200字独立；不足合并到 `设定/世界观/背景设定.md`） |
| 核心规则 | 世界运转的基本规则 | `设定/世界观/背景设定.md` |
| 特殊设定 | 区别于现实的独特设定 | `设定/世界观/背景设定.md`（与核心规则同文件） |
| 金手指 | 见上方「金手指合并规则」 | `设定/世界观/金手指.md`（统一在 `设定/世界观/` 子目录下，不放扁平 `设定/金手指.md`） |

> 模板与示例见 [output-templates.md](output-templates.md) 「Stage 4 设定+关系」节。下游 `story-import` 的 3.5 拆分步骤检测到 `设定/世界观/` 子目录已存在时直接 pass-through，不再 re-split。

### 阶段 5：人物关系提取

每对关系：

| 字段 | 说明 |
|------|------|
| 角色A | 全名 |
| 角色B | 全名 |
| 关系类型 | 家人/师徒/朋友/敌人/恋人/同事/上下级/商业/其他 |
| 情感倾向 | 正面/负面/中性/复杂 |
| 描述 | 关系本质+建立过程+关键互动（50-200字） |

#### 关系提取策略

**数据源**：从已提取的情节点描述中提取关系（不从原文提取），更高效、更聚焦。

**批量提取**：每 5 章批量提取一次，只记录新关系或关系变化。

**关系演变追踪**：当同一对角色关系发生变化时，记录演变轨迹：
```
第{N}章：{关系状态A} → 第{M}章：{关系状态B}
触发事件：{具体事件}
情感转变：{正面→负面/负面→正面/中立→复杂 等}
```

**最终状态合并**：同一对角色的多阶段关系，保留最新状态作为主记录，历史变化写入演变轨迹。避免同一对出现多条重复关系。

**隐含关系推断**：当角色间没有直接互动但有间接证据时：
- 通过第三方的评价/描述推断（置信度标 0.7）
- 通过共同出现的频率和场合推断（置信度标 0.6）
- 推断关系标记 `[推断]`，与直接证据关系区分

**关系网络密度**：
- 统计主要角色（主角+核心配角）的关系数量
- 关系数 < 3 → 关系网偏薄，检查是否有遗漏
- 关系数 > 10 → 关系网过密，检查是否有误合并

---

## 原子提取六大铁律

1. **绝对时序**：严格按事件发生的时间顺序排列
2. **客观白描**：只记录"发生了什么"，不用叙事框架词
3. **信息保真**：不遗漏改变语境的关键细节
4. **高度浓缩**：一个情节点一句话概括
5. **复合合并**：为同一戏剧目的服务的连续微动作合并为一个情节点
6. **客观事实**：提取客观事实，不做叙事分析

**客观白描 vs 叙事框架词**：
- 禁止：「通过对话，郑松得知张子豪在韩国训练」
- 正确：「吴志斌告诉郑松，张子豪在韩国训练」
- 禁止：「林风展现了自己的实力」
- 正确：「林风三招击败对手，围观者倒吸一口凉气」
- 禁止：「邵阳感到心碎和愤怒」
- 正确：「邵阳目睹宋丽与人拥抱，表情由刺痛转为冷漠」

---

## 合成阶段事实保真（阶段 3-5：剧情/设定/角色/报告）

阶段 3-5 从章节摘要二次合成，离原文已两跳，最易把「摘要没说的」用合理推断补成「看似坐实的事实」——这是拆文事实错误的最大来源（典型：给「双系魔法师」凭空补第二系、把坐骑等级安到骑手头上、给原文没给的字段编一个数值、把出场区间填成连续跨度含没出场的章）。强模型也照样漂移，因为越远离原文，模型越靠世界知识与"合理性"填空。三条硬约束：

1. **硬事实必须可溯源**：力量等级、数值、距离、属性、势力数量、谁对谁说了什么、角色出场章节——这类硬事实写进设定/角色/报告前，回原文核对（摘要不足就直接读原文）；核到才写。
2. **缺失写「原文未明确」，禁编造填空**：原文没给的字段，写「原文未明确/节选未涉及」，绝不用近义项、别处的范例或惯例补一个看似合理的值。
3. **跨指代不串**：相邻实体的属性不互相挪用——坐骑等级≠骑手等级、A 的台词≠B 的台词、本章统计数字≠相邻章数字。

落盘后做一次**事实可溯源自检**：抽查设定/角色/报告里的硬事实，逐条能否 grep 回原文；命中即过，命中不到的改写为「原文未明确」或删除，不保留无源断言。此自检独立于下方三个比率——比率查归类质量，它查事实真伪。

---

## 输出目录结构

```
拆文库/{书名}/
  原文/      原始文本备份（管道前置步骤）
  章节/      第{N}章_深度拆解.md + 第{N}章_摘要.md（含关键信息与扩写技法）
  角色/      {角色名}.md + 角色关系.md
  剧情/      {剧情标题}.md + 故事线.md + 节奏.md + 情绪模块.md + 散落情节.md
  设定/      世界观.md + 金手指.md
  拆文报告.md
  概要.md
  _progress.md
```

---

## 质量阈值体系

阶段 3 和阶段 4 完成后自检：

| 指标 | 阈值 | 计算 | 不达标处理 |
|------|------|------|------------|
| 置信度 | >= 0.85 | 有明确归属的情节点 / 剧情条内情节点总数 | 低于 0.85 标记「待复核」 |
| 覆盖率 | 85%-95% | 已归类情节点 / 总情节点数 | <85% 触发孤立情节二次分类；>95% 复核边界 |
| 关键信息覆盖 | >= 每章1条 | 含 `关键信息与扩写技法` 的章节数 / 摘要章节数 | 缺失章节回到 Stage 2 补提取 |
| 模块来源标注 | best-effort | 情绪模块卡尽量标注 RH/TR 或章节情节点来源 | 无把握的来源留空，不硬凑、不删模块（同桥段标签的 best-effort 处理）|
| 重叠率 | <= 35% | 跨剧情条共享情节点 / 总情节点数 | >35% 提示边界模糊，建议合并 |

> **小体量节选（< 30 章、单主线连续叙事）的特例**：此类素材按时序连续切分时，覆盖率天然接近 100%、散落情节接近 0，这是线性结构的正常结果，不算过度归并。此时复核重点是「有无把不同剧情强行并进同一条」，而非覆盖率数值本身——不必为压到 95% 以下而人为拆分。

---

## 散落情节兜底

阶段 3 聚合完成后执行（6 步，含覆盖率验证）：

1. **计算孤立比例**：孤立情节点数 / 总情节点数。若比例 < 5%，跳过后续步骤，直接标记为「少量散落，无需处理」
2. **筛选未分配情节点**：从所有章节摘要中收集未归类到任何剧情条的情节点
3. **三层置信度归入**：按角色重叠、地点重叠、因果关系三条线索计算相关性
   - **强相关**（0.8-1.0）：角色匹配 + 主题相关 → 归入现有剧情条，标记 `[孤立情节归入]`
   - **中等相关**（0.5-0.8）：角色匹配 或 主题相关 → 归入并标记 `[低置信归入]`，待复核
   - **弱相关**（<0.5）：不建议强行归入，宁可放入未分配
4. **主题聚类**：弱相关的情节点按主题关键词聚类
   - 聚类结果 >= 5 个情节点 → 形成候选剧情条，标记 `[聚类生成]`
   - 聚类结果 < 5 个 → 不单独建条
5. **散落情节归档**：仍无法归类的写入 `散落情节.md`，按章节排列，标注原因
   - 不丢弃任何情节点，不要强行分配到不相关的剧情
   - 在拆文报告中统计散落情节点数量和占比
6. **覆盖率验证**：
   - 覆盖率 = (总数 - 散落数) / 总数 × 100%
   - 目标：85%-95%
   - < 85% → 回到步骤 3，降低置信度阈值重试
   - > 95% → 检查是否有过度归并，复核边界剧情条

---

## Claude Code 执行指引

### 分块策略

Stage 2 使用 chapter-extractor agent 并行处理（每章一个 agent，每批 5-8 个），不分块。
其他阶段（0、1、3、4、5）的分块策略如下：

| 规模 | 策略 | 块大小 |
|------|------|--------|
| <50 章 | 按阶段整体处理 | 无需分块 |
| 50-100 章 | 按阶段整体处理 | 无需分块（可选智能分块） |
| 100-500 章 | 按章节分块 | 5-8 章/块 |
| >500 章 | **智能分块**：基于章节摘要识别自然分界，按语义连贯性切分 | 50-200 章/块 |

### 智能分块（>500 章）

对于大型小说，基于章节摘要识别自然分界，而非固定切分：

**分块原则（四大铁律）**：
1. **语义连贯**：每块是一个相对独立的内容单元（大故事阶段或主要事件线）
2. **自然分界**：在内容转折点、场景切换、时间跨越处切分，不在紧密剧情中间切
3. **大小适中**：每块 50-200 章，语义完整性优先于大小均匀
4. **避免割裂**：不在紧密剧情中间切分

**题材特化分块参考**：

| 题材 | 分块依据 | 示例 |
|------|---------|------|
| 修仙/升级 | 境界突破、地图切换 | 炼气期→筑基期→金丹期 |
| 都市 | 事件线、身份转变 | 学生→创业→商业帝国 |
| 历史 | 历史阶段、战役 | 起兵→统一北方→南征 |
| 玄幻 | 世界地图、势力变化 | 东域→中州→上界 |
| 有卷/部/篇 | 优先按原结构 | 按作者划分的卷/部 |

**无明显结构**时按固定章节数均匀切分。**硬约束**：所有章节必须被覆盖，块之间不能重叠（每章只属于一个块）。**分块上限**：最多 10 块（超出时扩大块大小，保持语义完整性）。

每块输出元数据：`块标题 | 起止章节 | 核心主题（2-5个） | 关键事件（2-5个） | 主角阶段`。

输入分块大小 6-8K token/块（中小型），章节边界对齐。输出长度限制见 SKILL.md（Stage 2 agent 模式按密度公式输出，Stage 3-5 单阶段 ≤8000 中文字符）。每块完成后更新 _progress.md。

### 跨块合并（大型小说 >500 章）

分块处理后，相邻块的边界剧情可能被机械切分割裂。Stage 3 聚合时执行跨块合并检查：

**合并判断标准**（必须同时满足）：
1. ✓ 同一核心事件/目标：讲述的是同一个核心事件（不是两个独立事件）
2. ✓ 主要人物相同：涉及的主要人物相同
3. ✓ 剧情发展连续：剧情 B 是剧情 A 的自然延续
4. ✓ 非因果独立事件：不是因果关系的两个独立事件

**应该合并**：
- "竞选县长秘书（准备阶段）" + "竞选县长秘书（投票阶段）" → 同一事件被分块割裂
- "修炼突破（前期）" + "修炼突破（后期）" → 同一突破过程

**不应合并**：
- "在办公室立足" + "竞选县长秘书" → 两个独立目标
- "炼气期修炼" + "筑基期修炼" → 不同阶段的独立剧情
- "东域修炼" + "中州历练" → 不同地图的独立剧情

**保守原则**：当不确定时，倾向于不合并（保持独立）。

**边界检测原则**：只检查相邻块中接近块边界的剧情对，远离边界的剧情不参与跨块合并。

### 跨会话恢复

- 进度通过 _progress.md 追踪
- 新会话读 _progress.md 定位断点
- 从断点所在块的起始章节重新开始（覆盖该块已有输出）

### 与 SKILL.md 的关系

四件套各自职责：

- `SKILL.md` = 路由逻辑 + 管道概要（阶段名称/输入/输出/停靠点定义）
- 本文件（`material-decomposition.md`）= 方法论细节（5 阶段操作步骤 + 六大铁律 + 输出结构）+ **质量阈值唯一权威**（置信度/覆盖率/重叠率）+ 分块策略唯一权威
- `references/output-templates.md` = 各 Stage 具体输出格式模板 + 快速预览报告模板 + 通用速查表
- `references/pipeline-ops.md` = 管道运维：`_progress.md` 模板与状态值、错误处理表、恢复机制操作步骤（不含阈值实体值，质量阈值见本文件）
