DeepSeek Harness (DSH) 通过 ctx.web 槽位提供网络搜索能力。开发者在使用基础包时，可能需要集成特定来源的搜索服务，或者希望将搜索计费与模型推理计费解耦。dsh-web-search-doubao 是一个社区插件，它将豆包搜索服务接入 DSH 的 ctx.web 槽位，提供独立的搜索功能。
基本信息¶
这是一个社区维护的插件，由开发者 kenny2077 维护，采用 MIT 许可证。它不依赖 DeepSeek 官方基础包，通过 cordis.patch.yml 注册 Provider，不会影响 DSH 基础包的运行。
核心功能¶
- 豆包搜索服务：提供基于 Volcengine 豆包搜索的 Web 搜索结果。
- 独立计费：搜索服务独立计费，不消耗模型 Token，避免搜索成本与模型推理费用混淆。
- 槽位插入：通过 Seam 模式将提供者插入到
ctx.web槽位，保持与 DSH 原生提供者一致的接口。 - 双版本支持：提供
custom和global两种版本，分别对应不同的 API 返回格式和结果长度。 - 运行时配置：支持在运行时修改设置（如版本、端点、片段长度等），无需重启 DSH 进程。
- 凭证安全存储：API 密钥通过 DSH 凭证服务存储，不直接写入配置文件。
安装与启用¶
在安装前，请确保已安装 DeepSeek Harness (DSH) 并可用 dsh CLI。
- 从 npm 安装：
dsh plugin add dsh-web-search-doubao
- 从 GitHub 安装（无需构建）：
dsh plugin add github:kenny2077/dsh-web-search-doubao
安装命令会通过 cordis.patch.yml 注册 Provider，并将活跃的 searchProvider 切换为 doubao。
配置与使用¶
获取密钥与配置¶
插件提供独立的 Web Search (Doubao) 设置卡片。API 密钥需通过凭证服务管理，而非配置文件。
- 获取 API Key：在豆包搜索控制台开通服务并创建 API Key。每月提供 500 次免费搜索额度。
- 配置：在 Harness 设置 GUI 的 “Web Search (Doubao)” 卡片中输入密钥。设置项包括版本（custom/global）、基础 URL 等，更改即刻生效。
使用搜索工具¶
配置完成后，在 Harness 中使用 web_search 工具即可调用豆包搜索。插件会将搜索结果标准化为 WebSearchResult 格式返回给模型。
注意事项¶
- 非 Ark 插件：这不是火山方舟（Ark）聊天侧的联网内容插件。它使用豆包搜索的独立 API，搜索过程与模型推理完全解耦。
- 源码检查：作为社区插件，建议在使用前检查源码与许可证。
- 依赖环境：插件依赖 DSH 的 seam 插入方式，运行依赖于当前 DSH 进程的权限。
生态背景¶
DeepSeek Harness 的核心理念是“一切皆插件”。此插件是社区开发者为丰富生态而构建的工具之一，与 DeepSeek 官方无直接从属关系。社区目录提供了插件的索引信息。
- GitHub 仓库：https://github.com/kenny2077/dsh-web-search-doubao
- 社区目录：https://www.skillhub.cn/plugins/kenny2077/dsh-web-search-doubao
