USER GUIDE
团影视使用说明
从下载安装到追番缓存，再到可选的专属后端与扫码登录，一份看懂团影视 App 的全部玩法。
1 下载与安装
团影视仅提供 Android 客户端，需 Android 7.0（API 24）及以上系统。
①前往
下载页，从
Gitee Releases 获取安装包，或按设备架构选择官方直链。
②普通手机选 Universal（兼容全部设备）或 arm64-v8a；旧设备选 armeabi-v7a；Chromebook / 模拟器选 x86_64。
③首次安装时，在系统弹窗中允许「未知来源」应用安装，完成后即可打开。
关于开源：团影视 App 端与后端代码均已开源，欢迎二次开发。源码见下载页「下载渠道」表中的 Gitee / GitHub 链接。
2 账号与登录
团影视支持两种使用方式：本地模式（免登录即可看片）与账号模式（注册后可同步追番、历史、评论等）。
注册 / 登录（本地）
- 在「我的」页选择注册，使用邮箱 + 密码创建账号，按提示完成邮箱验证。
- 登录后即可使用追番、观看历史、评论等账号相关功能（数据保存在本机）。
提示：本地账号数据仅存于当前设备；若要跨设备同步，请使用下方的专属后端模式。
3 专属后端模式（实验）
专属后端模式让你连接自建的后端服务，实现跨设备数据同步（追番、历史、评论、弹幕）与统一账号体系。该能力为实验特性，默认未开启。
如何开启
②填写后端服务地址（如 https://your-server/api/v1），打开开关。
③用后端账号（邮箱 + 密码）登录；登录后账号功能将自动走后端存储。
实验提示：后端模式需自行部署后端服务（已开源）。未配置后端时，App 以本地模式运行，功能不受影响。开启后端模式后，仅「后端模式 + 已登录」可见部分账号入口（如账号管理）。
4 扫码登录
扫码登录用于在后台管理页面免输密码登录：用已登录的手机 App「扫一扫」后台登录页上的二维码并确认即可。仅管理员账号可扫码登录后台。
完整闭环
①在后台登录页点击右上角二维码图标，页面切换为「扫码登录」面板并展示二维码。
②打开手机 App「我的 → 扫一扫」（需后端模式 + 已登录），扫描该二维码。
③App 端点击「确认登录」，后台页轮询到令牌后自动登录。
另一种用法
- App 端「登录」页也提供「扫码登录」入口，可让 App 出码，再用另一台已登录设备扫码确认。
- 非管理员账号扫码时会被拒绝并提示「需要管理员权限」。
5 在线观看
团影视接入数据源，使用原生播放器播放 HLS / m3u8 流，支持直播与点播。
发现内容
- 首页：推荐番剧与剧集（按 TV 番组 / 剧场番组 / 国漫专区分类）。
- 排期表：按星期查看每日更新。
- 排行榜：热门番剧榜单。
- 分类 / 搜索：按类型、地区筛选，或关键词搜索。
播放页
- 选集后进入播放页，可切换播放源与清晰度。
- 支持进度记忆、倍速、投屏等常见播放控制。
- 滑动进度条时弹幕会随之渲染定位。
6 弹幕
播放页支持弹幕显示与发送（需后端模式下的已登录账号）。
- 开启弹幕开关即可看到实时飘过的弹幕。
- 通过播放页底部的发送栏，选择颜色并输入内容，以当前播放位置为时间点发送；发送后会立即在本地显示。
7 追番与观看历史
- 追番：在番剧详情页点击「追番」，更新会在排期表与「我的」页集中展示。
- 观看历史：自动记录看过的剧集与进度，可在「我的 → 观看历史」继续观看。
- 后端模式下，追番与历史会随账号跨设备同步。
8 离线缓存下载
选集后可离线下载，缓存到本机随时随地观看，无需联网。
- 在剧集列表或播放页选择「下载」，任务在「下载」管理中查看进度。
- 缓存文件保存在本机存储，建议在 WiFi 环境下批量下载。
9 规则引擎与订阅源
团影视内置规则引擎，通过订阅源描述如何抓取与解析数据源，便于扩展内容来源。
- 规则支持 Jsoup / CSS 选择器 / 正则 / WebView 渲染等多种解析方式。
- 订阅源以
sub_<订阅ID>_<序号> 形式管理，可在数据源设置中导入与启用。
- 遇到带 JS 挑战 / WAF 的站点时，规则可借助 WebView 渲染后解析（失败时降级为空集合）。
进阶：规则与订阅属于自定义能力，普通用户可忽略；如需自建数据源，可参考开源仓库中的采集模块说明。
10 设置与个性化
- 开屏与主题：支持自定义专属开屏图；可在登录页右下角切换亮色 / 暗色主题。
- 新手引导：首次使用可跟随实验性的新手引导快速了解主要功能。
- 数据与隐私：「设置 → 数据」中管理后端模式、清除本地缓存等。
- 关于：查看版本、开源公告与反馈入口。
团影视 · 使用说明