开发者构建 Mentat：用私有 git 笔记库为 Claude 和 OpenCode 提供统一记忆

每开一个新的 AI 对话，一切又得从零开始。我是谁、我正在做什么、上周决定了什么、我喜欢什么样的回复风格。我在 Claude、OpenCode 里，在手机上、在笔记本电脑上，一遍又一遍地输入同样的背景信息。我有阅读障碍，所以打一整页背景资料既慢又累。我希望只写一次，然后让所有工具都能读到它。

于是我做了 mentat：一个由短小互链笔记组成的私有仓库，通过 MCP 提供给我的 AI 工具使用。我的真实笔记保持私密，所以我做了一个公开副本，里面是一个虚构的人物：mentat-template。（在《沙丘》里，mentat 是受过训练、如同人脑计算机的人。我觉得这个名字很贴切。）图片：Bill Sanderson，1997，Wellcome Collection，来自 Wikimedia Commons，CC BY 4.0。

笔记之间用 [[wiki 链接]] 相互连接。链接就是结构。我可以在 Obsidian 中打开这个文件夹，用任何编辑器编辑它，并用任何 diff 工具阅读它。每次 push 时，CI 会构建索引和链接图。

AI 工具并不是唯一的入口。在我的 Mac 上，这个仓库只是一个文件夹，我在 Obsidian 中把它作为 vault 打开：开始编辑前先 pull。如果某个对话的 pull request 在你离开时合并了，你会希望它先进入你的副本。

MCP 是 AI 工具调用外部工具的一种标准方式。一个小型 Cloudflare Worker 把笔记作为 MCP 服务器提供出去，所以 Claude 和 OpenCode 可以从任何设备调用它：read_note 完整读取一条笔记；search_notes 带摘要的关键词搜索；list_notes 按类型、标签或状态筛选；related_notes 双向跟随链接；latest_log 本月的日志。

每次 push 到 main，CI 会把笔记打包进 Worker 并重新部署。没有数据库，没有什么需要保持同步。

这些笔记是我的生活管理资料，所以服务器只有一条规则：只有我能进。读取是简单的部分。有用的部分是当某个对话替我更新笔记时：“订了新桌子”、“Jordan 回复了”。但我不希望某个对话直接写入所有其他对话都信任的笔记。一个网页或一封邮件可能诱骗某个对话写入误导性内容，然后之后每个对话都会把它当作事实来读。所以写入工具只会打开一个 pull request：日志行很短、带日期、容易识别，所以日志 PR 在静默 72 小时后会自动合并。新建或修改的笔记则总是等我处理。

这篇文章顶部的地图是同一个 Worker 上的一个页面 /graph，位于同样的 GitHub 登录之后。每条笔记是一个点，每个链接是一条线，点击一个点会打开该笔记。这是一个手写的小型力导向布局，没有外部脚本，所以页面可以在严格的内容安全策略下运行。

大部分功能第一次就成功了。这些没有：有一个使用虚构笔记的在线演示，只读且无需登录：要制作你自己的版本，在 mentat-template 上点击 Use this template，并把你的副本设为私有。用你自己的内容替换 me.md 和演示笔记，然后按照 docs/mcp.md 部署 Worker 并连接 Claude 或 OpenCode。从小处开始。一个 me.md 和几条关于你正在做什么的笔记，就足以让你不必向每个新对话解释自己。