tobi/qmd
QMD(Query Markup Documents)是一款在本机运行的命令行搜索工具,可以为 Markdown 笔记、会议转录稿、项目文档和知识库建立索引。记得术语时可以搜关键词,只记得大意时也可以用自然语言查找。
关键词和语义搜索如何配合
同一个查询会同时送到 BM25 全文检索和向量语义检索。前者按词匹配,后者按含义找相近的内容。QMD 还会扩展查询,把不同类型的扩展分别交给对应的检索方式,再合并候选排名,由本地模型重新排序。
首次使用与中文资料
可以从 README 的 Quick Start 入手,先用一小组熟悉的文档试搜。README 说明,本地模型会在首次使用时从 Hugging Face 下载并缓存。默认嵌入模型偏重英文,中文资料为主时可以选用项目支持的多语种 Qwen3-Embedding。切换嵌入模型后,需要运行 qmd embed -f 重新生成索引中的向量。
接入助手或应用
如果想让支持 MCP 的助手检索本地资料,QMD 默认由各客户端通过标准输入输出启动子进程,也支持用 HTTP 共享一个常驻服务,避免反复加载模型。自己的 Node.js 或 Bun 应用可以直接使用 QMD 的 SDK。
发表回复