手机上刷短剧不痛快?1600 星项目把红果搬进电脑,还能存进 NAS
- 2026-11-20 06:39:43

先说一个狼狈的场景
你想追一部短剧。手机 APP 里刷到一半,切出去回个消息,回来发现要重新找。剧集列表在竖屏里一列一列滑,下载按钮藏在右上角。想在电脑上用大屏看,官网只有网页版;想把整部剧存下来慢慢看,APP 又不给导出。
于是就变成这样:一边用手机投屏看剧,一边在电脑上开一堆网页标签找片源链接,一边还得手动拼文件名。
jackotom 的 hongguo-drama 想做的就是这件事:把红果短剧做成一个真正的桌面应用,搜索、播放、下载、追剧、整部合并导出,再顺手支持把剧集存进 NAS。
仓库 2026 年 10 月 7 日建的,GPL-3.0,一个多月拿到约 1600 颗星、250 个 fork。最新正式版 7.5 在 2026 年 11 月 17 日公开。
它到底做了什么
技术栈是 Electron 44 加 React 18 加 Vite,Node 需要 22.12 以上。界面按 macOS 影音应用做的:浅暖灰侧栏、白色内容区,红色只用在选中态和主要按钮上。
功能面铺得很开,但主线只有两条。
一条是看。三来源搜索(仓库自述的三来源,文档里出现过红果、DramaBox、ReelShort),红果热播榜,复制分享链接或剧集 ID 直接解析,播放支持续看、后续两集预取、系统画中画、窗口内全屏和主窗口小窗,观看记录、追剧提醒、缓存清理、代理设置、软件更新提醒都在。
另一条是拿。选集下载有队列、有重试、能按剧筛选,能导出弹幕、评论、剧评,也能把同一剧的几集合并成一个文件。
真正见功夫的是取源这一步。红果的播放接口要签名,签到一次才拿得到真实媒体地址;有些片源用的还是 ByteVC2 这类编码,常规播放器解不开。仓库的做法是只在遇到 ByteVC2 时才转码:引入固定提交的 Librempeg(里面带 BVC2 解码器)把视频转成 H.264,音频原样保留,其它片源不碰。仓库留了一次实测记录:一集 1080P 的 ByteVC2,136.997 秒,转码花了约 18.2 秒。普通 HEVC 片源走原路径,不额外重编码。
最值得说的设计:它是按媒体库来存片的
下载到 NAS 这块,作者改了目录结构。
以前的做法是在你选的目录里再套一层"剧名加哈希"的文件夹,里面再来一层 Season 01,保存位置和你选的位置对不上。现在改成你选哪个目录就是哪个目录,视频和资料同层摆放:
├── poster.jpg
├── 简介.txt
├── tvshow.nfo
├── 剧名 S01E001.mp4
└── 剧名 S01E001.nfo
tvshow.nfo 和分集 NFO 是媒体库标准格式,Jellyfin、Emby、Infuse 这类工具扫一下就能认。验收记录里,两个真实下载的分集在目录里躺成 7 个文件,ffprobe 确认了视频轨和时长,封面是有效 JPEG。
一个诚实的边界是:它不碰 SMB,也不存你的 NAS 账号。你得先用系统把共享挂到电脑上,它再帮你往那个目录里写。Docker 那条线还提供了一套浏览器 Web 和 REST API,能在 NAS 上搜剧、批量下载、合并,用 Bearer 令牌鉴权,单任务队列,媒体地址只允许官方 CDN 逐跳校验。
上手其实很简单
它不是给终端敲命令的类型。去 Releases 页面下对应平台的包就行。
macOS 13 以上,Apple 芯片和 Intel 都有 DMG,拖进应用程序,签名、公证、装订都做完了。Windows x64 有安装版和便携 EXE。Linux x64 给的是 AppImage,赋个执行权限就能跑。
从 7.5 开始,作者把长期发行范围固定成四类产物:macOS 双架构、Windows x64、Linux x64 AppImage。Docker、Android 手机版和 TV 版不再跟着 Release 发,手机和 TV 版在仓库里指向另一个独立维护的项目。
数据都在应用自己的目录里,卸载重装不会丢观看记录。
需要审慎的地方
第一,能不能播不完全由它决定。7.3 和 7.4 那阵,Issue 里集中出现"无法获取片源",有用户写得很直白:7.2 能正常播放,7.3 和 7.4 全部取不到源。7.5 移植了纯 JavaScript 实现的 Android v5 签名和新的播放器请求协议来修,但作者在发行回执里写明,不能宣称上游故障已经根治。到现在还有一个 Issue 挂着:已下载的剧集被误判成本地文件丢失。
第二,没有中文字幕。仓库专门写了一份核实文档:DramaBox 官网这一轮直接返回 403,ReelShort 的分集页面里找不到独立的字幕轨道,那个 book_sub_title 字段只是给文案拼接用的。作者没有编一个字幕来源出来,也没有拿 AI 翻译顶上。
第三,打包和验收并不同步。Windows 的 EXE 没有签名,装的时候可能拦你一下;Intel Mac 只做了 Rosetta 启动验收;上游部分片源会 404、只给预览或者直接超时,作者也写在文档里了,不保证所有内容永远可播。
第四,它的自我限制很明确:只做红果公开可用的片源,不登录账号,不接别的来源,不绕过锁定、付费和区域限制;合并之后保留原始分集,没有删除接口。这些既是合规声明,也是能力上限。
小结
短剧正在从"手机竖屏随手刷"往外走。有人在电视上看,有人在 NAS 里建自己的剧库,有人在大屏上边看边整理素材。
hongguo-drama 没有把短剧做成另一种内容,它只是把一个本来锁在手机里的消费场景,搬到了更适合存放和整理的地方。对喜欢囤剧、喜欢折腾媒体库的人来说,这类项目比官方 APP 好用;对只是想随手刷两集的人来说,它有点重。
仓库地址:
https://github.com/jackotom/hongguo-drama