搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

tobi/qmd

效率工具

在本地为 Markdown 笔记、会议记录和文档建立索引,支持关键词、语义和混合搜索,并通过 CLI 与 MCP 供 AI Agent 调用。

31,233
1,967
TypeScript
MIT
创建于 11 个月前

项目介绍

QMD 是一个本地 Markdown 搜索引擎,用于索引笔记、会议转录、文档和知识库。它通过 node-llama-cpp 和 GGUF 模型在本机完成 BM25 全文检索、向量语义检索和 LLM 重排,不依赖托管搜索服务(项目概览)。

三种搜索模式对应不同需求:qmd search 是快速关键词匹配,qmd vsearch 做语义相似搜索,qmd query 则组合查询扩展和 LLM 重排做混合检索。Collection 用来组织目录,context 用来描述每个 collection 或路径包含什么内容;这些 context 会随搜索结果返回,帮助 LLM 选中文档。

同一份索引既可以通过 CLI 使用,也能从 TypeScript SDK 或 MCP server 访问,因此 README 把它同时定位为面向 Agent 工作流和直接人工使用的工具。

快速使用

需要 Node.js 22 或更高版本,或 Bun 1.0 及以上。macOS 上需要安装 Homebrew SQLite 以支持扩展:brew install sqlite。

npm install -g @tobilu/qmd

qmd collection add ~/notes --name notes
qmd context add qmd://notes "Personal notes and ideas"
qmd embed

qmd search "project timeline"
qmd vsearch "how to deploy"
qmd query "quarterly planning process"

首次执行 qmd embed 会下载三个 GGUF 模型到 ~/.cache/qmd/models/:约 300 MB 的嵌入模型、约 640 MB 的重排模型和约 1.1 GB 的查询扩展模型。索引数据存放在 ~/.cache/qmd/index.sqlite。

要接入 Agent,可用 claude plugin marketplace add tobi/qmd 和 claude plugin install qmd@qmd 安装 Claude Code 插件,或运行 qmd mcp 启动 MCP server。需要共享长驻服务时,qmd mcp --http 会在 localhost:8181 启动 HTTP 传输。

数据与配置

Collection 和 context 的配置写在 ~/.config/qmd/index.yml(或 $XDG_CONFIG_HOME/qmd/index.yml)。用 qmd init 创建的项目内索引位于项目下的 .qmd/。每个 collection 可以配置 update shell 命令,qmd update 会先执行它再重建索引,适合先拉取 git 远端。

随仓库检入的 .qmd/index.yml 默认不被信任:update 命令、指向项目外的 collection 路径以及自定义模型 URI 都会被拦截,需要用 qmd trust 批准。Agent、CI 等无终端环境会跳过这些字段而不是执行它们(信任机制)。默认嵌入模型面向英文;处理中文、日文等内容时可通过 QMD_EMBED_MODEL 换成 Qwen3-Embedding 等多语言模型,并用 qmd embed -f 重新生成向量。

资源与部署限制

本地推理意味着模型下载和磁盘占用是安装的一部分,纯 CPU 机器上的嵌入与重排会更慢。可用 --no-rerank 跳过重排以加快混合检索,用 --max-docs-per-batch 或 --max-batch-mb 限制大语料嵌入时的内存占用。

MCP 的 HTTP server 不提供认证,只通过检查 Origin 和 Host 头阻止浏览器借助 DNS rebinding 读取索引。绑定到 0.0.0.0 时会跳过 Host 检查,除非设置 QMD_ALLOWED_HOSTS,因此任何可被其他机器访问的服务都需要自行在前面加认证层。

项目使用 MIT 许可证。

HotRepo 点评

截至 2026-11-19 当周,QMD 在 TypeScript 周榜上最高排到第 17 名,当周新增 175 Star,总 Star 为 31,232(快照)。仓库创建于 2025 年 12 月,这个总量反映的是短期快速增长,而不是长期积累。

在 Hacker News 讨论中,作者把项目描述为把搜索与检索的实践经验装进一个不过度设计的本地工具,并提到正在继续微调查询扩展和重排模型(作者评论)。评论者关心本地资源占用和大型 Obsidian 仓库的适配情况,有人回复说最接近的 Obsidian 替代品是 Omnisearch,而不是 QMD 插件(讨论)。这与 README 呈现的定位一致:QMD 是通用的 Markdown 索引器,提供 CLI、SDK 和 MCP 接入,并非 Obsidian 专用集成。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

Hacker News 讨论

QMD - Quick Markdown Search
▲ 25 · 7 条评论 · 2026年1月20日
QMD – Quick Markdown Search
▲ 3 · 1 条评论 · 2026年1月19日
QMD – Quick Markdown Search
▲ 2 · 0 条评论 · 2026年1月25日

相关推荐

  1. Timaga/noda-local-ai-notes面向 Windows 的本地优先 Markdown 笔记应用,提供知识图谱、语义搜索和带引用来源的问答。JavaScript105
  2. refactoringhq/tolaria管理纯 Markdown 笔记库的桌面与 iOS 应用,笔记保存在你自己的 git 仓库里。TypeScript20,341
  3. jessepinkman9900/claude-second-brain一条命令搭建由 Claude Code 维护的 Obsidian 知识库,自带本地混合检索与 Git 同步。JavaScript166
  4. fastrepl/anarlog本地优先的 AI 会议笔记工具,录制设备音频并把笔记保存在本地 SQLite 中。Rust9,702
  5. yjid/kensaku本地桌面启动器,可搜索文件名、文档正文、截图 OCR 与语义,并让 AI 代理查询同一索引。Rust197