Obsidian via notesmd-cli (obsidian-cli)

核心用法

Obsidian 技能通过 notesmd-cli 命令行工具与本地 Obsidian 仓库直接交互，无需 Obsidian 应用运行即可操作纯 Markdown 文件。该工具解析 macOS 上的 ~/Library/Application Support/obsidian/obsidian.json 自动识别已打开的仓库，支持设置默认仓库、搜索笔记内容、创建新笔记、管理 Daily Notes、读写 YAML Frontmatter 元数据，以及安全地移动/重命名文件并自动更新双向链接。

显著优点

• 纯文本优先：直接操作 .md 文件，与任何编辑器兼容，Obsidian 自动感知变更
• 无头自动化：不依赖 Obsidian GUI，适合脚本和自动化工作流
• 链接完整性：move 命令自动修复 [[wikilinks]] 和普通 Markdown 链接，避免断链
• 配置感知：自动读取 .obsidian/ 下的 Daily Notes、模板等用户配置
• 灵活的编辑集成：支持用 Obsidian 打开，或直接用 $EDITOR 编辑

潜在缺点与局限性

• 仅限 macOS：依赖特定路径的 Obsidian 配置文件，Windows/Linux 未明确支持
• 单仓库焦点：虽有仓库切换能力，但多数命令针对单一默认仓库优化
• Canvas 支持有限：.canvas 文件为 JSON 格式，工具主要处理 Markdown
• 插件生态隔离：无法直接与 Obsidian 插件交互，插件生成的内容需手动处理

适合人群

• 知识管理重度用户，需批量处理或自动化 Obsidian 笔记
• 开发者/工程师，偏好命令行工作流和版本控制（Git）管理笔记
• 需要与其他 CLI 工具链集成的自动化场景

常规风险

• 路径操作风险：delete、move 直接作用于文件系统，无回收站机制
• 链接解析边界：自动链接修复可能无法覆盖所有 Obsidian 扩展语法
• 配置漂移：手动修改 .obsidian/ 配置可能导致工具行为异常
• 并发编辑：同时用 Obsidian GUI 和 CLI 编辑同一文件可能造成冲突

核心用法

Obsidian 是一款基于本地 Markdown 文件的笔记应用，本 Skill 通过 notesmd-cli 工具实现对 Obsidian vault 的自动化管理。

主要功能模块

Vault 定位与配置

• 从 ~/Library/Application Support/obsidian/obsidian.json 读取 vault 列表
• 设置默认 vault：notesmd-cli set-default "vault-name"
• 支持 headless 操作，Obsidian 应用无需运行

笔记搜索

• 交互式模糊搜索：notesmd-cli search
• 内容全文检索：notesmd-cli search-content "query"

笔记创建与管理

• 创建笔记：notesmd-cli create "Folder/New note" --content "..."
• 每日笔记：notesmd-cli daily（自动读取 .obsidian/daily-notes.json 配置）
• 安全移动/重命名：notesmd-cli move，自动更新 [[wikilinks]] 引用

元数据操作

• Frontmatter 读写：notesmd-cli frontmatter "NoteName" --print/--edit/--delete

显著优点

1. 纯本地优先：所有操作直接读写磁盘文件，无云服务依赖，数据完全自主可控
2. 格式开放：标准 Markdown + YAML frontmatter，兼容任何文本编辑器
3. 安全重构：move 命令自动维护双向链接，避免手动重命名导致链接断裂
4. 配置继承：自动识别 Obsidian 的 daily notes、附件路径等用户设置
5. 双模式编辑：支持直接打开 Obsidian GUI，或调用 $EDITOR 终端编辑

潜在局限

• 仅支持本地 vault：无法操作 Obsidian Sync 或第三方同步的远程笔记
• macOS 为主：依赖 ~/Library/Application Support/obsidian/obsidian.json 路径，Windows/Linux 需额外配置
• CLI 功能边界：复杂 canvas 文件、插件配置等仍需 Obsidian 原生界面操作
• 移动链接依赖：虽然自动更新 wikilinks，但复杂嵌套路径或自定义链接语法可能覆盖不全

适合人群

• 使用 Obsidian 作为主力笔记工具的知识工作者
• 需要在自动化工作流（如每日日志生成、模板化笔记创建）中集成笔记操作的用户
• 偏好命令行效率、批量处理笔记的高级用户
• 对数据本地化和 Markdown 纯文本有强需求的隐私敏感用户

常规风险

1. 文件系统权限：需读取用户目录下的 vault 文件和 Obsidian 配置，确保沙箱环境授权
2. 批量操作不可逆：delete、move 等命令无回收站机制，建议首次使用前备份
3. 外部工具依赖：notesmd-cli 需通过 Homebrew 安装，应验证来源为官方 tap
4. 链接同步延迟：Obsidian 应用内缓存可能需要重启才能感知外部修改的链接变化