zhangzhenwen1/qmd-autosearch ↗★ 0
qmd-autosearch
DSH plugin: auto-supplement QMD semantic search when the model greps/globs a knowledge-base directory
AI 分析
核心用途是在模型检索知识库时自动增强语义搜索。适合使用 QMD 集合进行本地知识库管理,并希望模型能自动获取更精准上下文的用户。
インストール
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:zhangzhenwen1/qmd-autosearchドキュメント
README 全文を読む ↗配置
| 配置项 | 必填 | 默认值 | 说明 |
|---|---|---|---|
qmdUrl | ✅ | 无 | QMD MCP 服务地址(如 http://localhost:6179/mcp) |
collections | ✅ | 无 | 搜索范围:QMD 集合名列表(qmd collection list 可查) |
limit | 否 | 5 | 注入结果的条数上限 |
minScore | 否 | 25 | 最低匹配度过滤(百分数,低于此值的命中丢弃) |
triggerRoots | 否 | 自动 | 触发判断的文件系统根路径列表;缺省时从 QMD status 动态解析集合路径 |
未配置
qmdUrl/collections时插件禁用并输出 warn 日志。
使用
插件全自动运行,无需手动调用。配置完成后,正常使用 DSH 即可:
- 让模型在知识库目录内搜索(如
grep 某个概念) - 插件检测到搜索发生在 QMD 集合目录内,自动补充一次语义检索
- 结果作为补充提示注入模型的下一步上下文,模型可据此用
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 个(插件启动后首次触发时输出)