# Novel Track

> 故事线与人物线追踪更新 — 自动检测人物状态变化、识别伏笔/标记回收、超期告警、自动生成章节梗概

- Skill: `cwjdong-design/novel-track` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cwjdong-design/novel-track`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cwjdong-design/novel-track/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cwjdong-design (https://skillmd.com/u/cwjdong-design)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cwjdong-design/novel-track

---


# 故事线与人物线追踪更新（可执行版）

## 输入
- `本章定稿`（来自 novel-polish 输出的已润色正文）
- `本章剧情推演`（来自 novel-plot 的输出，用于交叉验证）
- `书名`（对应 `~/novels/books/<书名>/`）
- `章节号 N`

## 执行步骤总览
```
正文分析 → 人物状态自动检测 → 伏笔自动识别 → 超期扫描告警 → 章节梗概生成 → 文件写入
```

---

## 第 1 步：人物状态变更自动检测

> ⚠️ **第 1 章特殊处理**：当 `N = 1` 时，人物卡中尚无任何状态记录。此时「人物状态变更」改为「**人物状态初始化**」——从正文中提取人物的初始状态信息，写入人物卡的初始状态，而非追加变更记录。输出格式中将「变化前」列改为「初始值」，「变化后」列改为「设定值」，「证据句」列改为「设定依据」。

### 1.1 检测维度（6 维）
读取本章正文，逐人物扫描以下 6 个维度的变化：

| 维度 | 检测关键词/模式 | 变化类型 |
|------|---------------|---------|
| 🔺 修为/能力 | 突破、晋升、领悟、觉醒、进阶、掌握、提升 | 修为变化 |
| 📍 位置移动 | 离开、前往、到达、进入、返回、传送 | 位置变化 |
| 💔 关系变化 | 结盟、决裂、相认、背叛、告白、收徒 | 关系变化 |
| 💭 情感状态 | 情绪词（愤怒/狂喜/绝望/释然/恐惧→勇敢等） | 情感变化 |
| 🎯 目标变更 | 决定、放弃、改变计划、新的目标 | 目标变化 |
| 🎒 物品变更 | 获得、失去、损坏、使用（关键物品）、赠送 | 物品变化 |

### 1.2 检测算法（三步法）

**Step A: 人物索引建立**
扫描正文，提取本章中所有有名字+有台词或≥2 次出现的出场人物列表。

**Step B: 逐维扫描**
对每个出场人物，扫描 6 个维度：
```
对于每个人物：
  for 维度 in [修为, 位置, 关系, 情感, 目标, 物品]:
    使用关键词模式匹配 → 识别变化
    记录变化前后状态 + 证据句（正文中的原句）
```

**Step C: 交叉验证**
将检测到的变化与「本章剧情推演」中的人物情感弧线对比：
- 匹配的 → 标记「✅ 已验证」
- 不匹配的 → 标记「⚠️ 推演偏差」，需人工确认

### 1.3 变化判定规则

**有效变化（必须记录）**：
- 修为突破（如「突破金丹期」）
- 人物关系建立/破裂（如「与 XXX 结为道友」「与 XXX 决裂」）
- 关键物品获得/失去（如「获得神秘玉简」）
- 目标方向改变（如「放弃了复仇，转而追查真相」）

**有效变化但可能被忽略的（也需记录）**：
- 情感状态的显著转变（从「恐惧」到「勇敢」）
- 对某个重要事实的认知变化（「终于知道了 XXX 的真相」）
- 社会身份的获得（「被任命为 XXX」）

**不应记录为变化**：
- 日常情绪波动（「林夜有点不高兴」— 没有后续影响）
- 临时位置移动（「林夜走出客栈去买了点东西」— 场景内移动）
- 普通物品的得失（「林夜付了 10 灵石」— 非关键物品）

### 1.4 人物卡更新格式

> ⚠️ **追加前检查**：更新人物卡前，必须先读取目标文件，检查是否已存在 `## 状态变化记录` 段落。如果不存在，先在文件末尾（## 对话风格 段落之后）创建该段落，再追加本章变更记录。

