前言¶
DeepSeek Harness (DSH) 的核心能力之一是聯網搜索，默認使用系統提供的通用 Web 搜索提供者。當需要更精細的抓取能力或應對單賬號的速率限制時，直接替換提供者往往意味着重構配置。dsh-web-search-firecrawl 插件提供了一個解決方案：它將 DSH 的 web.searchProvider 替換爲 Firecrawl 的 /v1/search 接口，同時保留原有的 fetchProvider: http，並內置了多賬號池的管理邏輯。
這是什麼¶
這是一個爲 DeepSeek Harness 設計的插件，由 aa2246740 維護。它的核心價值在於將官方的 Web 搜索能力遷移至 Firecrawl，並提供了一套多賬號調度策略。插件會自動註冊 id: firecrawl 的 WebSearchProvider，支持 round-robin（輪詢）和 least-loaded（最少負載）兩種調度模式。
核心功能¶
- 替換搜索提供者：激活時，插件會將官方的
web.searchProvider設爲firecrawl，並保留fetchProvider: http。 - 多賬號池調度：支持配置多個 Firecrawl API Key，通過指定的調度算法分配請求。
- 故障轉移與重試：遇到 429（Too Many Requests）或 5xx 服務器錯誤時，插件會自動切換到下一個健康的賬號（默認冷卻 60 秒）。
- 失敗診斷：對於不可重試的 4xx 錯誤，插件會立即失敗並明確指出是哪個賬號導致的錯誤。
安裝與啓用¶
本發佈包含編譯好的 lib/ 目錄，普通使用不需要進行本地構建或 clone 倉庫。
使用 CLI 安裝¶
在終端執行以下命令，將插件安裝到 web profile：
dsh plugin --profile web add github:aa2246740/dsh-firecrawl#v0.1.4
注意：這條命令僅寫入 web profile，不能修改 Desktop App 的 profile。如果已經運行了 Web Host，請重新打開該 Host 一次，再刷新網頁。
使用 Desktop App 安裝¶
在 DSH Studio 桌面應用中，依次打開 設置 → 插件 → 添加插件，在“包名或地址”中輸入：
github:aa2246740/dsh-firecrawl#v0.1.4
安裝完成後，若應用提示刷新或重新打開，請按提示完成。
配置與使用¶
安裝完成後，需要進行賬號配置並使用新會話。
- 添加賬號：打開 WebUI 側欄的 插件，找到已安裝的
dsh-web-search-firecrawl，點擊 配置。在配置界面添加至少一個 Firecrawl API Key（例如firecrawl.dev上的fc-...格式）。保存時，密鑰不會回顯；若需要改名，保留 key 字段爲空即可保留原 key。 - 暴露接口：使用一個新會話，以激活插件對
web_search的暴露。
注意事項¶
- Profile 限制：如前所述，CLI 命令只寫入
webprofile，不能修改 Desktop App profile。 - 文件結構：本發佈已包含
lib/，無需進行本地 clone 或 TypeScript 構建。 - 安全合規：請勿將 API Key 或 DSH home/profile 目錄提交到倉庫；使用 Firecrawl 服務時，請遵守其服務條款。
- 開機掛載：
dsh.bundle是系統開機捕獲的掛載點。不要手動往 profile 的cordis.patch.yml中手寫同一條insert配置，否則會導致重複掛載。
適用場景¶
該插件適合需要利用 Firecrawl 強大抓取能力的 DSH 用戶，特別是當單賬號存在速率限制或需要通過多賬號分擔負載時。
總結¶
dsh-web-search-firecrawl 爲 DeepSeek Harness 提供了標準化的多賬號 Firecrawl 搜索接入能力。通過簡單的 CLI 命令或桌面端安裝即可啓用，配合側欄配置即可完成多 Key 管理。更多細節與源碼請參考：
- GitHub 倉庫：https://github.com/aa2246740/dsh-firecrawl
- 插件目錄：https://www.skillhub.cn/plugins/aa2246740/dsh-firecrawl
