前言¶

在 DeepSeek Harness（DSH）中，ctx.web 的搜索能力通过插件组合实现。已有后端需要调用辅助模型才能完成搜索，引入额外延迟与成本。当部署持有腾讯云 WSA API Key 且希望用单一请求完成检索时，可以直接使用 dsh-web-search-yuanbao。

插件定位¶

dsh-web-search-yuanbao 是 DeepSeek Harness 的一个搜索提供方插件，由维护者 WalterYOO 开发。它面向 ctx.web，直接对接腾讯元宝搜索 API，将检索结果映射为 WebSearchSource 格式，供模型工具使用。

直接 API 检索：发起一次请求即可获取标题、URL、摘要与发布时间，无需模型参与检索。
结果规范化：将 API 返回的摘要字段（passage 或垂直结果的 content）映射为 snippet；日期格式统一为 ISO-8601；丢弃无 URL 或无摘要的条目。
灵活凭证：支持通过 TENCENTCLOUD_WSA_APIKEY 环境变量或 ctx.credentials 服务读取 API Key。
限制与容错：仅支持结果数 10/20/30/40/50；不重试也不降级到其他后端；HTTP 重定向被拒绝；异常统一映射为 WEB_PROVIDER_ERROR、WEB_ABORTED 或 WEB_PROVIDER_CREDENTIAL_MISSING。

插件通过 dsh bundle 层挂载，安装命令如下：

dsh plugin --profile demo add ./dsh-web-search-yuanbao

安装后，该提供方会注册为 yuanbao。在 cordis.patch.yml 中配置搜索提供方：

- name: '@deepseek-ai/dsh-web'
- name: 'dsh-web-search-yuanbao'
  config:
    apiKeyEnv: TENCENTCLOUD_WSA_APIKEY

字段说明：

字段	默认值	含义
`apiKey`	omitted	明文 API Key；建议优先使用 `apiKeyEnv`
`apiKeyEnv`	`TENCENTCLOUD_WSA_APIKEY`	每次搜索时解析的凭证引用，非空时覆盖 `apiKey`
`baseURL`	`https://api.wsa.cloud.tencent.com`	API 基础地址，追加 `/SearchPro`
`count`	`10`	每次请求返回的结果数，支持 10/20/30/40/50

加载 Web 服务与提供方后，ctx.web.search() 会自动选择 yuanbao 作为提供方（若为唯一可用后端），或显式指定：

- name: '@deepseek-ai/dsh-web'
- name: 'dsh-web-search-yuanbao'
  config:
    searchProvider: yuanbao
    apiKeyEnv: TENCENTCLOUD_WSA_APIKEY

返回的每个可用页面映射为 WebSearchSource：

无 URL 或无摘要的条目会被丢弃；服务不生成答案，因此 content 字段不会出现在结果中。

适合持有腾讯云 WSA API Key 的部署，希望用单次请求完成检索，且对延迟与成本敏感的场景。插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证。

dsh-web-search-yuanbao 将腾讯元宝搜索集成到 DSH 检索能力中，通过直接 API 调用减少模型轮次。更多细节可查阅插件目录与 GitHub 仓库。