更新 `02-设定文档/人物库/<人名>.md` 时，使用以下格式追加：

```markdown
## 状态变化记录

### 第 N 章
- **修为**：[变化前] → [变化后]（证据：「正文原句...」）
- **位置**：[变化前] → [变化后]（证据：「正文原句...」）
- **关系变化**：
  - 新增关系：[人物名] — [关系类型]（证据：「...」）
  - 关系变化：[人物名]：[旧关系] → [新关系]（证据：「...」）
- **情感状态**：[旧状态] → [新状态]（触发事件：XXX）
- **目标变更**：[旧目标] → [新目标]（触发事件：XXX）
- **关键物品**：[获得/失去] [物品名]（证据：「...」）
```

**✅ 正例：完整的人物状态更新**
```markdown
### 第 42 章
- **修为**：筑基后期 → 筑基巅峰（证据：「林夜体内灵力翻涌，一道金光自丹田冲出，他终于踩在了筑基期的最后一层台阶上。」）
- **关系变化**：
  - 新增关系：青云子 — 敌人（证据：「青云子冷冷道：『从今日起，你便是青云宗的敌人。』」）
- **情感状态**：警惕 → 愤怒（触发事件：青云子软禁苏婉）
- **关键物品**：获得「钥匙碎片·朱雀」（证据：「拍卖师揭开红布，一道赤光映亮了整个大厅。」）
```

**❌ 反例：过度记录**
```markdown
### 第 42 章
- **位置**：客栈 → 拍卖场 → 客栈 （← 场景内移动，无需记录）
- **情感状态**：有点高兴 → 有点不高兴 → 又高兴了 （← 日常波动，无需记录）
- **关键物品**：获得「拍卖手册」 （← 非关键物品，无需记录）
```

---

## 第 2 步：伏笔自动识别与回收

### 2.1 新增伏笔自动识别

#### 识别规则
扫描正文，检测以下模式（满足任一即标记为「潜在伏笔」）：

| 模式类型 | 识别特征 | 置信度 |
|---------|---------|--------|
| 🔮 直接铺垫 | 人物明确提到「以后」「将来」「等我…」「如果我…」等未来指向 | 高 (0.9) |
| 🧩 信息不对称 | 某人知道某事但其他角色不知，读者也不知道全貌 | 中 (0.7) |
| ⚡ 异常强调 | 对某物品/人物/场景进行了不寻常的详细描写（超过 50 字且非主场景） | 中 (0.6) |
| 🕳️ 留白线索 | 提到某事物但不解释，如「那个东西」「那个人」「那种感觉」 | 低 (0.5) |
| 🔗 回调提及 | 提到之前伏笔但未完全揭示（伏笔的再次暗示） | 高 (0.9) |
| 🤝 人物约定 | 人物之间做出约定/承诺（「我们约好……」） | 中 (0.7) |

#### 伏笔新增决策
```
扫描到潜在伏笔 → 评估置信度
  ├─ 置信度 ≥ 0.7 → 自动确认为新增伏笔，建议回收章 = 当前章 + 3~10
  ├─ 置信度 0.5~0.7 → 标记「待确认」，列出证据句，由人工判断
  └─ 置信度 < 0.5 → 暂不记录
```

**✅ 正例：自动识别新增伏笔**
```
正文：「林夜注意到玉简上又多了一道裂纹，比之前更长了。他皱起眉头，但拍卖已经开始了，他没有时间细想。」

识别结果：
→ 🔮 直接铺垫（物品异常变化，暗示未来事件）
→ 建议回收章：第 47 章（+5 章）
→ 伏笔内容：「玉简的新裂纹暗示其中的力量正在加速流失」
```

**❌ 反例：误判伏笔**
```
正文：「客栈的房间很干净，桌上放着茶壶和四个杯子。」
→ 正常场景描写，不是伏笔。没有异常强调，没有留白线索 ❌
```

