AfuseKt 手机端向 TV 端推送资源库配置步骤
为什么 TV 端不自己加资源库
AfuseKt 的设计哲学：手机端负责配置和刮削，TV 端负责浏览和播放。
原因：
- 电视端遥控器输入账号密码体验极差
- 刮削需要大量网络请求（TMDB API、AI 辅助等），在电视上做效率低
- 手机屏幕小但触屏输入方便，适合精细操作；电视屏幕大适合躺沙发上看
推送前的准备
手机端需要完成
- [x] AfuseKt 已安装并通过邮箱注册
- [x] PRO 版已购买并激活
- [x] 已添加好所有资源库（阿里云盘 / Alist / Emby 等）
- [x] 资源库已刮削完成，海报墙正常显示
- [x] 云同步开关已打开（设置 → 云同步）
TV 端需要完成
- [x] AfuseKtV 已正确安装（架构匹配）
- [x] 首次启动完成（显示"等待同步"界面）
- [x] TV 和手机在同一局域网（推送时同网络最稳）
推送步骤
方法一：手动推送（最常用）
- 手机端 AfuseKt → 侧栏 → 设置
- 找到"云同步"或"TV 端同步"入口
- 点击 "向 TV 端推送配置"
- 等待进度条走完（通常 1-3 分钟，取决于刮削数据量）
- TV 端收到推送 → 自动刷新 → 海报墙出现
方法二：自动推送（v3.x 新功能）
设置 → 云同步 → 开启 "改动后自动推送 TV 端"
之后每次你在手机端修改了什么（加资源库、刮削新内容、改设置），AfuseKt 自动后台推送，不用你手动点。
注意：自动推送只在手机处于联网状态时工作；如果手机离线，下次联网后推送。
方法三：扫码配对（更安全）
如果手动推送连不上（两端不在同一局域网），可以扫码：
- TV 端 AfuseKtV 显示等待同步时，屏幕上会显示一个二维码
- 手机端 AfuseKt → 设置 → 扫描 TV 二维码
- 手机扫完 → 两端自动配对 → 开始推送
推送了哪些数据
| 推送内容 | 说明 |
|---|---|
| 资源库配置 | 所有已添加的协议地址、Token、连接参数 |
| App 设置 | 播放核心偏好、字幕设置、界面主题、杜比策略等 |
| 刮削元数据 | TMDB 的海报、简介、评分、演员等 |
| 观看历史（PRO） | 最近看过的条目 |
| 收藏和评分 | 收藏的条目、给过的分数 |
不推送的内容：
- 视频文件本身（视频还在你的云盘 / NAS / 手机本地）
- 海报图缓存（TV 端自己从 TMDB 重新下载一次海报图）
- OpenSubtitles 账号密码（TV 端需要单独登录）
推送频率建议
| 场景 | 推送频率 | 方法 |
|---|---|---|
| 第一次配置 | 手动推一次 | 方法一 |
| 日常加资源 / 刮削 | 自动推送开着就行 | 方法二 |
| 改了播放设置 | 自动推送会覆盖 | 方法二 |
| TV 端换了 / 重置了 | 手动完整推一次 | 方法一 |
| 两端网络不在一起 | 扫码配对 | 方法三 |
推送失败怎么办
| 现象 | 可能原因 | 解决 |
|---|---|---|
| 找不到 TV 端 | 两端不在同一局域网；TV 端没启动 | 确认同 WiFi；TV 端保持 AfuseKtV 前台运行 |
| 推送进度卡到一半 | 网络不稳定 | 两端重启 App；重试 |
| TV 端收到但没刷新 | TV 端在后台 | 切到 TV 端前台；等 10 秒 |
| 推送后只有部分资源库 | 上次推送中途断了 | 在手机端点"重新推送全部" |
| 电视端提示 PRO 未授权 | 手机端 PRO 过期 / 没激活 | 在手机端验证 PRO 状态；重新购买 |
Trakt 和跨设备同步
AfuseKt 推送的是 AfuseKt 自己的配置。如果你同时开了 Trakt 同步，观看历史和进度由 Trakt 负责跨设备同步——即使不推送，只要两端都绑了同一个 Trakt 账号，观看进度也会同步。
最佳实践：PRO 云同步负责配置和刮削数据，Trakt 负责观看历史和进度，两者同时开是最完整的跨设备方案。