用途：Obsidian CLI 是 Obsidian（1.12+，推荐 1.12.7+）的官方命令行界面，让你在终端里管理笔记库的笔记、任务、搜索、标签、属性、链接等内容，无需打开图形界面手动操作。
主要能力：涵盖通用（help、version、reload、restart）、日记（daily、daily:append、daily:read、daily:path 等）、文件与文件夹（create、read、append、move、rename、delete、open）、搜索（search、search:context、search:open）、任务（tasks、task，可切换或标记完成）、标签（tags、tag）、属性（property:set/read/remove、properties）、别名、链接（backlinks、links、orphans、deadends、unresolved）、大纲、书签、Bases 数据库、模板、命令与快捷键、标签页与工作区、历史与 diff、最近文件、字数统计、随机笔记、库信息、主题与 CSS 代码片段、插件管理以及开发者工具（eval、截图、console、errors、dom、css、cdp 等），共约 95 个命令。插件相关命令（如同步、发布）仅在对应插件启用后出现。
使用方式：先启用 CLI——设置 → 通用 → 命令行界面打开，并重启终端；Obsidian 应用须保持运行。macOS 注册会在 /usr/local/bin/obsidian 创建指向应用内 obsidian-cli 的软链接（需管理员权限），可用 ls -l /usr/local/bin/obsidian 验证；缺失时手动创建：sudo ln -sf /Applications/Obsidian.app/Contents/MacOS/obsidian-cli /usr/local/bin/obsidian。Windows 会生成 Obsidian.com 并加入 PATH；Linux 复制到 ~/.local/bin/obsidian。语法上顶层选项 vault=<name> 须放在最前；参数为 name=value 或 name="带空格的值"；裸标志如 overwrite、newtab；换行与制表符用 \n 和 \t；指定目标用 file=<名称>（wikilink 式，按基名解析，不带 .md）或 path=<文件夹/笔记.md>，省略时多数命令默认作用于当前活动文件；列表类命令常支持 format=text|json|tsv|csv|md|paths。示例：obsidian daily:append content="- [ ] Buy milk"、obsidian create name="Note" content="# Hello"、obsidian search:context query="TODO"、obsidian tasks daily todo、obsidian tags counts sort=count、obsidian backlinks file="Note"。
限制与注意：Obsidian 必须运行中；升级 Obsidian 后 CLI 二进制会变化，macOS 软链接可能失效，可重新执行 sudo ln -sf 或到设置里关闭再开启 CLI 让其重新注册；报“File not found”通常是 file=/path= 用法不当；其他平台细节与完整参数以官方帮助为准。