你还在满文件夹找笔记？给 AI 时代的一个本地文档搜索引擎

不知道你有没有这种感觉——写了一大堆笔记、文档、会议记录，时间长了根本找不到。

CMD + F 只能搜当前文件。Everything 之类的工具倒是快，但搜出来的是文件名，不是内容。就算找到了，也不记得那个文件里到底写了啥。

今天介绍一个工具叫 QMD，彻底解决了这个问题。

QMD 是什么？

QMD 是一个运行在本地的文档搜索引擎，专门给 markdown 文档、笔记、知识库用的。它能搜索内容，不是文件名。

核心功能：

- 关键词搜索（BM25） — 快速精准
- 语义搜索（向量） — 懂你说的意思
- 混合搜索 + LLM 重排 — 结合两者优点，结果最准确
- MCP 服务器 — 给 AI Agent 用的，Claude Code 能直接调
- 完全本地运行 — 数据不离开你的电脑，隐私无忧

简单说：你的所有笔记、文档、会议纪要，扔进去，想怎么搜就怎么搜。

为什么值得试试？

先说痛点。

你可能有很多笔记散落在各个文件夹里：~/notes、~/work/docs、~/Documents/meetings……每次找东西，要么靠记忆（文件名还记得），要么靠 grep 命令（还要记得加引号）。

QMD 解决了这个问题，而且解决得很彻底：

1. 语义搜索，懂你想找什么

比如你记得写过"关于季度规划的讨论"，但文件名可能是"sync-2024-03.md"。传统搜索搜"季度规划"能找到，但如果你搜"怎么定 OKR"，文件名里根本没有这两个词，传统工具就抓瞎了。QMD 的语义搜索能理解你的意思，找到相关内容。

2. MCP 支持，AI 时代的工作流

QMD 暴露了一个 MCP 服务器，Claude Code 这类 AI Agent 可以直接调用它。

{
  "mcpServers": {
    "qmd": {
      "command": "qmd",
      "args": ["mcp"]
    }
  }
}

也就是说，未来你跟 AI 说"帮我找一下上次那个关于 API 设计的会议记录"，AI 会自己去 QMD 搜，然后把结果给你。这是真正的 AI 时代的搜索工作流。

3. 完全本地，数据不出门

所有索引存在本地，没有账号，没有云服务，不用担心隐私。跑在 node-llama-cpp 上，用 GGUF 模型，完全离线和本地。

快速上手（5 分钟）

第一步：安装

# Node.js 环境
npm install -g @tobilu/qmd
或者 Bun

bun install -g @tobilu/qmd
或者直接 npx 运行（不用安装）

npx @tobilu/qmd search "关键词"

第二步：添加你的文档集合

# 把你的笔记目录加进去
qmd collection add ~/notes --name notes
qmd collection add ~/Documents/meetings --name meetings
qmd collection add ~/work/docs --name docs
给每个集合加描述（帮助语义搜索更准）

qmd context add qmd://notes "个人笔记和想法"
qmd context add qmd://meetings "会议记录和纪要"
qmd context add qmd://docs "工作文档"

第三步：生成索引

qmd embed

这一步会把所有文档向量化，建立索引。第一次跑需要一点时间，之后每次新增文档会自动更新。

第四步：开始搜索

# 关键词搜索（最快）
qmd search "API 设计"
语义搜索（懂意思）

qmd vsearch "怎么部署应用到服务器"
混合搜索 + 重排（最准）

qmd query "季度规划流程"

QMD 会列出结果，每个结果有文件名、匹配片段和相似度分数。输入 qmd get <文件名> 可以直接查看完整内容。

适合谁用？

写了很多笔记的人 — Obsidian、Logseq 用户，笔记散落在各个文件夹里，时间长了找不到。

开发者 / 技术写作者 — 有大量 markdown 文档、API 文档、架构设计文档，QMD 可以给 Claude Code 做工具用。

知识工作者 — 会议记录、项目文档、研究资料，用语义搜索能快速找到相关内容，不用死记文件名。

注重隐私的人 — 完全本地运行，没有账号，没有云，不用担心文档被上传。

相关链接

- GitHub：https://github.com/tobi/qmd
- npm：https://www.npmjs.com/package/@tobilu/qmd

---

给自己的数字记忆建一个本地搜索引擎，某种程度上比塞进各种云笔记更可靠——毕竟你的笔记，只有你能看到。