核心功能
Obsidian skill 基于 notesmd-cli 工具,为 AI 助手提供对 Obsidian 知识库的完整命令行管理能力。核心操作包括:
- 搜索:按文件名 (
search) 或内容 (search-content) 检索笔记 - 创建:通过 URI 协议在指定文件夹新建 Markdown 笔记
- 重构:
move命令安全重命名/移动笔记并自动更新 vault 内所有 [[wikilinks]] 引用 - 管理:列出、删除、查看笔记内容及 frontmatter
显著优点
1. 纯文本友好:Obsidian vault 本质是普通文件夹,.md 文件兼容任何编辑器,无厂商锁定
2. 链接自动维护:notesmd-cli move 相比裸 mv 能批量修正内部链接,大幅降低重构风险
3. 跨平台:支持 macOS、Linux,通过官方 config 文件自动解析 vault 路径,避免硬编码
4. URI 集成:--open 参数可直接唤起 Obsidian 桌面端,无缝衔接 GUI 工作流
局限性与风险
| 问题 | 说明 |
|------|------|
| 依赖 Obsidian 安装 | `create --open` 需要系统已注册 `obsidian://` URI handler |
| 隐藏目录限制 | 无法通过 URI 在 `.` 开头文件夹下创建笔记 |
| 非官方工具 | `notesmd-cli` 为社区第三方工具,非 Obsidian 官方出品 |
| 无版本控制 | 删除/移动操作不可逆,vault 需用户自行 Git 备份 |
适合人群
- 重度 Obsidian 用户,希望用 AI 自动化批量笔记操作
- 需要程序化维护知识库链接结构的技术写作者
- 追求「本地优先、纯文本」笔记哲学的开发者
安全提示
- 工具直接读写本地文件系统,建议配合 vault 的 Git 备份使用
move会修改多个文件,操作前确认路径- 多 vault 环境务必通过
print-default或 config 文件确认目标 vault