前言¶
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
