# 经验教训记录

每次被纠正后追加一条记录。每次新任务前先扫一遍本文档。

## 格式
- [YYYY-MM-DD] 问题: xxx | 根因: xxx | 正确做法: xxx

---
- [2026-07-17] 问题: 配置完 key6 后没同步更新 usage_monitor spec，也不知道用户看到的 Dashboard 后端是 246 本地采集而非 Windows bridge | 根因: 没有先看 § spec 了解实际架构，开发完成后也没更新 spec | 正确做法: ①改代码前先看对应模块的 § spec 了解架构 ②改完后同步更新 spec 的 api/constraints/dependencies 与实际实现一致

- [2026-07-31] 问题: 之前多篇微信文章入库只做了 "从DB读内容+分析报告"，漏掉了 Obsidian 全文保存和 wiki 关键字提取两个步骤，导致知微/笑笑搜不到全文和概念 | 根因: 对 user-article-ingestion skill 的标准流程执行不完整 — "入库" 的心理模型只停留在"读了、分析了、报告了"，忽略了持久化环节（存 Obsidian + 提取 wiki）。id=484 的截断问题只是催化剂，根本原因是长期习惯性漏步 | 正确做法: 每篇微信文章处理完必须自查 checklist — (1) 全文存 Obsidian raw/articles 了吗？(2) wiki 关键字提取了没有？(3) link index 更新了吗？(4) agentmemory 记录了吗？四项全满足才算"已入库"。

