sugarforever/dsh-plugins

DeepSeek Harness Plugins

Project Overview项目介绍

This is a plugin collection for DeepSeek Harness, currently offering dsh-zvec-grep. It adds semantic workspace search based on zvec and zvec-grep, auto-indexes and tracks file changes. It is ideal for locating vaguely described content and analyzing cross-file information. Use exact text search for known fixed content; it requires Node.js 22 or higher.

这是DeepSeek Harness的插件集合,目前提供dsh-zvec-grep插件,可基于zvec和zvec-grep为工作区添加语义搜索能力。它会自动建立索引并监听文件变更,适合语义定位表述模糊的内容、分析跨文件信息。精确文本搜索更适合已知固定内容,要求Node.js 22及以上版本。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

npx @deepseek-ai/dsh plugin --profile web add @sugarforever/dsh-zvec-grep

sugarforever/dsh-plugins 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-plugins

这个仓库用于维护 DeepSeek Harness 插件。目前提供 dsh-zvec-grep

dsh-zvec-grep

dsh-zvec-grep 为 DeepSeek Harness 增加基于 zvec-grepzvec 的工作区语义搜索能力。

插件会在会话创建或恢复时读取当前工作区,在后台建立索引,并持续监听文件的新增、修改和删除。Agent 可以通过 zvec_search 按语义查找代码和文档,适合定位表述不确定的内容,以及分析架构、调用关系、控制流和跨文件信息。对于已知标识符、固定文本、正则表达式或错误信息,仍然适合使用精确文本搜索。

安装插件:

npx @deepseek-ai/dsh plugin --profile web add @sugarforever/dsh-zvec-grep

然后正常启动 DeepSeek Harness,例如:

npx @deepseek-ai/dsh web

插件会自动完成索引初始化,不需要单独安装或启动 zvec-grep 服务。Web 界面还会显示索引状态,包括 IndexingRefreshingReadyError

搜索引擎 @zvec/zvec-grep 是插件的可选依赖:网络正常时会随插件一并安装,安装失败也不会导致插件安装失败。此时插件照常加载,zvec_search 返回带修复命令的结构化错误,状态标签显示 Error;受限网络下可单独执行 npm install -g @zvec/zvec-grep,插件会自动从全局 npm root 解析到它(也可用 engineModule 指定路径)。引擎缺失最多每 30 秒重探一次,因此安装后无需重启 Harness。

首次使用时可能需要下载默认的本地嵌入模型。索引保存在工作区的 .zvec-grep/ 目录中,Node.js 版本要求为 22 或更高。

配置、工作机制和开发命令请参阅 dsh-zvec-grep/README.md

License

MIT

上一个 Prev dsh-token-cost 下一个 Next dsh-codegraph