为什么你的AI Agent换个会话就失忆obsidian-wiki跨会话记忆机制揭秘【免费下载链接】obsidian-wikiFramework for AI agents to build and maintain a digital brain through Obsidian wiki | Memory System for Agents项目地址: https://gitcode.com/gh_mirrors/obs/obsidian-wiki每次开一个新对话你的 AI Agent 就失忆了——忘了你用什么技术栈、忘了上周刚修过的坑一切从头解释。obsidian-wiki是一个让 AI Agent 构建并维护数字大脑的开源框架它的跨会话记忆机制把记忆落盘成普通的 Markdown 文件会话开始时自动注入你是谁、正在做什么会话结束时自动捕获可复用的结论从此 Agent 换会话不再失忆 为什么 AI Agent 总会健忘问题出在大模型的上下文窗口会话一结束记忆就清零。上下文窗口是短期记忆关闭窗口后模型对你的一切了解随之消失聊天记录不是知识库。答案藏在某个再也找不到的聊天日志里下次遇到同样问题只能从头再来每次都要重复自我介绍。我们用 Python FastAPI Postgres——这句话你可能已经说过一百遍。市面上的记忆方案大多依赖向量数据库和 API 服务但 obsidian-wiki 走了一条更透明的路线没有 API Key、没有嵌入模型、没有向量库——记忆就是磁盘上一堆可读、可 grep、可 diff 的 Markdown 文件。obsidian-wiki 的记忆由哪 5 个文件承载跨会话记忆的核心是记忆表面Memory Surface由 5 个文件组成全部存放在你的 vault一个普通文件夹里文件作用谁写入index.md主索引所有页面的目录自动生成保留你手写章节log.md按时间记录的活动日志只追加自动生成hot.md约 500 词的热缓存快照下次会话直接读它自动生成仅Key Takeaways由模型写_meta/profile.md关于你的持久事实技术栈、偏好memory profile set/ 捕获技能_meta/todos.md跨会话的未了事项memory todo add这套设计的关键区分是哪些是生成的哪些是你自己的。index.md是对齐而非覆盖——你手写的阅读队列章节会原样保留而过期的条目会被清掉hot.md超字数时按价值从低到高依次丢弃刻意写下的结论最后才被截断。完整的文件说明、写入规则和迁移流程都写在官方文档 docs/memory.md 里。会话开始注入、会话结束捕获记忆如何跨会话流动这是整个机制最巧妙的部分——两个 Hook 夹住一次会话的生命周期SessionStart 注入wiki-session-recap.sh新会话启动时自动把你的资料 未了事项 最近活动渲染成一个 350 词以内的块塞进会话上下文。Agent 一睁眼就知道你是谁、在干什么Stop 捕获wiki-stop-capture.sh会话结束前如果本次改动过东西就提示执行/wiki-capture --quick把可复用的东西写进_meta/和日志。两个 Hook 还有一个值得称道的设计任何错误路径都静默退出——vault 没配置、包导入失败、文件系统慢都不会阻塞你的会话。一个会让会话起不来的记忆系统比没有记忆更糟。相关实现见 obsidian_wiki/hooks.py。你还可以按会话微调注入行为WIKI_SESSION_RECAPfalse跳过注入、WIKI_RECAP_MAX_WORDS调整字数预算、WIKI_RECAP_MIN_CONFIDENCE过滤低置信度的画像事实。hot.md让 Agent 不用翻遍全库就能接上进度hot.md是跨会话续接的钥匙每次写入操作后它都会被重建所以下一次会话不用爬整个 vault读一个 500 词的快照就能接上上次的工作。其中## Key Takeaways是唯一由模型刻意写下的槽位每次重建都会原样保留——Agent 上一会话得出的结论下一会话依然在场。多个 Agent 并行写记忆不会互相覆盖早期版本里十几个技能各自用散文描述往日志追加一行没有加锁——两个技能并行跑时后写的直接覆盖先写的更新悄悄丢失且不报任何错误。现在所有 5 个文件走同一条写入路径取一把建议锁advisory lock、用os.replace原子替换。memory sync更是把写日志 对账索引 重建热缓存三步锁在一起另一个写入者不可能插进中间留下一个从未存在过的中间状态。核心实现加锁与原子写在 obsidian_wiki/memory.py整体架构详见 docs/architecture.md。如果你的 vault 是旧版本手工维护的obsidian-wiki memory migrate会先做时间戳备份、再采用生成器绝不直接覆盖——迁移预览效果如下顺带一提连是哪次对话都能搜回来跨会话记忆解决记住结论Session Brain解决找到现场它对你的 Agent 会话历史建一张主题图冷启动只需约 3 秒然后你可以这样找回记忆obsidian-wiki sessions-query 那个带诡异重试循环的认证 bug不用向量、不调 API本地 TF-IDF 社区检测按相关度 × 新近度90 天指数衰减排序。详见 docs/session-brain.md。快速上手60 秒给 Agent 装上跨会话记忆pip install obsidian-wiki obsidian-wiki setup --vault ~/brainsetup会顺带注册上面提到的两个会话 Hook。之后在任意项目里对 Agent 说一句set up my wiki即可。不想碰终端直接把仓库丢给 Agent 让它自己装也行。用 Python 把它当记忆层也只需几行from obsidian_wiki import Memory memory Memory(~/brain) memory.remember(stack, Python, FastAPI, confidence0.9) memory.recap() # 会话开始时注入完整安装路径pip / uv / pipx / clone / 多 vault见 docs/installation.mdAPI 细节与和 mem0、Zep 等向量记忆方案的诚实对比见 docs/python-api.md。它适合谁✅适合想让 Agent 记住知识而非对话缓存的人希望记忆可读、可编辑、能进 git、没有外部服务依赖的人多 Agent 混用Claude Code / Cursor / Codex / Gemini 等想共享同一个大脑的团队。⚠️留意检索是词汇匹配的搜 database choice 找不到只写了 Postgres 的页面——给页面打好tags和summary效果最佳。一句话总结obsidian-wiki 把 AI Agent 的跨会话记忆做成了会自己更新的笔记——会话开始自动想起会话结束自动记牢全部落在你自己文件夹里的 Markdown 中。【免费下载链接】obsidian-wikiFramework for AI agents to build and maintain a digital brain through Obsidian wiki | Memory System for Agents项目地址: https://gitcode.com/gh_mirrors/obs/obsidian-wiki创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考