@bocha-ai/dsh-web-search-bocha

English | 中文

由 Bocha Web Search 支持的 WebSearchProvider 和可安装 Profile 组合包（bundle），用于 DeepSeek Harness。该包注册提供方 ID bocha，调用博查的 POST /v1/web-search 端点，并携带一个 dsh.bundle patch，安装后选择这个提供方。

该包只提供搜索。DeepSeek Harness 继续通过其 web 能力拥有面向模型的 web_search 工具、结果上限、引用、提供方选择和错误呈现。

安装

把组合包安装到 Profile：

dsh plugin --profile web add @bocha-ai/dsh-web-search-bocha

如需检查最终组合配置，可以执行下面的可选命令；它打印配置后就会退出：

dsh --profile web --dump-config

启动 Web 应用只需要执行：

dsh --profile web

API 密钥使用下面任一方式配置即可，不需要同时配置。

方式一：DSH credentials 文档

把密钥存入 $DSH_HOME/.credentials.yaml（通常是 ~/.dsh/.credentials.yaml）：

BOCHA_API_KEY: your-api-key

在 POSIX 上，该文件必须仅属主可访问：

chmod 600 ~/.dsh/.credentials.yaml

插件会在每次搜索时经由 Harness credentials 服务解析这个引用，因此轮换已存密钥后，下一次请求就会使用新值，无需重启。

方式二：环境变量

对于 CI、容器或按次覆盖，在启动 Harness 前导出密钥：

export BOCHA_API_KEY='your-api-key'

如果两种方式都配置了 BOCHA_API_KEY，继承的环境变量优先级高于受管凭据文档。

移除这个包会同时移除其提供方行和组合包层：

dsh plugin --profile web remove @bocha-ai/dsh-web-search-bocha

组合包行为

cordis.patch.yml 把基础 web 行的完整配置替换为 searchProvider: bocha，并插入加载本包的 web-search-bocha 行。现有提供方仍保持挂载，但 ctx.web 会把搜索路由到 bocha。随后应用的 Profile、Harness home 和命令行 patch 层可以替换任一行。

配置

配置键	默认值	含义
apiKey	—	可选的博查 API 密钥字面值。settings 描述会将它脱敏，但仍应优先使用 credentials 服务，以免明文密钥进入 Profile patch。