【qmd】本地运行的智能知识搜索工具，让 Markdown 笔记、会议记录和文档秒变可检索的知识库

QMD 是一个完全在你自己的设备上运行的混合搜索引擎，专为个人知识管理设计——它能快速索引你的 Markdown 笔记、会议转录、技术文档等文本内容，并支持关键词搜索、语义搜索和带大语言模型重排序的高质量混合搜索，所有处理均离线完成，隐私与速度兼得。

主要功能与特性包括：
– ✅ 三合一混合搜索：同时集成 BM25 全文检索（SQLite FTS5）、向量语义搜索（基于 GGUF 嵌入模型）和 LLM 驱动的重排序（qwen3-reranker），按需调用 search / vsearch / query 命令；
– ✅ 智能上下文感知：通过 qmd context add 为笔记目录或路径添加描述性上下文（如“会议纪要”“API 文档”），该信息会随搜索结果返回，显著提升 AI 代理的决策质量；
– ✅ 多格式本地索引：自动解析 Markdown 标题、生成文档 ID（6 字符哈希）、按语义边界智能分块（支持标题/代码块/列表识别），代码文件还可启用 AST 感知分块（.ts/.py/.go 等）；
– ✅ 开箱即用的 AI 代理集成：原生支持 MCP（Model Context Protocol），可作为 Claude Desktop / Claude Code 插件直接调用；提供 --json、--files 等结构化输出，方便 LLM 工作流消费；
– ✅ 灵活部署方式：既可命令行直用（npx @tobilu/qmd），也可作为 Node.js/Bun 库嵌入自有应用（import { createStore } from '@tobilu/qmd'），还支持长时 HTTP MCP 服务（避免重复加载大模型）。

安装与快速使用示例：

# 全局安装（Node.js 或 Bun）
npm install -g @tobilu/qmd
# 或
bun install -g @tobilu/qmd

# 添加你的知识源（如笔记、会议记录、文档）
qmd collection add ~/notes --name notes
qmd collection add ~/Documents/meetings --name meetings

# 添加上下文（大幅提升搜索相关性）
qmd context add qmd://notes "个人笔记与灵感"
qmd context add qmd://meetings "团队会议转录"

# 生成向量索引（首次运行会自动下载 GGUF 模型）
qmd embed

# 开始搜索
qmd search "项目时间线"        # 快速关键词搜索
qmd vsearch "如何部署服务"     # 语义相似性搜索
qmd query "季度规划流程"       # 推荐：混合搜索 + 重排序，结果最精准

这个工具特别适合以下场景：
– 知识工作者与工程师：需要频繁检索大量本地 Markdown 技术文档、会议纪要、设计稿和代码注释；
– AI 原生开发者：正在构建本地化 AI 代理（如 Claude 插件、RAG 应用），需要低延迟、高隐私、可编程的检索后端；
– 注重隐私与离线能力的用户：拒绝将敏感笔记上传至云端，希望所有数据、模型、索引完全保留在自己设备上（macOS/Linux 支持完善）；
– 希望轻量接入检索能力的应用开发者：通过 SDK 直接嵌入 @tobilu/qmd，几行代码即可获得工业级混合搜索能力，无需维护 Elasticsearch 或向量数据库。

总结：QMD 不是一个玩具级 CLI 工具，而是一套设计严谨、架构清晰、开箱即用的本地知识检索基础设施——它把前沿的混合搜索策略（RRF 融合 + 位置感知加权 + LLM 重排）真正落地为日常可用的命令与 API。对追求效率、隐私与可控性的知识管理者和 AI 应用开发者而言，它值得成为你本地工具链中的核心一环。