功能定位：为什么要在TV端做“节点快捷键”
Android TV 原生遥控器按键稀缺，方向键+确认+返回几乎就是全部交互。kuailian在 v5.3.1 把「AI 节点预诊」搬到电视端后，后台会在晚高峰提前 5 分钟自动切线，但大屏没有触控，想手动抢回主动权就得先下沉到「设置-节点列表-二级菜单」三步，既打断观影，也考验盲操记忆。官方为此开放「遥控器快捷键映射」：允许把任意节点或「智能加速」绑定到 Color 键、数字键 0-9 或播放/暂停长按，实现一键直达。核心收益是“把三次点击压缩成一次盲按”，在体育直播、云游戏、海外课堂三类高并发场景里，经验性观察可把切点耗时从平均 9-11 秒降到 3-4 秒，且无需起身找手机。
与手机端「Shortcuts」不同的是，TV 版快捷键完全离线生效：映射表写在本地 /data/data/com.kuailian.privacy tool/files/remote_keymap.json，即使 privacy tool 隧道尚未建立，也能先完成节点预热，降低握手延迟。该功能入口仅当检测到系统为「android.software.leanback」且版本≥Android 8.0 时才会出现，手机平板上即使侧载 APK 也看不到选项。
前置检查：版本、遥控与权限白名单
1. 版本号与渠道
截至当前的最新版本（2026-04-28 发布的 5.3.1）才带「遥控器快捷键」开关；若你通过当贝市场等第三方商店安装，可能仍停留在 5.2.x，需先到官网 apk 直链覆盖升级。升级后首次启动会弹《TV 端用户协议》，必须下拉到底并确认，否则功能入口被隐藏。
2. 遥控器按键兼容表
| 按键 | 系统事件 | 快连能否捕获 | 备注 |
|---|---|---|---|
| 数字 0-9 | KEYCODE_0…9 | ✅ | 推荐绑定常用节点，记忆负担最小 |
| Color 红/绿/黄/蓝 | KEYCODE_PROG_RED… | ✅ | 小米、索尼、雷鸟常见 |
| 播放/暂停 | KEYCODE_MEDIA_PLAY_PAUSE | ⚠️ | 需长按 1.2 s，与 Kodi 等冲突 |
| 语音键 | KEYCODE_SEARCH | ❌ | 系统独占，无法映射 |
3. 后台存活与 Suspend 白名单
Android TV 10+ 对后台 privacy tool 采用「Suspend 冻结」策略，若快连被系统挂起，快捷键会失效。进入 设置-应用-特殊应用访问-电池优化，把kuailian设为「不优化」；再在「设备偏好设置-节能待机」关闭「深度睡眠」。对于小米/当贝盒子，还需在「安全中心-自启动」手动勾选。验证方法：退出快连界面后，用 adb shell ps | grep kuailian 观察进程是否持续存在。
三步配置：最短可达路径（以索尼 X95K 为例）
- 打开kuailian-TV 版，按向下键选中侧边栏「设置」→「高级」→「遥控器快捷键」，按中心键进入。
- 在「可映射按键」列表里选中「红键」，界面提示「按下遥控器上要绑定的键」，此时按遥控红色按钮，屏幕会弹出「已捕获 KEYCODE_PROG_RED」。
- 紧接着进入「选择动作」界面，方向键切到「节点：日本 02 游戏专线」，确认后返回首页。此时屏幕右上角出现透明 Toast：「红键→日本 02」。
整个流程纯遥控完成，无需鼠标或手机扫码。若误绑定，可在同一入口选中按键后，底部会出现「清除映射」选项，确认即回退。
分支场景：没有 Color 键的遥控器怎么办？
天猫魔盒、早期小米 Stick 只提供方向+确认+返回，此时可用「数字键」替代：把「0」绑定到「智能加速」，「1-6」绑定到六大洲各一个常驻节点。记忆口诀「0 自动、1 北美、2 日本、3 香港、4 新加坡、5 欧洲、6 澳洲」。因数字键在 Leanback 桌面默认无系统功能，冲突概率最低。
提示
若遥控器为蓝牙语音款，数字键可能被长按呼出语音，可在「设置-遥控器与配件-按钮功能」把「长按数字」设为「无」，即可释放给快连。
验证与观测：怎么知道快捷键生效了？
1. 视觉层
成功触发后，屏幕右上角先弹出 1.5 s 透明 Toast，显示「正在连接：节点名」，随后主界面节点卡片左上角出现绿色「已连接」角标。若绑定的是「智能加速」，会额外显示「AI 预诊中…」转圈 0.8 秒。
2. 日志层（可复现）
adb shell logcat | grep Kuailianprivacy tool 可看到如下关键字：
RemoteKeyReceiver: red key captured, dispatch action=NODE_SWITCH:jp02 WireGuard: bringing up tunnel jp02 (UDP/51820)
若未出现 RemoteKeyReceiver 行，说明系统未把键事件派发给快连，需检查是否被其它应用抢占焦点。
副作用与边界：何时不该用？
- 观看 Netflix 时频繁切节点会触发其「位置变更」校验，导致正在播放的剧集强制退回详情页。经验性观察：两次切点间隔<90 秒极易复现。缓解办法：把「智能加速」绑定到按键，而非具体国家节点，让 AI 只在丢包>3% 时才跳。
- 多跳链路（4 级联）场景下，快捷键只切换最后一跳出口，前三跳仍保持旧线路，若你为了 Web3 空投需要整链换新，必须回到「设置-多跳」手动重建，快捷键无法一次完成。
- 遥控器红外键重复率偏高（老旧华为荣耀盒子），可能出现「一次按键触发两次」导致来回切换。可在「设置-高级-遥控器防抖」打开 300 ms 去抖，代价是连击响应变慢。
与第三方自动化协同：CLI 守护模式+红外转发
快连 5.3.1 桌面端已开放 REST 8945 端口，TV 端虽默认关闭，但可在「设置-实验室」打开「本地 RPC」开关，暴露 localhost:8946（仅监听 127.0.0.1）。配合 ADB 可推一条 JSON 指令完成切点：
adb shell curl -X POST 127.0.0.1:8946/switch \
-d '{"node":"jp02","reason":"remote_key"}'
若你已在路由器部署 Node-RED，可把红外转发器学习到的 Color 键事件转成 HTTP 请求，实现「遥控器→红外→Node-RED→ADB→快连」闭环，映射逻辑写在云端，随时改键而不动 TV。权限最小化原则：RPC 端口只接受本地回环，需借助 ADB 转发，避免把 8946 直接暴露在局域网。
故障排查：快捷键突然失灵怎么办？
| 现象 | 可能原因 | 验证步骤 | 处置 |
|---|---|---|---|
| 按红键无 Toast | 键被系统抢占 | logcat 无 RemoteKeyReceiver | 检查「按钮重映射」类应用，卸载或取消勾选红键 |
| Toast 后卡在「认证中」 | 节点临时下线 | 手机端同节点亦无法握手 | 等待 3 分钟或再按一次切换到备用节点 |
| 重启 TV 后映射消失 | /data 分区未挂载 | 查看 /sdcard/keymap_backup.json 是否存在 | 打开快连→设置→遥控器快捷键→右上角「恢复映射」 |
适用/不适用场景清单
推荐
- 晚高峰看 4K 体育直播，需秒切低延迟线路
- 云游戏排位，30 秒内完成跨洲匹配
- 海外课堂 Zoom 突然丢包，需要盲切稳定节点
不推荐
- 需要整链多跳刷新 IP 的 Web3 空投任务
- Netflix 同剧集连续切点（易触发位置校验）
- 红外遥控器老化、连击率>5% 的老盒子
最佳实践 5 条（检查表）
- 升级 5.3.1 并同意 TV 端协议，否则入口隐藏。
- 优先用数字键 0-6，减少与系统/视频应用冲突。
- 把「智能加速」而非具体国家绑定到最易按的键，降低流媒体封号风险。
- 打开「遥控器防抖」300 ms，老红外盒子必备。
- 每季度导出 keymap_backup.json 到 U 盘，防恢复出厂丢失。
FAQ（结构化数据，利于搜索引擎 FAQ Rich Snippet）
为什么我的遥控器没有 Color 键还能映射吗？
可以。用数字键 0-9 替代，系统冲突更少，记忆口诀见正文。
快捷键会不会被系统升级清空？
快连在 /sdcard 自动备份 keymap_backup.json，系统升级后打开应用会提示「恢复映射」。
映射后延迟能降多少？
经验性观察，可把切点耗时从 9-11 秒降到 3-4 秒，具体因节点状态而异。
收尾：下一步行动
Android TV 的大屏交互注定「能少按一次是一次」。把节点切换做成遥控器快捷键，看似小众，却是kuailian在 5.3.1 里对 TV 用户最实用的减法设计。今晚就升级，先给红键或数字 0 绑一个「智能加速」，看一场欧冠，体验卡顿前 5 分钟被 AI 悄悄修好的感觉。若你家盒子遥控器连数字键都缺，那就用 ADB+RPC 自己造一个，成本只是一条 curl 命令——性能与成本之间的取舍，永远留给愿意动手的人。
