dsh-web-tools

dsh-web-tools

DeepSeek Harness 多搜索源 Web Search / Fetch 插件。

支持 Tavily、Exa、Firecrawl、Parallel、Brave、You.com、Jina 和 SearXNG，可配置搜索顺序、自动切换搜索源、多 API Key 和额度查看。

English | 简体中文

功能

• Tavily、Exa、Firecrawl、Parallel、Brave、You.com、Jina、SearXNG
• 自定义搜索顺序和 Provider fallback
• 每个 Provider 支持多个 API Key
• 额度、Key 状态和连接测试
• web_search / web_fetch 原生接入
• 会话级「联网搜索」开关
• 系统代理和自托管 SearXNG

插件不提供共享 Key 或中转服务，请求由本地 DSH 直接访问对应 Provider。

安装

dsh plugin --profile web add github:A3Boy/dsh-web-tools

重启 dsh web 后打开：

Settings → Web Search

更新：

dsh plugin --profile web update dsh-web-tools

移除：

dsh plugin --profile web remove dsh-web-tools

当前针对 DeepSeek Harness 0.1.0-rc.6 开发和测试。

Providers

Provider	Search	Fetch	Quota
Tavily	✅	✅	✅
Exa	✅	✅	—
Firecrawl	✅	✅	✅
Parallel	✅	✅	Dashboard only
Brave Search	✅	—	✅
You.com	✅	—	✅
Jina	✅	✅	Best effort
SearXNG	✅	—	Self-hosted

简单选型：

用途	可以先试
普通搜索	Tavily
语义 / 技术搜索	Exa
搜索 + 网页正文	Firecrawl / Parallel / Jina
常规 Web 搜索	Brave
Web / News	You.com
自托管	SearXNG

不需要全部配置。

只配置一个 Provider 就可以使用；配置多个后可以使用自动切换。

免费额度参考

Provider	免费额度 / 新用户额度
Tavily	1,000 credits / 月
Exa	注册送 $20 + 每月 $10
Firecrawl	1,000 credits / 月
Parallel	注册送最高 $80 + 每月 $5
Brave Search	每月 $5 credits
You.com	新账号 $100 credits
Jina	新 API Key 10M tokens
SearXNG	自托管，无平台额度

部分 Provider 的免费额度需要注册或绑定支付方式，具体以官方规则为准。

Parallel 和 You.com 另外提供免费 MCP Search，但本插件当前使用它们的 REST API，因此仍需要填写对应 API Key。

搜索顺序

可以自己安排搜索源顺序：

Tavily → Firecrawl → Exa → Parallel → Brave

第一项作为默认搜索源。

搜索链中的 Provider 可以拖动排序，也可以从搜索链移除。

移出搜索链不会删除 Provider 配置，仍然可以单独测试。

自动切换

如果当前 Provider 出现这些情况：

限流
超时
网络错误
服务异常
额度不足

插件会尝试下一家。

例如：

Tavily
   ↓ timeout
Firecrawl
   ↓
success

API Key 认证失败时，如果同一个 Provider 配置了多把 Key，会先尝试下一把可用 Key。

多 API Key

每个 Provider 可以配置多个 API Key：

Tavily
├── Key A
├── Key B
└── Key C

插件会自动选择可用 Key。

完整 API Key 不会返回给浏览器端，设置页只显示掩码信息。

Quota

当前额度支持：

Provider	额度
Tavily	✅
Firecrawl	✅
Brave	✅
You.com	✅
Jina	✅
Exa	—
Parallel	Dashboard only
SearXNG	Self-hosted

支持多 Key 的 Provider 会合并显示总额度。

例如：

Key A: 950 / 1000
Key B: 982 / 1000

Pool: 1932 / 2000

额度信息后台自动刷新，默认缓存时间为 5 分钟。

Brave 的额度来自 Search 返回的 X-RateLimit-* 信息，插件会保存最近一次查询结果。

Quota 只用于设置页显示，不影响正常搜索。

Test Search

设置页可以直接测试完整搜索链。

会显示：

• 最终使用的 Provider
• 搜索耗时
• 返回结果数量
• 每次尝试的 Provider
• 是否成功 / 超时 / 限流 / 认证失败
• 搜索结果

Test Search 和 Agent 实际使用的是同一条搜索链。

Web Fetch

支持正文读取的 Provider：

Tavily
Exa
Firecrawl
Parallel
Jina

因此可以：

web_search
    ↓
找到网页
    ↓
web_fetch
    ↓
读取正文

Search 和 Fetch 不要求使用同一家 Provider。

例如：

Brave Search
    ↓
Parallel Fetch

网络代理

支持：

HTTPS_PROXY
HTTP_PROXY
Windows 系统代理

以下本地地址默认不走代理：

localhost
127.0.0.1
::1
*.local

也支持 NO_PROXY。

SearXNG

SearXNG 不需要 API Key。

只需要填写自己的实例地址，例如：

http://127.0.0.1:8080

可以单独使用：

SearXNG

也可以放在 fallback 最后：

Tavily → Exa → Brave → SearXNG

页面语言

Web Search 页面支持：

跟随系统
中文
English

只修改这个插件页面，不影响 DSH 其他页面。

会话「联网搜索」

输入框左侧有一个「联网搜索」开关，点击即可开启或关闭，开启后会一直保持到再次点击。

• 关闭：让 AI 自己判断当前问题需不需要上网
• 开启：每轮回答前至少完成一次联网研究——用户给了具体 URL 时直接抓取该页面（web_fetch），否则先搜索（web_search）再按需抓取；联网无法完成时，会提示 Agent 明确说明哪些信息没有经过联网验证
• 状态跟着当前会话走：刷新页面、切换会话都不会丢失
• 当前没有可用搜索源（插件被禁用或没有任何一个搜索源可用）时，按钮会置灰
• 也可以用快捷命令 /search 一键切换同一个开关

这个功能和 8 个搜索源是配合的：开启后，搜索会按你配置的顺序自动切换可用的搜索源。

安全

• API Key 只在 DSH Host 侧使用
• 浏览器端不会拿到完整 API Key
• 日志不会输出完整 Key
• 请求不经过本项目的中转服务器
• 不上传搜索使用记录
• 可以只使用自托管 SearXNG

开发

安装依赖：

npm install

测试：

npm test

类型检查：

npx tsc -p tsconfig.json --noEmit
npx tsc -p tsconfig.client.json --noEmit

构建：

npm run build

改动 src/ 后请运行一次 npm run build，并把生成的 lib/ 产物一起提交。包没有 prepare 脚本，GitHub 安装会直接使用仓库里已提交的 lib/，因此源码与 lib/ 必须保持一致。

Provider Adapter 位于：

src/host/providers/

新增 Provider 可以参考现有实现。

更多开发说明见：

CONTRIBUTING.md

更新后还是旧版本？

如果更新插件并重启后仍然是旧代码，可以在 profile 目录重新安装依赖：

cd ~/.dsh/profiles/web
pnpm install

本地开发如果使用 file: 指向插件目录，可能会加载旧快照。

可以改用 link:。

Contributing

欢迎 Issue 和 Pull Request。

如果有新的 Search Provider 想接入，也欢迎提交。

License

MIT © A3Boy