zhangzhenwen1/qmd-autosearch0

qmd-autosearch

DSH 插件:当模型在知识库目录执行检索时,自动补充 QMD 语义搜索结果并注入上下文。

AI 分析

核心用途是在模型检索知识库时自动增强语义搜索。适合使用 QMD 集合进行本地知识库管理,并希望模型能自动获取更精准上下文的用户。

包名
qmd-autosearch
版本
0.1.1
许可证
MIT
最近更新
2026年8月16日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:zhangzhenwen1/qmd-autosearch

配置

配置项必填默认值说明
qmdUrlQMD MCP 服务地址(如 http://localhost:6179/mcp
collections搜索范围:QMD 集合名列表(qmd collection list 可查)
limit5注入结果的条数上限
minScore25最低匹配度过滤(百分数,低于此值的命中丢弃)
triggerRoots自动触发判断的文件系统根路径列表;缺省时从 QMD status 动态解析集合路径

未配置 qmdUrl / collections 时插件禁用并输出 warn 日志。

使用

插件全自动运行,无需手动调用。配置完成后,正常使用 DSH 即可:

  1. 让模型在知识库目录内搜索(如 grep 某个概念
  2. 插件检测到搜索发生在 QMD 集合目录内,自动补充一次语义检索
  3. 结果作为补充提示注入模型的下一步上下文,模型可据此用 read 读取命中文档正文

效果示例

模型执行 grep 内需 后,下一步上下文中会出现:


QMD 语义检索补充:你在知识库目录执行了「grep 内需」,系统已自动用语义检索(范围限定 QMD 集合,LLM 重排)补搜,查询词「内需」。结果如下(docid 映射为绝对路径后用 read 读取正文):

Found 3 results for "内需":
#abc123 85% /concepts/.md - 
#def456 42% /principles/.md - 
...

验证插件已生效

  • 让模型在集合目录内 grep 一个词,观察下一步是否出现上述补充消息
  • 或查看宿主日志中的 qmd-autosearch: 触发路径池(来自 QMD 集合)N 个(插件启动后首次触发时输出)