写在排障之前

前四篇讲的都是「顺境」：界面怎么用、配置怎么改、应用怎么找回。这篇讲「逆境」——连不上、禁错了、升级后还原了、最坏情况下电视开不了机。

排障的第一原则先说清楚：大部分问题的答案，是按顺序核对几个检查点，而不是上来就动大手术。本篇按「连接 → 误禁用 → 开机异常 → 固件升级 → 最后手段」的顺序，把高频问题整理成问答形式。每条问题都给出「为什么」和「怎么办」，可以对照着一步步来。

连接类问题

Q1：工具突然连不上电视了，怎么办？

连不上是最常见的报错，九成出在三个检查点上，按顺序查：

1. IP 是否变了。电视的 IP 地址可能因路由器重新分配而变化。到电视的网络设置里查看当前 IP，和工具里填的对不对得上。对不上，改成新 IP 再连。
2. 电脑与电视是否在同一个 Wi-Fi。电脑连了 5G、电视留在 2.4G，或者电脑VPN、电脑网线走内网，都会导致「明明都开着网却连不上」。把两者拉到同一个网络里再试。
3. 无线调试是否还开着。如果清理工作已经做完、按建议关掉了无线调试并撤销了授权，工具自然连不上——这不是故障，是正常状态。需要时重新打开无线调试即可。

三个检查点走完还连不上，再考虑重启路由器和电视，让网络层彻底重置一次。连接问题的排查顺序永远是「先软后硬」：先核对地址和开关，最后才动设备。

Q2：电视上没弹出配对确认窗口

配对窗口只在无线调试刚打开、首次连接时出现。如果电视端没反应，依次确认：电视的无线调试确实处于开启状态、电视与电脑在同一网络、IP 填写正确。窗口弹出后要及时在电视上确认，超时会消失，重新触发连接即可。

Q3：清理完成之后，还要做什么？

收尾动作和第一篇讲过的一样重要：关闭无线调试并撤销授权。调试通道是留给维护用的，日常看电视用不到它。关掉它，既省一点系统开销，也少一个暴露面。等下次需要维护时再打开，授权是即时重建的，不影响任何既有配置。

误禁用与恢复

Q4：禁用某个应用后，电视出现异常了

先别慌，判断异常的表现：如果是某个功能打不开、某个入口消失，通常就是误禁了与之关联的应用。此时的正规恢复通道是 tools/restore.sh——它会依据改动前的记录，把你禁用过的东西恢复回去。

恢复前后的认知要对齐，这比操作本身更重要：

• restore.sh 恢复的是「你自己禁用过的东西」，依据是清理时保存的记录。
• 它不是时光机，不能撤销你做的无关修改（比如删过的东西、改过的设置）。
• 恢复记录不是完整的系统备份，别把它当系统镜像用。

Q5：恢复之后发现还有问题

如果 restore.sh 跑完仍有异常，多半是禁用清单里漏记了某项，或异常另有原因。此时按「症状—应用」的逻辑倒推：什么功能坏了，就去找提供这个功能的应用，在 App 资源库里确认它是否还在、是否被禁用。仍无法定位时，带上电视型号和现象描述到项目社区求助，比你反复试错高效得多。

开机异常与启动循环防护

Q6：电视卡在开机画面、反复重启，怎么办？

这是所有问题里最吓人的一种，但项目在机制上已经为它上了保险。电视能正常开机，依赖一组中间件软件包（系统底层服务）。如果这些核心包被禁用，电视就可能陷入「开机循环」（boot loop）。CleanYourTV 项目内置了 guard 保护：禁用清单会避开这些核心软件包，从机制上防止「误禁中间件导致开不了机」。

这不是纸上谈兵。项目历史上真实发生过海尔电视的 boot loop 案例（编号 #1578），社区据此完善了 guard 保护。换句话说，你现在享受到的「禁用不会让电视变砖」，是前人踩坑换来的。

如果不幸仍然遇到开机异常，处置顺序是：

1. 不要反复强制断电重启，先让电视自己完成一两次重启尝试，有时会自愈。
2. 确认无线调试通道是否可用，若可用，用工具连接后执行恢复。
3. 无线调试不可用时，按第 4 章讲的恢复路径处理，必要时参考社区针对该型号的案例。

Q7：guard 保护是万能的吗？

不是，也不该被当成万能。guard 保护核心软件包不被这个工具链误禁，但它拦不住你手动在系统里做的其他危险操作，也拦不住硬件故障和固件自身的问题。对它正确的期待是：正常使用 CleanYourTV，开机安全性有兜底；越出这个范围的操作，风险自担。

固件升级之后

Q8：电视升级固件后，之前的修改被还原了

电视固件升级有可能部分还原你对系统应用状态的修改——禁用被解除、首页设置变化，都是可能出现的情况。升级后不必逐项手动核对，用 tools/check.py 做体检：它会比对当前状态与记录，告诉你哪里变了。

核对之后，对需要恢复的项，用 check.py 的 --fix 参数恢复即可。建议把「升级后跑一次 check.py」固化为习惯：每次电视提示固件升级，升级完成、网络连通后，花两分钟核对一次，首页立刻回到你熟悉的样子。

最后手段：恢复出厂

Q9：所有办法都试过，还是不行

恢复出厂设置是清单上的最后手段，因为代价是彻底的一刀切：它会清掉一切修改——你的禁用状态、首页配置、主题、隐藏清单，全部回到出厂原点。CleanYourTV 带来的所有便利一并归零，需要从头走一遍安装和配置流程。

决定走这一步之前，确认三件事：

1. 前面的针对性手段（restore.sh、check.py --fix）都已尝试。
2. 社区里没有该型号的现成案例可以直接套用。
3. 你接受「全部重来」的时间成本，并已参考第 3 章的备份策略保存好关键记录。

如果三条都确认了，恢复出厂之后，按本书前面章节的流程重做一遍即可——流程本身就是为了「随时可以重来」而设计的。

排障速查

收尾的一句叮嘱：排障的胆子要分场景——连接问题大胆试，恢复操作按记录来，开机异常守住「不动核心包」的底线。这套工具链的设计哲学始终如一：把可逆的操作交给你，把不可逆的坑用机制挡掉。理解了这一点，日常使用就没有真正可怕的事故。

还有一条给「怕麻烦星人」的终极建议：把本书第 3 章的备份策略做实。出问题时，恢复的速度不取决于你多临危不乱，而取决于当初有没有留下记录。花十分钟做好的备份，会在某个深夜帮你省下一小时的抓狂——这笔账，怎么算都划算。