# Butler 反思总览

本文档汇总 butler agent 迄今完成的所有反思记录，包括 W5 流程反思、W9 图式反思、W11 类型审计三类。

---

## 一、W5 流程反思（v1–v8 + 架构反思）

> 位置：`wiki/logs/butler/reflections/`
> 触发：每 20 条 action 达阈值，或 3 条同 action 连续失败，或 bug/用户指出问题。

| 编号 | 日期 | 触发方式 | 核心发现 | 主要提案 |
|------|------|----------|----------|----------|
| v1 | 2026-04-22 | 20 条阈值 | diff 严重超 W0 限制（平均 47 行）；trail 过多（17/19）；打分无区分度 | 提案 1：stub 模板≤20 行；提案 2：canonical 质量过滤；提案 3：每 3 次 stub 后重建 registry |
| v2 | 2026-04-22 | 20 条阈值 | v1 提案验证全部有效；explore 比例偏低（模式 D 持续）；首个 add-tag 动作参与 | 提案 4–8：质量分层、alias 检测、explore 比例修复 |
| v3 | 2026-04-22 | 47 条阈值 | 0 次失败（canonical 过滤全拦截）；wiki 规模快速增长（44→59 页）；tag 池开始积累 | 提案 9–10：tag 批量动作、quality_score 分项显示 |
| v4 | 2026-04-22 | 55 条阈值 | median quality 从 14→7（stub 堆积超过深化速度）；类型只有 person/topic 2 类 | 提案 11–13：recent.json 限额+归档；alias_conflicts 系统化；discover_doc 新探索源 |
| v5 | 2026-04-22 | 用户 req | 深化批量效率高于广度；18 页无事件数据；16 页残留 stub 标记未清 | 提案 14–16：archive 触发日志；stub 清理条件扩展；chapter 作新 explore 源 |
| v6 | 2026-04-22 | 阈值 | history 存储架构引入；recent.json 翻页+归档上线；W5 与 user-req 分治 | 提案 17–19：alias 冲突扫描纳入 W5；无事件页放宽 rubric；页面级 enrich 优先 |
| v7 | 2026-04-22 | bug 驱动 | 鲁桓公页面包含其他朝代 4 条错误事件；根因：事件日期过滤严格匹配失效 | 提案 20–22：事件日期过滤加容错窗口；加入 W4 红旗检查；建立 bug 复盘模板 |
| v8 | 2026-04-23 | 用户 req | 引入全站知识量 K 度量；首次快照 K=13336；链接命中率仅 20.8%（全为指向章节页的死链） | 提案 23：批量生成 130 章节 stub；提案 24：主页知识量仪表板；提案 25：K 时间线折线图 |
| arch | 2026-04-23 | 用户 req | 页面>671 后 renderAll 性能恶化（DOM 节点 2684+）；pages.json 329KB 接近警戒线 | T1：首字过滤栏；T2：虚拟滚动；T3：预建索引；T4：后端查询层 |

**累计提案数**：25 条（v1–v8）+ 架构层 4 级方案

---

## 二、W9 图式反思（R105–R129）

> 位置：`wiki/logs/butler/schema_patterns/`
> 触发：每完成 3 精品+3 stub 一组后触发，记录页面结构模式。
> 时间：全部集中在 2026-04-23。

### 识别的人物细分类型

| 类型 | 代表页面 | 累计估计页数 | 关键 schema 特征 |
|------|----------|-------------|-----------------|
| 战国将领 | 桓齮、庞暖 | ~8 | 战役→胜负→结局轴；秦将需"败亡"子节；合纵将领需"主要活跃诸侯国" |
| 忠义殉主者 | 纪信、周苛、冯去疾、公子高 | 4 | 殉主场景原文；死前话语；殉主方式（烧/烹/自杀/殉葬）；同类互链 |
| 汉代诸侯王 | 刘赐、淮南厉王、刘安 | ~8 | 封国沿革节；家庭内斗/宫廷矛盾；与同期诸侯王关系 |
| 导火索人物 | 雷被 | 少 | 关键节是"历史意义"而非"生平"；需分析因果链 |
| 秦代大臣·谏言者 | 淳于越 | ~3 | 谏言内容+谏言结果两轴；需"谏言原文"独立节 |
| 鸿门宴人物 | 项庄、曹无伤 | 3 | 链接[[鸿门宴]]事件页并反向链接；参与人物对照表 |
| 亡国末代君主 | 赵王迁 | ~4 | 决策失误→灭国关键一役→降/死/流亡→史官评价；需"亡国责任分析"节 |

