qmd-autosearch

模型在知识库目录里跑 grep、glob，命中的往往只是字面匹配的少数行，语义上真正相关的文档却悄悄漏掉。想手动再触发一次 QMD 语义检索，既打断工作流节奏，也多了一步无谓的人工介入。qmd-autosearch 要补的正是这条缝隙：在模型无感知的情况下自动完成一次语义补搜，把命中结果异步注入下一步上下文，零额外指令、零外部依赖。

触发逻辑刻意保守：搜索路径落在已配置的 QMD 集合目录内且为顶层调用时才生效。查询词优先取最近一条用户消息作为语义主查询，消息过短或与主题无关时回退到 grep pattern。检索走 QMD lex + vec 混合通道，服务端 LLM 重排后再经 minScore 过滤与 limit 截断，结果异步入队到 agent.inbox.nextStep，绝不阻塞当前工具调用。同一 agent 内按工具、路径、pattern 三元组去重，QMD 服务不可用或无命中时静默跳过，原流程不受任何影响。

适合已在 DeepSeek Harness 中运行 agent 工作流、本地或内网部署了 QMD MCP 服务、且至少建好一个 collection 的团队。尤其是知识库体量大、纯关键词检索经常不够用的场景：配好之后无需改任何 prompt，模型每次 grep 之后，下一步上下文里就会多出一组语义命中，随时可以 read 展开正文。