前言¶

在 DeepSeek Harness（DSH）里做需要联网检索的智能体时，web_search 往往要接一家搜索 API，并在 profile 里把 provider 指清楚。若你只想用 Brave Web Search、不想多后端切换、也不想要额外设置界面，社区插件 dsh-brave-search（维护者 BuffMcBigHuge，GitHub 仓库 BuffMcBigHuge/dsh-brave-search）就是把查询交给 Brave、结果经 ctx.web 回传的单一实现。本文介绍其定位、能力与安装配置步骤；事实以仓库 README 与 package.json 为准。

这是什么¶

dsh-brave-search 是 DSH 的 Brave Search provider：一次 fetch 调用 https://api.search.brave.com/res/v1/web/search，把结果交回 Harness。无设置卡片、无多后端扇出、无插件内状态——README 的表述是：若你希望 web_search「就是 Brave」，即为此设计。

依赖关系：需要带 web 服务的 DSH（任意挂载了 @deepseek-ai/dsh-web 的 profile），以及 Brave Search API Key（免费档约 2,000 次/月，见 Brave API Dashboard）。package.json 标明 Node >=20.3，许可证 MIT，当前包版本 1.0.0。

核心功能¶

下面能力均来自 README 说明：

1. 单一后端：只注册 provider 名 brave；在 profile 里设置 searchProvider: brave 后，选择路径明确，不会像多后端插件那样隐式 fallback——Brave 不可用或限流时搜索失败，而不是静默换引擎。
2. 密钥解析顺序：credential 服务 → $DSH_HOME/.credentials.yaml → 环境变量 BRAVE_API_KEY。
3. 与 Harness 参数对齐：尊重 maxResults 与 harness 的 recency 过滤；结果数量上限为 Brave 的 count=20。
4. 失败信息可读：缺 key、非 2xx、以及免费档 429 上限会有明确错误（例如缺 key 时为 brave: no BRAVE_API_KEY found — …，错误 key 为 brave: HTTP 401）。

插件自带 bundle patch，安装后 provider 会自动挂载，无需再手写 Cordis 包声明（仍须在 profile patch 里指定 searchProvider）。

安装与启用¶

安装插件¶

在已具备 web profile 的前提下执行（命令来自 README，勿自行改仓库路径写法）：

dsh plugin --profile web add github:BuffMcBigHuge/dsh-brave-search

将 web_search 指向 Brave¶

在 profile patch 文件 $DSH_HOME/profiles/<profile>/cordis.patch.yml 中增加或调整 web 条目：

- id: web
  name: "@deepseek-ai/dsh-web"
  config:
    searchProvider: brave

注意：patch 里某一节的 config 会整体替换该节原有 config，而不是合并。若 profile 里已有 fetchProvider 或其他 web 配置，必须在同一块里一并写出，否则会丢掉原设置，并可能出现 multiple usable web providers are registered。

保存 API Key¶

推荐写入 $DSH_HOME/.credentials.yaml（文件权限建议 chmod 600，credential provider 不会加载对属主以外可读的文档）：

# $DSH_HOME/.credentials.yaml
version: 1
refs:
  BRAVE_API_KEY: your-key-here

也可在启动前用环境变量：

BRAVE_API_KEY=… dsh web

典型用法与验证¶

安装并完成 profile、密钥配置后，在对话或任务中发起需要联网搜索的请求即可。README 说明：成功时不会打印专门的 telemetry 行，搜索结果本身即验证；配置错误则从前述 brave: 前缀错误信息判断。

开发与自测可在克隆后的仓库内运行（面向维护者，非安装路径）：

node --test test/

适用场景与注意¶

适合：已在 DSH 使用 @deepseek-ai/dsh-web，且希望固定 Brave、配置尽量少的开发者。

注意：

• 插件在当前 dsh 进程权限下运行；安装前请自行审阅 GitHub 源码 与 MIT 许可证，勿把社区目录页当作官方应用商店——SkillHub 等目录站点与 DeepSeek / 幻方无官方从属关系。
• 无多引擎兜底；需容忍 Brave 限流（429）或服务不可用时的硬失败。
• 免费 API 配额与计费以 Brave 仪表盘为准，本文不展开具体商业条款。

结尾¶

dsh-brave-search 把 DSH 联网搜索收成「一个后端、一条 API、密钥从 credential 来」的最小路径；与多 backend 插件相比，取舍是简单与可预期，而不是自动切换搜索引擎。

• 社区目录页：https://www.skillhub.cn/plugins/BuffMcBigHuge/dsh-brave-search
• GitHub：https://github.com/BuffMcBigHuge/dsh-brave-search