笔记照样记在 Obsidian 里。
你的代理也能读写它们。
把 Obsidian 保险库中的一个文件夹关联到项目。你在 Obsidian 里写的内容,会成为 AI 编程代理开始工作前读取的记忆;代理学到的东西会以 Markdown 形式回到保险库,[[links]] 完好无损。
无需在 Obsidian 中安装插件,无需 Obsidian Sync 订阅,也无需在保险库里运行代理。桌面应用运行且联网期间,AgentsRoom 会监视磁盘上的这个文件夹,同样的笔记会送达 Claude Code、Codex、GitHub Copilot CLI,或你在该项目上启动的任何其他代理 CLI。
在应用内拍摄的真实会话:项目记忆中的「Obsidian 同步」把 Obsidian 保险库的一个文件夹双向关联起来。保险库里的两条笔记连同描述和标签一起进入记忆。被要求编写价格辅助函数的代理先查看记忆,并遵循写在 Obsidian 里的价格规则。被要求保存学到的内容时,它在同一条笔记中添加一个章节,这条笔记以 Markdown 形式回到保险库文件夹,链接完好无损。
在 Obsidian 中编辑的笔记会进入记忆,代理保存的笔记会落到保险库。对同一条笔记的两处编辑会等你处理。
很多开发者早已把自己的思考记在 Obsidian 里:架构笔记、决策、运维手册,以及某个模块为什么这样构建。除非你手动粘贴,或者在保险库里运行代理,否则 Claude Code 和其他代理 CLI 每次开始会话时对这些一无所知。
AgentsRoom 已经为每个项目提供了一份记忆,代理在深入代码之前会先读它,并在工作时往里写。Obsidian 同步把两者连接起来。你选择保险库中的一个文件夹,其中的 Markdown 笔记就成为该项目记忆中的笔记。反过来,代理保存的笔记会带着前置元数据和 [[wiki-links]] 写回这个文件夹,因此 Obsidian 依然是你的编辑器和你的图谱。
这是同步,不是一次性导入,而且它从不替你裁决分歧。当同一条笔记在两次同步之间被两边都修改,或在一边被删除时,两个版本都会保留,这条笔记会一直等到你作出选择。其他笔记照常同步。
Obsidian 同步能做什么
保险库中的一个文件夹,一个项目,每个代理读到同样的笔记。
双向同步
在 Obsidian 中的编辑会更新项目记忆。代理创建或修改的笔记会以 Markdown 形式写入文件夹,记忆中已有的笔记也会导出到这里。
或仅从保险库同步到记忆
不想让任何东西碰你的保险库?这个模式只读取文件夹。代理照样能读你的笔记,但它们写的内容永远不会进入 Obsidian。
冲突等你处理
不会让最后写入的一方胜出。对同一条笔记的两处编辑,或一处编辑遇上一次删除,只会让这一条笔记暂停,并显示两个版本:Obsidian 的版本和记忆的版本。保留哪个由你选择。
链接和属性保持不变
[[note#heading|alias]] 链接、Markdown 正文以及你添加的 YAML 属性都保持原样。代理写的笔记会在前置元数据中带上描述和标签。
所有代理 CLI
这些笔记成为普通的记忆笔记,Claude、Codex、GitHub Copilot CLI、Cursor 以及 AgentsRoom 支持的另外 10 个代理 CLI 都通过同样的记忆工具读取它们。
多台电脑
关联属于你的账户。在另一台电脑上,项目会显示这个关联,并请你在那台电脑上指定对应的保险库文件夹。取消关联会停止所有电脑上的同步。

工作原理
四个步骤。前三步每个项目只需做一次。
- 1
打开项目记忆
在项目中,从 Dock 打开「项目记忆」(大脑图标)。在它的工具栏中,点击「Obsidian 同步」。
- 2
选择保险库文件夹
点击「选择保险库文件夹」,选择你的保险库或其中一个子文件夹。一个几百条笔记的项目文件夹比整个保险库更合适:其中的每条笔记都会与项目共享。
- 3
选择方向并关联
在「同步方向」下选择「双向同步」或「仅从保险库同步到记忆」,阅读关于共享的提示,然后点击「关联此文件夹」。第一次同步会立即运行。
- 4
你来写,也让代理来写
继续在 Obsidian 中编辑。AgentsRoom 会在几秒内发现已保存的文件,并且每 30 秒检查一次记忆,无需打开面板。「立即同步」会马上执行一次同步;「待解决的冲突」列出等待你选择的笔记。

Obsidian 和代理 CLI 本身已经能做什么
让代理处理你的笔记,并不需要 AgentsRoom。最简单的做法是在保险库文件夹中启动 Claude Code 或 Codex:笔记就是 Markdown 文件,代理会像处理代码一样读取和编辑它们。社区插件更进一步,把代理带进 Obsidian 本身。例如 Claudian 会在侧边栏中打开 Claude Code、Codex、OpenCode 等代理,并以保险库作为工作目录。
还有一些桥接方案,适用于在别处工作的代理。像 mcp-obsidian 这样的 MCP 服务器通过社区插件 Local REST API 暴露保险库,这意味着 Obsidian 必须处于打开状态。从 1.12 版本起,Obsidian 自带命令行(Settings、General、Command line interface),提供 read、search、create 和 append 等命令,它同样需要与正在运行的应用通信。
Obsidian 同步满足的是另一种需求。你的代理在代码仓库里工作,而不是在保险库里,而你希望对这个项目重要的笔记,成为每个代理开始工作前都会读取的内容,在每台电脑上、对项目的每位队友都是如此。同步直接读写磁盘上的文件,因此 Obsidian 无需打开;它会为你保留冲突,而不是让最后写入的一方胜出。它可以与上述任何方案并用。
需要知道的事
- 同步在 AgentsRoom 桌面应用运行且联网期间进行。应用关闭期间在 Obsidian 中所做的编辑,会在下一次同步时被读取。
- 关联文件夹中的每条 Markdown 笔记,都会与所有有权访问项目记忆的人共享,而记忆存储在 AgentsRoom 的服务器上。请关联一个项目文件夹,而不是装满个人笔记的保险库,也不要在里面放任何机密。
- 最多 2,000 条笔记,每条笔记 1 MB,总计 16 MB,子文件夹最多八层。附件、隐藏文件夹和符号链接不在同步范围内。
- 每个项目一个保险库文件夹。一个文件夹不能与另一个项目关联的文件夹重叠。
- 当代理重命名或移动一条记忆笔记时,文件在保险库中的路径保持不变,所以你的链接不会失效。在两次同步之间于 Obsidian 中被重命名又被编辑的笔记,可能会以一条新笔记加一次待确认的删除的形式回来:不经你选择,什么都不会被删除。
- 关联文件夹和解决冲突需要在桌面端进行。你从移动应用操控的代理读取的也是同样的笔记。
常见问题
Claude Code 能读取我的 Obsidian 保险库吗?
能,读取你关联的那个文件夹中的笔记。它们会成为项目记忆中的笔记,你在项目上启动的每个代理(包括 Claude Code)都会被告知在探索代码之前先查看这份记忆。代理不需要在保险库里运行,Obsidian 也不需要打开。
我的代理会写入我的保险库吗?
只有在你选择「双向同步」时才会。届时,代理创建或修改的笔记会以 Markdown 形式写入关联的文件夹,前置元数据中带有描述和标签,[[links]] 也会保留。选择「仅从保险库同步到记忆」时,任何内容都不会写入保险库。
如果代理正在修改一条笔记时,我在 Obsidian 中编辑了它,会怎样?
这条笔记会暂停,并同时显示 Obsidian 版本和项目记忆版本,直到你选择其中一个。一边的删除操作同样会等待你的选择。其他笔记继续同步。如果在你决定之前任一版本又发生了变化,你需要先查看更新后的冲突。
我需要 Obsidian 插件、Obsidian Sync 或 Local REST API 吗?
不需要。AgentsRoom 直接在磁盘上读写该文件夹中的 Markdown 文件。Obsidian 中什么都不用安装,应用也不必打开,同步也不使用 Obsidian Sync。但 AgentsRoom 桌面应用需要处于运行且联网状态。
哪些代理 CLI 可以使用我保险库中的笔记?
AgentsRoom 支持的全部 14 个代理 CLI(Claude、Codex、GitHub Copilot CLI、Cursor 以及另外 10 个代理 CLI)。保险库中的笔记就是普通的记忆笔记,通过与代理自己写的笔记相同的记忆工具读取。
谁能看到关联文件夹中的笔记?
所有有权访问项目记忆的人。这份记忆与项目中的所有成员共享,并存储在 AgentsRoom 的服务器上。这就是为什么文件夹需要你明确选择,以及面板会在关联前提醒你。请关联属于这个项目的文件夹,而不是整个保险库,也绝不要在里面放密码或密钥。
它能在多台电脑上使用吗?
可以。关联保存在你的账户中。在第二台电脑上,项目会显示这个关联,并请你在那台电脑上指定对应的保险库文件夹,因为不同电脑上的路径不同。取消关联会停止所有地方的同步,笔记和文件都保留在原处。
这和「从 Obsidian 导入」有什么不同?
「从 Obsidian 导入」只把笔记复制到记忆一次,由你挑选哪些笔记。「Obsidian 同步」则从此让一个文件夹和记忆保持一致,可以双向同步,也可以仅从保险库同步,并且会处理冲突。两个按钮都在项目记忆的工具栏中。
延伸阅读
你可能还会喜欢
项目记忆
为您的 AI 编码代理提供长期记忆。决策、架构和陷阱在会话之间持续存在,并与项目中的每个人共享。免费,无限制。
Obsidian 替代品
寻找 AI 代理记忆的 Obsidian 替代品?比较 AgentsRoom 和 Obsidian:代理编写的笔记,团队共享,包含 MCP 工具,知识图谱。
关联文件夹
把其他文件夹和仓库加入 AgentsRoom 项目,无需移动它们。你启动的每个代理都会收到它们:在 Claude Code、Codex 和另外四个 CLI 上通过 --add-dir,而「更改」标签页可以分别提交每个仓库。
多供应商
AgentsRoom支持14个AI编码供应商:Claude、Codex、GitHub Copilot CLI、OpenCode、Antigravity CLI、Aider、Grok Build、Mistral Vibe、Kimi Code、Amp、oh-my-pi、Freebuff、Devin和Cursor。为每个代理分配不同的供应商,在对话中途切换供应商,通过自动交接保持完整上下文。最好用的多供应商AI编码工具。
把你已有的笔记交给你的代理
把一个保险库文件夹关联到项目,让 Claude Code、Codex 和每个代理 CLI 从你已经写下的内容出发。
配套应用:随时随地监控你的 Agent
使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。
把 Bug 和需求直接发送到您的公开待办清单。