### 2.2 伏笔回收自动识别

#### 回收判定规则
扫描正文，与「伏笔追踪表」中所有未回收伏笔进行语义匹配：

```
回收确认条件（满足任一条即确认）：
1. 正文明确解释了伏笔中的神秘/未知元素
   → 例：伏笔「神秘玉简的作用未知」→ 正文「玉简中的力量可以…」
2. 伏笔中暗示的事件/人物发生了
   → 例：伏笔「某人将在拍卖会出现」→ 正文「拍卖会上果然出现了那人」
3. 伏笔中铺垫的物品被使用了
   → 例：伏笔「获得一把生锈的剑」→ 正文「林夜拔出那把剑，剑身骤然发光」
4. 人物根据伏笔信息做出了行动
   → 例：伏笔「发现密室的线索」→ 正文「林夜按照线索找到了密室」

回收方式记录格式：
- 直接揭示：正文明确解释了伏笔
- 事件兑现：伏笔暗示的事件发生
- 物品使用：伏笔中的物品被使用
- 信息联动：伏笔信息引发了角色行动
```

**✅ 正例：自动识别回收**
```
伏笔 V07：「神秘玉简中封存的力量与林夜血脉共鸣」（第 35 章铺垫，计划第 42 章回收）

正文：「林夜将灵力注入玉简，玉简表面符文亮起，一股古老的力量涌入他的经脉——竟然与他体内的血脉产生了共鸣。他终于明白了，这玉简是林家先祖留下的遗物，只有林氏血脉才能开启。」

→ 回收确认：✅ 已回收
→ 回收方式：「直接揭示」+ 「物品使用」
→ 回收质量：高（完整解释了伏笔中的两个元素：力量共鸣 + 血脉关联）
```

**❌ 反例：误判回收**
```
伏笔 V03：「苏婉的真实身份暗示」（第 20 章铺垫）

正文：「苏婉今天穿了一件很漂亮的裙子。」
→ 这不构成回收，只是日常描写 ❌
```

### 2.3 伏笔追踪表更新

更新 `02-设定文档/伏笔追踪表.md` 时使用以下格式：

```markdown
## 伏笔追踪表

| ID | 内容 | 铺垫章 | 计划回收章 | 实际回收章 | 状态 | 回收方式 | 回收质量 |
|----|------|--------|-----------|-----------|------|---------|---------|
| V01 | XXX | 3 | 10 | 10 | ✅ 已回收 | 直接揭示 | 高 |
| V02 | XXX | 8 | 15 | — | 🟡 进行中 | — | — |
| V03 | XXX | 20 | 38 | — | 🚨 超期 | — | — |

### 第 N 章变更
- **新增**：V12 — 「林夜在拍卖会上竞得的碎片是钥匙的一部分」（铺垫章 N，计划回收章 N+8）
- **回收**：V07 — ✅（实际回收章 N，回收方式：直接揭示，回收质量：高）
```

---

## 第 3 步：超期告警

### 3.1 超期定义与分级

```
超期判定公式：
超期程度 = 当前章 - 最小(计划回收章, 计划回收章中的最新关联章)

告警等级：
  ├─ 超期 1-3 章  →  🟡 轻度超期（提醒级别）
  ├─ 超期 4-7 章  →  🟠 中度超期（警告级别）
  ├─ 超期 8-15 章 →  🔴 重度超期（紧急级别）
  └─ 超期 > 15 章  →  💀 严重超期（需考虑回收可行性重评估）
```

### 3.2 超期告警输出

当检测到超期伏笔时，输出告警信息：

```markdown
## 🚨 超期告警 — 第 N 章扫描结果

| 告警级别 | ID | 伏笔内容 | 铺垫章 | 计划回收 | 已超期 | 建议处理 |
|---------|-----|---------|--------|---------|--------|---------|
| 💀 严重 | V03 | 苏婉真实身份 | 20 | 38 | 4 章 | 立即在下章安排回收 |
| 🟡 轻度 | V09 | 拍卖场的暗号 | 40 | 41 | 1 章 | 下章回收即可 |
```

