dsh-web-search-firecrawl

Readme

# dsh-web-search-firecrawl

```sh
dsh plugin --profile web add github:aa2246740/dsh-firecrawl
```

PATH 上要有官方 `dsh`（没有就用 `npx @deepseek-ai/dsh`）和 **pnpm**。`dsh plugin add` 会在 `$DSH_HOME/profiles/web` 里跑 pnpm。仓库已提交编译好的 `lib/`，git 安装不用 `prepare`，也不用改 profile 的 `allowBuilds`。

然后重启这个 Host，再刷新页面。`dsh plugin add` 只写 profile，不会热挂正在跑的进程。

给 DeepSeek Harness 的 `web_search` 换 Firecrawl，并带多账号池。包名仍是 `dsh-web-search-firecrawl`。仓库是 `dsh-firecrawl`。

在 `ctx.web` 上注册 `id: firecrawl` 的 `WebSearchProvider`，走 Firecrawl `/v1/search`。调度默认 `round-robin`，也可 `least-loaded`。`429` 或 `5xx` 切到下一个健康账号，默认冷却 60 秒。不可重试的 `4xx` 立刻失败并点名那个账号。

这个 bundle 会把官方 `web.searchProvider` 设成 `firecrawl`，并保留 `fetchProvider: http`。设置在 Settings → Plugins → Plugin configuration → **Firecrawl search**。

面向官方 DeepSeek Harness **0.1.5-rc.2**。

## 其它装法

本地目录或 tarball：

```sh
dsh plugin --profile web add ./dsh-firecrawl
dsh plugin --profile web add ./dsh-web-search-firecrawl-0.1.1.tgz
```

`dsh.bundle` 是开机捕获的。不要再往 profile 的 `cordis.patch.yml` 手写同一条 insert，会重复挂载。

```sh
dsh plugin --profile web remove dsh-web-search-firecrawl
```

## 使用

1. 打开 WebUI：Settings → Plugins → Plugin configuration → **Firecrawl search**。
2. 加至少一个 Firecrawl API key（[firecrawl.dev](https://firecrawl.dev) 的 `fc-...`），点 **保存**。密钥不会回显。改名时 key 留空表示保留原 key。
3. 用会暴露 `web_search` 的新会话。

激活时会把旧的按账号密钥迁进按账号 ID 索引的 secret dictionary。

## 许可

MIT。Firecrawl 服务用你自己的账号，遵守它的条款。不要把 API key 或 DSH home/profile 提交进这个仓库。