前言¶
DeepSeek Harness (dsh) 通過 web_search 工具爲模型提供聯網能力，後端選擇通過 ctx.web 接口決定。默認情況下，搜索行爲可能依賴內置端點。vincibeans/dsh-web-search-anysearch 插件爲 dsh 註冊了一個名爲 anysearch 的 WebSearchProvider。當選擇該後端時，它會調用 POST https://api.anysearch.com/v1/search；當未選擇時，它會委託給官方 DeepSeek 搜索端點。該插件允許用戶直接在 dsh 的插件設置卡片中切換這兩個後端，並支持通過環境變量或 YAML 配置文件進行管理。
安裝¶
使用官方命令將插件添加到 web 配置文件中：
dsh plugin --profile web add @wenqi_bian/dsh-web-search-anysearch@alpha
安裝完成後，需要重啓 dsh web，因爲 profile bundles 和瀏覽器端在啓動時讀取。如需在重啓前檢查配置樹，可使用：
dsh --profile web --dump-config
使用方法¶
安裝並重啓後，可以通過以下方式啓用或切換搜索後端：
- 打開 Settings -> Plugins ->
@wenqi_bian/dsh-web-search-anysearch。 - 在開關中選擇 AnySearch 或 official DeepSeek search。
- 保存設置。下次
web_search調用將使用所選的後端，無需重啓進程。
其他配置方式¶
除了 GUI 操作，還支持以下方式：
* 環境變量：設置 DSH_WEB_SEARCH_PROVIDER=anysearch 後啓動 dsh。
* YAML 補丁：在 profiles/web/cordis.patch.yml 中配置 searchProvider 爲 anysearch。
AnySearch 支持匿名訪問。若需提高速率限制，可在設置卡中填寫 API key，它會存儲在憑證域中；或者手動在 ANYSEARCH_API_KEY 引用下配置。
配置項說明¶
插件提供以下配置項（默認值）：
| 配置鍵 | 控制項 | 默認值 | 說明 |
|---|---|---|---|
searchProvider |
後端切換 | anysearch |
決定下一次 web_search 的後端，可選 anysearch 或 deepseek-official。 |
apiKeyEnv |
API key 字段 | ANYSEARCH_API_KEY |
卡片存儲密鑰的引用名稱，每次搜索時解析。 |
apiKey |
unset | 手動寫入配置的密鑰，優先級高於環境變量引用。 | |
baseURL |
端點字段 | https://api.anysearch.com |
AnySearch 基礎地址，/v1/search 會自動拼接。 |
憑證域的解析順序爲：$DSH_HOME/.credentials.yaml -> $DSH_HOME/.env -> 繼承的環境變量。若兩個字段都未設置，則進行匿名搜索。
限制與注意事項¶
- 版本要求：需要 dsh >= v0.1.5-alpha.1。
- 搜索範圍：僅支持一般搜索，不支持垂直領域（如
finance.quote）。 - 官方後端：切換回官方後端時，需要配置
DEEPSEEK_API_KEY或使用 DeepSeek 賬號登錄（dsh 0.2.0 及以後）。 - API Key 安全：API key 字段爲只寫，已存儲的密鑰不會在界面上回顯。移除密鑰需在憑證存儲中手動處理。
- 數據信任：查詢結果發送至
https://api.anysearch.com或配置的端點，請將搜索結果視爲不可信的外部數據。 - GUI 顯示：插件配置頁僅在 Web GUI 組合瀏覽器端且 bundle 列入 profile 時顯示；Headless 配置文件模式下功能完整。
