2026-07-03 上帝页拆分与簿记脚本化

背景

三个大页（124KB / 92KB / 73KB）导致每次 ingest 命中即整页读写，单次更新 3-6 万 token。同时 lint 发现 21 页 source_count 漂移——手工数数不可靠。

拆页明细

上下文管理与 Harness Engineering（124KB → 4 页）

• 原页保留为路由/核心页（33.8KB，31 源）：范式跃迁、核心公式、组件解剖、设计原则、失败模式、CLAUDE.md 治理
• [[wiki/concepts/Harness 工程案例索引]]（33.6KB）：全部企业/团队案例
• [[wiki/concepts/Harness 架构演进与前沿]]（31.7KB）：组合优化、Managed Agents、三家对比、ETCLOVG、State-Aware Runtime
• [[wiki/concepts/Harness 机制与配置工程]]（24.8KB）：七种定制机制、Goal 模式、压缩对比、Hooks、Token 经济学
• Loop 段落合并入 [[wiki/concepts/Loop Engineering]]（去重后 14.5KB）

Skills、Agents 与工具设计（92KB → 5 页）

• 原页保留为路由页（12.1KB）；拆分前后 77 个 raw 来源链接集合逐一比对一致
• [[wiki/concepts/Skill 设计方法论与实战案例]]（29.2KB）
• [[wiki/concepts/Skill 治理、进化与安全]]（19.3KB）
• [[wiki/concepts/Agents 编排与 Loop Engineering]]（13.7KB）
• [[wiki/concepts/机制分层与工具设计]]（27.3KB）

Claude Code（73KB → 4 页）

• 主页保留（27.8KB）：定位、产品事件主线
• [[wiki/entities/Claude Code 多 Agent 与自主执行]]（18.4KB）
• [[wiki/entities/Claude Code 模型接入与选型]]（17.1KB）
• [[wiki/entities/Claude Code 配置体系与扩展机制]]（14.5KB）

原则：内容只搬移不改写，来源链接随段落跟随，原页留一行链接指向新页。

簿记脚本化

• 新增 scripts/kb-metrics.py：从页面 [[raw/...]] 唯一引用重算 source_count 回写 frontmatter，并同步 index.md 的（N 源，MM-DD）指标。generated 页除外。
• 修复 scripts/update-confidence.py 硬编码 TODAY = date(2026, 6, 21) → date.today()。
• 全量回写一轮：21 页 source_count、22 行 index 指标、confidence 重算。
• 重新生成 raw catalog/coverage（877 raw md，372 未覆盖）。

流程变更

• kb-ingest：批量模式（簿记批末一次）+ changelog 降级（普通摄入只写 log 一行）+ 禁止手数来源
• kb-lint：先跑 wiki-health / kb-metrics —dry-run / raw-integrity，LLM 只判断语义问题
• references/_context.md：两个 generated 大文件（>170KB）禁止整页读取，只准 grep

遗留

• raw/.checksums 落后约 146 个新增文件，待确认后 regenerate
• 4 页仍触发 large-page 警告（分水岭 52 源、Agent 原理 43 源、矛盾与视角差异 72 源、raw-主题索引 456 源为索引页属正常），后续再评估拆分
• 372 篇 raw 未被 wiki 覆盖，其中 6-21 至 7-03 新增源需要补摄入