ARTICLE · 1373239
HGhub源码回来了,这次变成了插件播放器
点进 HGhub 的 GitHub 仓库,现在看到的项目介绍,已经变成了通用视频播放器。
这和最近流传的“黄果短剧 APP 开源了”,有了很大的距离。
我把原作者公告、当前代码说明和开发文档对了一遍。截至 11 月 16 日,这个项目已经重新公开源码,转向由用户自行导入 JavaScript 插件的播放器。它不内置内容源,也不提供官方内容源列表。
如果还按“拿到源码,装好就能刷剧”来理解它,第一步就会碰壁。
对想研究跨端应用的人来说,这次变化倒更值得看。一个原本和具体站点联系紧密的客户端,开始把界面、播放和内容来源拆开。拆到哪里了,又有哪些事情还没做完?
◆代码曾被清空,现在有了新版本
先把最容易混淆的身份说清楚。
HGhub 是个人维护的第三方项目。维护者此前在公告中否认了“员工离职开源”的说法,也说明与相关官方团队没有雇佣或合作关系。因此,把它写成黄果官方 APP 公开源码,会让读者认错项目。
原作者确实曾清空代码、Release 和构建记录。但当前仓库已经有了新的客户端源码和开发文档,11 月 15 日的提交说明也明确记录了插件播放器源码的公开。
所以,“已经清空,只剩停更公告”描述的是此前的状态。今天再介绍,就得把后续补上。
当前首页将插件版标为早期开发阶段,重点完善 Windows 和 Android,其他平台仍在适配和验证。想了解它,先看新 README 和支持状态,再决定要不要折腾历史副本。
◆装上播放器,内容从哪里来
新版把内容来源交给了插件。
用户可以在插件中心导入文件、粘贴代码,或者填写插件及插件列表的网址。移动端的入口放在“我的”里面。应用本身无需注册 HGhub 账号,某个来源需要登录,再由对应插件提供入口。
播放器负责统一展示搜索、详情、分集和播放界面,也管理本地收藏、观看历史与续播进度。插件负责向它提供站点数据。
这里有个很实在的变化。客户端可以继续改界面和播放体验,某个来源的数据适配则由对应插件处理。维护者同时写明,不维护或分发第三方内容插件,也不承诺第三方站点持续可用。
安装成功,只说明播放器在;能看到什么、能否登录、评论和互动是否可用,还要看装了什么插件。

按当前协议整理的职责示意,具体实现范围以项目支持状态为准。
◆前端写界面,Rust 管宿主
它的技术组合仍然是 Rust、Tauri 2、React 和 TypeScript。
Tauri 的官方架构文档解释了这种搭配。界面运行在 WebView 中,前端通过命令与 Rust 侧通信,系统能力和原生逻辑放在另一侧。写过网页的人,可以沿用前端工具完成界面,但仍要处理原生层和不同系统的条件。
HGhub 在这之上加了插件宿主。
按当前 HPP 协议草案,插件只返回结构化数据,界面由应用统一绘制。插件需要表单时,也由宿主负责呈现。这样一来,不同来源可以共用一套页面,某项能力没有实现,对应入口就收起。
插件交付为一个自包含的 JavaScript 文件,通过宿主提供的接口处理网络和存储。协议还要求插件只在被调用时执行,每个插件使用独立运行时,并设置超时和内存限制。
这套设计有明确的分工,但别把隔离理解成内容可信。协议没有插件签名和审核机制,也不承诺替用户担保第三方插件。尤其涉及账号的插件,要知道它由谁提供、会把信息发到哪里。
◆写了五个平台,离全部好用还有多远
项目文档里最值得认真读的一页,是当前支持状态。
11 月 15 日的审计记录写着,应用版本为 0.0.1,协议为 1.0.0-dev。它仍处于开发初期,不能据此宣称五个平台都已经完整验证。
导入、订阅更新、网络与存储、MP4/HLS 等能力,已有不同范围的实现和回归记录。但设备能力探测、外部播放流等项目尚缺,跨端和后台行为也没有完成验证。
文档给出的设备证据包括 Android 插件导入和单部真实 MP4 播放。这个结果很具体,证明的范围也有限。它不能顺手扩大成所有来源、所有格式、所有手机都能稳定播放。
项目自己的浏览器测试使用真实 Rust/QuickJS 与生产 React,媒体由本地合成。这能检查不少流程,却仍然需要和原生窗口、真实站点、设备解码分开看。
做客户端的人应该很熟悉这种差别。搜索结果出来了,下一步还要看详情;播放地址拿到了,下一步还要看解码。返回、切集、拖动和重新进入应用,也各有自己的问题。
◆想学它,从自己的测试视频开始
如果目的是研究插件开发,我建议先用仓库里的虚构示例。
官方入门教程提供了一个单文件插件,可以验证安装、搜索和详情。完整示例还允许填写自己控制的 HTTPS MP4 地址,用来检查播放。你可以先用有权使用的测试视频,把这条过程走通。
这样排错会清楚得多。搜索和详情不对,检查字段映射;到了播放再失败,就继续看资源对象、请求环境和设备端结果。先减少外部站点的变化,才能看清应用自身的问题。
想改客户端,再看开发指南要求的 Node.js 22、pnpm 10、Rust 1.90 或更高版本,以及对应系统的 SDK 和工具链。macOS、Android 和 iOS 各有平台条件,装好前端依赖只完成了其中一段。
还有一件事要在复用前看清。当前源码采用 PolyForm Noncommercial 1.0.0,项目声明禁止商业用途,并明确不提供商业授权。源码可以阅读,能否用于自己的产品,要回到具体许可证判断;外部内容和服务的授权还需单独确认。
我更愿意把现在的 HGhub 当成一个正在重构的跨端播放器项目来读。它的价值,落在界面怎样复用、插件怎样接入、播放怎样验证这些具体问题上。
如果你准备打开仓库,先读 README,再读支持状态,最后用自己的测试视频走一次插件流程。
看完这三处,再决定它值不值得花下一个小时。















































































