Memory Garden

这是什么？适合谁？

Memory Garden（drephantom/memory-garden）是一个基于 Obsidian 的个人认知回溯 Agent：在 Obsidian 笔记上做个人认知回溯：立场快照、混合检索与只读 MCP 工具，带 48 个测试与 3 个可复现 eval。

核心价值：把个人知识库变成可回溯的认知记录——立场随笔记演化可追踪，混合检索找到相关旧笔记。

适合人群：

• 用 Obsidian 管理知识库的用户
• 想记录立场演化的研究者
• 关注 Agent 记忆与 RAG 的开发者

使用前提：Obsidian 笔记库与 Python 环境

准备工作

1. 安装：clone 仓库并配置
2. 数据：指向你的 Obsidian 笔记库
3. 环境：Python + 模型接口
4. 成本：MIT 开源免费
5. 时间：配置 + 首次回溯约 20 分钟

快速上手（3 步）

第一步：安装配置

git clone https://github.com/drephantom/memory-garden
cd memory-garden
pip install -r requirements.txt

克隆并安装

第二步：指向笔记库

把 Obsidian 笔记库接入

第三步：运行回溯

让 Agent 做立场快照与检索

成功判定：对某个主题得到一份基于笔记的立场快照或相关旧笔记检索结果。

初级用法

立场快照

对某主题生成当前立场快照。

混合检索

在笔记库中做混合检索。

只读 MCP

通过只读 MCP 工具接入 Agent。

高级玩法

认知演化追踪

追踪立场随时间的变化。

自定义检索策略

调整混合检索的权重。

多主题回溯

批量回溯多个主题。

小技巧

1. 笔记库先做基础整理，检索更准
2. 只读工具保证不误改笔记
3. 立场快照定期生成，便于对比
4. 用 eval 数据验证检索质量
5. 关注模型对长笔记的截断

常见踩坑

踩坑 1：检索不相关

• 现象：返回的笔记与主题无关
• 原因：检索权重未调
• 解决：调整混合检索参数

踩坑 2：快照失真

• 现象：立场快照与笔记不符
• 原因：笔记噪音或模型偏差
• 解决：清理噪音笔记并复核快照

踩坑 3：笔记库路径错误

• 现象：加载不到笔记
• 原因：路径配置错
• 解决：核对笔记库路径

踩坑 4：模型接口问题

• 现象：调用失败
• 原因：凭据或端点
• 解决：按 README 配置模型

踩坑 5：项目较新

• 现象：功能有限
• 原因：2026-08 新建
• 解决：以 README 为准

常见问题 FAQ

Q1: 只支持 Obsidian 吗？

A: A: 当前基于 Obsidian 笔记，具体数据源以 README 为准。

Q2: 会改动我的笔记吗？

A: A: MCP 工具为只读设计，不会修改笔记。

Q3: 免费吗？

A: A: MIT 开源免费。

Q4: 检索质量如何？

A: A: 提供 3 个可复现 eval 与 48 个测试用于评估。

Q5: 数据隐私？

A: A: 本地运行，笔记不出本机，但模型调用会发送相关文本。

进阶学习建议

掌握基础后，建议深入：

1. 研究混合检索在个人知识库上的调优

2. 把立场快照做成定期自动化

3. 用 eval 数据持续改进检索质量

参考链接

• 官方仓库

最后更新：2026-08-31 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成