文档自动化与工作台
文档目录

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 的访问权限,但文件本身不受影响。
本页内容