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` — 理解全局架构和模块导航
-2. 根据任务涉及的模块，读取对应的 wiki 页面：
-   - 聊天/消息相关 → `wiki/chat.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`
+1. 读取 `wiki/index.md` — 理解全局架构，利用**症状导航表**快速定位相关模块
+2. 读取对应模块页 — 每个模块页统一 5 节结构：设计决策 → 关键文件+集成契约 → 代码逻辑(不变量) → 活跃问题+陷阱 → 变更记录
+3. 如涉及已知问题，检查模块页的"活跃问题"节（全局索引见 `wiki/known-issues.md`）
 
 **判断标准**: 你能用一句话说清楚"这个改动涉及哪个模块、走哪条数据链路、影响哪些组件"吗？如果不能，你还没读完。
 
@@ -395,16 +383,15 @@ docs/
 3. **docs/ARCHITECTURE_BRIEF.md** — 架构决策或关键组件变更时
 4. **docs/features/** — 功能状态变化时
 5. **docs/knowledge-base/** — 新的排查经验或配置说明
-6. **wiki/** — 编译后知识库维护（按触发规则更新对应页面）：
-   - 修复 bug → 更新 `wiki/known-issues.md`
-   - 架构变更 → 更新对应模块页 (routing/chat/saas/memory/...)
-   - 文件结构变化 → 更新对应模块页的"关键文件"表
-   - 模块状态变化 → 更新对应模块页的"功能清单"表
-   - 功能清单变化 → 更新 `wiki/feature-map.md` 对应链路
-   - API 接口增删 → 更新对应模块页的"API 接口"表
-   - 测试增删 → 更新对应模块页的"测试链路"表
+6. **wiki/** — 编译后知识库维护（按触发规则更新对应页面，每页统一 5 节: 设计决策 / 关键文件+集成契约 / 代码逻辑 / 活跃问题+陷阱 / 变更记录）：
+   - 修复 bug → 更新对应模块页"活跃问题"节 + `wiki/known-issues.md` 索引
+   - 架构变更 → 更新对应模块页"设计决策"节
+   - 文件结构变化 → 更新对应模块页"关键文件"表
+   - 跨模块接口变化 → 更新对应模块页"集成契约"表
+   - 新增不变量发现 → 更新对应模块页"代码逻辑"节的 ⚡ 标记项
+   - 功能链路变化 → 更新 `wiki/feature-map.md` 索引表
    - 数字变化 → 更新 `wiki/index.md` 关键数字表 + `docs/TRUTH.md`
-   - 每次更新 → 在 `wiki/log.md` 追加一条记录
+   - 每次更新 → 在 `wiki/log.md` 追加一条记录 + 模块页"变更记录"节更新最近 5 条
 6. **docs/TRUTH.md** — 数字（命令数、Store 数、crates 数等）变化时
 
 #### 步骤 B：提交（按逻辑分组）