Obsidian

• 个人知识库。 会议记录、阅读笔记、想法和操作指南都放在一个地方，彼此相互链接，多年后仍可搜索。
• 与 AI 智能体协作。 由于笔记是纯文本文件，Claude Code 或 Codex 等智能体可以读取你的笔记作为上下文，把摘要写回，并维护一份持续更新的日志。设置教程见下方链接。
• 每日笔记与任务。 每天一篇笔记，记录当天发生的事情和接下来要做的事，并使用复选框，可在整个知识库中汇总。
• 写作草稿。 适用于长文档、大纲和研究资料，并可链接回你所用的原始来源。

如果你需要与团队进行实时协同编辑，它就不太适合；共享文档工具是为此而设计的。

1. 从官网下载 Obsidian 并安装。
2. 创建仓库（vault）。 选择 Create new vault，为其命名并选择一个文件夹。如果想用已有的 Markdown 文件来试用，请改选 Open folder as vault。
3. 写下你的第一批笔记。 写两篇笔记，并用 [[...]] 把其中一篇链接到另一篇。打开第二篇笔记，查看它的反向链接（backlinks）。
4. 开启每日笔记（设置 → Core plugins → Daily notes），如果你希望每天有一篇笔记。

供 AI 智能体使用：开启命令行工具。 Obsidian 1.12 新增了官方 CLI（命令行界面），让包括智能体在内的程序能够在正在运行的 Obsidian 中搜索、读取和写入笔记：

1. 更新到最新的安装包（1.12.7 或更高版本）。应用内更新有时并不足够，如有需要请重新下载安装包。
2. 进入 Settings → General，开启 Command line interface。
3. 按提示完成注册，然后重启终端。
4. 在终端中输入 obsidian help。如果显示命令列表，说明已经可以使用。

Obsidian 必须处于运行状态，CLI 才能工作；如果它已关闭，第一条命令会将其打开。

在应用中： 撰写笔记，用 [[...]] 建立链接，按 Ctrl/Cmd+Shift+F 搜索，并打开关系图谱视图，查看笔记之间的联系。

从终端（以及供智能体使用）： 几个常用命令：

obsidian search query="meeting notes"
obsidian read file="Project plan"
obsidian create name="Ideas" content="# Ideas"
obsidian daily:append content="- [ ] Call the bank"
obsidian backlinks file="Project plan"

参数使用 name=value 的形式（含空格的值需要加引号）；open（创建笔记后打开该笔记）等标志不需要值。file= 像链接一样按名称查找笔记；path= 则接受保险库内的完整路径。两者都不指定时，许多命令会作用于当前打开的笔记，因此写入时务必指定笔记名称。

连接智能体： 将我们的 Obsidian 技能提供给你的智能体。该技能会告诉智能体优先使用官方 CLI，先读取再写入，并在移动或删除笔记前先询问。初学者教程会完整讲解整个设置过程。

• 备份你的 vault。 它只是一个文件夹，所以把它复制到安全的地方，或者放到版本控制（Git）下管理。在让智能体写入之前先做这一步。
• 删除默认进入回收站。 CLI 命令 delete 会把笔记移到回收站；加上 permanent 则会跳过回收站。未经你同意，绝不要让智能体使用 permanent。
• 社区插件会在你的电脑上运行代码。 只安装你信任的插件，并且只安装你需要的数量。
• 同步是付费附加功能。 把 vault 放在云端文件夹中也可以，但如果两台设备同时编辑同一篇笔记，可能会产生冲突副本。