qmd 本地文档检索5 分钟从安装到第一次搜索【免费下载链接】qmdmini cli search engine for your docs, knowledge bases, meeting notes, whatever. Tracking current sota approaches while being all local项目地址: https://gitcode.com/GitHub_Trending/qmd1/qmd笔记、会议纪要、API 文档散落在各个目录grep只能匹配字面量换个说法就搜不到。qmd 是一个完全跑在本地的 markdown 混合检索 CLIBM25 全文 向量语义搜索 本地 LLM 重排序三套模型全走 GGUF 离线运行文档不出机器。它到底解决什么问题混合检索而非单一全文qmd query走 BM25 向量双通道先用 Qwen3 1.7B 微调模型把查询扩展成lex/vec/hyde三类子查询再用 Qwen3-Reranker 0.6B 做 cross-encoder 精排纯grep和纯sqlite FTS5都只有一条通道模型全部本地node-llama-cpp加载 3 个 GGUFembeddinggemma-300M / qwen3-reranker-0.6B / qmd-query-expansion-1.7B首次使用自动下载到~/.cache/qmd/models/无 API key、无网络请求结果带上下文树qmd context add qmd://notes Personal notes给目录挂描述命中子文档时一起返回专为喂给 LLM 做 RAG 选文设计适合不适合markdown/txt 笔记库、会议记录、文档站PDF、Word 等二进制格式需要接 MCP / agent 工作流的场景多人并发写同一索引库从零到第一次搜索完整操作线前置检查Node.js 22engines字段硬性要求或 Bun 1.0macOS 用户额外装 Homebrew SQLitebrew install sqlitesqlite-vec 扩展依赖预留约 2GB 磁盘给模型缓存~/.cache/qmd/models/获取与构建克隆仓库并进入目录拿到 2.8.3 源码git clone https://gitcode.com/GitHub_Trending/qmd1/qmd cd qmd装依赖并编译 TypeScript 到dist/npm install npm run build把qmd命令软链到 PATH此后终端里直接可用qmdnpm link建索引 → 喂文档 → 出结果qmd collection add ~/notes --name notes qmd embed qmd query how to deploy前一条把目录登记进 collection 注册表默认 glob 是**/*.md第二条生成向量嵌入首次跑会顺带下载三个 GGUF 模型。qmd query输出按相关度排序的结果列表每条含qmd://notes/xxx.mdURI、docid形如#abc123和相关度分数0–1拿到 docid 后可用qmd get #abc123取全文-c notes限定只在某个 collection 里搜。30 秒看懂它的检索链路查询进来 → 本地小模型扩展 → 双通道并行召回 → 融合 重排 → 返回 Top-K查询扩展qmd-query-expansion-1.7B-q4_k_mLoRA 微调自 Qwen3把原查询拆成lexBM25 关键词、vec稠密句子、hyde假设答案三类子查询原查询同时发给两个后端双通道召回lex走 SQLite FTS5 的 BM25vec/hyde走 sqlite-vec 的向量近邻embedding 用 embeddinggemma-300MRRF 融合Reciprocal Rank Fusion 按排名而非分数合并两路结果规避 BM25 分与余弦分不同量纲的问题LLM 重排qwen3-reranker-0.6b 对前 40 个候选做 cross-encoder 打分输出 0–1 的 relevance score让它更顺手值得动的 2-3 个配置models.embed配置文件模板 里的models:块默认hf:ggml-org/embeddinggemma-300M-GGUF/embeddinggemma-300M-Q8_0.gguf中文语料建议换成hf:Qwen/Qwen3-Embedding-0.6B-GGUF/Qwen3-Embedding-0.6B-Q8_0.gguf119 语种覆盖改完必须qmd embed -f重建向量-Cqmd query参数默认 40指送入重排器的候选上限。CPU 机器调到 20 能明显降延迟结果量大时调到 60–100 提召回ignoreexample-index.yml中 collection 级字段YAML 专属、无 CLI 命令按 glob 排除drafts/**、archive/2023/**这类噪声目录内置排除node_modules/.git等无法取消踩过的坑换了 embedding 模型后搜索效果没变化甚至更差不同模型的向量空间不互通旧向量还在被检索。执行qmd embed -f强制全量重嵌再跑qmd query验证。改了index.yml的路径或 ignore 规则搜索结果没更新配置文件模板 顶部有注释编辑 YAML 本身不触发重建改完必须跑qmd update才会按新规则重新索引。中文笔记搜不到英文正常默认 embeddinggemma-300M 偏英文。设QMD_EMBED_MODEL环境变量指向 Qwen3-Embedding-0.6B 的 GGUF URI然后qmd embed -f两条命令搞定。下周把散落的会议记录和项目文档收进一个目录qmd collection add登记后任何一句话描述都能直接定位到原文——--json输出还能直接灌给 agent 做 RAG。打开终端跑上面第一条git clone命令。【免费下载链接】qmdmini cli search engine for your docs, knowledge bases, meeting notes, whatever. Tracking current sota approaches while being all local项目地址: https://gitcode.com/GitHub_Trending/qmd1/qmd创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考