QMD — 本地 Markdown 文档搜索引擎

视频链接：https://v.douyin.com/s-NIe6pvtdU/

---

QMD 是什么

QMD（Query My Documents）是一个完全本地运行的 CLI 搜索引擎，专门用来搜索 Markdown 文档、知识库、会议记录等内容。它把三种搜索技术融合到了一个工具里：

• BM25 关键词搜索 — 传统的全文检索，精确匹配
• 向量语义搜索 — 理解语义，找不到关键词也能搜到相关内容
• LLM 重排序 — 用大模型对结果二次排序，提升准确率

不需要联网，不需要 GPU，装完就能用。

作者是谁

QMD 的作者是 Tobias Lütke，Shopify 的创始人兼 CEO。他平时大量使用 Markdown 来记录笔记、会议内容和文档，东西多了找不到，就自己动手造了这个工具。

他的 GitHub 账号就是 tobi，QMD 仓库至今已获得 24000+ Stars。

怎么用

安装和使用都非常简单：

# npm 安装
npm install -g qmd

# 添加要索引的目录
qmd add ~/Documents/notes

# 生成向量嵌入
qmd embed

# 开始搜索
qmd search "你的搜索关键词"

QMD 还提供了 MCP Server，可以无缝接入 Claude Code 等 AI 编程助手，让 Agent 直接搜索你的本地文档。

哪些工具在用 QMD

QMD 已经成为本地语义搜索的基础设施，被大量 AI 工具集成：

编程 Agent

工具	集成方式
Claude Code	多种 skill/插件支持（ghost、claude-never-forgets、git-wiki 等）
OpenClaw	记忆模块默认搜索引擎
Codex	remnic / memento-vault 插件
Cursor / Windsurf	memento-vault hooks
pi	pi-qmd 扩展、pi-memory 记忆扩展
Hermes	remnic 插件

笔记工具

• Obsidian — 有多个 QMD 集成插件（obsidian-qmd、qmd-search-obsidian），可在 Obsidian 内直接使用 QMD 的混合搜索

记忆/上下文系统

QMD 生态最活跃的领域，各种基于 QMD 的 Agent 记忆方案层出不穷：

• remnic (73★) — 多 Agent 本地记忆插件，支持 OpenClaw、Hermes、Codex、Claude Code
• ghost (11★) — Claude Code 会话自动捕获 + QMD 语义搜索
• Memento Vault — 跨编程 Agent 的知识持久化
• Claude Never Forgets — 自动导出会话、索引、跨会话记忆召回
• MemClawz — OpenClaw 的三层记忆体系
• Lucid Context Engine — 自主上下文引擎，含显著性评分和跨 Agent 记忆

同类工具

• seekx (17★) — OceanBase 出品，受 QMD 启发而建

为什么 QMD 会火

除了作者本身的影响力，QMD 能快速传播还有两个原因：

1. OpenClaw 的集成 — OpenClaw 记忆模块默认使用 QMD 作为本地搜索引擎，大量 OpenClaw 用户因此接触并开始使用 QMD
2. MCP 协议的支持 — QMD 提供 MCP Server，意味着任何支持 MCP 的 AI 工具都能直接调用 QMD 搜索本地文档，这大幅降低了集成门槛

总结

QMD 解决了一个很具体但很普遍的需求：你有大量 Markdown 笔记，需要快速、准确地找到内容。它不是要替代 Google，而是要让你在本地就能搜到自己的知识。加上 MCP 的支持，AI Agent 也能读懂你的笔记了。

如果你的笔记量已经大到找东西困难的程度，QMD 值得一试。

---

参考：

• tobi/qmd - GitHub
• remnic - 多 Agent 本地记忆插件
• obsidian-qmd - Obsidian 插件