功能定位：订阅节点为何突然消失
kuailian（QuickLink privacy tool）的订阅节点列表本质上是把远端 YAML/Clash 格式文件缓存在本地 RAM-Only 数据库，并在每次「刷新订阅」时做差异合并。空白列表通常意味着缓存未能写入、解析失败或被合规策略过滤，而非节点本身丢失。
核心关键词「快连订阅节点导入后列表空白」在 8.3.1 版后出现的频率明显上升，主因是客户端新增「AI-Route 合规预检」——当节点描述字段命中当地敏感特征码时会被自动隐藏，UI 层表现为空白，但原始数据仍在缓存目录。
版本差异：8.3.1 与 8.2.x 的缓存逻辑变化
在 8.2.x 及更早版本，客户端采用「全量覆盖」：每次拉取新订阅直接替换旧库；8.3.1 起改为「增量合并 + 合规预检」。好处是减少 80% 流量，副作用是当远端首次返回空或字段异常，本地会留下 0 条可见记录，形成空白列表。
经验性观察：若你曾在 8.2.x 手动编辑过节点备注，升级后这些备注会被视为「不可合并字段」而触发隐藏逻辑；回退到 8.2.x 可立即恢复可见，但会丢失 AI-Route 节能特性。
操作路径：三平台的最短自救入口
Android
- 打开快连 → 底栏「节点」→ 右上角 ⋮ → 诊断工具 → 清除订阅缓存。
- 回到「节点」页 → 长按订阅卡片 → 刷新；若仍空白，点「导出日志」检查是否出现 "compliance_filter=1"。
- 若日志提示合规过滤，进入「设置-合规与隐私」关闭「AI-Route 预检」后重复步骤 2。
iOS
- 快连主界面 → 节点 → 下拉到底出现「缓存诊断」→ 点「清除缓存并重新拉取」。
- 若列表仍为空，转「系统设置-快捷指令」确认允许运行脚本后，再次下拉刷新。
- iOS 18.4 以上需额外在「隐私与安全-本地网络」给快连打开权限，否则拉取阶段直接超时。
Windows/macOS
- 顶部菜单「订阅」→ 诊断 → 清空缓存；或按 Ctrl+Shift+D 呼出调试窗口输入 clear_sub_cache。
- 若调试窗回显 "filter hit"，在「设置-高级」关闭「合规预检」开关后重新导入。
- 如仍失败，删除安装目录下 config/sub_cache.db 后重启客户端，系统会重建空库。
边界条件：哪些情况清缓存也无效
1. 远端订阅本身返回空文件或 403——可用浏览器验证订阅链接是否下载到 0 字节；2. 本地时间误差 >5 分钟导致 TLS 握手失败，日志里会提示 "cert verify err"；3. 公司/校园网络对 YAML 关键词进行 DPI 重置，表现为「下载成功但解析 0 条」。上述场景不属于客户端故障，需先修正网络或订阅源，再执行清除缓存步骤。
风险控制：关闭 AI-Route 预检的取舍
关闭后可立即恢复隐藏节点，但失去合规过滤，可能在极端地区触发运营商白名单重置，导致整段 IP 被限速。建议临时关闭恢复列表后，再手动删除有争议备注字段，然后重新开启预检。
验证与观测：如何确认已恢复
1. 节点页出现「上次更新：刚刚」且计数 >0；2. 调试窗输入 show_stats，回显 "visible_nodes" 与 "raw_nodes" 数量一致；3. 切换任意节点可正常握手，日志不再打印 "compliance_filter" 字样。经验性观察：恢复后首次测速可能偏高，因 AI-Route 需重新采样延迟，属正常现象，30 秒后会回落。
适用/不适用场景清单
| 场景 | 是否推荐清缓存 | 理由 |
|---|---|---|
| 个人订阅<200节点 | ✔ | 重建耗时低，收益高 |
| 企业审计环境 | ✘ | 清缓存会重置审计指纹，需报备 |
| 远端订阅每日变更大 | ✔ | 增量合并易出错，全量重建更稳 |
| 局域网共享旁路模式 | △ | 需先关闭强制隧道，否则重建过程会断流 |
最佳实践：避免再次空白的三条规则
- 订阅源使用 HTTPS 且域名备案合规，减少被中间设备重置概率。
- 在备注字段避免国家+城市+数字串写法（如 "US-NewYork-01"），改用友好名称 "NewYork A"，降低 AI-Route 误杀。
- 每月 1 次手动刷新+导出备份，文件保存到本地加密盘，即使远端异常也能秒速导入。
FAQ：快连订阅空白恢复常见疑问
Q1：清除缓存后节点依旧为0，一定是订阅源问题吗？
不一定。先检查本地时间、TLS 证书与网络是否重置 YAML 关键词；若日志出现 "filter hit"，则是合规预检过滤，需关闭 AI-Route 预检或修改备注字段。
Q2：iOS 快捷指令卡片提示失败，需要重装 App 吗？
无需重装。升级至 8.3.1 并在系统设置-快捷指令中打开「允许运行脚本」即可；若仍失败，检查本地网络权限是否被 iOS 18.4 关闭。
Q3：关闭 AI-Route 预检会被封号吗？
个人用户不会封号，但企业审计环境下会被标记为"合规未达标"，影响后续审计报告；建议仅临时关闭，完成备注修正后立即恢复。
Q4：旁路模式下清缓存导致打印机失联怎么办？
在「设置-国内绕行」添加打印机 IP 段（如 192.168.x.x）并关闭「强制全隧道」，重建缓存期间局域网设备不会断流。
Q5：能否彻底禁用增量合并回到 8.2.x 逻辑？
官方未提供开关；如需旧逻辑，只能回退客户端到 8.2.x 版本并关闭自动更新，但会丢失 AI-Route 节能与量子前向保密特性。
总结与下一步行动
快连订阅节点导入后列表空白，本质是缓存与合规预检冲突。先通过「诊断-清除缓存」快速自救，再依据日志判断是否关闭 AI-Route 预检，最后以备注字段规范+定期备份防止复发。
若你处在企业审计或旁路模式，务必在操作前备份 sub_cache.db 并通知合规团队。完成恢复后，建议每月手动刷新一次并导出节点快照，确保下次空白能在数十秒内回滚，而非重新排障。
