用途:QMD 用于在 Obsidian 仓库中进行语义搜索。建议在直接读取文件前先搜索,以相关片段代替整篇文件读取,降低上下文开销。
主要能力:提供三种检索方式——混合检索(lex+vec,质量最佳,适合复杂或概念性查询)、关键词 BM25(适合精确词、人名、工单号、日期)、纯语义检索(适合说不出确切词的探索性查询)。支持按路径或 docid 读取文档,也支持按 glob 批量读取。
调用方式:优先使用 MCP 工具 mcp__qmd__query、mcp__qmd__get、mcp__qmd__multi_get、mcp__qmd__status,注册后无需 --index 参数。未注册时回退 CLI:qmd --index <name> query|search|vsearch|get|multi-get,始终需要 --index <name>。Grep/Glob/Read 仅在完全未安装 QMD 时作为最后手段。
索引:本仓库使用具名 QMD 索引,名称取自 vault-manifest.json 的 qmd_index;未设置时使用仓库文件夹名的 slug 形式。索引存于 ~/.cache/qmd/<name>.sqlite,在仓库之外。首次克隆需运行一次引导命令:node --experimental-strip-types .scripts/qmd-bootstrap.ts(幂等,可重复运行)。索引管理仅 CLI:qmd --index <name> update 增量重建;qmd --index <name> embed 重新生成向量嵌入。SessionStart 钩子与 PostToolUse 防抖刷新会自动执行 update,但大量改动后应显式运行 embed。
适用场景:检索过往决策、事件、人物或项目;创建新笔记前查重;创建后查找应互相链接的笔记;准备评审或一对一沟通的上下文。
限制:资料未提供收费、价格、平台兼容性与效果数据,暂未提供。