# hghub **Repository Path**: liyu2015/hghub ## Basic Information - **Project Name**: hghub - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-11 - **Last Updated**: 2026-11-11 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README *关于本项目:HGhub 只是我体验 Tuari2 移动端开发时做的小玩具,开源几天后不知为何收到了大量star。* *意识到可能存在的潜在危险后,我立刻更换了开源协议为 **PolyForm Noncommercial 1.0.0** ,并在 Readme 中写入了大量保护自己的文段。目前 HGhub收到的star实际上德不配位。* *在之后的更新中,我不再会维护任何获取上游数据的工作,维护方向将偏重于 UI/UX 与使用体验,同时仍会低频率的响应 PR 与 Issues。如果版权方或其授权代表认为本项目涉及其合法权益,欢迎通过 GitHub 仓库留言联系。收到明确的权利方通知后,我会第一时间积极响应,并根据对方诉求立即归档项目或将仓库转为私有,停止公开访问。*
# HGhub **黄果短剧第三方客户端 · Rust + Tauri 2** Windows / macOS / Android 三端 · Fluent 设计 · 沉浸式竖屏播放
> ⚠️ 本项目仅供 **学习与技术交流**,不提供、不存储、不分发任何音视频内容。 > 所有内容均来自第三方站点,版权归原作者与上游站点所有。 **使用须知** - **以访客身份正常使用**:像普通访客一样浏览就好,请勿滥用本项目。 - **不要给上游增加压力**:本项目本身不提供下载功能,请勿改动代码去做批量下载 / 批量抓取,也不要高频轮询、并发轰炸接口或挂机刷播放量;内置的封面与播放列表缓存请不要改小或关掉。 - **尊重上游版权**:不要去除水印与站点标识,不要把剧集搬运、转码、修改后二次分发到别处(网盘、资源站、其他 App 等),更不能改完拿出去出售。 - **不要公开传播接口与直链**:接口地址、播放直链、解密方式请勿公开张贴或打包成「资源站」——上游一旦封禁,所有人都没法再用。 - **不要商业化**:禁止打包出售、接入广告 / 会员 / 付费点播,或作为收费服务的一部分分发(详见 [LICENSE](LICENSE))。 - **合理使用**:仅供个人学习、研究与自用;请在 24 小时内删除相关资源,并支持正版。 - **遵守当地法律**:使用者应自行判断并承担合规责任。 > ⚖️ 许可证自 v1.1.0 版本起改为 **PolyForm Noncommercial 1.0.0**:**禁止任何商业用途**—— > 包括打包出售、接入付费/会员/广告变现、作为收费产品或服务的一部分分发。 > 个人学习、研究、自用与非营利使用不受限制,详见 [LICENSE](LICENSE)。 ## 官方渠道与仿冒提醒 - **唯一官方仓库**:[github.com/Minireel/HGhub](https://github.com/Minireel/HGhub) - **唯一下载渠道**:[GitHub Releases](https://github.com/Minireel/HGhub/releases)。仓库源码页不放任何可执行文件, 其余网站、网盘、QQ 群、公众号、第三方下载站分发的「HGhub」安装包**一律非官方**,作者不保证其安全性与完整性。 > 🚫 **已发现的恶意修改版**:[`hichuv/HGhub`](https://github.com/hichuv/HGhub) > > 该仓库与本项目无关,是在旧版本源码基础上擅自加入**卡密验证、VIP 付费解锁**等变现功能的修改版, > 代码改动不透明、安全性无法验证。**请勿下载、勿注册、勿付费**;如已安装,建议立即卸载,改用官方 Release 包安装。 > > 本项目**从未、也不会**加入任何卡密 / VIP / 付费解锁 / 广告功能。如果你遇到的「HGhub」要求输入卡密或付费开通,那一定不是官方版本。 ## 技术栈 | 层 | 选型 | | --- | --- | | 壳 | Tauri 2(Rust 1.90+) | | 前端 | React 19 + TypeScript + Vite 7 + Tailwind CSS 4 | | 播放 | hls.js(HLS / AES-128) | | 网络 | reqwest + rustls | ## 目录 ``` . ├─ src/ 前端 │ ├─ api.ts 接口封装 + 本地媒体协议 URL │ ├─ store.tsx 全局状态(导航栈 / 用户 / 本地收藏 / 主题) │ ├─ html.ts 吃瓜正文清洗与图片代理 │ ├─ components/ Feed(播放页)/ VideoSurface / PlayerControls / Panels / UI │ └─ pages/ Home / Search / Category / Profile / Posts ├─ src-tauri/ Rust 后端 │ └─ src/ │ ├─ net.rs 请求层(边缘信封 + 重试) │ ├─ api.rs 业务命令 │ ├─ media.rs 封面解密 + HLS 代理 + 缓存 │ └─ session.rs token 持久化 └─ docs/API.md 接口文档 ``` ## 开发 / 构建 ```bash pnpm install # 首次安装 pnpm app:dev # 桌面端热重载 pnpm app:build # 打包:Windows → NSIS 安装程序;macOS → .app + .dmg ``` macOS 先装 Xcode Command Line Tools(`xcode-select --install`),打包目标写在 `src-tauri/tauri.macos.conf.json`(`app` + `dmg`,窗口用系统标题栏 Overlay)。 Android(需 Android SDK + NDK,并配置 `ANDROID_HOME` / `NDK_HOME`): ```bash pnpm android:init # 首次生成 android 工程 pnpm android:dev # 真机 / 模拟器调试 pnpm android:build # 产出 APK ``` iOS(需 Xcode、xcodegen、CocoaPods 与 Apple 开发者账号;自行签名安装到自己的设备): ```bash export APPLE_DEVELOPMENT_TEAM=<你的 Team ID> pnpm tauri ios init --ci # 首次生成 Xcode 工程(src-tauri/gen/apple) pnpm tauri ios build --export-method debugging # 产出 src-tauri/gen/apple/build/arm64/HGhub.ipa xcrun devicectl device install app --device <解压后的 Payload/HGhub.app> ``` 最低系统版本写在 `src-tauri/tauri.ios.conf.json`(iOS 15)。iOS 复用安卓的触屏界面;自定义协议与 macOS 相同,为 `hg://localhost`。 ### 环境注意 - 工程若放在 **exFAT** 盘(不支持符号链接),需保留 `.npmrc` 中的 `node-linker=hoisted`。 - pnpm 10 靠 `package.json` 的 `pnpm.onlyBuiltDependencies` 放行 `esbuild`,否则 `vite build` 缺少二进制; pnpm 11 起该字段失效,白名单改在 `pnpm-workspace.yaml` 的 `allowBuilds`(两处都保留)。 ## 实现要点 「设置 → 播放 → 启动时静音」默认开启,每次启动应用均静音,播放时可手动开启声音。关闭此选项后,下次启动恢复上次的静音状态;音量仍会记忆。 安全加固后的正文处理、FakeIP/内网限制、账号线路隔离及本地回归方法,见 [客户端内容与网络安全](docs/security.md)。镜像线路仅支持游客浏览,跨站点切换和首次升级后需要重新登录。 Mihomo 与 sing-box 分流规则、已知域名统计及导入方法,见 [网络分流规则](rules/README.md)。 1. **统一边缘信封**:站点把 `/api/**` 收敛为 `POST /api/edge/request`(`method/path/body(base64)/content_type` + `Authorization: Bearer`),本项目只对接这一个入口,无需处理 Cookie。 2. **封面解密**:封面为 AES-128-CBC 密文,Rust 侧解密后经自定义协议输出,前端 `` 直接使用。 3. **HLS 代理**:m3u8 与分片经自定义协议转发并改写 `#EXT-X-KEY` / 分片地址,绕开 WebView 的 CORS 与防盗链。 4. **自定义协议**:Windows / Android 为 `http://hg.localhost/*`,macOS 为 `hg://localhost/*`(Tauri 的平台差异)。 Rust 侧 `lib.rs` 与前端 `api.ts` 各自按平台生成一次基址,两处必须一致,否则封面与视频全部加载失败。 5. **不做签名逆向**:只复用浏览器同源行为,接口字段均有文档与实测样本。 ## 免责声明 - 本项目与内容提供方无任何关联,作者不参与内容的制作、上传与分发。 - 本项目仅在上述官方渠道发布;任何第三方修改版(尤其是加卡密、VIP 变现的版本)均与作者无关,请自行甄别。 - 使用者应自行遵守所在地法律法规;因使用本项目产生的任何后果由使用者自行承担。 - 若相关权利方认为本项目存在侵权,请通过 Issue 联系,我们会及时处理。 ## License [PolyForm Noncommercial License 1.0.0](LICENSE) —— **仅限非商业用途**。 - **允许**:个人学习、研究、自用、爱好项目,以及在非营利组织内部使用;可以自由修改、二次开发。 - **禁止**:任何商业用途。包括但不限于打包出售、接入付费/会员/广告变现、作为收费服务或商业产品的一部分分发。 - **保留声明**:分发本项目或其修改版时,必须附带本许可证全文(或上面的链接)以及 `Required Notice` 声明行。 - 商业授权请通过 Issue 联系作者单独洽谈。 > 历史说明:v1.0.1 及更早版本以 MIT 发布,已发出的副本继续按 MIT 授权;自 **v1.1.0** 起的新版本一律适用 PolyForm Noncommercial 1.0.0。 ## 常见问题 **1. `pnpm install` 报 `ERR_PNPM_EISDIR ... symlink`** 工程放在 exFAT / FAT32 盘时无法创建符号链接,保留 `.npmrc` 里的 `node-linker=hoisted` 即可。 **2. `tauri android build` 报 `Failed to create a symbolic link ... jniLibs`** 同样是 exFAT 不支持符号链接。可手动把 Rust 产物拷进 jniLibs,再直接跑 Gradle: ```bash cp src-tauri/target/aarch64-linux-android/debug/libhuangguo_client_lib.so \ src-tauri/gen/android/app/src/main/jniLibs/arm64-v8a/ cd src-tauri/gen/android ./gradlew assembleDebug # Windows: gradlew.bat assembleDebug ``` 产物在 `src-tauri/gen/android/app/build/outputs/apk/`。 **3. Android 构建提示找不到 SDK / NDK** 需要设置 `ANDROID_HOME`(Android SDK 根目录)、`NDK_HOME`(`$ANDROID_HOME/ndk/<版本>`)与 `JAVA_HOME`(JDK 17)。 **4. macOS 打开时提示「已损坏」或「无法验证开发者」** Release 里的 dmg 没有用 Apple 开发者证书签名和公证,从网上下载后会被 Gatekeeper 拦下。 把 HGhub 拖进「应用程序」后,在终端执行一次: ```bash xattr -cr /Applications/HGhub.app ``` ## LinuxDO https://linux.do/