前言¶
在 DeepSeek Harness（DSH）里做联网能力时，模型侧通常已有 @deepseek-ai/dsh-tool-web 提供的 web_search 工具；真正缺的是「搜什么后端」——ctx.web 需要挂一个 search provider，才能把查询落到可用的 HTTP API 上。若你已有 Brave Search API 订阅，希望 Harness Web 里统一选 Brave、并在界面里配密钥与地区/语言，而不是自己改进程环境或 patch，社区插件 dsh-brave-search-provider（维护者 yoggu，分类：联网工具）就是针对这一层的实现：它提供 Brave 后端的 search provider 与 Plugins → Brave Search 设置页，不替代模型侧的 web_search 工具，也不提供 HTTP fetch provider。
这是什么¶
dsh-brave-search-provider 是 DSH 的 Brave Search API 后端插件：bundle 为 Web 搜索选择 brave，并注册 Brave 相关设置卡片。简介原文为：Brave-backed ctx.web search provider and settings card for the DeepSeek Harness.
插件当前发布版本为 0.1.4（见仓库 package.json），许可证 MIT。社区目录页：SkillHub 插件页；源码与说明：GitHub yoggu/dsh-brave-search-provider。
核心功能¶
下面几点均来自仓库 README，便于和「整包联网方案」区分边界：
- Search provider：为 DSH 的
ctx.web搜索提供 Brave Search API 实现；后端只调用 Brave 的 HTTPS web-search 端点，不跟随重定向；每次请求解析 API key。 - 设置页：在 Harness UI 中增加 Plugins → Brave Search，可配置国家（默认
us）、搜索语言（默认en）、请求超时（默认 30 秒）。设置页界面语言支持 English、German，其他 locale 回退 English；这与搜索结果语言无关。 - 密钥管理：在设置页填写 Brave Search API 订阅 key，保存到 DSH credential store 的
BRAVE_API_KEY；也可在 DSH 进程环境中设置BRAVE_API_KEY。设置页仅报告 key 是否存在，不展示明文。 - 不负责的部分：模型面向的
web_search仍由@deepseek-ai/dsh-tool-web提供；本插件不提供 fetch provider。
运行环境要求（package.json）：Node >=22.19.0，DSH ^0.1.5-rc.2 || ^0.2.0-rc.1；面向 web 平台（dsh.client.platform: web）。
安装与启用¶
安装前请自行审阅仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，密钥勿写入仓库或 profile patch。
从 GitHub 标签安装（推荐）¶
安装最新 tagged release（资料原文命令，profile 为 web）：
dsh plugin --profile web add 'https://github.com/yoggu/dsh-brave-search-provider.git#v0.1.4'
若你实际使用的 profile 不是 web，将 --profile web 换成对应 profile。
本地 link 安装（可选）¶
README 还提供下载源码并在本地 link 的方式；link 期间需保持 checkout 路径不变：
git clone --branch v0.1.4 --depth 1 https://github.com/yoggu/dsh-brave-search-provider.git
cd dsh-brave-search-provider
pnpm install
dsh plugin --profile web add "link:$(pwd)"
启用后配置¶
- 必要时重启 DSH Web 并刷新页面。
- 打开 Plugins → Brave Search，填入 Brave Search API 订阅 key（或事先配置环境变量
BRAVE_API_KEY）。 - 按需调整 country、search language、timeout。
卸载：
dsh plugin --profile web remove dsh-brave-search-provider
典型用法¶
README 未单独给出「对话里怎么说」的示例；可复现路径是：安装插件 → 配置 BRAVE_API_KEY 与地区/语言/超时 → 在已启用 @deepseek-ai/dsh-tool-web 的 Harness 里使用模型侧 web 搜索。此时 ctx.web 的 Web 搜索由 bundle 选中的 brave provider 走 Brave API；开发者验证插件时可安装 DSH peer 依赖后执行：
npm test
（仓库说明：在安装 DSH peer dependencies 之后运行 npm test。）
适用场景与注意¶
适合谁：已有 Brave Search API 订阅、使用 DSH Web profile、希望把 ctx.web 搜索固定到 Brave，并希望在 UI 里管理密钥与 us/en 等默认检索参数的智能体或 Harness 开发者。
注意：
- 本插件只解决 search provider + 设置页；若缺少模型侧搜索工具，仍需
@deepseek-ai/dsh-tool-web等既有组件。 - API key 仅通过 credential store 或进程环境注入；不要 commit 到 git 或 profile patch。
- 社区目录（如 SkillHub）与 DeepSeek / 幻方无官方从属关系，安装来源以你信任的仓库与 release 标签为准。
结尾¶
dsh-brave-search-provider 把 Brave Search API 接到 DSH 的 ctx.web 搜索链路上，并用 Plugins → Brave Search 集中管理密钥与检索参数，适合已订阅 Brave、希望在 Harness Web 里即用即配的场景。进一步了解请查看 SkillHub 目录页 与 GitHub 仓库 README。
