前言¶

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（最少负载）两种调度模式。

核心功能¶

1. 替换搜索提供者：激活时，插件会将官方的 web.searchProvider 设为 firecrawl，并保留 fetchProvider: http。
2. 多账号池调度：支持配置多个 Firecrawl API Key，通过指定的调度算法分配请求。
3. 故障转移与重试：遇到 429（Too Many Requests）或 5xx 服务器错误时，插件会自动切换到下一个健康的账号（默认冷却 60 秒）。
4. 失败诊断：对于不可重试的 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

安装完成后，若应用提示刷新或重新打开，请按提示完成。

配置与使用¶

安装完成后，需要进行账号配置并使用新会话。

1. 添加账号：打开 WebUI 侧栏的 插件，找到已安装的 dsh-web-search-firecrawl，点击 配置。在配置界面添加至少一个 Firecrawl API Key（例如 firecrawl.dev 上的 fc-... 格式）。保存时，密钥不会回显；若需要改名，保留 key 字段为空即可保留原 key。
2. 暴露接口：使用一个新会话，以激活插件对 web_search 的暴露。

注意事项¶

• Profile 限制：如前所述，CLI 命令只写入 web profile，不能修改 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