dsh-zvec-grep

在 dsh 里做代码检索时，纯关键词的 grep 往往抓不住「这段逻辑在哪」「和某概念相关的文件」这类意图。本插件把语义工作区搜索接进会话：通过宿主 shell 驱动 zg CLI，在 BM25、向量与 RRF 混合检索之上，向模型暴露 zg_search、zg_index、zg_status 三个工具，让搜索与建索引成为会话内的一等能力。

传输默认走 auto：守护进程就绪时用 server，未就绪时静默回落 direct（本包与上游一样只探测就绪、不替你拉起守护进程）。插件还会注入 systemPrompt 路由规则，并在 tools.guard 上叠两层约束：对 zg_* 的安全兜底，以及在已索引工作区里要求先成功 zg_search 再允许 grep/rg 的「搜索优先」门禁，减少模型跳过语义检索直接全文扫盘。

配套 Web 设置卡可配置默认 embedding、结果上限、搜索优先配额与时间窗、守护进程就绪状态，并提供「重建工作区」入口；索引与重建在模型侧与卡片侧共用同一套后台任务与互斥逻辑。平台方面仅面向 POSIX（Linux/macOS），工作区根路径须为以 / 开头的绝对路径；Windows 会话会快速拒绝并说明原因，避免用错误路径假装搜到了结果。

适合在 dsh 中长时间改仓、希望模型先语义定位再精读文件的用户；也适合希望把 zg 索引生命周期（建索引、状态、重建）和检索参数（过滤、预览、刷新策略等）收拢到插件与设置界面里、而不是每次手写 CLI 的团队。