### 3.3 超期处理建议（自动生成）

对于每个超期伏笔，自动生成处理建议：

```
1. 轻度超期（🟡）：在下一章的自然情节中回收即可，无需大改节奏。
   建议插入位置：开场后的发展段。

2. 中度超期（🟠）：需要在 3 章内安排回收，建议在下一章的转折段插入。
   评估：该伏笔是否仍与当前主线方向一致？如不一致，考虑修改伏笔内容。

3. 重度超期（🔴）：必须下章回收，可考虑作为下一章的钩子/高潮事件。
   评估：超期过久可能导致读者遗忘，回收时需加入前情提示（1-2 句）。

4. 严重超期（💀）：该伏笔可能已过时，评估以下选项：
   A. 强制回收：在 2 章内作为重要事件回收
   B. 修改整合：修改伏笔内容以适应当前剧情方向
   C. 标记作废：如果与主线已无关联，标记为「已废弃」并记录原因
```

**✅ 正例：合理的超期处理**
```
V05（铺垫章 25，计划回收章 35，当前章 42，超期 7 章 🟠 中度超期）
→ 建议：下章转折段插入回收。原伏笔内容「拍卖场幕后老板的身份」，当前主角正好在拍卖场，时机合适。
→ 实际安排：在第 43 章拍卖会高潮段揭示幕后老板身份。
```

**❌ 反例：不合理的超期处理**
```
V05（超期 7 章 🟠）→「随便找个地方硬塞一句回收」 
→ ❌ 伏笔回收必须自然融入情节，不能硬塞
```

---

## 第 4 步：自动生成章节梗概（200-300 字）

### 4.1 梗概生成算法

```
输入：本章正文
输出：200-300 字章节梗概（高冲突/多事件章节允许扩展到 350 字）

算法：
1. 提取核心事件（1 句话，≤30 字）
2. 提取冲突描述（1 句话，≤30 字）
3. 提取关键转折（1 句话，≤30 字）
4. 提取章末结果/状态（1 句话，≤30 字）
5. 合并为一段，控制在 200-300 字（高冲突/多事件章节允许扩展到 350 字）
```

### 4.2 梗概模板

```
模板：场景（位置+时间），人物A的状态/行动，导致[核心事件]。过程中，[冲突描述]，但[转折/新信息]改变了局面。最终，[结果/状态]。章末：章末钩子的一句话说效果。
```

### 4.3 梗概质量检查

```
□ 字数：200-300 字（高冲突/多事件章节允许扩展到 350 字）
□ 覆盖了核心事件、冲突、转折、结果
□ 没有剧透所有细节（保留阅读趣味）
□ 不使用「本章讲述了」「这一章描写了」等废话开头
□ 不包含人物内心独白或对话
□ 可作为后续查阅时快速回忆此章的入口
```

**✅ 正例：200-300 字梗概**
```
青云城拍卖会上，林夜为竞得一枚钥匙碎片与数名修士展开激烈竞价，最终以全部身家拍下碎片，却在离开时遭到青云子长老的截杀。激战中，林夜被迫将灵力注入玉简以求自保，意外引发玉简与血脉的共鸣，暴露出他是林家后人的身份。青云子震惊之下叫停了围攻，但下令将苏婉软禁于青云宗。林夜回到客栈，发现玉简上又多了一道裂纹——留给他继承先祖力量的时间正在流逝。（197 字）
```

**❌ 反例：不合格梗概**
```
这一章写了林夜去拍卖会买东西。他遇到了一些人，发生了一些事。最后他回到客栈休息了。这章总体还不错。（48 字）
→ ❌ 字数严重不足，没有核心事件，没有冲突，没有转折，使用了废话开头
```

