前言¶
DeepSeek Harness(下称 DSH)里的 web 能力通过 ctx.web 这条 seam 暴露,内置 web_search 工具可以接入不同的搜索后端。如果你的目标是在 DSH 中把 web 搜索请求路由到 Brave Search Web API,并且希望保持插件化配置,可以关注 dsh-web-search-brave。
DSH 的插件生态按“一切皆插件”组织,社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系,不应把它理解成官方应用商店。
这是什么¶
dsh-web-search-brave 是一个 Brave Search-backed WebSearchProvider,用于 DSH 的 web seam(ctx.web)。它的作用是为 DSH 的 ctx.web / web_search 提供 Brave Search 后端。
该插件由 cnChenKai 维护,许可证为 MIT。engines 要求 Node.js >=22。
核心功能¶
下面只列已核实的插件能力:
- 为 DSH 的
ctx.web/web_search提供 Brave Search 后端。 text_decorations默认false,搜索片段不带高亮标记。page_age(ISO 8601)映射到 seam 的publishedAt。- 需要
BRAVE_API_KEY;Brave 没有 keyless 模式,免费额度为 2,000 queries/month。
安装与启用¶
先确认 DSH 运行环境满足 node >=22,然后按下面步骤安装并启用。
1、安装插件¶
在目标 DSH profile 下运行安装命令:
dsh plugin --profile web add dsh-web-search-brave
这条命令会把 dsh-web-search-brave 添加到 web profile 的插件集合中。
2、配置 API Key¶
在 DSH credential store 中设置 BRAVE_API_KEY,或者在启动 dsh web 的环境中导出该变量。credential store 示例如下:
# ~/.dsh/.credentials.yaml
BRAVE_API_KEY: BSA...
上面使用占位值,实际值应替换为你自己的 Brave Search API key。
3、选择 Brave 搜索提供方¶
在 profile 的 cordis.patch.yml 中,将 web 配置的 searchProvider 设为 brave:
# your profile's cordis.patch.yml
- id: web
name: '@deepseek-ai/dsh-web'
config:
searchProvider: brave
经过上面的步骤后,DSH 的 web_search 会使用 Brave Search 作为搜索后端。
依赖与许可¶
该插件声明了以下 peerDependencies:
@deepseek-ai/dsh-credentials
@deepseek-ai/dsh-launch-environment
@deepseek-ai/dsh-web
@deepseek-ai/schemastery
许可证为 MIT。engines 要求 Node.js >=22。
适用场景与注意¶
适合的场景:
- 你正在 DSH 中使用
ctx.web/web_search,并希望切换到 Brave Search。 - 你可以管理
BRAVE_API_KEY,并且用量在免费额度内即可满足需求。 - 你希望通过 DSH profile 和
cordis.patch.yml做声明式配置。
注意事项:
- 该插件需要 Brave Search API key,Brave 没有 keyless 模式。
- 免费额度为 2,000 queries/month,生产或高频使用需自行评估配额。
- 插件会以当前
dsh进程权限运行。安装前请检查源码、依赖和许可证是否符合你的使用要求。 - 社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系。
链接¶
- 社区目录:https://www.skillhub.cn/plugins/cnChenKai/dsh-web-search-brave
- GitHub:https://github.com/cnChenKai/dsh-web-search-brave