用途:qmd 是工作区搜索工具,用于在工作区知识库中查找既往工作、上下文、分析或决策。注意不要与 Quarto 文档(.qmd 扩展名)混淆,后者使用 epq 和 quarto 技能。
主要能力:提供混合检索(BM25+向量)、纯 BM25 检索、纯向量检索,以及按路径获取文档、按行切片获取、按 glob 批量获取、重建索引、生成嵌入、查看索引健康状态和列出集合内已索引文件。
使用方式:常用命令包括 qmd query --no-rerank "your question"(混合检索,资料要求始终使用 --no-rerank)、qmd search "keywords"(仅 BM25,快速,无 LLM)、qmd vsearch "semantic query"(仅向量)、qmd get "path/to/file.md"、qmd get "path/to/file.md:100" -l 50、qmd multi-get "projects/**/*.md"、qmd update、qmd embed、qmd status、qmd ls projects。结构化查询可用 $'...\n...' 传入多行查询文档,包含 intent、lex、vec、hyde 等字段;lex 支持否定(-term),vec 与 hyde 不支持否定。
限制与注意事项:资料称 Qwen3-4B 重排器较慢且会降低结果质量,故建议 --no-rerank;--no-rerank 下分数为 RRF 序数值,仅表示排名顺序而非语义距离,不应据此判断质量,需用 qmd get 查看实际文档。重复路径可能因多目录索引同一文件而出现,属去重产物。批量相似度计算(如 1000+ 项的两两相似)不适合用 qmd CLI,建议直接用 sentence-transformers 与 numpy。向子代理布置搜索任务时应显式给出 qmd CLI 命令,不要依赖可能不可用的 MCP 工具。