功能定位：为什么需要“一键清理失效节点”
在kuailian（Kuailian）v8.4.0及之后版本，全球2300+节点每日动态上下线，手动剔除已宕机或高丢包节点既耗时又容易漏删。官方把“一键清理”入口放在节点管理→批量维护，核心逻辑是：先读取本地缓存的最后一次握手时间，再与云端心跳表比对，超过阈值（默认90 s无响应）即标为失效，最后一次性移除对应配置文件与路由表项。经验性观察：清理后首屏加载延迟平均下降约一档，后台保活耗电降低。
三步直达：各平台最短操作路径
Android / iOS
- 打开快连→右下角“我的”→节点管理→右上角┇→批量维护。
- 在“失效节点”页签点击扫描，等待进度圈走完（数十秒内）。
- 列表出现红色叹号节点→点底部一键清理→二次确认→完成，返回主界面。
Windows / macOS
- 任务栏图标右键→节点管理→顶部切换到维护模式。
- 左侧勾选仅显示失效→点击刷新心跳。
- 右侧出现灰色节点→下方批量删除→确认→配置自动重载，无需重启客户端。
Linux 命令行（headless）
执行后终端回显“Removed X nodes”。若需先预览，可去掉--apply，会列出待清理列表但不删除。
例外与取舍：哪些节点会被放过
一键清理默认跳过以下三类，避免误杀：
- 用户手动标记的收藏节点（星标），即使90 s无响应也会保留；
- 处于“专线模式”的节点，因IPLC链路可能主动关闭探测包；
- 近24 h内曾成功播放过流媒体（Netflix、Disney+）的节点，系统写入
last_media_ok标志。
如需强制删除，可在扫描前关闭“保留收藏”开关，但清理后若原收藏节点恢复在线，需要重新手动添加。
副作用与缓解方案
经验性观察：部分用户清理后首次重连耗时增加，因为本地缓存被清空，客户端需重新拉取全球拓扑。缓解办法是在设置→加速与缓存里把“预拉取节点拓扑”打开，Wi-Fi环境下会在后台静默更新，减少等待。
与第三方路由器的协同
若你在GL.iNet或华硕固件里导入快连订阅链接，清理失效节点后，需要手动点“更新订阅”才能同步删除。当前官方尚未开放路由器端的自动purge API，工作假设：未来版本可能提供?purge=stale参数，届时订阅链接将返回已过滤列表，可再观察。
故障排查：清理后仍显示“节点不存在”
| 现象 | 可能原因 | 验证步骤 | 处置 |
|---|---|---|---|
| 点击连接提示“节点不存在” | 本地缓存已删，但UI列表未刷新 | 下拉节点列表，看是否闪退 | 杀掉APP重进，或点刷新 |
| 清理按钮灰色不可点 | 当前无失效节点 | 切到“全部节点”页，看是否全绿 | 无需操作，或降低心跳阈值 |
| iOS 17.5清理后闪退 | 系统privacy tool配置残留 | 设置→通用→privacy tool与设备管理，看是否有多余描述文件 | 删除旧描述文件，重启手机再进APP |
适用/不适用场景清单
适用
- 节点数>50且每周更换出口的游戏直播团队；
- 使用Split-App 3.0分流，需要保持白名单节点高可用的跨境电商；
- 路由器固件订阅模式，定期做 housekeeping 的SOHO网络。
不适用
- 节点数<10，且全部已手动调优的个人用户，误删风险大于收益；
- 企业版合规通道，仅允许固定三出口，任何自动删除都会触发审计告警；
- 正在执行长任务（大文件上传、系统更新），清理会导致强制重连中断。
最佳实践检查表
- 清理前备份：在设置→配置管理→导出，保存
kuailian_backup.json到本地，误删可一键还原。 - 调整心跳阈值：若你常在弱网环境，把“失效判定”从90 s提到180 s，减少误判。
- 清理后测速：用内置网络诊断小部件跑三次Ping，确认剩余节点延迟<300 ms再开始游戏或会议。
- 定期而非频繁：建议每周一次，过于频繁会导致缓存反复重建，反而增加耗电。
验证与观测方法
想量化清理效果，可在清理前后记录以下指标：
- 节点列表数量：设置→关于→诊断信息，看
available_nodes数值； - 首屏握手耗时：打开APP→点连接→到“已连接”提示的秒表差；
- 后台耗电：系统电池统计，观察快连占比是否下降。
经验性观察：清理后首屏握手缩短约一档，后台耗电下降可见，但具体数值因机型与系统差异较大，建议以自身三次平均为准。
版本差异与迁移建议
v8.3及更早版本无“批量维护”入口，只能长按单条节点删除。若你仍在旧版，建议先导出节点列表，再升级到截至当前的最新版本，升级后旧收藏会自动继承，无需手动迁移。
FAQ（FAQPage Schema）
一键清理会把我的收藏节点删掉吗？
默认不会。系统会跳过带星标节点，除非你手动关闭“保留收藏”开关。
清理后节点数量没变怎么办？
说明当前无失效节点，或心跳阈值设置过短。可尝试把判定时间从90 s调到180 s再扫描。
路由器订阅什么时候能自动清理？
截至当前的最新版本，路由器端仍需手动点“更新订阅”。官方未公布自动purge时间表，建议每周手动更新一次。
总结与下一步行动
kuailian的“一键清理失效节点”把原本需要逐条长按的5分钟操作压缩到10秒，核心是“心跳阈值+收藏保护”两层过滤。对节点数多、出口频繁变化的进阶用户，每周清理一次可显著降低首屏延迟与后台耗电；但对节点数少或合规通道场景，误删风险反而更高，应谨慎开启。
下一步建议你：①升级到截至当前的最新版本；②首次使用前导出备份；③把心跳阈值调到适合自己网络环境的数值；④清理后用网络诊断小部件验证剩余节点质量。完成这四步，你就能在保持节点池干净的同时，避免误删带来的重连烦恼。