StreamBox-APP

项目概述

StreamBox 是一款 Netflix 风格的跨平台流媒体播放器，对接 TVBox 生态片源，以电视、电视盒子和投影仪的遥控器操作为优先，同时适配桌面键鼠与手机触摸。仓库为 Monorepo，包含 Flutter 客户端与名为 Gateway 的 JAR Bridge 中间服务。它不内置片源，所有内容来自用户自行配置的第三方源。

为遥控器而生的流媒体界面，片源交给 TVBox 生态。

主要功能

• 沉浸首页：侧边导航、轮播推荐、继续观看与分类内容行，首页片源在设置中统一选择
• 聚合搜索：宽屏左侧搜索与历史、右侧结果网格，方向键移动时自动滚动并保留焦点
• 遥控播放：底部集中显示时间轴与常用操作，选集、线路与设置使用侧栏
• 片源管理：显示当前首页片源与搜索范围，按官方片源和自定义集合切换，支持一键启停
• 健康检测：最多 6 个片源并发检测、单源 12 秒超时，完成后自动补位并区分等待与检测中
• JAR 运行时：Gateway 通过配置发现手工配置的 JAR 片源，接口格式与苹果 CMS 完全兼容
• 远程配置：官方片源地址与顺序可在服务端维护，客户端启动后台同步并定时检查更新

适用人群

• 使用电视、电视盒子与投影仪的用户
• TVBox 生态的片源使用者
• 想在多端统一观看体验的观众

快速上手

1. 安装 Flutter SDK 与（可选）JDK 21，克隆仓库
2. 仅用 CMS 源：进入 client 执行 flutter pub get 后 flutter run -d macos
3. 需要 JAR 源：在 jar-bridge 执行 ./gradlew run 启动 Gateway，再启动客户端
4. 也可用根目录 ./dev.sh 一条命令同时拉起 Bridge 与客户端

核心优势

• 遥控优先：从布局到按键都围绕遥控器与方向键设计
• Gateway 可选：不部署 Bridge 也能直接使用 CMS 源
• 片源可远程维护：官方片源地址与顺序在服务端调整，客户端无需重装
• 网络失败有缓存：同步失败时继续使用本地缓存，自定义源不被清理

系统要求

项目	要求
客户端	Flutter SDK 3.11+、Dart SDK 3.11+、macOS 需 CocoaPods
JAR Bridge	JDK 21+
内容来源	用户自行配置的第三方片源

注意事项

• Gateway 不自带片源，需要自行准备 Spider JAR 并写入配置
• 官方片源配置入口使用 HTTP 明文传输，存在被篡改风险
• 仅作技术研究与学习用途，请确保所接入的内容源合法合规