Obsidian Vault
Obsidian 入口直接打开本地的一个 Vault,能读能写能建笔记;文件和双链保持 Obsidian 原样,Agent 也可以在这个目录里读写。
更新于 2026年11月10日
左侧栏「Obsidian」打开一个本地 Vault。入口默认显示,可以在「设置 → 通用设置」用 Obsidian 开关收起来;这个开关同时决定 Agent 能不能访问已配置的 Vault。
选择 Vault
点左下角的 Vault 名称切换与管理:
- 已发现的本地 Vault 列表。
- 创建 Proma Vault:由 Proma 建一个干净的目录。
- 打开本地仓库:指向已有的 Obsidian 库。
- 云端 Vault 需要先同步或挂载到本机,Proma 读写的是磁盘目录。
Vault 就是普通文件夹,笔记是普通 .md 文件。Proma 不改格式、不改目录结构,同一份文件在 Obsidian 里打开与这里一致。
文件树
左侧是 Vault 目录树,顶部显示可见内容条数,右侧有「新建笔记」。
- 文件夹可展开 / 收起。
- 右键可以新建笔记、新建文件夹。
- 笔记行尾可以删除,确认后从 Vault 里永久删除,不进废纸篓。
编辑
右侧是实时 Markdown 编辑器:
- 自动保存,也可以
Cmd/Ctrl + S立即保存。 - 文件在外部被改过(例如 Obsidian 里编辑)后,保存会提示冲突并保留本地草稿,不会静默覆盖。
- 顶部的 Properties(frontmatter)以可编辑属性展示,平铺的键值可以直接改;嵌套或复杂结构保留原文本。
[[笔记名]]显示为可点的链接,点击在同一个编辑器里打开目标笔记,Alt / Option点击改写链接本身。
Agent 与 Vault
授权后,Agent 可以把 Vault 当项目目录一样读写:查找笔记、整理结构、补写内容、按模板新建。
- 它不会自动读取当前打开的笔记,需要时须明确要求。
- 它不会自己选择或切换 Vault,建库和切库始终是你的操作。
- 从会话里让 Agent 打开某篇笔记时,内容会在会话右侧的工作区展示。
注意
- Vault 与项目是两套东西:项目负责会话、文件改动与 Git,Vault 只承载笔记内容。
- 双链依赖笔记名唯一,同名笔记会指到同一个目标,命名时带上主题。
- 笔记在外部被改过时,删除会被拒绝,需要刷新后再操作。
- 跨设备同步由 Obsidian 或你自己的同步方案负责,Proma 只操作本地目录。
- 关掉 Obsidian 开关后入口消失,Agent 也失去这个 Vault 的访问权限,但文件本身不受影响。