docs: CLAUDE.md+log同步 — wiki重构后§3.3§8.3更新

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

CLAUDE.md

@@ -142,21 +142,9 @@ desktop/src-tauri    (→ kernel, skills, hands, protocols)
 
 **接到任务后，第一件事是阅读 wiki 获取上下文，而不是直接动手。**
 
-1. 读取 `wiki/index.md` — 理解全局架构和模块导航
+1. 读取 `wiki/index.md` — 理解全局架构，利用**症状导航表**快速定位相关模块
-2. 根据任务涉及的模块，读取对应的 wiki 页面：
+2. 读取对应模块页 — 每个模块页统一 5 节结构：设计决策 → 关键文件+集成契约 → 代码逻辑(不变量) → 活跃问题+陷阱 → 变更记录
-   - 聊天/消息相关 → `wiki/chat.md`
+3. 如涉及已知问题，检查模块页的"活跃问题"节（全局索引见 `wiki/known-issues.md`）
-   - 连接/路由相关 → `wiki/routing.md`
-   - 记忆/上下文相关 → `wiki/memory.md`
-   - Agent/分身相关 → `wiki/chat.md` (Agent 部分)
-   - Hands/技能相关 → `wiki/hands-skills.md`
-   - 管家/行业相关 → `wiki/butler.md`
-   - 中间件相关 → `wiki/middleware.md`
-   - SaaS/认证/计费 → `wiki/saas.md`
-   - 安全相关 → `wiki/security.md`
-   - 数据库相关 → `wiki/data-model.md`
-   - Pipeline/工作流 → `wiki/pipeline.md`
-   - 功能链路追踪 → `wiki/feature-map.md`
-3. 如涉及已知问题，检查 `wiki/known-issues.md`
 
 **判断标准**: 你能用一句话说清楚"这个改动涉及哪个模块、走哪条数据链路、影响哪些组件"吗？如果不能，你还没读完。
 
@@ -395,16 +383,15 @@ docs/
 3. **docs/ARCHITECTURE_BRIEF.md** — 架构决策或关键组件变更时
 4. **docs/features/** — 功能状态变化时
 5. **docs/knowledge-base/** — 新的排查经验或配置说明
-6. **wiki/** — 编译后知识库维护（按触发规则更新对应页面）：
+6. **wiki/** — 编译后知识库维护（按触发规则更新对应页面，每页统一 5 节: 设计决策 / 关键文件+集成契约 / 代码逻辑 / 活跃问题+陷阱 / 变更记录）：
-   - 修复 bug → 更新 `wiki/known-issues.md`
+   - 修复 bug → 更新对应模块页"活跃问题"节 + `wiki/known-issues.md` 索引
-   - 架构变更 → 更新对应模块页 (routing/chat/saas/memory/...)
+   - 架构变更 → 更新对应模块页"设计决策"节
-   - 文件结构变化 → 更新对应模块页的"关键文件"表
+   - 文件结构变化 → 更新对应模块页"关键文件"表
-   - 模块状态变化 → 更新对应模块页的"功能清单"表
+   - 跨模块接口变化 → 更新对应模块页"集成契约"表
-   - 功能清单变化 → 更新 `wiki/feature-map.md` 对应链路
+   - 新增不变量发现 → 更新对应模块页"代码逻辑"节的 ⚡ 标记项
-   - API 接口增删 → 更新对应模块页的"API 接口"表
+   - 功能链路变化 → 更新 `wiki/feature-map.md` 索引表
-   - 测试增删 → 更新对应模块页的"测试链路"表
    - 数字变化 → 更新 `wiki/index.md` 关键数字表 + `docs/TRUTH.md`
-   - 每次更新 → 在 `wiki/log.md` 追加一条记录
+   - 每次更新 → 在 `wiki/log.md` 追加一条记录 + 模块页"变更记录"节更新最近 5 条
 6. **docs/TRUTH.md** — 数字（命令数、Store 数、crates 数等）变化时
 
 #### 步骤 B：提交（按逻辑分组）

wiki/log.md

@@ -9,6 +9,16 @@ tags: [log, history]
 
 > Append-only 操作记录。格式: `## [日期] 类型 | 描述`
 
+## [2026-04-22] docs | Wiki 重构 — 5节模板+集成契约+症状导航+归档压缩
+- **Phase A**: log.md 归档(548→335行, 38条活跃) + hermes-analysis 归档 + known-issues 转索引(277→38行)
+- **Phase B**: middleware.md 重构(157→136行) — 集成契约+3不变量+单真相源
+- **Phase C**: saas.md(231→173, 移除安全重复) + security.md(158→199, 吸收安全内容) + memory.md(363→147, 最大压缩59%)
+- **Phase D**: routing(330→131) + chat(180→134) + butler(215→150) + hands-skills(281→170) + pipeline(157→154) + data-model(181→153)
+- **Phase E**: index.md 新增症状导航表(144→101行, ≤120预算) + 移除架构Q&A(移入各模块)
+- **Phase F**: feature-map.md 33链路详细描述→紧凑索引(424→60行)
+- **CLAUDE.md**: §3.3 阶段1 更新(症状导航+5节说明) + §8.3 wiki维护规则更新(新模板触发规则)
+- 净减 ~1,200 行，消除所有跨3+页重复，10/10 模块页新增集成契约
+
 ## [2026-04-22] docs | Wiki 一致性修复 — 数字/格式/重复内容清理
 - **index.md**: 数据流图中间件 15→14 层
 - **chat.md**: 中间件层引用 15→14 层