3步部署qmd本地文档检索从安装到首次搜索完整指南【免费下载链接】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会议记录、读书笔记、踩坑日志本地文件越攒越多想找三年前写的某句话只能翻遍文件夹也没着落。qmd 是一个完全跑在本地的文档检索引擎把 Markdown 笔记建成索引再用关键词、向量和 LLM 重排序的组合帮你定位原文全程数据不出机器。先看它解决什么问题先说结论qmd 把翻文件夹变成搜一下而且过程对隐私和离线都友好。笔记不出本机隐私天然兜底。索引、向量、重排序全部在你的电脑上完成文档内容不经过任何外部服务敏感会议记录和私人手账也能直接收进索引。不用记住原话才能找到东西。你清楚记得429 限流这样的字眼时关键词检索最快只记得大意时向量相似度搜索能把相关段落捞出来两条召回路径互为补充。AI 助手也能查你的笔记。运行qmd mcp后搜索变成标准 MCP 服务IDE 和聊天机器人可以直接调用这个本地知识库不用再复制文件。三步部署qmd跑起来整个部署只有三条核心命令顺利的话 10 分钟内就能看到搜索结果。确认Node环境qmd 依赖 Node.js 且要求 22 及以上版本同时系统里要有 Git。node -v预期输出 v22.x 或更高版本就可以直接往下走否则先升级 Node。克隆qmd仓库把源码拉到你的工作目录后续所有操作都在这个目录里完成。git clone https://gitcode.com/GitHub_Trending/qmd1/qmd预期出现 qmd 文件夹里面有 src/、test/、docs/ 等目录。安装依赖并构建进入项目目录后一条命令装好依赖并跑构建脚本生成可执行产物。cd qmd npm install npm run build预期末尾无报错bin/qmd 入口与 dist/ 目录就绪可以用npm run qmd -- 子命令的方式调用。完成第一次检索建索引、加文档、搜一次按建索引→加文档→搜一次的动作顺序推进每一步都有明确的终端反馈。建索引在你存放笔记的目录下初始化一个项目级索引会生成.qmd配置和 SQLite 索引文件。npm run qmd -- init此时你会看到一行ready to go with new local index目录里多出索引文件。把文档加入索引把 Markdown 笔记所在的文件夹登记为一个 collectionqmd 按模式匹配把文件切块并写入数据库。npm run qmd -- collection add ./notes此时你会看到该集合收录的文件数若提示还有文档缺少向量可以先运行npm run qmd -- pull把本地模型下载好再执行npm run qmd -- embed补齐向量。执行第一次搜索把你想找的那句话敲进去qmd 会先做查询扩展再混合检索并重排输出带分片的排序结果。npm run qmd -- query 上次讨论的限流方案此时你会看到前几条命中结果每条包含文件路径、行号和片段内容按相关度从高到低排列。它背后在做什么一条自动流水线你只需要输一句话剩下的流程自动完成扩展查询 → BM25 与向量并行搜索 → RRF 分数融合 → LLM 重排 → 输出结果具体来说本地小模型先把你的句子扩成关键词、语义、假设答案三种查询BM25 和向量搜索并行取候选RRF 把两个排名合成一个再由本地 LLM 对头部候选重排决定谁排在前。更细的查询语法lex / vec / hyde 三种行类型见 docs/SYNTAX.md名字点到为止够用即可。卡住了先翻这里高频卡点基本都是症状→原因→一条命令对照排查就行。症状搜索明显偏慢。原因重排环节要在 CPU 上逐条跑本地 LLM。解决搜索时加--no-rerank只用 RRF 分数速度提升明显。症状提示还有文档需要 embeddings或向量召回为空。原因文件已入索引但向量没生成。解决执行npm run qmd -- embed补齐。症状文件改过了搜索结果却不更新。原因索引建立后的变更没有重新入索引。解决执行npm run qmd -- update重建全部集合。顺带说下高级配置集合路径、匹配模式、忽略规则和模型地址都集中在 example-index.yml 这份模板里把它复制到~/.config/qmd/index.yml即可启用改完记得再跑一次 update 让配置生效。之前找不着的那句话现在敲一半就能浮出来会议记录不用再靠翻文件夹回忆。下一步很简单挑一个笔记最多的目录把 init 和 collection add 跑完用 query 试试你最久没想起的一个问题。【免费下载链接】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），仅供参考
3步部署qmd：本地文档检索从安装到首次搜索完整指南
3步部署qmd本地文档检索从安装到首次搜索完整指南【免费下载链接】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会议记录、读书笔记、踩坑日志本地文件越攒越多想找三年前写的某句话只能翻遍文件夹也没着落。qmd 是一个完全跑在本地的文档检索引擎把 Markdown 笔记建成索引再用关键词、向量和 LLM 重排序的组合帮你定位原文全程数据不出机器。先看它解决什么问题先说结论qmd 把翻文件夹变成搜一下而且过程对隐私和离线都友好。笔记不出本机隐私天然兜底。索引、向量、重排序全部在你的电脑上完成文档内容不经过任何外部服务敏感会议记录和私人手账也能直接收进索引。不用记住原话才能找到东西。你清楚记得429 限流这样的字眼时关键词检索最快只记得大意时向量相似度搜索能把相关段落捞出来两条召回路径互为补充。AI 助手也能查你的笔记。运行qmd mcp后搜索变成标准 MCP 服务IDE 和聊天机器人可以直接调用这个本地知识库不用再复制文件。三步部署qmd跑起来整个部署只有三条核心命令顺利的话 10 分钟内就能看到搜索结果。确认Node环境qmd 依赖 Node.js 且要求 22 及以上版本同时系统里要有 Git。node -v预期输出 v22.x 或更高版本就可以直接往下走否则先升级 Node。克隆qmd仓库把源码拉到你的工作目录后续所有操作都在这个目录里完成。git clone https://gitcode.com/GitHub_Trending/qmd1/qmd预期出现 qmd 文件夹里面有 src/、test/、docs/ 等目录。安装依赖并构建进入项目目录后一条命令装好依赖并跑构建脚本生成可执行产物。cd qmd npm install npm run build预期末尾无报错bin/qmd 入口与 dist/ 目录就绪可以用npm run qmd -- 子命令的方式调用。完成第一次检索建索引、加文档、搜一次按建索引→加文档→搜一次的动作顺序推进每一步都有明确的终端反馈。建索引在你存放笔记的目录下初始化一个项目级索引会生成.qmd配置和 SQLite 索引文件。npm run qmd -- init此时你会看到一行ready to go with new local index目录里多出索引文件。把文档加入索引把 Markdown 笔记所在的文件夹登记为一个 collectionqmd 按模式匹配把文件切块并写入数据库。npm run qmd -- collection add ./notes此时你会看到该集合收录的文件数若提示还有文档缺少向量可以先运行npm run qmd -- pull把本地模型下载好再执行npm run qmd -- embed补齐向量。执行第一次搜索把你想找的那句话敲进去qmd 会先做查询扩展再混合检索并重排输出带分片的排序结果。npm run qmd -- query 上次讨论的限流方案此时你会看到前几条命中结果每条包含文件路径、行号和片段内容按相关度从高到低排列。它背后在做什么一条自动流水线你只需要输一句话剩下的流程自动完成扩展查询 → BM25 与向量并行搜索 → RRF 分数融合 → LLM 重排 → 输出结果具体来说本地小模型先把你的句子扩成关键词、语义、假设答案三种查询BM25 和向量搜索并行取候选RRF 把两个排名合成一个再由本地 LLM 对头部候选重排决定谁排在前。更细的查询语法lex / vec / hyde 三种行类型见 docs/SYNTAX.md名字点到为止够用即可。卡住了先翻这里高频卡点基本都是症状→原因→一条命令对照排查就行。症状搜索明显偏慢。原因重排环节要在 CPU 上逐条跑本地 LLM。解决搜索时加--no-rerank只用 RRF 分数速度提升明显。症状提示还有文档需要 embeddings或向量召回为空。原因文件已入索引但向量没生成。解决执行npm run qmd -- embed补齐。症状文件改过了搜索结果却不更新。原因索引建立后的变更没有重新入索引。解决执行npm run qmd -- update重建全部集合。顺带说下高级配置集合路径、匹配模式、忽略规则和模型地址都集中在 example-index.yml 这份模板里把它复制到~/.config/qmd/index.yml即可启用改完记得再跑一次 update 让配置生效。之前找不着的那句话现在敲一半就能浮出来会议记录不用再靠翻文件夹回忆。下一步很简单挑一个笔记最多的目录把 init 和 collection add 跑完用 query 试试你最久没想起的一个问题。【免费下载链接】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），仅供参考
