用途:为笔记保存提供跨后端的统一存储接口,支持 Obsidian、Notion 和本地文件系统三种存储方式,通过配置决定使用哪个后端。
主要能力:提供 get_storage_backend() 读取 km-config.json 中的 storage.primary 字段,默认回退到 local;提供 save_note(relativePath, content) 统一保存函数,按后端分派到对应操作;提供 normalize_path(path) 做路径规范化,将 Windows 反斜杠转为正斜杠并去掉前导斜杠。后端映射包括:创建笔记对应 mcp_obsidian_create_note、mcp_notion_API-post-page、write_to_file;搜索对应 mcp_obsidian_search_vault、mcp_notion_API-post-search,本地无搜索;读取对应 mcp_obsidian_read_note、mcp_notion_API-get-block-children、read_file。路径格式分别为相对 vault 路径、数据库/页面 ID、文件系统路径;Wikilinks 在 Obsidian 与本地支持,Notion 转换为 mentions。
使用方式:在支持 MCP 工具的环境中必须优先使用 MCP 工具,例如用 mcp_obsidian_create_note(path, content) 而非 write_to_file。Antigravity/Gemini CLI 的 MCP 工具名使用单下划线。Obsidian 相关工具包括 mcp_obsidian_create_note、mcp_obsidian_search_vault、mcp_obsidian_read_note、mcp_obsidian_list_notes。每次保存后需验证:工具是否真正执行、是否收到成功响应、用 Glob 确认文件存在。
限制:资料未提供安装命令、依赖版本、配置字段完整说明、Notion 搜索与本地搜索的具体行为细节,也未说明各后端的权限或错误处理方式。