前言¶
DeepSeek Harness（DSH）採用插件化架構，智能體在調用 web_search 工具時需要配置相應的搜索後端。本插件旨在解決這一配置成本，它複用 WorkBuddy 桌面 App 的登錄態，將雲端 agentic 檢索能力接入 DSH 的 web_search 工具。用戶無需申請 API Key，也不需要安裝其他 DSH 插件即可直接使用搜索功能。
核心功能¶
本插件通過以下方式實現零配置接入：
* 複用登錄態：直接使用 WorkBuddy 桌面端的登錄狀態，無需額外的 API Key。
* 雲端檢索：調用 WorkBuddy 的雲端 agentic 檢索服務。
* 帶引用綜述：返回包含引用來源的綜述文本，便於覈查。
* 零硬依賴：純 ESM 模塊，無構建步驟，不依賴其他 DSH 插件即可完整工作。
* 安全設計：對憑據文件只讀，token 續期僅在內存中完成，不回寫磁盤，避免與其他插件衝突。
安裝與啓用¶
在安裝前，請確保滿足以下前置條件：
* 已安裝並登錄 WorkBuddy 桌面 App（國內版或國際版）。
* Node.js 版本 >= 20。
執行以下命令完成安裝：
dsh plugin --profile web add dsh-workbuddy-websearch
安裝完成後，重啓 DSH 即可生效。重啓後，模型在調用 web_search 時將自動走 WorkBuddy 的搜索接口。
典型用法¶
安裝並重啓 DSH 後，無需任何額外操作，直接在對話中發起搜索請求即可：
dsh --profile web "幫我搜一下最近的 XX 進展"
安裝成功後，可以通過以下命令覈驗配置是否生效：
dsh --profile web --dump-config | grep -i workbuddy-websearch
適用場景與注意¶
本插件主要適用於需要快速接入聯網搜索能力的 Windows/macOS 開發者。
功能限制¶
- 僅支持搜索：本插件僅提供
web_search（聯網搜索）功能，不提供web_fetch（抓取指定 URL）功能。 - 平臺限制：
- Windows x64（穩定）。
- macOS（實驗性）。
- 不支持：32 位 Windows、Linux、WSL、鴻蒙。
插件衝突¶
- 註冊 ID 唯一性：同一個搜索 provider id 只能有一個插件註冊。本插件註冊的 ID 爲
workbuddy-agentic。若同時安裝了註冊了相同 ID 的其他插件（如舊版本或 fork 版本），只有其中一個會生效，另一個會靜默不激活。
短結尾¶
該插件通過複用 WorkBuddy 桌面端的現有資源，爲 DSH 提供了無需額外配置的聯網搜索能力。適合希望在現有工作流中快速增加搜索功能的用戶。
