布莱恩喵
折腾笔记已复盘

我给 Obsidian 做了一套跨 Agent 操作协议

当多个 AI 都能读写个人知识库时,最重要的不是让它们更聪明,而是让它们知道边界、入口、路由和哪些东西不能碰。

ObsidianAI 工作流知识管理Agent

结论先说:Obsidian 接入 AI 以后,真正需要的不是又一个“万能助手”,而是一套跨 Agent 都能遵守的操作协议。

我之前最担心的事情很具体:不同工具、不同会话、不同机器都能碰我的笔记库。短期看很方便,长期看如果没有规则,它们会把私人笔记、公开内容、项目进展和临时碎片搅在一起。到最后,AI 没有帮我整理知识库,反而帮我制造了一层新的混乱。

所以这套协议的目标不是炫技,而是让 AI 进来以后先知道:这里不是普通代码仓库,这是一个人的长期记忆库。

为什么折腾

我的 Obsidian 里东西太杂了。

有项目记录,有工具手册,有剪藏,有技术资料,也有私人内容、账本、日记和临时想法。人自己打开时能靠语境判断,但 Agent 不一定能判断。

如果没有入口规则,它可能会把网站草稿写进私人库,把一次性命令塞进项目文档,把需要保留历史的记录直接覆盖掉。更麻烦的是,不同 Agent 的习惯还不一样:有的偏向重构,有的偏向总结,有的偏向直接执行。

跨 Agent 协议就是为了解决这个问题:不管谁来操作,都先按同一套入口、目录边界和信息路由工作。

我的公开版环境

公开版可以讲成三层:

  • 私人 Obsidian 库保存原始材料。
  • 维护系统保存规则、入口、流程和日志。
  • 网站项目保存公开文章、草稿、分发包和发布状态。

这里最关键的边界是:Obsidian 是素材库,不是网站编辑部。

网站内容可以从 Obsidian 读取素材,但文章正文必须在网站项目里重写。这样即使未来要把网站项目上传到 GitHub,也不会把私人笔记库混进去。

实际怎么做

第一步是定义“先读什么”。

普通查询只需要读总入口、导航和当前协议。做结构维护时,才继续读主控台、协作手册、总规则、自动维护说明和 wiki 规则。这样不会每次都把整个维护系统塞进上下文,也避免 Agent 靠猜。

第二步是把信息路由写清楚。

临时想法、网页剪藏、工具说明、AI 工具、长期项目、视频资料、私人内容、账本、日记,都有默认位置。不确定时先放碎片箱,而不是强行分类。

第三步是写操作边界。

默认允许新建笔记、追加项目更新、补最小 frontmatter、更新 MOC 和索引。默认禁止删除笔记、大范围改写正文、擅自处理敏感目录、创建假占位页。

这个规则很朴素,但它让 AI 的行为从“我觉得可以”变成“系统允许这样做”。

哪里卡住

第一个坑是根目录。

Obsidian 根目录如果什么都能放,很快就会变成所有工具的垃圾入口。后来我把根目录收窄,只保留总说明、导航和必要规则,其他维护文档全部进维护系统。

第二个坑是“整理”和“破坏”之间很近。

AI 很容易觉得自己在帮你清理,其实是在把原始证据改没。所以协议里明确:优先新增,不优先破坏;项目更新追加,不覆盖历史;原始来源保留,不直接改写。

第三个坑是公开内容的边界。

网站文章、小红书内容、YouTube 脚本看起来也像笔记,但它们不该回流到私人库。现在我把这些都放在网站项目的 editorial 工作区,Obsidian 只保留项目级摘要。

值不值得

值得,尤其是当你真的开始让 AI 长期参与知识库维护以后。

没有协议时,AI 像一个能干但没规矩的临时工。有协议以后,它更像一个知道办公室分区、知道什么能动、什么不能动的协作者。

这不是为了让系统变复杂,而是为了让我以后不用每次重新解释:这类信息放哪里,那类内容不能公开,项目日志不要覆盖。

下一步

下一步我会继续收紧两件事:

  • 网站公开内容继续留在项目目录,不再混回私人 Obsidian。
  • Obsidian 的维护记录只写阶段摘要,不保存网站全文和平台分发包。

真正有用的个人知识库,不是所有东西都自动化,而是自动化以后仍然不乱。