前言¶

DeepSeek Harness (DSH) 的插件化架構允許開發者根據需要擴展功能。在 Web 能力中，內置的 web_search 工具通常需要外部網關支持才能執行真實的網絡檢索。dsh-web-search-tokenrhythm 插件正是爲了解決這一問題而生，它將 DSH 的內置工具對接到 Token Rhythm 網關的 OpenAI Responses API。

這是什麼¶

這是一個由 Joeytisaly 維護的插件。它的核心作用是將 DSH 的內置 web_search 工具轉化爲通過 Token Rhythm 網關的真實搜索請求。該插件複用用戶已保存的 DEEPSEEK_API_KEY，無需註冊新的賬號或獲取新的密鑰。

安裝與啓用¶

安裝需要進入 dsh 的配置文件目錄（例如 %USERPROFILE%\.dsh\profiles\web）。

1. 在該目錄下執行安裝命令：

   pnpm add dsh-web-search-tokenrhythm

2. 編輯 profiles/web/package.json，在 dsh.profile.bundles 數組中添加 "dsh-web-search-tokenrhythm"。

3. 重啓 dsh web 以激活該提供者。

核心功能¶

• 真實搜索：通過 Token Rhythm 網關的 OpenAI Responses API 執行真實的網絡搜索。
• 複用密鑰：自動讀取已保存的 DEEPSEEK_API_KEY，無需額外的認證配置。
• 自動掛載：當插件被列在配置文件的 bundles 中時，會自動掛載提供者。
• 原生支持：支持 OpenAI Responses API 中原生的 web_search 工具。
• 自動重試：針對網關返回的 transient 503 錯誤，會自動重試最多 maxRetries 次（默認爲 2 次）。

典型用法¶

在 DSH 的聊天界面中，直接向智能體提問即可觸發搜索。
示例：
* “幫我搜一下 XXX”
* “search the web for XXX”

插件激活後，智能體的回覆中會包含真實的搜索來源鏈接。

適用場景與前置條件¶

• 前置條件：
  • 你的網關必須支持帶有原生 web_search 工具的 OpenAI Responses API。
  • 必須在設置中保存 API 密鑰（默認引用爲 DEEPSEEK_API_KEY）。
• 注意：
  • 搜索結果可能僅返回打開頁面的 URL，不包含結構化的標題或摘要。
  • 如果網關不支持 web_search 工具，此插件無法工作。

總結¶

該插件通過複用現有密鑰和配置，簡化了在 DSH 中接入真實網絡搜索的流程。對於需要聯網能力的智能體開發，這是一個直接可用的方案。

更多詳情可參考：
* GitHub 倉庫：https://github.com/Joeytisaly/dsh-web-search-tokenrhythm
* 社區目錄：https://www.skillhub.cn/plugins/Joeytisaly/dsh-web-search-tokenrhythm