
DeepSeek 官方搜索只认自家 key,一个人在第二天补上了这个洞:dsh-free-search 的 920 颗星从哪来
它是什么 给 DeepSeek Harness 用的免费搜索插件:替掉只认官方 key 的内置搜索,接了二十多个免费或付费引擎,一个挂了自动换下一个。
为什么火了 内置搜索只认 DeepSeek 官方 key,用网关、免费模型的人一搜就失败;它来得最早、更新最勤,成了插件目录搜索类第一,跟着 DSH 和「免 key 用 DSH」的风潮一起涨。
C你可以怎么跟 别在 DSH 搜索这一格里跟它抢;学打法:新平台开源后 48 小时内,补上「官方能力绑死自家账号」的缺口,做成零配置、自动回退,然后跟着平台每次更新。
- 数据(每天更新) · 建库 2026-08-14 · 974 星 · 7 天 +213
GitHub · 星数 数据 2026-10-09 → 2026-11-08(31 天,31 次观测)。10-28 以前的点来自 deeply / 存档补录,不是每天都有
DeepSeek 开源 DeepSeek Harness(DSH)的第二天,一个叫「暮迟」的开发者建了一个仓库,给它做免费搜索。84 天后,这个插件 GitHub 上 920 星、npm 一个月 9.3 万次下载,是 DSH 插件目录里搜索类的第一名。它没上过媒体,X 上没人提过。下面讲它怎么占住这个位置,以及你想让自己的开源项目拿到星,能从这里抄走什么。
一个余额为零的用户
2026 年 9 月 28 日,一位 Windows 上的 DSH 桌面端用户在 dsh-free-search 的仓库里开了一个 issue(#46)。他写得很直白:装了插件、配了 Bing,可模型调 web_search 的时候还是走 DeepSeek 官方搜索,「而我的 DeepSeek 余额为零,导致搜索直接失败」。他顺手翻了插件源码,定位到是哪几行判断没让插件接管,连修法都写好了。
这件事里有这个项目的全部答案。DSH 自带的 web_search 只认 DeepSeek 官方 API key;用网关、用第三方免费模型、或者余额用光了的人,一搜就失败,agent 会回一句「无法联网」。官方仓库的讨论区(Discussion #1715)里也有人报过同样的 401。dsh-free-search 的 README 开头就写这个场景:「没有(或不想用)DeepSeek 官方 key……那么内置搜索必然失败」。
它是什么
一个 DSH 插件(npm 包 dsh-free-search,MIT 协议,JavaScript)。装上之后,它替掉内置 web_search 的后端:默认走不要 key 的 DuckDuckGo、Bing、SearXNG,再加上 Exa、Tavily、Parallel、You.com 这些搜索厂商的匿名免费额度;从中国大陆出去默认用 Bing,其他地区默认用 Parallel;一个引擎挂了自动换下一个。你有 key 的话,它还能接 Perplexity、百度千帆、Kimi、阿里百炼、豆包、知乎。
后来它越长越大:网页设置页、一键测试所有引擎、按 key 冷却、web_fetch 抓网页正文、搜 GitHub / B 站 / V2EX / Reddit 的平台搜索,还有一键研究。从「一个免费搜索」变成了 DSH 的搜索全家桶。
作者 DDDMUC(暮迟),GitHub 账号 2024 年 7 月注册,只有这一个仓库,主页填的是对外经贸大学官网,关注者 15 人。看不出背后有公司或资源。
涨得怎么样
| 指标 | 数字 | 出处 |
|---|---|---|
| GitHub 星 | 10-17 442 → 11-06 920,20 天翻倍 | GitHub,每日记录 |
| 近 7 天 / 前 7 天新增星 | +207 / +143,单日最高 +37(11-06) | 同上 |
| npm 月下载 | 8 月 1.1 万、9 月 2.9 万、10 月 7.9 万 | npm 下载统计 |
| npm 日下载 | 10-09 约 2,500 → 10-30 以后 4,600–5,600 | 同上 |
| 在 DSH 插件目录的排名 | 有下载数据的 4,669 个插件里排第 26,搜索类第 1 | awesome-dsh-plugin,11-05 |
| 版本 | 08-15 首发,到 11-06 共 96 个版本,最新 0.9.33 | npm |
星还在加速,下载比星更说明问题:一个月 9 万多次(这里面有多少是 CI、镜像、自动更新,外面看不出,真实装机人数未知)。
用户从哪来
第一,DSH 本身。 DSH 是官方开源项目,约 27.4 万星,10-09 到 11-06 又涨了 2.7 万。DSH 0.2.1 起在「插件」页里内置了插件市场,社区目录 awesome-dsh-plugin 收录了 9,111 个插件;两边都按星数和下载量排序。排在前面的装的人多,装的人多星更多,搜索类第一会一直吸新用户。它 08-16 就被目录收录了。
第二,「免 key 用 DSH」的风潮(推断,时间线对得上)。 另一个插件 dsh-our-free-model(装上就能免费用 DeepSeek V4.1 Flash、Kimi K3)10-09 是 4,454 星,11-06 是 62,222 星。这批人手里没有官方 key,内置搜索一定失败。同一段时间,dsh-free-search 的日下载从约 2,500 翻到约 5,000。
第三,名字就是搜索词。 网页上搜「dsh-free-search」「DeepSeek Harness 免费 搜索 插件」,它都排第一;GitHub 上搜「dsh-search」排第二。
第四,一条 B 站视频。 《deep seek harness free web search plugin》,8 月 26 日发布,3 分 25 秒,约 4,400 播放,简介里放了仓库地址。是不是作者自己发的没核实。
第五,搜索厂商主动上门。 Parallel 的员工来提 PR 修 UA 和流式解析,You.com、Outcrawl、Serply 提 PR 把自家引擎接进来,一个叫 qikairo7 的用户一个人贡献了一键研究和垂直源搜索这些大块功能。几万次下载的入口,对搜索 API 厂商就是一个免费分发渠道,所以他们愿意出力;他们出力,插件就更全。
没找到的:X 大号提及(0 条)、媒体报道(知乎、凤凰网、QQ 新闻的「DSH 插件盘点」写的都是另一个搜索插件 ModSearch)、付费推广。README 里有一句常规的「如果这个插件帮到了你,欢迎给仓库点个 ⭐」。
为什么是它,不是别人
DSH 的搜索插件非常挤,GitHub 上搜得到几十个,绝大多数不到 100 星:
| 对手 | 规模 | 差在哪 |
|---|---|---|
| DSH 内置搜索 | 默认安装 | 只认 DeepSeek 官方 key |
| liustack/modsearch | 944 星,npm 30 天约 6 万 | 作者另有 4.8k 星的项目,媒体写的是它;但它是给各种 agent 用的通用搜索桥,不是 DSH 原生,下载比 dsh-free-search 少 |
| anysearch-dsh(厂商官方) | 681 星,npm 1.6 万 | 只有自家一个后端 |
| dsh-web-search-free、dsh-web-search-pro | 61 星、86 星,npm 各 6 千多 | 引擎少,更新慢 |
| 只接一家的插件(-exa、-brave、-tavily…) | 个位到十几星 | 那一家挂了就不能用 |
它赢在四件事,前两件最要紧:
- 早。 DSH 08-13 开源,它 08-14 建库、08-15 上 npm,赶上了第一波插件热和目录收录。
- 一直能用。 DSH 自己改 API 很勤(0.2.0-rc、0.2.1-rc 都动过搜索接口,仓库 issue #49、#80、#91、#107 都是这类),每改一次插件就要跟着修。它 84 天发了 96 个版本,10 月一个月 44 个;同类插件大多停在 8 月,用户自然流到它这里。
- 零配置。 装上就能用,按地区选默认引擎,失败自动回退。用户关心的只有一件事:能不能搜到。
- 排序机制赢家通吃。 一旦成了搜索类第一,目录和市场会替它持续拉新。
功能全是后来的事。最早起作用的就是「免 key、来得早、一直能用」;功能是用户和厂商往一个已经有人用的地方堆出来的,不是先有功能才有人用。也因为这样,功能本身很好抄,已经有人 fork 改名重新发:@copylee/dsh-free-search(30 天 1.1k 下载)、dsh-union-search(npm 描述直接写着「renamed from dsh-free-search」,3.4k 下载)。抄的人没抄走排名和更新节奏,所以都没起来。
如果是你
一句判断: 在 DSH 里再做一个搜索插件,没机会了;这个项目真正值得学的是打法——新平台开源,48 小时内补上官方默认能力和用户实际用法之间的缺口,然后比谁都勤地跟着平台更新。
适合谁: 手快、愿意天天盯一个新平台更新日志的个人开发者;能在平台开源当天读懂它的插件接口;最好本来就在用这个平台,自己先碰到那个坑。
不适合谁: 想在 DSH 搜索这一格里跟它正面抢的(第一名已经有 9 万月下载和厂商站队,fork 改名的都没起来);做完一版就不想管的(这类插件的命是跟着平台 API 改,停更一个月就掉队);想靠它赚钱的(开源插件图的是星和名气,这里没有收入)。
怎么做: 两条路。一是在 DSH 里找下一个同样的缺口:官方默认绑定了自家服务、而大量用户在用网关和免费模型的地方(搜索之外,看看抓取、语音、图片、记忆这些能力是不是也只认官方 key,推断),做一个装上就能用、带自动回退的替代品。二是等下一个大平台开源(新的 agent harness、新的编辑器插件体系),开源当天就去读它的插件接口,问一句「哪项内置能力是绑死官方账号的」,48 小时内发出第一版。名字直接用用户会搜的词,像 dsh-free-search 这样,一眼说清楚给谁、干什么、免费。
怎么拿到 star: 先进目录和插件市场,这是排序起点;README 第一屏写那个失败场景(「没有官方 key,内置搜索必然失败」),让碰到坑的人一眼认出来;到平台官方仓库里报同样问题的 issue、讨论帖下面留一句可用的解决办法;把搜索 API 这类厂商当成贡献者,给他们留接入的口子,他们会来提 PR,也会替你传播。
什么时候之前: DSH 这一波大约还在上升期(它一个月还涨 2.7 万星),想在 DSH 里找下一个缺口,越早越好;官方一旦把某项能力改成不绑 key,对应的缺口当天就没了。换平台的打法没有死线,但只有平台开源后头一两周有效。
什么情况说明看错了: ① DSH 官方让内置搜索支持任意模型和网关,dsh-free-search 的日下载跟着掉一半以上——说明它吃的是一次性缺口,不是长期需求;② DSH 星数增速明显放缓、插件市场下载停涨——这个生态里的位置就不值钱了;③ 某个大厂或知名作者发了一个 DSH 原生的同类插件,一个月内反超它的下载——说明「早 + 勤」挡不住名气,你也一样挡不住。
最后一句给所有做开源的人:平台越大,它留下的缺口越确定。真正的竞争不在功能,在于谁第一个到、谁一直在。
---
数据与出处:GitHub 仓库页与每日星数记录(10-17 到 11-06);npm registry 与下载统计(截至 11-05/11-06);awesome-dsh-plugin 目录(11-05 版);仓库 issue #46(09-28)、#86(10-19);DSH 官方仓库 Discussion #1715;B 站 BV1zA8f6gE9k;网页搜索结果(11-06)。下载数可能含自动化流量;「免 key 模型插件带来需求」是按时间线推断的。
研究底稿:竞品表、获客证据、完整研究报告
- 竞品
名字 在哪 上线 规模 它和这家不同在哪 DSH 内置 web-search-deepseek 大厂功能 2026-08-13 随 DSH 默认安装(DSH 约 27.4 万星) 只认 DeepSeek 官方 key,网关或免费模型下返回 401;它不要 key liustack/modsearch 开源 2026-02-22 944 星,npm 30 天约 6.1 万 跨 agent 的搜索桥,作者有 modlens 的名气,媒体盘点写的是它;dsh-free-search 是 DSH 原生 provider,中文引擎和设置页更全,下载量更高 anysearch-team/anysearch-dsh 开源 2026-08-13 681 星,npm 1.6 万 厂商官方插件,只有 AnySearch 一家后端;它把 AnySearch 当作众多引擎之一 MochiNek0/dsh-web-search-free 开源 2026-08-20 61 星,npm 6.8k 同样多引擎回退,但引擎少、迭代慢 anweat/dsh-web-search-pro 开源 2026-08-13 86 星,npm 6.4k 多引擎 + 缓存,维护和覆盖面不如它 单后端插件(dsh-web-search-exa / brave / searxng、dsh-tavily、dsh-bing-search 等) 开源 2026-08 中起 个位到十几星,npm 几百到 1.5k 只接一家,挂了就不能用;它会自动回退 - 用户从哪来
- 查实 DSH 平台生态 + 插件市场 / 目录排序:DSH 约 27.4 万星,dshmarket 30 天 npm 约 100 万下载;dsh-market 和 awesome-dsh-plugin 按星和下载排序,它 08-16 被收录,目前搜索类下载第一
- 推断 平台事件:免 key 模型插件带来搜索刚需:dsh-our-free-model 10-09 4,454 星 → 11-06 62,222 星,同期它的日下载约 2.5k → 5k;README 和官方 Discussion #1715 都写明没有官方 key 时 web_search 401
- 查实 名字即搜索词 / GitHub 与网页搜索:Jina 搜「dsh-free-search」「DeepSeek Harness 免费 搜索 插件」排第一;GitHub 搜 dsh-search 排第二
- 查实 B 站视频:BV1zA8f6gE9k(2026-08-26,约 4,430 播放),简介放了本仓库地址;作者身份未核实
- 查实 社区和搜索 API 厂商贡献:Parallel、You.com、Outcrawl、Serply 提 PR 接入自家引擎(#78 #90 #104 #105 #52);qikairo7 贡献 research、domain_search 等大块功能
- 查实 README 求星:README 写「如果这个插件帮到了你,欢迎给仓库点个 ⭐」
DDDMUC/dsh-free-search:为什么能跑出来
研究日期 2026-11-06。数据来源:我们的 github 库(repo_day / repo_profile)、GitHub API、npm registry 与 npm downloads API、awesome-dsh-plugin.com/plugins.json(2026-11-05 版)、Jina 搜索与网页正文、x-radar。
一句话
DeepSeek 官方 8 月 13 日开源的 DeepSeek Harness(DSH,约 27.4 万星)自带的 web_search 只认 DeepSeek 官方 API key;用网关、第三方免费模型的人一搜就 401。dsh-free-search 是这个空缺里最早、迭代最勤的补丁:装上就能用,不要 key,还把 27 个以上的搜索引擎接进同一套回退链。它的量跟着 DSH 生态和「免 key 用 DSH」的风潮一起涨。
1. 它是什么
- DSH 插件(npm 包
dsh-free-search,MIT,JavaScript),实现 DSH 的ctx.webWebSearchProvider seam,替掉内置web_search的后端。 - 默认免 key:DuckDuckGo / Bing / SearXNG / AnySearch,外加 Exa、Tavily、Keenable、Firecrawl、Parallel、You.com 这些厂商的匿名额度。中国大陆出口默认走 Bing,其他地区默认走 Parallel。配了 key 的话还能接 Perplexity、百度千帆、Kimi、阿里百炼、豆包、知乎、OpenAI/Gemini/Claude 内置搜索等。
- 后来又加了 auto 路由、multi 并发合并、按 key 冷却、多 key 轮换、网页设置页、web_fetch、platform_search(GitHub/B站/V2EX/Reddit…)、domain_search(41 个垂直源)和 research 一键研究,已经从「一个免费搜索」长成了「DSH 的搜索全家桶」。(README,GitHub)
- 作者「暮迟」(DDDMUC),China,主页填的是对外经贸大学官网,GitHub 关注者 15 人;GitHub 账号 2024-07 注册。个人开发者,看不出背后有公司或资源。
2. 增长数据
- GitHub 星:10-17 442 → 11-06 920(我们的库),20 天翻倍;近 7 天 +207,前 7 天 +143,单日最高 +37(11-06)。当天 GitHub API 现查是 942 星、58 fork。
- npm 下载(更接近真实使用):8 月 1.1 万、9 月 2.9 万、10 月 7.9 万;近 30 天(10-07~11-05)93,185 次。日下载从 10-09 的约 2,500 涨到 10-30 以后稳定在 4,600–5,600。(api.npmjs.org)
- 生态内排名:awesome-dsh-plugin 收录 9,111 个插件,其中 4,669 个有 npm 下载数据。按 30 天下载量,dsh-free-search 排第 26,搜索类第 1,高于 modsearch(5.8 万)和 AnySearch 官方插件(1.5 万)。
- 迭代速度:npm 84 天发了 96 个版本(10 月一个月 44 个),现在是 0.9.33;作者提交 230 次。100 多个 issue/PR,很多来自用户,也有搜索 API 厂商。
3. 竞品
DSH 搜索插件非常拥挤:GitHub 上搜「dsh search / dsh web search / dsh tavily / dsh searxng」能找到几十个,绝大多数不到 100 星。
| 竞品 | 形态 | 上线 | 规模 | 和它的差别 |
|---|---|---|---|---|
| DSH 内置 web-search-deepseek | 大厂功能 | 2026-08-13 随 DSH | 默认装 | 只认 DeepSeek 官方 key;走网关或免费模型就 401(官方仓库 Discussion #1715 原话) |
| liustack/modsearch | 开源 / npm | 2026-02-22(DSH 之前就有,给通用 coding agent 用) | 944 星,npm 30 天 6.1 万(npm API) / 5.8 万(目录) | 作者有 modlens(4.8k 星)的名气,知乎、QQ 新闻的「16 个超火 DSH 插件」写的是它;定位是跨 agent 的搜索桥,不是 DSH 原生 provider |
| anysearch-team/anysearch-dsh | 厂商官方插件 | 2026-08-13 | 681 星,npm 1.6 万 | 只推自家 AnySearch,一家后端 |
| @fffangchenghao/dsh-web-search | npm | — | npm 8.2k | 免 key 搜索 + fetch bundle |
| MochiNek0/dsh-web-search-free | 开源 | 2026-08-20 | 61 星,npm 6.8k | 名字几乎相同,引擎少,作者精力分在 dsh-desktop 上 |
| anweat/dsh-web-search-pro | 开源 | 2026-08-13 | 86 星,npm 6.4k | 多引擎 + 缓存 |
| 单后端插件(dsh-web-search-exa / -brave / -searxng / dsh-tavily / dsh-bing-search…) | 开源 | 8 月中起 | 个位到十几星,npm 几百到 1.5k | 只接一家 |
| dsh-search-failover / dsh-search-mcp 等 | 开源 | 8 月 | 个位星 | 思路一样(回退池),但没有持续维护 |
4. 增长手段(用户从哪来)
- DSH 生态本身是最大的流量来源(已证实)。DSH 是官方开源项目,约 27.4 万星,10-09 到 11-06 又涨了 2.7 万星;插件市场 dshmarket 30 天 npm 下载约 100 万。插件市场(dsh-market,DSH 0.2.1+ 内置在「插件」页)和 awesome-dsh-plugin 目录都按星数、npm 下载量排序,所以「星多 → 排前 → 装的人多 → 星更多」是一个自增强循环。它 08-16 被收录进目录,分类是 browser。
- 免 key 用 DSH 的风潮带来硬需求(推断,时间线吻合)。dsh-our-free-model(装上就能免费用 DeepSeek V4.1 Flash、Kimi K3,不要 key)10-09 是 4,454 星,11-06 到了 62,222 星。这批用户没有 DeepSeek 官方 key,内置搜索一定 401。同一段时间 dsh-free-search 的日下载从约 2,500 翻到约 5,000,星增速也在加快。README 开头写的正是这个场景:「没有官方 key / 用 opencode-go 这类网关……内置搜索必然失败」。
- 名字就是搜索词(已证实)。用 Jina 搜「dsh-free-search」「DeepSeek Harness 免费 搜索 插件」,它都排第一;在 GitHub 搜「dsh-search」,它排在市场插件之后的第二。
- B 站视频(已证实,规模小)。BV1zA8f6gE9k《deep seek harness free web search plugin》,2026-08-26 发布,3 分 25 秒,约 4,430 播放,简介里放了本仓库地址。是不是作者本人发的没核实。
- README 求星:「如果这个插件帮到了你,欢迎给仓库点个 ⭐」。这是常规做法。
- 社区和厂商贡献,让它变成搜索 API 的分发渠道(已证实)。Parallel 员工(georgeatparallel)提 PR 修 UA 和 SSE 解析;You.com(brainsparker)、Outcrawl(heydryft)、Serply 提 PR 把自家引擎加进去;qikairo7 一个人贡献了 research、domain_search、语言池等大块功能。厂商愿意免费出力,因为这里有几万次下载的入口,反过来让它的覆盖面越来越大。
- 没找到:X 大号提及(x-radar 搜「dsh-free-search」「DDDMUC」0 条)、媒体报道(凤凰网、知乎、腾讯云、cnblogs 的 DSH 插件盘点都没写它,写的是 ModSearch)、付费投放。
5. 为什么跑出来
- 官方留了一个必然出现的缺口:内置搜索绑定官方 key。DSH 用户越来越多地走网关或免费模型,搜索 401 成了人人都会碰到的问题(Discussion #1715、本仓库 issue #46、#86)。
- 来得早:DSH 开源后第二天(08-14)建库,第三天(08-15)上 npm,赶上了第一波插件热和目录收录。
- 零配置:装上就能用,地区自动选默认引擎,失败自动回退,「搜索永不直接失败」。这正好解决了用户最关心的「能不能用」。
- 维护强度远超同类:84 天 96 个版本。DSH 自己频繁改 API(0.2.0-rc、0.2.1-rc 移除 searchProviderId 等,见 issue #49、#80、#91、#107),每次都要跟着修;大部分同类插件停在 8 月,这家一直跟着升级,所以留住了用户。
- 赢家通吃的排序机制:插件市场和目录按星、下载排序,搜索类第一名会持续吸走新用户。
6. 差异化
相比内置搜索,它不要官方 key;相比单后端插件,它是「免 key 引擎 + 匿名额度 + 付费 key」一整套回退池,外加中文本地化(Bing zh-CN、百度、知乎、微信、头条);相比 modsearch,它是 DSH 原生 provider,有设置页、/free-search-engine 弹窗,中文用户体验更顺。不过这些差异化大部分是后来堆出来的,早期真正起作用的是「免 key + 早 + 一直能用」。功能越来越全,是因为用户和厂商都往这里堆东西;不是先有了功能才有了用户。差异化本身容易抄(已经有人 fork 改名),真正的护城河是排名和维护节奏。
7. 可见度与跟风
- 可见度:小圈子里在传。DSH 中文圈里知名度高(目录搜索类第一,有 B 站视频),但出了 DSH 生态几乎没人知道;没有媒体、没有 X 大号写过;它是免费插件,不涉及收入。
- 跟风:copylee711/dsh-free-search(GitHub fork,npm
@copylee/dsh-free-search,30 天 1.1k 下载);drscrewdriver/dsh-union-search(npm 描述原文「renamed from dsh-free-search」,3.4k 下载);delef/dsh-free-web-search、dsh-keyless-search、dsh-bing-search 等同名同思路的插件。
8. 别人能借鉴的
- 盯住新平台官方默认能力和用户实际用法之间的缺口(这里是:官方只认自家 key,用户却在用网关和免费模型),在平台开源后 48 小时内交付零配置的补丁,拿下目录里这一类的第一名。
- 「免 key 引擎 + 各家厂商匿名额度 + 自动回退」这套组合可以照搬到任何 agent harness(Claude Code、Codex、OpenCode、pi……),做成「给 agent 用的免密钥搜索」。
- 跟平台 API 变化的维护节奏本身就是护城河;把插件做成厂商愿意主动来接入的渠道,功能就会越来越全。
9. 不确定
- npm 下载里有多少是 CI、镜像、自动更新检查,不清楚;实际装机人数未知。
- 「dsh-our-free-model 带来需求」这条因果是从时间线推出来的,没有拿到 referral 数据。
- B 站视频的作者是谁,DSH 官方群、QQ 群里有没有推荐它,都没核实。
- 有没有变现(厂商分成、联盟)没看到;README 里没有赞助或推广位。