obsidian 是做什么的?
用于处理本地 Obsidian 知识库。Obsidian 知识库是一个包含 Markdown 文件和 .obsidian/ 配置的普通文件夹。
来源
- 应用配置:
~/Library/Application Support/obsidian/obsidian.json - 默认知识库名称:
obsidian - 常用本地知识库路径:
~/obsidian - 官方 CLI:
obsidian - 知识库命令会从当前工作目录解析知识库;请在
~/obsidian下运行它们。
初始检查
command -v obsidian
obsidian version
obsidian vaults
cd ~/obsidian
obsidian commands filter=search:
全局命令如 version 和 vaults 可以在知识库外工作。知识库内容相关的命令在 ~/obsidian 外可能会输出 Vault not found.。请使用 obsidian commands,而不是 obsidian help 来探索 CLI。
如果 obsidian 提示 CLI 被禁用:
- 优先要求用户启用 设置 -> 通用 -> 高级 -> 命令行界面。
- 如果你已经确认了应用配置格式,
~/Library/Application Support/obsidian/obsidian.json中使用"cli": true。 - 更改应用级 CLI 配置后重启 Obsidian。
读取工作流
优先使用官方 CLI 进行 Obsidian 感知的查询:
cd ~/obsidian
obsidian search query="OpenClaw" format=json
obsidian search:context query="OpenClaw" limit=20 format=json
obsidian read path="Folder/Note.md"
obsidian file path="Folder/Note.md"
obsidian outline path="Folder/Note.md" format=json
obsidian backlinks path="Folder/Note.md" format=json
obsidian links path="Folder/Note.md"
obsidian properties path="Folder/Note.md" format=json
当你已经知道路径并且需要精确字节时,使用直接文件系统读取:
sed -n '1,220p' "$HOME/obsidian/Folder/Note.md"
rg -n "term" "$HOME/obsidian"
当新鲜度或知识库选择重要时,请说明你使用了哪个来源。
写入工作流
选择最窄的写入路径:
- 新笔记:
obsidian create path="Folder/Note.md" content="..."。 - 追加/前置每日笔记:
obsidian daily:append content="..."。 - 简单笔记编辑:在 Markdown 文件上使用
apply_patch。 - 重命名/移动笔记:优先使用
obsidian move path="Old.md" to="Folder/New.md",以便更新链接。 - 写入后打开 UI:仅在有用或请求时添加
open。
常用命令:
cd ~/obsidian
obsidian create path="Notes/New.md" content="# New\n\nBody"
obsidian append path="Notes/New.md" content="More text"
obsidian move path="Notes/New.md" to="Archive/New.md"
obsidian daily:path
obsidian daily:read
obsidian daily:append content="- Follow-up item"
对于多行内容,优先在知道路径后使用 apply_patch 编辑 .md 文件。避免对长文本使用脆弱的 shell 引号。
Bases、Canvas、插件
首先使用 CLI 发现:
cd ~/obsidian
obsidian bases
obsidian base:views path="Projects.base"
obsidian base:query path="Projects.base" view="Active" format=json
obsidian plugins format=json
obsidian plugins:enabled format=json
obsidian commands filter=workspace:
对于 .canvas、.base 和 .json 文件,尽量作为结构化数据进行读取/编辑。保持格式稳定,并在编辑后验证 JSON。
安全
- 不要批量重写知识库。使用目标路径并检查差异。
- 除非用户要求或任务明确涉及设置/插件工作,否则不要编辑
.obsidian/。 - 除非明确要求,否则不要删除笔记;优先使用废纸篓而非永久删除。
- 不要通过 Obsidian URI/CLI 路径创建隐藏的以点开头的文件夹笔记。
- 保留 frontmatter 和维基链接,除非任务是对它们进行重构。
- 如果存在多个知识库,不要猜测;使用
obsidian vaults和obsidian.json。