📌 obsidian-cli 是什么？

Obsidian 的图形界面很好用，但有些操作用命令行更快——批量建笔记、批量改标签、批量移动文件、把笔记和脚本联动。obsidian-cli 是 Obsidian 创始人 kepano 的技能，让 AI 帮你用命令行管理笔记库。

它解决的是"重复劳动"：手动在界面里点几百次，不如一条命令。尤其是笔记库大了之后，批量整理、批量迁移、定期备份这些活，用命令行脚本化处理，又快又不容易出错。

对开发者、或者笔记库很大的重度用户来说，这个技能能把 Obsidian 从"手动的记事本"升级成"可编程的知识库"。

🧩 核心功能

笔记创建：批量创建笔记、模板套用。

批量整理：批量改标签、移动文件、重命名。

检索：命令行检索笔记内容。

备份同步：脚本化备份、导出笔记库。

自动化：把笔记操作接入脚本和定时任务。

元数据处理：批量读写 frontmatter 属性。

👍 优点

高效：批量操作比手动点快得多。

可脚本化：能接入自动化流程。

可控：命令行操作清晰可复现。

⚠️ 不足与局限

命令行有学习成本，不熟的人容易出错。

批量操作前务必备份，否则误操作难恢复。

部分高级操作仍需图形界面配合。

🙋 适合谁用

开发者：用命令行管理笔记。

重度 Obsidian 用户：笔记库大、需要批量操作。

自动化爱好者：把笔记接入脚本。

知识管理团队：统一笔记库维护。

🛠️ 第一次安装

前提：电脑装了 Node.js（18+），有支持 Skill 的 AI 工具（如 Claude Code）。打开终端执行：

bash
npx skills add kepano/obsidian-skills --skill obsidian-cli

CLI 会自动检测你装的 AI 助手，确认安装位置后即可使用，装完可以用 npx skills list 确认它在列表里。

✍️ 上手：几个真实例子

场景一：批量建笔记

提示词
帮我在"读书笔记"目录下，按这份书单批量创建 20 篇笔记，套用同一个模板。

场景二：批量改标签

提示词
帮我把所有旧笔记里 #TODO 标签改成 #待办，并统计改了多少篇。

场景三：备份

提示词
帮我写一个脚本，每天自动把笔记库备份到指定目录。

🎯 典型应用场景

批量整理：改标签、移文件、重命名。

模板建笔记：批量创建统一模板的笔记。

备份：定期自动备份。

自动化：笔记和脚本联动。

⚖️ 和类似方案对比

和图形界面相比，obsidian-cli 的价值在"批量"和"自动化"——界面点一下能做的，命令行能对几百篇一次做完。如果你只是偶尔记笔记，图形界面就够；一旦笔记库上千篇、需要频繁整理，命令行就是省时利器。

💡 常见问题 FAQ

问：会误删笔记吗？
批量操作前先备份，AI 会提醒你先在临时目录演练。

问：不熟命令行能用吗？
能，把需求说清楚，AI 会生成命令并解释每一步在干嘛。

问：能撤销吗？
命令行操作通常不可撤销，所以备份和预览清单很重要。

问：支持哪些平台？
Mac、Windows、Linux 都支持，命令略有差异，AI 会按你的系统给。

🤖 适合哪些 AI 工具

Claude Code、Cursor、Codex 等支持 Skill 的工具都能装。