dsh-codevault

读开源代码时最令人沮丧的往往不是当场没看懂，而是三天后完全想不起自己理解了什么。dsh-codevault 要解决的就是这个遗忘循环：在对话中读懂某个机制后，用一句自然语言让模型记一笔，插件便按仓库、文件、符号三个层级归档成一张知识卡片。反复阅读同一个对象时，新内容追加到同一张卡的时间线上而不是另开碎片，卡片随阅读自然生长，顶部 readCount 递增，各次要点去重合并。

卡片以 Markdown 加 JSONL 落盘，[[wikilink]] 由插件按坐标自动生成，放进 Obsidian vault 后图谱开箱即用。配置 vaultDir 后，模型可只读检索你已有的笔记，经你确认后把关联链接补到卡片上，把代码理解与项目知识串成一张网。底层日志只追加、卡片是生成视图，因此 read_history 可以精确回放到第 N 次阅读的任意版本，read_delete 删除事件后卡片也能正确重建，版本历史就是事件流本身，无需额外存储。每条记录还可附带两到三条回访问题，回看时先自答再补空，把被动翻阅变成主动回忆。

整套插件纯本地运行，不读你的仓库、不联网、不调外部 API，只写自身数据目录。它不给代码打分、不编造未读到的字段，destructive 操作一律要求确认。适合那些认真读开源代码、希望把零散理解沉淀为可回放、可关联的个人知识库的开发者，尤其是已在 Obsidian 中管理笔记、想要把代码阅读笔记与项目文档串起来的人。