别人都在做红果客户端,他做了一层 SDK:openhongguo 11 天 329 颗星怎么来的
它是什么 红果短剧的非官方 SDK:不用登录就能搜剧、拿播放地址,Go、Node、安卓、iOS、RN、Flutter 都能直接装。
为什么火了 红果第三方客户端潮证明了开发者想自己做,它是唯一能拿来就用的库;作者自己发帖投周刊,下游插件 dsh-hongguo 在 X 上 12 万浏览又把人引了回来。
B你可以怎么跟 抄打法,别抄位置:找下一个客户端扎堆、却没有可复用库的热点 App,做多端 SDK,照 linux.do 帖、周刊投稿、找人做好玩的下游作品这个顺序推。
- 数据(每天更新) · 建库 2026-10-26 · 372 星 · 7 天 +202
GitHub · 星数 数据 2026-10-28 → 2026-11-08(12 天,12 次观测)。10-28 以前的点来自 deeply / 存档补录,不是每天都有
红果短剧是抖音旗下的免费短剧 App。今年 9、10 月,GitHub 上冒出十几个「红果电脑版」「红果 TV 版」,最大的有 5,400 星。10 月 26 日,一个做过 2,800 星临时邮箱项目的开发者没再做一个客户端,他做的是一套谁都能 import 的 SDK。11 天后它有 329 星、93 个 fork,最大的一次涨星来自一个拿它做「Agent 干活时在侧边栏刷短剧」插件的人。这篇讲它怎么在一个挤满了的热点上找到空位,还有你想让自己的开源项目拿到星,能从这里学走什么。
「谁能拒绝在蹬的间隙来上一集红果呢」
11 月 5 日早上,PDM 的作者 frostming 在 X 上发了一条:「我宣布,DeepSeekHarness 比 pi 牛逼多了,谁能拒绝在蹬的间隙来上一集红果呢?严肃 cc @yihong0618」,配图是 DSH 右侧边栏里正在播的一部短剧。这条到 11-06 有 12 万浏览,底下有人回「建议上线老板识别模式」。
他做的插件叫 dsh-hongguo:Agent 跑任务的时候,输入框上方弹出提示,点剧名就开播,Agent 停下来自动暂停。插件 README 第二行写着:「数据来自 openhongguo」,装插件时 npm 会把 openhongguo 一起装上。
当天就有人跟着做了一个 LG 电视 webOS 版(那条帖子 6,000 多浏览)。openhongguo 的 npm 日下载从平时的每天几十次,11-04 涨到 220、11-05 到 309(npm 下载统计);GitHub 星 11-06 一天加了 63。
它是什么
一个 Go 写的红果短剧非官方 SDK,Apache-2.0 协议。用匿名设备发请求,不用登录,能浏览频道、搜剧、看热搜和排行榜、读分集列表,拿到各清晰度的播放地址和内容密钥。
卖点在「一套核心,六种语言」:Go 之外的版本都由同一份 Go 代码编出来——Node.js 用 WebAssembly,Android 和 iOS 用 gomobile,另有 React Native 和 Flutter 包,分别发到了 npm、Maven Central、SPM、pub.dev。Node 里五行代码就能从搜索走到播放地址。仓库还附了一个命令行 ohg,ohg play 剧名 直接调 mpv 播放。
作者 beilunyang,之前的项目 moemail(临时邮箱)有 2,836 星、2,604 fork,本来就有一批开发者认识他。
涨得怎么样
| 日期 | 星 | 当天发生了什么 |
|---|---|---|
| 10-26 | 建库 | npm 首发当天下载 306 次 |
| 10-27 | — | 作者在 linux.do 发开源推广帖 |
| 10-28 | 50 | |
| 10-30 | 72 | 阮一峰《科技爱好者周刊》417 期收录 |
| 10-31 | 148 | 单日 +76,观测期最大 |
| 11-03 | 223 | |
| 11-05 | 266 | frostming 的 X 帖 |
| 11-06 | 329 | +63 |
出处:GitHub 每日记录、npm 下载统计。近 7 天 +257。fork 93,fork/star 约 28%,同期新仓库的中位大约 11%——来的人很多是真拿去写代码的,不只是点个星。
星从哪来
第一,作者自己在 linux.do 发帖(10-27)。 标题直接写用途:「助力你开发自己的红果 App」。正文先列能做什么,再贴六种语言的安装命令和一段 Node 示例,最后一句「如果你用它做出了自己的红果短剧 App,或者有什么好玩的玩法,欢迎在帖子里晒出来」。59 个赞,当天几十条回复。这句邀请后来真的兑现了:11-04 有人在 linux.do 发帖说「用 openhongguo SDK 解决 90%」,做了一个网页大屏播放器。
第二,阮一峰周刊(10-30)。 作者自己去周刊仓库投稿,排在 417 期第 13 条。周刊周五发,第二天星从 72 跳到 148。同一天还有 zendot、bytesizego(写了一篇 Go 代码解读)这些站转载,这一跳具体有多少来自周刊,只能按时间推断。
第三,下游作品带量(11-05)。 就是开头那条帖子。DSH 插件这阵子正热,「Agent 干活时摸鱼」本身就是一个能转发的梗,而插件 README 把来源指回 openhongguo。11-06 的 +63 和这件事对得上,也是按时间推断。
没看到广告、买量或刷星的痕迹。整件事都在中文开发者的小圈子里:linux.do、阮一峰周刊、X 上 frostming 和 yihong0618 那一圈、几个 Telegram 频道,没有媒体报道。
为什么是它,不是那十几个客户端
红果第三方项目已经很挤了:
| 项目 | 形态 | 规模 |
|---|---|---|
| hongguo-desktop-releases | 闭源 Win/Mac/TV 客户端,只放安装包 | 5,416 星 |
| yangbin1322/hongguo-player | 电脑版安装包,没有源码 | 2,676 星 |
| 红果鉴 / 真果鉴(guoapp) | 私有客户端 | 1,684 / 891 星 |
| jackotom/hongguo-drama | 开源桌面应用(GPL) | 878 星 |
| aston314/hongguo-tv-releases | TV / webOS 安装包 | 838 星 |
| 各种下载器 | 只管下载解密 | 最多几百星 |
它们做的都是给看剧的人用的成品。9、10 月这一波一边证明了「在电脑、电视上看红果」有很多人想要,一边也证明了有很多开发者想自己做一个——可想做的人要么去拆别人的客户端,要么自己从头逆向。openhongguo 就补在这个位置上,到现在也没有第二个红果 SDK。
它能被拿去就用,还因为工程做得像个正经库:各包管理器都发了包,错误码、分页去重、自动换设备都封装好了,CI 里有接口契约检查。现在的开发者有 AI 帮忙,剩下那 10% 界面几天就能写完,dsh-hongguo 和 webOS 版都是这样冒出来的。别人每拿它做一个好玩的东西,就替它做一次宣传。
代价是天花板:看剧的人不会去给一个 SDK 点星,它的星比成品客户端低一个量级。
风险
它逆向的是字节的接口,还会拿内容密钥做解密。README 写了一大段免责声明,「禁止商业用途」「不得大规模采集」,可接口随时可能改,也可能收到 DMCA,哪天失效没人说得准。照着这条路做的项目,也要先想清楚这一点。
如果是你
一句判断: 「挤满了的热点往下做一层 SDK」这个打法能抄,红果这个位置已经有人占了;值得做,但星的天花板低,还得背着法律风险。
适合谁: 会逆向、会写跨端库的开发者;在 linux.do、V2EX、X 中文圈有点存在感、能自己发帖投稿的人。
不适合谁: 想要几千星的人(成品客户端才拿得到那个量级);不想碰版权和平台接口风险的人。
怎么做:
- 找下一个「第三方客户端已经扎堆、但没有可复用的库」的热点 App,标准是 GitHub 上同一个 App 冒出来五个以上客户端或下载器。然后做 SDK,不做客户端。
- 如果还想跟红果,做它没做的部分:比如把 openhongguo 包成 MCP 服务或 agent 工具、做 Python 版,或者干脆做一个最好玩的下游应用,拿星的会是你自己。
- 照它的做法发包:一份核心,用 gomobile / wasm 编到多端,每个包管理器都发,README 第一屏放五行能跑的示例。
怎么获客: 照它的顺序来。linux.do 开源推广帖,标题写「助力你做自己的 X」,结尾邀请大家晒作品 → 周五之前给阮一峰周刊投稿 → 自己或者找有名的开发者,拿它做一个能截图、能当梗转发的下游作品(插件、TV 版),README 里写明「数据来自 xxx」。
什么时候之前: 热点 App 的第三方潮通常只有一两个月,要在客户端扎堆之后、平台开始封接口之前发出去。拿红果来说,窗口大概就是现在。
什么情况说明看错了: 发出去两周 fork/star 还在 10% 上下,说明没人真拿它开发,开发者要的是成品;或者目标 App 的接口一个月里改了几次、下游项目纷纷失效,这层 SDK 就站不住了。
研究底稿:竞品表、获客证据、完整研究报告
- 竞品
名字 在哪 上线 规模 它和这家不同在哪 hongguo-desktop-releases 开源 2026-09-14 5416★ 闭源成品客户端,只发安装包,没有可复用的接口 yangbin1322/hongguo-player 开源 2026-09-29 2676★,7 天 +890 红果电脑版安装包,不含源码 guoapp(红果鉴/真果鉴) 开源 2026-09/10 1684★ + 891★ 私有短剧客户端成品 jackotom/hongguo-drama 开源 2026-10-07 878★ 开源桌面应用,接口没封装成库 aston314/hongguo-tv-releases 开源 2026-10-07 838★ TV/webOS 成品安装包 红果下载器们(zhangbaio/hongguo、parallelpan/hongguo-downloader 等) 开源 2026-10 几百★以内 只管下载解密,不是 SDK 穿山甲短剧内容 SDK 大厂功能 早已有 字节官方 B 端 要签约、面向商业 App;openhongguo 是匿名逆向的个人用途 GKD 规则 / Xposed 红果模块 Android 早已有 — 改官方 App 去广告,不是另起客户端 - 用户从哪来
- 查实 linux.do 开源推广帖(作者自发):2026-10-27 发帖「助力你开发自己的红果 App」,59 赞,linux.do/t/topic/3080753
- 查实 阮一峰科技爱好者周刊:第 417 期(10-30)第 13 条,作者投稿;第二天 star +76,是单日最大
- 查实 下游爆款插件 + X 大号:frostming 的 dsh-hongguo 用 openhongguo,11-05 X 帖 120.3K 浏览;之后有 webOS 版跟进;npm 下载 11-04/05 猛增
- 查实 聚合站 / 博客转载:zendot.org、bytesizego.com(10-30)、hotrepo、trendshift、Telegram yihong0618 频道
beilunyang/openhongguo:红果短剧的非官方匿名 SDK
调研日期 2026-11-06。数据来源:我们的 github 库(repo_profile / repo_day,10-28 起)、npm 下载 API、GitHub 原始 README、Jina/Exa 搜索与网页正文。
一句话
它是红果短剧(抖音旗下的免费短剧 App)的逆向 SDK:一套 Go 内核,编成 Node.js(wasm)、Android(gomobile)、iOS/macOS(SPM)、React Native、Flutter 六种包,用匿名设备、不用登录就能搜剧、看榜、列分集、拿播放地址和内容密钥,另附一个命令行 ohg。
结论
它没有自己去造新需求。它是两股已经在涨的潮里给开发者用的那一层底座:
- 红果第三方客户端潮。2026-09 到 10 月 GitHub 上冒出十几个「红果电脑版 / TV 版」客户端,大的已有几千 star。
- DeepSeek Harness(DSH)插件潮。
同类项目都是做成品客户端或下载器,它是唯一一个「多语言、能发包、匿名免登录」的 SDK,别人拿去就能几行代码做自己的红果 App。star 主要靠三件事:作者自己发帖(linux.do,10-27)、阮一峰周刊 417 期收录(10-30)、下游爆款插件 dsh-hongguo 带量(11-05,X 上 12 万浏览)。
增长数据
- star 曲线(github 库 repo_day):10-28 有 50 → 10-30 有 72 → 10-31 有 148(单日 +76,观测期最大) → 11-03 有 223 → 11-05 有 266 → 11-06 有 329(+63)。近 7 天 +257,fork 93(fork/star 约 28%)。没有可疑标记。
- npm
openhongguo每天下载量(api.npmjs.org):10-26 首发当天 306,之后每天 26–72;11-04 涨到 220,11-05 到 309,正好接上 dsh-hongguo 的发布和传播(这个插件用 npm 依赖 openhongguo)。react-native-openhongguo近 30 天 527。 - 建库 2026-10-26,v0.2.0;作者 beilunyang 的旧项目 moemail(临时邮箱)有 2836 star、2604 fork,本来就有开发者受众。
竞品 / 同类
| 名字 | 形态 | 上线 | 规模 | 和 openhongguo 的不同 |
|---|---|---|---|---|
| waligoraamodio288-rgb/hongguo-desktop-releases | 闭源客户端(Win/Mac/TV),只放安装包 | 2026-09-14 | 5416★(库里标「新号单库暴涨」) | 给终端用户的成品,没有可复用的接口 |
| yangbin1322/hongguo-player | 红果电脑版,只放安装包 | 2026-09-29 | 2676★,7 天 +890 | 同上,不含源码 |
| zhoufuweigg/guoapp、Xanerix/guoapp(红果鉴/真果鉴) | 私有短剧客户端 | 2026-09/10 | 1684★ / 891★ | 成品 App |
| jackotom/hongguo-drama | GPL 开源桌面版 | 2026-10-07 | 878★ | 开源但只是一个应用,要复用接口得自己拆 |
| aston314/hongguo-tv-releases | TV/webOS/桌面安装包 | 2026-10-07 | 838★ | 成品 |
| N3urda/hongguoTV | 安卓 TV 客户端、接口调研 | 2026-09-21 | 871★ | 单一平台 |
| zfdang Hongguo Open Player | Electron 开源播放器 | 约 2026-10-29(V2EX) | 未核实 | 成品;解密写在应用里 |
| zhangbaio/hongguo、zhenyong97/hongguo-downloader、parallelpan/hongguo-downloader(470★,10-31) | 下载器 | 2026-10 | 小 | 只管下载,不是 SDK |
| ucmao/media-parser | 多平台落地页解析 | 2025-12 | 460★ | 只解析推广页链接 |
| 穿山甲短剧内容 SDK(csjplatform) | 官方 B 端 SDK | 早已有 | 大厂 | 要签约、给 App 开发者分发内容;openhongguo 是匿名逆向的个人用途 |
| GKD 订阅规则、Xposed 模块 | 改官方 App(去广告) | 早已有 | — | 改官方客户端,不是另起一个 |
可以看出:做「红果客户端」的很多、已经很挤,做「SDK」的只有它一家。
用户从哪儿来(有证据的)
- linux.do 开源推广帖(作者自己发,2026-10-27):「助力你开发自己的红果 App」,59 赞,当天几十条回复。linux.do/t/topic/3080753 。正好对上 10-26/27 的首批 star 和 npm 的 306 次下载。
- 阮一峰《科技爱好者周刊》第 417 期(10-30 周五发布),第 13 条,作者自己投稿(ruanyf/weekly issue #12884)。github.com/ruanyf/weekly/blob/master/docs/issue-417.md 。第二天 10-31 的快照就是单日最大的 +76。
- 聚合站 / 博客被动转载:zendot.org(10-30,当时 103★)、bytesizego.com 的 Go 代码解读(10-30)、hotrepo.ai、trendshift、context7,还有 Telegram 频道「yihong0618 和朋友们」转发过(搜索摘要能看到,日期未核实)。
- 下游爆款带量:frostming(PDM 作者)做了 DSH 插件 dsh-hongguo,「Agent 干活时在侧边栏刷红果」。他 11-05 在 X 上发帖 cc @yihong0618,120.3K 浏览(https://x.com/frostming90/status/2118135104547782867)。插件 README 写明数据来自 openhongguo,npm 依赖也是它。后续:KAI(@lfk_dsk)当天跟了一个 LG webOS 版 hongguo-webos(6175 浏览);Cheery(@cheery9998)发了「AI 干活时摸鱼」的转帖;OKHK Telegram 频道、awesome-dsh-plugin 目录都收录了这个插件。对应的数据是 npm 11-04/05 下载猛增、11-06 的 star +63。
- linux.do 上的下游作品帖(11-04):「用 openhongguo SDK 解决 90%」,做了一个网页本地大屏播放。
没找到广告、买量、刷星的证据。
为什么跑出来
- 需求被验证过:9–10 月一波红果第三方客户端(5.4k、2.7k、1.7k star……)已经证明「大屏、电脑上看红果」有很多人想要,同时也证明开发者想自己做一个。openhongguo 做的是这些人共用的那层。
- 形态独一份:一套 Go 内核编成六个平台的包,都上了 npm / Maven Central / pub.dev / SPM,匿名免登录,错误码、分页去重、自动换设备都有。同类全是成品,没有能直接 import 的库。
- 工程质量能被 AI 时代的开发者马上用起来:下游帖子原话是「用 openhongguo SDK 解决 90%,自己用 AI 去做很简单」,dsh-hongguo 和 webOS 版都是几天内冒出来的。被别人拿去用,本身就是传播。
- 踩中 DSH 插件热:DSH 生态正火(主库 27 万 star,插件大量涌现),「Agent 干活时刷短剧」这个梗在 X 上自带传播,还把来源引回 openhongguo。
- 作者有阵地:moemail 2.8k star 的老作者,熟悉 linux.do 和阮一峰周刊的投稿路数。
差异化
同类都是「给看剧的人的成品客户端」,它是「给开发者的多语言 SDK」。差异化就是它跑出来的原因:star 和 fork 主要来自想自己动手做红果 App / 插件的开发者(fork 率 28%,远高于新库约 11% 的中位),下游作品又反过来给它带量。代价也在这里:star 规模比成品客户端小一个量级,普通用户不会给 SDK 点 star。
可见度
小圈子里在传:中文开发者圈(linux.do、阮一峰周刊、X 上的 frostming / yihong0618 圈、Telegram 频道)。没有主流媒体报道;329 star,还早期。
跟风者
还没有别的红果 SDK。有的是下游应用:frostming/dsh-hongguo、lfkdsk/hongguo-webos、linux.do 用户的网页播放器。
别人能借鉴的
- 在「成品客户端已经挤满」的热点上,往下做一层「多语言 SDK + 各包管理器都发包」,吃的是开发者流量,还能被下游作品反复引用。
- 一套 Go 内核用 gomobile / wasm 编成多端,让「六端一致」变成卖点。
- 发布顺序:linux.do 开源推广帖 → 阮一峰周刊投稿 → 等或者推动有名的开发者拿它做好玩的东西(插件、TV 版)。
还不确定的
- 法律风险:它逆向字节系接口,还拿内容密钥(CENC 解密),很可能被下线或接口失效;字节会不会发 DMCA,未知。
- 10-31 那次 +76 是周刊带来的还是 zendot / bytesizego 带来的,只能按时间推断;11-06 的 +63 也是按时间推断和 dsh-hongguo 有关。
- Hongguo Open Player 等其他客户端是不是也用了 openhongguo,未核实。
- 没能直接查 stargazers(GitHub API 当时限流)。