一款红果短剧跨平台桌面播放客户端（支持 macOS 与 Windows）。无需安装安卓模拟器，内置流媒体解密与本地代理，提供剧目检索、演员与作品浏览、沉浸式观影和本地进度记忆。
以下截图来自当前版本的实际运行界面，剧目、榜单排名和热度随来源更新。
竖屏视频按画幅适配播放区域，右侧可切换分集、查看评分与剧情摘要；底部提供进度、倍速、音量和全屏控制。
通过海报、集数、题材和简介浏览短剧，支持热门榜单、真人短剧、精品漫剧与 AI 短剧分类，也可直接搜索剧名。
点击播放侧栏的短剧信息，查看完整剧情、题材标签、评分及演职员表；有演员主页的条目可继续查看其作品。
按全部、男演员或女演员筛选榜单，查看演员排名、人气、名次变化与代表作品，点击卡片进入主页。
从演员简介和合作演员继续探索参演作品，点击海报即可播放；作品较多时可继续加载。
播放进度自动保存在本地，历史页标记已看集数，点击剧目可恢复观看；喜欢的短剧也可在播放页加入收藏。
- 🚀 免模拟器极速播放：直接在桌面端原生直连播放，告别笨重的安卓模拟器；
- 🎬 实时流式解密代理：内置基于 Spade-A 派生算法的 CENC-MP4 流式解密中间件，动态重写 MP4 容器（消除
sinf还原为avc1/hvc1），支持标准 HTTP Range 分片请求与 Seek 拖拽； - 🎞️ 分集选择与连续播放：通过匿名设备协议获取剧目分集，支持上一集、下一集及自动连播；实际内容可用性取决于来源与网络状态；
- ⚡ 按需读取与预加载：按播放器请求的 Range 范围读取并解密媒体，兼容路径支持并发分块下载；条件允许时预取下一集信息，减少连播等待；
- 🌟 剧星榜与演员主页：顶部「剧星榜」入口支持分页浏览演员排名与人气信息；点击演员查看简介、合作演员及参演短剧，作品列表可加载更多，点击作品即可进入播放；
- 📱 沉浸式影院视效：智能画幅自适应（横屏 16:9 / 竖屏 9:16 均按最大视口等比铺满），支持一键全屏、双击全屏、铺满模式与选集侧栏收展；
- ⌨️ 快捷键对齐移动端：
空格/K：播放 / 暂停↑/PageUp：上一集↓/PageDown：下一集←/→：快退 / 快进 5 秒F或双击画面：全屏切换
- 🕒 本地进度记忆与收藏：本地持久化保存每部短剧的观看历史、当前集数及精确秒数，支持继续播放与书架收藏；
- 🖥️ 跨平台原生桌面支持：同时支持 macOS（Apple Silicon 与 Intel 架构）及 Windows（x64），提供原生安装包及免安装便携版。
当前实现采用 Electron 桌面窗口 + Node.js / Express 本地服务 + Vue 界面，观看历史与收藏以本地 JSON 文件保存。早期方案中的 SwiftUI、AVPlayer 和 SQLite 选型不代表当前实现。
运行指南、实现记录与早期研究文档位于 docs/：
- 🚀 快速开始与安装指南
- 🛠️ 综合审查落实记录与实现边界
- 📐 产品设计与技术架构（早期方案）
- 🔍 参考项目架构解析：hongguo-player
- 🔍 参考项目架构解析：hongguo-drama
- 🧪 真机接口验证与方案报告
在本项目的设计与开发过程中，参考了社区中相关优秀开源项目的实践与研究：
zhangbaio/hongguo：红果短剧协议解析与媒体解密开源研究项目，提供了 CENC 解密与移动端协议处理参考；N3urda/hongguoTV/woshishiq1/drpys：开源短剧爬虫与算法派生实践，提供了基于 Spade-A 派生 AES 密钥的计算逻辑参考；jackotom/hongguo-drama：提供了 MP4 CENC 容器格式重写（消除sinf还原为avc1/hvc1）及媒体处理参考。
yangbin1322/hongguo-player：原第三方 macOS 客户端，提供了 9:16 沉浸式竖屏观影体验与原型交互参考。
- 学习与技术交流：本项目仅供个人学习、多媒体流处理与跨平台桌面应用开发技术交流研究，不用于任何商业用途。
- 参考开源项目：因可能存在版权风险，本项目的所有内容与实现逻辑均参考社区已开源的项目与公开网络技术资料。
- 内容来源与版权：所有短剧音视频数据与元信息均实时请求自公开网络服务，本项目不提供、不存储亦不分发任何音视频资源文件。请支持正版内容。
- 侵权与异议联系：本项目高度尊重原创内容与相关知识产权。对于可能存在的侵权行为，如果有人觉得不合适，请联系作者进行处理（可通过 GitHub 提交 Issue 或联系作者），作者将在核实后第一时间进行删除或修改。