前言¶
在使用 Trae 積分或 WorkBuddy 積分配置 DeepSeek Harness(DSH)時,常見的問題是:模型對話功能正常,但 web_search 功能一直返回 401 錯誤。這是因爲 DSH 的內置搜索模塊只認 DEEPSEEK_API_KEY,而積分配置下並不存在這個 Key。
dsh-web-search-nokey 插件通過往 ctx.web 註冊一個無需憑據的 WebSearchProvider,將查詢請求直接轉發給公開搜索頁,從而修復了這個問題。
插件簡介¶
- 名稱:dsh-web-search-nokey
- 一句話:Keyless web search for DeepSeek Harness
- 作者:a1435473620
- 類別:聯網工具
- 許可證:MIT
核心功能¶
- 免 Key 搜索:無需配置 API Key,直接調用公開搜索接口。
- 修復 401 錯誤:專門解決 Trae / WorkBuddy 積分配置下
web_search返回 401 的問題。 - 多後端支持:使用 Bing RSS、Bing 網頁、360 搜索作爲搜索後端。
- 環境變量支持:支持通過
DSH_WEB_SEARCH_NOKEY_*前綴的環境變量配置各項參數。 - 代理支持:支持通過配置文件或環境變量設置代理。
安裝¶
使用 DSH 的插件命令安裝。安裝後直接生效,無需修改配置或重啓。
dsh plugin --profile web add github:a1435473620/dsh-web-search-nokey
安裝到 npm 後,也可以使用短名:
dsh plugin --profile web add dsh-web-search-nokey
卸載:
dsh plugin --profile web remove dsh-web-search-nokey
配置與使用¶
直接調用 web_search,請求會自動路由到此插件。
插件包內包含 cordis.patch.yml,用於將 web.searchProvider 寫死爲該插件,防止與 DSH 內置後端衝突導致搜索失效。
一般無需修改配置。如需調整,可編輯 profile 中的 cordis.patch.yml(或通過環境變量):
| 字段 | 默認值 | 說明 |
|---|---|---|
engines |
bing-rss, bing-html, so360 |
後端順序,即兜底順序 |
maxResults |
8 |
單次搜索結果上限 |
timeoutMs |
12000 |
單個上游請求超時時間 |
proxy |
空 | 需要代理時填寫,例如 http://127.0.0.1:7897 |
環境變量覆蓋格式爲 DSH_WEB_SEARCH_NOKEY_ 加上配置項名(例如 DSH_WEB_SEARCH_NOKEY_PROXY)。同時支持系統環境變量 HTTPS_PROXY / HTTP_PROXY。
注意事項¶
- 360 搜索特性:360 搜索結果爲跳轉殼,需點擊才能到達真實頁面,僅作爲兜底後端。
- 日期缺失:多數結果沒有發佈日期(Bing RSS 返回的是抓取時間而非發佈時間),舊頁面可能顯得很新。
- 限流風險:使用公開搜索頁,非官方 API,調用量過大可能被限流,日誌會記錄
engine=xxx failed並自動切換後端。 - 依賴零:無額外工具或 UI,不依賴任何外部庫。
結語¶
對於使用 Trae 或 WorkBuddy 積分的 DSH 用戶,這是解決 web_search 401 錯誤的實用方案。它不提供額外功能,專注於解決“無 Key 無法搜索”這一核心痛點。