@deads-inc/dsh-web-search-brave：Brave Search 后备的 DSH 联网工具

DeepSeek Harness（dsh）通过 ctx.web seam 提供联网能力。@deads-inc/dsh-web-search-brave 插件通过注册 WebSearchProvider 实现 Web 搜索功能，使内置的 web_search 工具能够使用 Brave Search API。

核心能力¶

该插件主要提供以下功能：

• 注册 Provider：将 WebSearchProvider 注册到 ctx.web seam。
• 工具支持：支持内置的 web_search 工具。
• 并发控制：通过进程内串行化请求实现并发安全的速率限制，默认请求间隔为 1500ms。
• 错误重试：遇到 429/403 状态码时，执行指数退避与抖动策略，最多重试 3 次，单次退避上限 30s。
• 灵活配置：支持通过 DSH 设置或环境变量进行配置。

安装与启用¶

1. 安装插件

使用 npm 安装（推荐）：

dsh plugin --profile web add @deads-inc/dsh-web-search-brave

2. 配置 API Key

插件需要 BRAVE_API_KEY 才能运行。在重启 dsh 之前，先导出该环境变量：

export BRAVE_API_KEY=<your-key>

3. 启用搜索提供者

该插件默认注册 brave-search，但不会自动设为默认提供者。需要在 cordis.patch.yml 中配置补丁：

- id: web
  config:
    searchProvider: brave-search

安装脚本 bash install.sh 会自动处理上述配置。

典型用法¶

安装并配置完成后，可以直接在命令行中使用 web_search 工具：

dsh --profile web "Use web_search to find one page about Node.js 24. Reply with just the URL."

注意事项¶

• 环境要求：需要 Node.js 版本 >= 18.17。
• 依赖关系：需要安装对应的 @deepseek-ai/* peer 依赖（由宿主 DSH 提供）。
• 安全性：
  • API key 仅发送到配置的 baseURL（默认为 Brave 官方端点）。
  • 自定义 baseURL 仅用于代理或测试，插件不验证其域名。
  • 插件无 postinstall 脚本、无遥测、无其他网络调用。

生态背景¶

DSH 采取插件化架构，本插件由社区维护，仅通过 npm 发布，不涉及任何官方应用商店逻辑。更多细节与源码可参考 GitHub 仓库。