前言

最近Obsidian 正式发布了 CLI（命令行接口）功能！这意味着，我们可以像操作本地文件一样，直接通过命令行来管理我们的笔记库了！

这个 CLI 接口可以完美地被各种 AI 工具调用，从此为 Obsidian 插上强大的 AI 翅膀。本文将详细介绍如何使用这个新功能，以及如何结合 AI 工具提升我们的笔记效率。

什么是 Obsidian CLI？

Obsidian CLI 是 Obsidian 官方提供的命令行工具，它允许用户通过终端命令来操作 Obsidian 的各种功能，包括：

• 创建和编辑笔记
• 管理日常笔记
• 搜索内容
• 处理任务
• 操作标签
• 设置属性
• 甚至进行插件开发调试

启用方式

obsidian 更新到1.12.4 以上，在 Obsidian 中启用 CLI 功能：

1. 打开 Obsidian 设置
2. 进入「通用」选项
3. 找到「命令行接口」
4. 启用「启用命令行接口」

注意：使用 CLI 时，Obsidian 应用需要保持打开状态。

[!info] 出处
本文主要参考了 Obsidian 官方 CLI 文档

基础命令一览

笔记操作

# 创建新笔记
obsidian create name="笔记名称" content="# 标题\n内容"

# 读取笔记
obsidian read file="笔记名称"

# 追加内容
obsidian append file="笔记名称" content="- 新内容"

# 搜索
obsidian search query="关键词" limit=10

日常笔记

# 打开今日笔记
obsidian daily

# 读取今日笔记
obsidian daily:read

# 向今日笔记追加内容
obsidian daily:append content="- 学习新技能"

任务和标签

# 查看任务
obsidian tasks daily

# 查看标签
obsidian tags

# 设置属性
obsidian property:set name="状态" value="进行中" file="笔记名称"

开发者工具

# 热重载插件
obsidian plugin:reload id="插件ID"

# 运行 JavaScript
obsidian eval code="app.vault.getFiles().length"

# 截图
obsidian dev:screenshot path="screenshot.png"

AI + Obsidian CLI：真正的生产力飞跃

，这才是最令人兴奋的部分！现在，我们可以告诉 AI 工具（如 OpenCode、Claude Code 等）：“帮我记一下今天的笔记”、“总结一下我本周的学习内容”，AI 就会自动调用 Obsidian CLI 完成这些操作。

场景一：AI 辅助记录

以前我们需要手动打开 Obsidian，创建一个新笔记，然后输入内容。

现在只需要告诉 AI：

“帮我记录今天的学习内容：学习了 Python 的异步编程，重点是 asyncio 和 await 的用法。”

AI 就会自动执行：

obsidian daily:append content="- 学习 Python 异步编程：asyncio 和 await 的用法"

场景二：AI 智能总结

当你想要回顾一周的笔记时，只需要告诉 AI：

“帮我总结一下这周的日常笔记，看看我都在忙什么。”

AI 就会：

# 先读取一周的日记
obsidian search query="daily" limit=50
# 然后分析内容，生成总结

场景三：结合 Base 做数据分析

Obsidian 的 Base 功能非常强大，结合 AI 可以实现智能数据分析：

# 查看项目的所有任务状态
obsidian tasks

# 获取标签统计
obsidian tags sort=count

# 然后让 AI 分析这些数据，给出建议

场景四：自动创作工作流

想象一下这样的工作流：

1. 你告诉 AI：“帮我整理一下关于 Python 学习的笔记”
2. AI 自动搜索相关笔记
3. AI 分析内容，提取重点
4. AI 创建一篇结构化的学习总结笔记

# AI 自动执行
obsidian search query="python" limit=20
# 分析后创建新笔记
obsidian create name="Python 学习总结" content="..."

实战：OpenCode 调用 Obsidian CLI

作为测试，我成功使用 OpenCode 调用了 Obsidian CLI。以下是简单的演示：

# 在 OpenCode 中运行
"/c/Users/htwl/AppData/Local/Programs/obsidian/Obsidian.com" daily:append content="- 学习opencode"

执行结果：

Added to: 09_我的日记/2026-03-02.md

成功了！🎉

这意味着未来我们可以：

• 让 AI 自动记录每日待办
• 让 AI 根据我们的笔记生成周报
• 让 AI 定时整理和归档笔记
• 让 AI 分析知识库，给出学习建议

不需要学复杂语法

很多人看到命令行可能会担心：“是不是要学习很多复杂的命令？”

答案是：完全不需要！

我们只需要了解 Obsidian CLI 能做什么，剩下的让 AI 去处理就好了。就像我们现在使用 AI 一样，不需要知道 AI 背后的复杂算法，只需要告诉它我们要什么。

核心思路

1. 了解能力：知道 CLI 能做什么（创建笔记、搜索内容、管理任务等）
2. 描述需求：用自然语言告诉 AI 你想要什么
3. AI 执行：AI 会帮你调用正确的命令

例如：

• ❌ 不需要知道：obsidian create name="X" content="Y" template="Z"
• ✅ 只需要说：“帮我创建一个会议笔记”

总结

Obsidian CLI 的发布，标志着 Obsidian 正式迈入了 AI 时代。通过 CLI 接口，我们可以：

1. 自动化日常记录：让 AI 帮我们快速记录想法和任务
2. 智能内容搜索：AI 可以快速检索和分析笔记内容
3. 自动创作和整理：AI 根据现有笔记生成新的总结和报告
4. 数据分析：结合 Base 功能，AI 可以分析我们的知识库

最重要的是，我们不需要学习复杂的命令行语法，只需要知道"能做什么"，剩下的交给 AI 就好了。

这才是真正的生产力提升！

参考文件

Obsidian 官方 CLI 文档：
https://help.obsidian.md/cli

如果这篇分享对你有所启发，欢迎关注！期待你的点赞、收藏、转发、推荐或留言～ 你的支持，是我持续创作的最大动力！感谢！🙏
微信公众号：环境猫 er
CSDN : 细节处有神明
个人博客：https://maoyu92.github.io/