andy nguyen 介绍了 ByteRover 如何打通 Obsidian vault 和 AI 编码 Agent。
问题
你花了几个月甚至几年在 Obsidian 里建第二大脑：架构决策、设计草图、研究笔记。但当你打开 Claude Code、Cursor 或 Codex 时，这些知识消失了。Agent 不知道你已经文档化了那些 trade-offs 和策略。你的个人笔记和代码库活在两个完全不同的世界里。
ByteRover 的解法
ByteRover 不需要复杂桥接，因为它和 Obsidian 有相同的 DNA：
- 都是 Markdown 文件 + YAML frontmatter，按文件夹组织，没有数据库
- 没有专有格式，没有二进制 blobs，没有编码层。只是磁盘上的 .md 文件
因为 vault 结构上等同于 ByteRover 的 Context Tree，ByteRover 可以把 Obsidian notes 当作原生知识源。
核心功能
Federated Search：一次查询搜索 vault 知识和项目代码。 一次策展，全项目可用：同一个 vault 可以链接到每个项目。 Universal Support：vault 变成 22+ 编码 Agent 的知识源（Claude Code、Cursor、Windsurf 等），零额外配置。 Read-Only Safety：Agent 可以读并从笔记中学习，但不能修改或删除 vault 内容。 Zero Friction：不需要 Obsidian 在运行，不需要插件，不需要 REST API，不需要 API keys。只是磁盘上的 Markdown。
使用流程
Step 1：在 vault 里初始化 ByteRover
cd ~/Documents/MyVault
brv
运行 brv 启动 TUI 进行初始设置。
Step 2：策展 vault 知识 在 vault 目录里告诉 coding agent：
> curate the knowledge from ./Architecture/ to context tree
> curate all notes from ./Decisions/ to context tree
> curate the knowledge from ./Design/api-design.md to context tree
Agent 提取知识，写入 .brv/context-tree/，使其结构化、索引化、可搜索。
Step 3：链接 vault 到项目 切换到任何想用 vault 知识的项目：
cd ~/code/my-project
brv source add ~/Documents/MyVault
Step 4：跨所有内容搜索
brv search "authentication flow"
结果会同时显示项目代码和 vault 笔记（用 [MyVault] 前缀标记）。
关键原则
- 从小处开始：不要一次策展整个 vault。选当前工作最相关的 3 个文件夹。
- 笔记变化时重新策展：context-tree 是快照。大笔记更新后，告诉 agent 重新策展。
- 用别名保持清晰：从多个项目链接时，给 vault 一个清晰的别名。