福建人飘在上海，记录上海的生活

← 返回首页

obsidian/Obsidian-CLI-终端操控知识库

2 分钟

Obsidian CLI 横空出世！终端党终于能优雅地操控知识库了

作为一名写了十多年前端的老家伙，我对终端有着迷之执念——能敲命令解决的事，绝不想点鼠标。这不，Obsidian 终于在 2026 年 2 月底推出了官方 CLI，让我激动得差点把咖啡喷在键盘上。

今天就跟大家聊聊这个让我”效率翻倍”的新玩具，看看它到底香不香。

什么情况下你会需要 CLI？

先说说我自己的场景：

场景一：写代码写到一半，突然有个绝妙的想法冒出来。以前我要么分心去点 Obsidian 记一笔，要么转头就忘。现在？obsidian daily:append "刚才想到的XXX可以用XX方案实现" 直接搞定，丝滑得像德芙。

场景二：用脚本批量处理笔记。周末整理知识库，想把所有标签是 #todo 的任务汇总到一个文件，grep 加 sed 能搞定，但要和 Obsidian 同步更新双链就麻烦了。CLI 一行命令，obsidian move 自动帮你更新所有引用关系，香！

场景三：让 AI 帮我读笔记、写摘要。配合 Claude Code 或者 OpenCode 这些 Agent 工具，可以直接用自然语言操控你的第二大脑，而不用担心它们拿到你整台电脑的权限。

如果你也有类似需求，CLI 值得一试。

开启 CLI 只要 3 步

  1. 更新 Obsidian：确保版本 ≥ 1.12.4
  2. 开启功能：Settings → General → Command line interface → 开启
  3. 注册：点「Register CLI」，按提示添加到系统 PATH，然后重启终端

搞定！现在终端里输入 obsidian 就能看到帮助信息。

高频命令清单

日常笔记 - 晨间必备

# 打开今天的日记
obsidian daily

# 在日记末尾追加内容（记灵感超方便）
obsidian daily:append content="- [ ] 优化这个组件的性能"

# 在日记开头插入（比如写今日计划）
obsidian daily:prepend content="## 今日目标"

# 查看日记路径
obsidian daily:path

文件操作 - 基础 CRUD

# 创建新笔记
obsidian create name="项目笔记/架构设计" content="# 架构设计"

# 读取笔记内容
obsidian read file="项目笔记/架构设计"

# 追加内容到笔记末尾
obsidian append file="项目笔记/架构设计" content="\n\n## 新增需求"

# 移动笔记（双链自动更新！）
obsidian move file="临时文档" to="归档/2026"

# 删除笔记
obsidian delete file="垃圾文件"

搜索 - 找不到东西？不存在的

# 搜索文件名
obsidian search query="会议记录"

# 带上下文的全文搜索（类似 grep）
obsidian search:context query="Obsidian CLI" limit=10

# 列出所有标签
obsidian tags counts

# 查看某个标签下的文件
obsidian tag tag="#效率工具"

高级操作 - 玩转双链

# 查看某笔记的反向链接（谁引用了我？）
obsidian backlinks file="Obsidian使用指南"

# 查看孤立文件（没有任何引用的笔记）
obsidian orphans

# 查找未解析的链接（[[wikilink]] 但文件不存在）
obsidian unresolved

# 列出文件的所有出站链接
obsidian links file="项目笔记/架构设计"

插件管理

# 查看已启用插件
obsidian plugins:enabled

# 启用/禁用插件
obsidian plugin:enable copilot
obsidian plugin:disable copilot

# 重新加载插件（开发调试用）
obsidian plugin:reload my-custom-plugin

同步和发布

# 查看同步状态
obsidian sync:status

# 同步历史版本
obsidian sync:history

# 发布笔记到网站
obsidian publish:add file="已完成的文章"

自动化脚本示例

每天早上跑这个脚本，自动打开日记并添加例行任务：

#!/bin/bash
# morning-routine.sh

# 打开今日日记
obsidian daily

# 添加晨间任务
obsidian daily:append content="- [ ] 查看邮件"
obsidian daily:append content="- [ ] 回顾本周目标"

# 把最近修改的文件列表复制到剪贴板
obsidian files sort=modified limit=5 --copy

# 检查有没有未完成的双链
obsidian unresolved

echo "晨间准备完成！"

和 AI Agent 结合 - 第二大脑的正确打开方式

这是我觉得最骚的用法：

# 让 AI 帮你总结某篇长笔记
obsidian read file="读书笔记/失控" > summary.txt
# 然后丢给 Claude 分析

# 或者直接用 eval 执行 JS
obsidian eval "app.vault.getMarkdownFiles().length"
# 返回你的笔记总数

配合 Obsidian Headless（无头客户端），可以让 AI Agent 在服务器上访问你的笔记，而不需要启动桌面应用。这对于：

  • 自动备份笔记到服务器
  • 让团队成员共享知识库
  • AI 帮你整理和归纳笔记

简直是知识管理爱好者的终极形态。

CLI 的一些限制

说了这么多优点，也得提提局限：

  1. 需要 Obsidian 在后台运行：CLI 依赖桌面客户端，不是完全独立的命令行工具
  2. 命令语法还在演进：官方说后续版本可能有变化，但基本用法应该问题不大
  3. Windows 体验略差：主要体现在路径处理上，但基本能用

总结

Obsidian CLI 补齐了最后一块短板——它让知识库真正变成了”可编程”的工具。不管你是终端爱好者、脚本达人，还是想让 AI 帮你管笔记，CLI 都值得一试。

我现在的习惯是：写代码遇到灵感，用 obsidian daily:append 快速记录；周末整理笔记，用脚本批量归档；需要 AI 帮忙时，直接调用 CLI 让它读取笔记。

效率提升是真的肉眼可见。

你平时用什么方式管理笔记？有没有被”找不到之前记的东西”困扰过？评论区聊聊你的痛点，看看 CLI 能不能帮到你。