QMD 本地文件索引与检索
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-qmd。
技能介绍
要解决什么问题
本机散落着大量 Markdown、文档或其它被 mask 规则覆盖的文件时,单靠 grep 或 IDE 全文搜索很难做按集合管理的检索,也缺少关键词(BM25)与语义(向量)可切换或组合的查询方式。若你还希望 Agent 通过 MCP 直接查本地索引,就需要一套把「建库—更新—查询—按行取片段」串起来的约定,而不是每次临时拼脚本。
技能如何工作
qmd 面向本地文件索引与搜索,核心流程可以概括为:
- 建集合:
qmd collection add /path --name docs --mask "**/*.md"指定路径、集合名与文件匹配规则。 - 维护索引:
qmd update刷新索引,qmd status查看当前状态;默认数据目录在~/.cache/qmd。 - 多种检索:
qmd search走 BM25;qmd vsearch走向量;qmd query做混合检索;需要原文片段时用qmd get docs/path.md:10 -l 40按路径与行号拉取。 - 嵌入与重排:向量相关能力依赖 Ollama,通过环境变量
OLLAMA_URL(默认http://localhost:11434)连接。 - Agent 接入:
qmd mcp以 MCP 模式暴露能力,便于助手在对话里查本地文档库。
适用边界与注意点
索引的是本机路径下的文件,不是远程云盘 API;向量与混合查询需要本机或可达的 Ollama 服务,否则只能稳定使用不依赖嵌入的 BM25 路径。集合与 mask 设计决定了索引范围,范围过大时 update 成本会上去,宜按项目或文档集拆分 collection。技能说明的是 qmd 的使用方式与命令语义,具体二进制安装与 PATH 配置需在你自己的环境中完成。
使用场景
- 维护多套内部 Markdown 文档库,需要按集合增量 `qmd update` 后再用关键词或语义查段落
- 在 Agent 对话里通过 `qmd mcp` 查本机规范文档,并用 `qmd get` 按行号引用原文
- 本地技术笔记路径固定,想用 `qmd query` 混合检索替代纯 grep 扫盘
- 接入 Ollama 后,对同一 `collection` 对比 `vsearch` 与 `search` 的召回差异
适合人员
- 在本机维护多仓库文档、需要把路径注册为 qmd collection 并定期 update 的技术写作者
- 为 OpenClaw/Claw 类 Agent 接 MCP,要把本地知识库暴露成可查询工具的集成工程师
- 已跑 Ollama、希望本地 BM25 与向量检索共用一套索引的 AI 应用开发者
- 负责内部 Wiki 导出到磁盘、要用 mask 规则分批索引再检索的文档管理员