用途:为使用 Obsidian 进行知识管理提供指导,包括 vault 结构、插件开发、URI 自动化、Markdown 扩展与外部工具集成。
主要能力:说明 vault 目录与 .obsidian 配置结构;介绍 obsidian:// 协议(open、new、search、daily 等)及 vault、file、path、name、content、query 等参数;给出插件开发模板与 manifest.json 结构,涉及 App、Vault、Workspace、MetadataCache、FileManager 等核心 API 类及 onload/onunload 生命周期;介绍 Local REST API 插件的安装、API key 认证与 /vault/、/search/simple/、/commands/、/active/、/open/ 等端点;整理 wikilink、嵌入、callout、块引用、标签、frontmatter、注释、LaTeX、Mermaid 等 Markdown 扩展;并列出 obsidian-cli 等命令行工具。
使用方式:简单打开或创建操作可用原生 obsidian:// URI;复杂追加、前置、命令等自动化可用 Advanced URI 插件;完整程序化访问用 Local REST API 插件,默认端点 https://127.0.0.1:27124,请求头使用 Authorization: Bearer YOUR_API_KEY。插件开发建议使用独立开发 vault 与热重载插件,用 registerEvent() 保证卸载清理。
限制与注意:URI 方案要求桌面应用已打开对应 vault,无头环境会静默无效;Local REST API 需单独启用插件;同名笔记的 wikilink 会静默取字母序第一个;脚注定义前需空行;含空格或特殊字符的 vault 路径在部分 shell 集成插件中可能异常。具体收费、价格与平台支持资料暂未提供。