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