**❌ 反例：过于冗长的梗概**
```
林夜从客栈出发，路上遇到了张三，聊了几句，然后去了拍卖场。拍卖场很大，很多人。第一件拍品是一把剑，林夜没兴趣。第二件拍品是一颗丹药，林夜也没兴趣。第三件拍品……（后省略 400 字流水账）
→ ❌ 流水账式，没有主次，超字数
```

---

## 第 5 步：文件写入

### 5.1 更新文件清单
| 文件 | 操作 | 内容 |
|------|------|------|
| `02-设定文档/人物库/<人名>.md` | 追加 | 第 N 章的状态变化记录 |
| `02-设定文档/伏笔追踪表.md` | 更新 | 新增/回收的伏笔行 |
| `02-设定文档/故事线状态.md` | 追加 | 第 N 章的 200 字梗概 + 主线进度 |
| `00-大纲细纲/章节规划.md` | 标记 | 将第 N 章标记为「✅ 已完成」 |
| `04-错误库/修正记录.md` | （不直接写入） | 如有发现不一致，在此阶段向用户报告，由用户决定是否记录 |

### 5.2 故事线状态更新格式
```markdown
### 第 N 章（YYYY-MM-DD）
**梗概**：（200-300 字梗概）
**冲突类型**：[A+B] 人物冲突 + 环境冲突 / [C] 内心冲突
**信息增量**：（1-3 条新信息摘要）
**伏笔变化**：新增 N 条 / 回收 N 条
**主线进度**：N / 总章节数（XX%）
**状态**：✅ 已完成
```

---

## 最终输出格式

```markdown
## 📊 追踪更新 — 第 N 章

### 👤 人物状态变更
| 人物 | 维度 | 变化前 | 变化后 | 证据句 | 验证 |
|------|------|--------|--------|--------|------|
| 林夜 | 修为 | 筑基后期 | 筑基巅峰 | 「一道金光自丹田冲出，他终于踩在了筑基期的最后一层台阶上。」 | ✅ 已验证 |
| 苏婉 | 位置 | 自由 | 软禁 | 「青云子挥袖道：『带下去，关入后山。』」 | ✅ 已验证 |

### 🔗 伏笔变更
**新增伏笔**：N 条
| ID | 内容 | 计划回收章 |
|----|------|-----------|
| V12 | 钥匙碎片的来历暗示 | 第 50 章 |

**回收伏笔**：N 条
| ID | 内容 | 铺垫章 | 回收章 | 回收方式 | 质量 |
|----|------|--------|--------|---------|------|
| V07 | 玉简与血脉共鸣 | 35 | 42 | 直接揭示 | 高 |

### 🚨 超期告警
| 级别 | ID | 内容 | 已超期 | 建议 |
|------|-----|------|--------|------|
| 💀 严重 | V03 | 苏婉身份 | 4 章 | 下章强制回收 |
| 🟡 轻度 | V09 | 拍卖场暗号 | 1 章 | 下章自然回收 |

### 📝 章节梗概
（200-300 字梗概内容）

### 📈 主线进度
**第 N 章 / 共 Y 章（XX%）**

### ⚠️ 需人工确认
- [伏笔 V08] 自动识别为「潜在伏笔」但置信度中(0.6)，需人工判断
- [人物 张三] 行为与第 38 章人物卡描述有轻微偏差，需确认

### 🔄 已更新文件
- [x] `02-设定文档/人物库/林夜.md`
- [x] `02-设定文档/人物库/苏婉.md`
- [x] `02-设定文档/伏笔追踪表.md`
- [x] `02-设定文档/故事线状态.md`
- [x] `00-大纲细纲/章节规划.md`
```

## 自检清单
- [ ] 所有出场人物的 6 维变化已扫描
- [ ] 新增伏笔已识别并分配 ID
- [ ] 回收伏笔已标记并记录回收方式和质量
- [ ] 所有未回收伏笔的超期状态已检查
- [ ] 超期告警含处理建议
- [ ] 章节梗概字数在 200-350 字之间（高冲突/多事件章节允许扩展到 350 字）
- [ ] 人物卡更新使用证据句
- [ ] 输出中标注了需人工确认的项