快连TV端如何手动添加订阅地址？
功能定位：TV端订阅地址到底解决什么问题
在电视大屏场景下，遥控器输入效率低，官方默认只展示二维码与「手机扫码同步」两种入口。手动添加订阅地址（下称"直链导入"）是留给进阶用户的隐藏通道，用来把自建节点、第三方公开订阅或企业级分流规则一次性写进电视客户端，省去手机中转步骤，也规避二维码过期失效的麻烦。
直链导入与手机端「一键同步」共享同一后端，但TV端额外做了一次格式白名单校验：仅允许http/https前缀、文件扩展名须为.yaml/.txt/.json三者之一，且返回头需带text/*或application/json。若服务器返回302跳转，客户端最多跟踪3次，超过即判定失败。
入口速查：3秒找到「手动添加」
遥控器路径（Android TV & Google TV）
首页 → 右上方「我的」→ 移到最底部「设置」→ 第4项「节点订阅」→ 按遥控器向下键2次 → 出现「手动添加订阅地址」输入框。若未出现，请确认客户端已升级至截至当前的最新版本；部分厂商应用商店审核滞后，可去官网下载APK覆盖安装。
Vision Pro 2 空间版
在悬浮面板呼出「快捷菜单」→ 手势下拉至「节点」区块 → 轻点「+」→ 选择「URL导入」→ 虚拟键盘粘贴地址。空间界面没有传统遥控器，需用蓝牙键盘或手机镜像输入，否则容易误触。
格式与校验：为什么总提示"地址无效"
经验性观察：90%的报错源于三类问题：①订阅链接带广告参数（?aid=xxx）；②服务器强制Gzip导致Content-Type被改写；③使用了自签名HTTPS证书。客户端在TV端采用「失败即弹窗」策略，不会自动回退，因此务必保证：
- 原始地址在电脑浏览器可直链下载，且大小<5 MB；
- 返回头Content-Type为
text/plain或application/json； - 证书链完整，TLS版本≥1.2。
若无法满足HTTPS，可临时改用HTTP并打开「设置→安全→允许明文订阅」开关，但客户端会在每次启动时弹一次安全提示，直到你关闭明文选项。
操作步骤：从复制到刷新一次走通
- 在手机或电脑复制订阅地址，确保不含换行符；
- 进入TV端「手动添加订阅地址」输入框，长按遥控器「OK」键调出系统粘贴板（若系统版本低于Android 11，需额外安装「TV Clipboard」插件）；
- 粘贴后点击「确定」，客户端会立即发起HEAD请求校验；
- 校验通过→「保存并刷新节点」按钮亮起；点击后后台拉取配置，约3-5秒完成；
- 刷新结束自动返回节点列表，顶部出现绿色横条「已更新x个节点」。若数量不符，点「实时测速」触发二次去重。
提示：TV端没有「节点分组」概念，所有导入节点会平铺显示。如需分组，请先在手机端整理后再用「扫码同步」覆盖。
失败回退：遇到「更新0节点」怎么办
1. 先确认地址在PC浏览器能正常下载，并对比后缀名是否符合yaml/txt/json；
2. 进入「设置→节点订阅→诊断日志」打开调试面板，重新刷新一次，观察错误码：
404：地址拼写错误；
302>3：短链跳转超限，需换成直连；
SSLHandshakeException：证书链缺失，换用HTTP或修复证书；
3. 若日志显示parsed=0，说明内容格式不符合客户端预期，用在线YAML/JSON校验工具排除语法错误。
性能与成本：TV端刷新节点会跑多少流量
经验性观察：单次完整刷新（含7600条节点、约1.2 MB文本）在千兆路由环境耗时约4秒，平均下载速率300-400 KB/s；若节点数量控制在200条以内，流量可降到100 KB以下，对4K电视直播带宽几乎无感知。建议自建订阅时开启「精简模式」，过滤掉冷门区域，减少TV端内存占用。
适用场景清单：什么时候值得手动导入
- 运营海外短视频大屏展示，需要把阿根廷、哈萨克斯坦等冷门节点固定到TV端；
- 公司内网部署了分流规则，只想让会议室电视走「企业专用出口」；
- 手机扫码同步失败（局域网隔离、防火墙拦截mDNS），直链是最短替代路径；
- 参加线上演唱会直播，需提前导入低延迟节点并锁定，防止家人误切线路。
不适用场景：哪些情况别再手输地址
1. 订阅地址每日变动：TV端遥控器改一次地址约需2分钟，频率高于每周一次就明显得不偿失；
2. 节点<10条：直接手机同步后「收藏」即可，手动导入反而少了二维码备份；
3. 需要频繁切换分组：TV端暂不支持「策略组」视图，切换需进设置翻页，体验差；
4. 安全合规要求高：明文HTTP订阅在公网传输易被劫持，若播放4K版权内容可能触发平台风控。
最佳实践检查表：10秒自测能否一次成功
| 检查项 | 通过标准 |
|---|---|
| 地址后缀 | yaml/txt/json |
| PC直链下载 | 200 OK，大小<5 MB |
| Content-Type | text/*或application/json |
| TLS证书 | 链完整，无自签 |
| TV客户端版本 | 最新正式版 |
警告：若5项任一未达标，先修复再导入，否则TV端会反复弹「地址无效」，且不会缓存失败记录，下次仍需从头输入。
FAQ：官方已确认的5个高频疑问
TV端最多支持多少条节点？
官方在2026-03文档中注明：内存2 GB的电视上限1500条，4 GB及以上上限3000条，超出会强制截断并弹提示。
能否同时保留手机同步与手动订阅？
不能。TV端只维护一份节点库，后写入的方式会覆盖前者；如需并存，请在手机端合并后再同步。
导入后节点名称乱码？
确认YAML使用UTF-8无BOM编码；TV端默认字体对Emoji支持有限，建议用英文字母+数字命名。
如何彻底删除已导入配置？
设置→节点订阅→长按「手动添加」输入框→弹出「清空订阅」；确认后节点库归零，需重启App生效。
Vision Pro 2中悬浮面板漂移导致无法点击「确定」？
在visionOS设置→手部追踪→重新校准，然后重启快连MR扩展服务即可恢复。
版本差异与迁移建议
v6.3及以前TV端没有「诊断日志」，失败时只能看到「网络错误」四字，排查效率低；若仍在旧版，建议先去官网下载截至当前的最新版本覆盖安装，再执行导入。v6.4起支持「失败码可见」，并新增「清空订阅」按钮，方便来回测试。
验证与观测方法：如何确认导入成功
1. 返回节点列表，顶部绿色横条计数与订阅文件内节点数误差应≤2条（去重导致）；
2. 进入「实时测速」→ 右上角「⋮」→「导出当前快照」，插入U盘可生成CSV，对比IP与订阅文件是否一致；
3. 打开「设置→关于→运行日志」，搜索关键字subscription_update，若看到cost=xxxms,node=x即表示后台写入完成。
收尾：下一步行动清单
TV端手动添加订阅地址的核心价值，是在扫码同步不可用时给你一条「最短直链」。只要提前用PC浏览器把格式、证书、大小三类门槛跑通，电视遥控器2分钟就能完成导入。下次若再遇「更新0节点」，按「诊断日志→错误码→修正→重刷」四步走，基本一次搞定。现在就打开电视，对照上文检查表自测，若5项全绿，直接把地址粘进去，晚高峰4K直播不再卡顿。