深耕数码、AI兴趣领域
16
41
让 AI 洞察你的知识网络：Obsidian CLI 完整指南
2026-05-14 23:02:26
1点赞
12收藏
0评论
Obsidian 正式发布了 CLI，AI 终于能直接读懂你的整个知识库了。
这篇文章从基础概念到实战演示，把 Obsidian CLI 一次讲清楚。
一、Obsidian CLI 是什么
先回答一个非技术背景朋友最常问的问题：CLI 是 AI 助理吗？
不是。
CLI 全称是 Command Line Interface，即命令行界面。它和平时用的 Obsidian App（图形用户界面 GUI）是两种完全不同的交互方式：
Obsidian App（GUI）：界面图形化，有按钮有菜单，鼠标点击即可操作。
Obsidian CLI ：纯文本，黑底白字操作对象
但本质上它们操作的都是同一个软件同一个文件。
举一个具体的例子：创建一条新笔记。
在 App 里，点「新建笔记」按钮就好了。
在命令行里，输入命令：
obsidian create --name newnote
回车，笔记就建好了。
CLI 看起来黑乎乎的，全是字，确实不如图形界面直观。1970 年代之前，所有计算机操作都是这种方式——那时候鼠标还没发明，也没有高级图形显示技术，所有操作都是键盘输入指令。后来施乐研发出图形界面，苹果把它用在个人电脑上，GUI 才普及开来。
所以问题来了：既然 App 用得好好的，为什么要去敲命令？
因为 CLI 不是给人类用的，是给 AI 用的。
人类用 CLI 确实抽象，但 AI 可以瞬间学会所有命令，也能迅速把多条命令组合起来，实现大量而复杂的操作。关键是：得先教 AI 怎么用。
二、启用 CLI，并教会 AI 使用
第一步：启用 Obsidian CLI
打开 Obsidian 设置，确认版本 ≥ 1.12.4
找到「命令行界面」选项并打开
系统提示注册路径，点「注册」
打开终端，输入
obsidian，看到帮助信息即表示启用成功
第二步：教会 AI 使用 CLI
以 OpenCode 为例，教会 AI 新技能，首选方式是添加 Skill。
Obsidian CEO Kepano 亲自编写了 obsidian-cli Skill，可直接安装使用。
接下来建议修改 CLAUDE.md 文件，加入 Obsidian CLI 的使用规范：
# Obsidian 操作规范
- 涉及 Obsidian 的操作，优先使用 obsidian-cli Skill
- 所有命令加上 `--silent` 参数，避免频繁弹窗
- 标签搜索优先用 `obsidian tag` 命令，而非全文匹配
验证一下
直接在 Obsidian 里对 Claude Code 说：
帮我创建一篇笔记，标题叫「AI 创建的笔记」，内容是今天的日期。
OpenCode自动调用了 obsidian-cli Skill，执行 create 命令创建笔记，全程无需手动输入任何命令。
打开 Obsidian，笔记已创建成功，内容正是今天的日期。
注意看这个简单的操作，背后其实叠加了多个命令。创建笔记、自动填入日期——这些对于人类来说要好几步，对 AI 来说只是一句话的事。
三、AI+CLI 与 AI 直接查改的根本区别
到了这一步，有人会问：
现在 Claude 的 Obsidian 插件不也能让 AI 读和改笔记吗？CLI 的优势在哪？
Obsidian 的两个层次
对 Obsidian 要建立起两层认知：
第一层：Obsidian 是一个 Markdown 编辑器。 对纯文本文件进行增删改查，和其他 Markdown 编辑器差别不大。
第二层：Obsidian 也是一套知识管理系统。 双向链、标签、笔记属性、Canvas……这些能力超出了 Markdown 标准本身，是普通编辑器做不到的。
对于第一层，所有 AI Agent 都能胜任——本质上就是读写纯文本文件。
到了第二层，理解双向链、笔记属性、标签体系，AI 就力不从心了。它只能一个个读取文件，通过文本匹配去推断关系，效率低、错误率高，token 消耗也很大。
而这些关系信息，Obsidian 内部其实早就知道了。
Obsidian CLI 的本质，就是把 AI 推断关系这一步，直接变成查询关系。
举例：查找反向链接
假设想知道有哪些笔记提到了「复利思维」。
手动找法：在每一条笔记里搜索「复利思维」关键词——笔记数量少则几十篇，多则上百篇，每篇都要打开看一遍。
用 CLI 找：
obsidian search "复利思维" --backlinks
一行命令，瞬间返回所有提到「复利思维」的笔记列表。
这不是搜索，这是直接查询 Obsidian 内部已经建立好的链接索引。
更有意思的场景
假设想找出所有同时包含「AI」相关标签和「知识管理」标签的笔记。这里的「AI」可能包括 AI 工具、AI 概念、AI 学习等好几个子标签。
只需要用自然语言告诉 OpenCode：
用 Obsidian 的标签搜索命令，同时找 AI 开头的标签和知识管理标签的笔记。
然后 OpenCode 会自动执行：
调用
obsidian tag命令，查找 AI 相关标签查找知识管理标签下的笔记
交叉比对，取交集
接下来可以再让它用 Canvas Skill 创建一张可视化图谱：
中心节点：AI + 知识管理
二级节点：AI 工具、AI 概念、AI 学习……
末级节点：具体文章
在这个图谱里，所有关于 AI 与知识管理的思考汇聚在一起。思维变成了一棵树——用这种方式回顾之前的思考，体验确实不一样。如果产生了新的想法，直接记录或新建笔记即可。
结论：什么时候用哪种方式
单条笔记内的文稿润色、改写：用AI 直接查改
跨多条笔记的关系梳理：推荐用Obsidian CLI
没有 CLI 之前，AI 只能一篇一篇翻你的笔记，看到的是碎片。
有了 CLI，AI 能理解笔记之间是怎么连接起来的。
现在就是最好的起点
有的朋友可能会说：我的笔记还很少，知识网络没有建立起来，是不是用不上？
恰恰相反。
每一次记录，AI 都能帮你理解它在整个知识体系中的位置——不需要等到网络成熟再开始。
反倒是一开始就准备构建知识网络，会少走很多弯路。
作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～