### 引文质量规律（R119–R129 持续发现）

| 规律 | 说明 |
|------|------|
| +1 citation offset | 063/067/074 等多章事件编号普遍+1，验证时默认减 1 核查 |
| fabricated 双人对话 | 奸臣与忠臣对话易被"标准化"，史记实际多用"王不听，听X"叙述而非直接对话 |
| italic blockquote | `> *"..."*` 格式常混入论语语录或改写版本，非史记实际文字 |
| 嵌套引号冲突 | 对话文字放入 blockquote 时，内部引号须去掉（"必要损失"） |
| 史记叙事克制 | "无以应"三字不加评论；预言+性格+结局平铺不作因果连接；"如其神符"不加质疑 |

### 已创建模板

| 模板文件 | 触发轮次 |
|----------|---------|
| `skills/templates/忠义殉主者.md` | R105–R107 |
| `skills/templates/汉代诸侯王.md` | R108 后 |
| `skills/templates/战国将领.md` | R109 前 |

---

## 三、W11 类型审计（R960–R1080）

> 位置：`wiki/logs/butler/type_audits/`
> 触发：每 10 轮（mod 10 == 0）执行一次，扫描错误分类、发现新概念。
> 时间：全部集中在 2026-04-24。

### 类型分布演变

| 类型 | R960 | R980 | R1080 | 变化说明 |
|------|------|------|-------|---------|
| event | 2945 | 2945 | 3070 | 稳定增长 |
| person | 933 | 934 | 939 | 小幅增长 |
| story | 477 | 477 | 479 | 基本稳定 |
| 侯国 | 320 | 320 | 320 | 不变 |
| place | 37 | 37 | 70 | **本 session 翻超 2 倍** |
| state | 6 | 17 | 20 | 从 6 个增至 20 个邦国页 |
| concept | 62 | 62 | 68 | 新增地理/政治概念 |
| redirect | 182 | 185 | 190 | 持续小幅增长 |
| disambiguation | 3 | 4 | ~5 | 新增"丰""吕"等多义消歧 |

### 重要发现

| 轮次 | 发现 | 处理 |
|------|------|------|
| R960 | registry 双 YAML 块解析漏读：130 页 type 字段丢失 | 加入 housekeeping P1 |
| R970 | v2.0 起 accept 不再 git add，pages.json 严重滞后 | 手动触发 rebuild-registry |
| R980 | rebuild 后 state 类从 6→17，381 页纳入 registry | 已修复 |
| R990 | wanted_pages 从 200 条压降至 10 条（-95%） | 完成里程碑 |
| R1040+ | place 页快速增长（37→70）；KG top-100 全覆盖；无分类错误 | 类型分布健康 |

### 新增高价值页面（来自 wanted_pages 攻坚）

秦/汉/赵/魏/周/韩/燕/晋/代/吴/鲁/殷/陈/卫/郑 等 15 个 state 页；
番禺/濮阳/栎阳/沙丘/曲沃 等重要地理页；
中国/天下/三秦/山川/东国 等政治地理概念页。

---

## 四、知识量 K 增长轨迹

| 时间点 | K 值 | 页数 | 精品页 | link 命中率 |
|--------|------|------|--------|------------|
| 2026-04-23 首次快照 | 13,336 | 229 | 10 | 20.8% |
| R129（2026-04-23 末） | 63,191 | ~1500 | 421 | — |
| R1080（2026-04-24） | — | 5,613 | — | — |

> K 大幅提升主要来自：章节 stub 批量生成（提案 23 实施后 link 命中率跃升）、精品页深化、place/state 类型扩展。

---

## 五、待跟进事项（来自各轮反思但尚未完成）

- [ ] registry 双 YAML 块解析修复（H-W11a，housekeeping P1）
- [ ] 战国将领模板应用到已有 ~8 页
- [ ] 冯去疾/公子高补原文引文和同类互链
- [ ] 鸿门宴事件页增加"参与人物"对照表
- [ ] 孔子页"思想要点"混源问题（论语语录 → 散文化描述）全面清理
- [ ] 067 章 +1 offset 系统化扫描修正

---

*最后更新：2026-04-24*