需要在命令行操作 Obsidian vault…

通过 `obsidian` CLI 操作正在运行的 Obsidian vault，管理笔记、任务、属性和搜索，并支持插件/主题开发调试。

适用场景

解决思路

1. 使用 `obsidian` CLI 与正在运行的 Obsidian 实例交互；先运行 `obsidian help` 查看所有可用命令，完整文档见 https://help.obsidian.md/cli。
2. 参数通过 `=` 传值，含空格的值用引号包住，例如：`obsidian create name="My Note" content="Hello world"`。
3. 标志（flags）是不带值的布尔开关，例如：`obsidian create name="My Note" silent overwrite`。
4. 多行内容中用 `\n` 表示换行、`\t` 表示制表符。
5. 文件定位：很多命令接受 `file` 或 `path`；两者都不给时操作当前活动文件。`file=<name>` 按 wikilink 方式解析（只需名称，无需路径或扩展名）；`path=<path>` 是从 vault 根开始的精确路径，例如 `folder/note.md`。
6. Vault 定位：命令默认作用于最近聚焦的 vault；用 `vault=<name>` 作为第一个参数指定 vault，例如：`obsidian vault="My Vault" search query="test"`。
7. 常用命令模式：`obsidian read file="My Note"`；`obsidian create name="New Note" content="# Hello" template="Template" silent`；`obsidian append file="My Note" content="New line"`；`obsidian search query="search term" limit=10`；`obsidian daily:read`；`obsidian daily:append content="- [ ] New task"`；`obsidian property:set name="status" value="done" file="My Note"`；`obsidian tasks daily todo`；`obsidian tags sort=count counts`；`obsidian backlinks file="My Note"`。
8. 在任何命令上使用 `--copy` 将输出复制到剪贴板；用 `silent` 防止文件被打开；在列表命令上使用 `total` 获取计数。
9. 插件/主题开发循环第 1 步：代码改动后重载插件以加载变更：`obsidian plugin:reload id=my-plugin`。
10. 插件/主题开发循环第 2 步：检查错误：`obsidian dev:errors`；如果出现错误，修复后从第 1 步重复。
11. 插件/主题开发循环第 3 步：用截图或 DOM 检查进行视觉验证：`obsidian dev:screenshot path=screenshot.png`；`obsidian dev:dom selector=".workspace-leaf" text`。
12. 插件/主题开发循环第 4 步：检查控制台输出中的警告或意外日志：`obsidian dev:console level=error`。
13. 在应用上下文中运行 JavaScript：`obsidian eval code="app.vault.getFiles().length"`。
14. 检查 CSS 值：`obsidian dev:css selector=".workspace-leaf" prop=background-color`。
15. 切换移动端模拟：`obsidian dev:mobile on`。
16. 运行 `obsidian help` 查看额外开发者命令，包括 CDP 和调试器控制。

适用边界 · 注意事项

• Obsidian 未打开或没有正在运行的实例时不能使用。
• 未安装或无法使用 Obsidian CLI 时不能使用。
• 目标不是 Obsidian vault 时不能使用。