Agent Skills
返回列表
🤖

QMD 本地文件索引与检索

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 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 规则分批索引再检索的文档管理员