前言¶
DeepSeek Harness (DSH) 的 ctx.web 插槽是智能體聯網能力的基礎。默認提供者可能無法滿足對搜索結果新鮮度或頁面抓取格式（如純 Markdown）的特定需求。dsh-firecrawl 插件通過註冊新的提供者，將 Firecrawl 的能力接入 DSH 的原生工具鏈，使 web_search 和 web_fetch 直接使用 Firecrawl 的接口。
插件定位¶
這是一個註冊兩個提供者（搜索和抓取）到 ctx.web 插槽的插件。它解決了通過 Firecrawl 進行網絡搜索（獲取新鮮來源）以及抓取任何頁面爲乾淨 Markdown 的問題。由 Lorodn4x 維護，許可證爲 MIT。
核心功能¶
- 註冊兩個提供者到
ctx.web插槽。 - 使原生工具
web_search和web_fetch通過 Firecrawl 工作。 - 搜索返回新鮮來源。
- 抓取任何頁面的乾淨 markdown。
安裝與啓用¶
使用以下命令將插件添加到配置文件：
dsh plugin --profile web add --save link:/путь/к/dsh-firecrawl
安裝後，需在配置文件中完成最後一步。將 "dsh-firecrawl" 添加到 dsh.profile.bundles 列表的最後（確保插件在 @deepseek-ai/dsh-web-app 之後應用）。在啓動配置文件前，將 API 密鑰放入 FIRECRAWL_API_KEY 環境變量（密鑰爲可選，但建議用於正式使用）。最後重啓配置文件以應用更改。
配置說明¶
插件支持通過環境變量配置 Firecrawl API。以下爲關鍵配置項：
| 鍵名 | 默認值 | 說明 |
|---|---|---|
apiKeyEnv |
FIRECRAWL_API_KEY |
存放密鑰的環境變量名 |
apiKey |
無 | 顯式傳入的密鑰（優先級高於 env），不要在公開補丁中保留字面密鑰 |
baseURL |
https://api.firecrawl.dev |
API 基礎地址，用於 self-hosted 場景 |
searchLimit |
8 |
單次搜索請求的來源數量 (1-20) |
timeoutMs |
60000 |
單次調用的超時時間 |
如果不提供密鑰，Firecrawl 會處理匿名流量，但會有較低的流量限制。
使用注意¶
- 提供者選擇：啓用後，搜索功能會通過 Firecrawl 進行。DeepSeek 提供者仍被註冊，但不會被選擇。
- PDF 支持：目前 PDF 頁面插槽不支持。
- 運行權限：插件以當前 DSH 進程權限運行。安裝前應檢查源碼與許可證。
結語¶
dsh-firecrawl 通過將 Firecrawl 的能力橋接到 ctx.web 插槽，簡化了集成流程。更多細節請參考目錄頁與 GitHub 倉庫。
- 目錄頁: https://www.skillhub.cn/plugins/Lorodn4x/dsh-firecrawl
- GitHub: https://github.com/Lorodn4x/dsh-firecrawl
