dsh-web-search-free

dsh-web-search-free

中文 | English

DeepSeek Harness (dsh) 的免费 Web Search / 网页抓取插件。它把 dsh 默认的 deepseek-official 通道换成多引擎 + 自动 fallback：按你排的顺序依次尝试已填 Key 的引擎，失败或额度用尽就换下一个；同一引擎可填多个 Key（每行一个），按序轮换。 不烧模型 token：直接调各引擎的检索端点，不经过任何 LLM。 装上即接管，卸载即回落：以 dsh bundle 层安装，无需手改 profile。 自带配置卡片：拖动排序、填 Key、测试 Key、查看用量，界面语言跟随 dsh。 请求只从宿主进程发出：浏览器侧只有配置卡片，不直接访问任何外部服务。 为什么是 "free"

官方通道 deepseek-official 的每次搜索都是一次完整的模型调用（带服务端 web_search 工具），搜索请求本身和回灌进上下文的 sources 都从 DEEPSEEK_API_KEY 余额扣 token。 如果你的对话模型走第三方渠道、没配 DEEPSEEK_API_KEY，官方通道仍会被选中，直到模型真正调用 web_search 才报 WEB_PROVIDER_CREDENTIAL_MISSING。本插件不依赖任何 LLM 凭据。 支持的引擎 表格顺序即默认调用顺序：按可持续免费次数从多到少（不限量 > 每日重置 > 每月重置 > 一次性），相当时注册/绑卡门槛低的优先。 抓取：只能搜索的引擎（✗）不参与抓取。没有可用的抓取引擎时，web_fetch 退回无 Key 的 Jina Reader 和 dsh 本地抓取（见高级设置）。 结果日期：决定模型能否判断时效。Brave 最全（实测 18/20）；Tavily 通用搜索不返回日期，Firecrawl、AnySearch 没有该字段。在意时效可把 Brave 往前挪。

各引擎注意事项 Jina：s.jina.ai 每次扣 1 万 token，约够 1,000 次搜索，用完不重置。 Exa：余额不清零，约 1,400 次基础搜索。 TinyFish：免费层 Search 30 次/分钟、Fetch 150 URL/分钟。 SearXNG：「Key」框填实例地址（如 https://searx.example.com），每行一个。实例需在 settings.yml 的 search.formats 里加上 json，否则返回 403。 百度千帆：Key 在百度智能云 API Key（V2）页面创建，旧版 AK/SK 不可用。只搜中文网页。 火山引擎：Key 来自联网搜索控制台的「API Key 管理」，火山方舟（Ark）的 Key 不可用。每月 1 日重置，只搜中文网页。

安装

前置条件：dsh ≥ 0.1.2-rc.1，pnpm 在 PATH 上。

在 dsh 界面里安装：侧边栏「插件」→ 右上角「添加插件」→ 输入 dsh-web-search-free → 「安装」。

或用命令行安装。配置卡片只在 Web 界面出现，因此一般装到 web profile：

安装后 dsh 自动对账 dsh.profile.bundles，插件即接管 web 搜索与抓取。 例外：如果 profile 的 cordis.patch.yml 里已经有一条 - id: web（打开过 dsh「插件 → 网页搜索 → 启用新版 Web 搜索 API」开关就会写入），它会覆盖插件的设置，插件装上了也不会被调用。插件会在日志和卡片顶部提示这种情况，处理方法见插件没有接管搜索。

从本地源码安装