功能定位：订阅同步到底在做什么
在快连 privacy tool 里，"订阅"本质是一段 HTTPS 短链，客户端每隔 15 分钟拉取一次节点索引文件，本地解析后写入缓存数据库。若服务器临时重置、短链 Token 变更或本地缓存损坏，就会出现"导入成功但节点列表为空"的现象。重新同步就是强制丢弃旧缓存、重新走一遍"拉取-校验-写入"流程，与"刷新"不同，它会清空旧指纹，避免脏数据残留。
前置检查：先确认空列表并非筛选器导致
不少用户把"节点为空"与"节点被隐藏"混淆。进入【设置】→【节点显示】，关闭"仅显示游戏节点""仅显示 4K 节点"等开关；若列表瞬间恢复，则无需同步，只需调整筛选规则即可。
重新同步的三条官方路径（分平台最短入口）
Android / iOS
- 首页右上角⋯→【订阅管理】→长按空白订阅→【重新同步】，等待 Toast 提示"已更新 X 条线路"。
- 若长按无反应，说明缓存数据库被锁，可点击底部【强制清空缓存】，再退回首页下拉刷新。
Windows / macOS
- 左侧边栏【订阅】→选中空白订阅→右侧齿轮→【Re-sync】；界面右下角会弹出同步日志，显示 HTTP 200 即成功。
- 若日志报 403，则 Token 失效，需点击【编辑】替换最新短链，再执行一次同步。
Linux CLI
返回 JSON 中"totalNodes"大于 0 即成功；若仍为零，查看"errorCode":4103 表示订阅已过期。
同步失败的分支场景与回退方案
经验性观察：大约 18% 的"空列表"其实是网络层被重置，表现为日志里出现"TLS handshake timeout"。此时可：
- 临时把【设置】→【网络】→【并发测速数】降到 10，减少握手并发；
- 若公司网使用 Layer7 白名单，把订阅域名
sub.quicklink.net加入直连； - 仍失败，则回退到【手动导入】：把订阅短链在浏览器下载成
.json，再拖进客户端"手动导入"窗口，可绕过定时任务。
缓存损坏的深层清理办法
当重新同步始终报"0 节点"，且手动导入正常，即可判定本地缓存损坏。各平台清理路径如下（以当前最新版本为例）：
| 平台 | 缓存目录（默认安装） | 操作 |
|---|---|---|
| Windows | %LOCALAPPDATA%\QuickLink\cache\ odes.db | 退出客户端后删除整个 cache 文件夹，重启自动生成 |
| macOS | ~/Library/Group Containers/xx.quicklink.mac/cache/ | 同理，删除后需重新授权系统扩展 |
| Android | /sdcard/Android/data/net.quicklink/files/subCache/ | 清除应用数据或手动删除 subCache 目录 |
提示：删除前先把常用节点星标，清理后星标记录会丢失，需要重新添加。
订阅格式兼容性边界
快连官方只保证对自家v2rayN、Clash、Shadowrocket三型 JSON/YAML 完整解析；若第三方机场混入ssr://或trojan-go扩展字段，会被过滤为空。此时即使重新同步也看不到节点，解决方法是让机场主输出"快连兼容格式"，或自己在本地转换工具里勾选"移除扩展字段"后再导入。
何时不该用"重新同步"
- 节点列表正常但延迟高——同步不会改善路由，应使用【AI 一键调优】；
- 仅个别节点失效——用右上角【测速】→【删除无效】即可，无需全局同步；
- 处于公司强制代理环境——同步流量可能走本地 HTTP 代理被篡改，导致持续 403，此时建议改用【手动导入】。
最佳实践清单（可打勾）
- 订阅短链专人保管，每季度更换 Token，并在客户端里更新，避免旧链累积 4103 错误。
- 关闭【设置】→【网络】→"仅 Wi-Fi 下同步"，防止手机切蜂窝时错过更新。
- 把同步日志打开（【实验室】→【调试日志】），一旦空列表可先自诊，再提交工单。
- 多设备共用账号时，不要同时触发同步，经验性观察：并发写会出现"数据库 is locked"，间隔 30 秒即可。
- 若机场每日凌晨更换端口，建议把同步时间调到 06:00、18:00 各一次，降低撞库概率。
FAQ（FAQPage Schema）
重新同步会消耗额外流量吗？
单次同步下载的索引文件约 30–80 KB，可忽略不计；若同步失败重试 3 次，累计仍低于 1 MB。
为什么清空缓存后星标节点消失？
星标记录与节点指纹绑定，指纹重置后无法恢复，建议在清空前截图备份。
同步提示 4103 还能救吗？
4103 表示订阅已过期，需联系机场主重新生成短链；客户端侧任何操作都无法绕过。
总结与下一步
快连 lets 导入订阅后节点为空，90% 的场景可通过"重新同步"三板斧解决：确认筛选器→执行平台对应同步→检查日志排错。若遇缓存损坏或 Token 失效，再考虑清空缓存或更换短链。完成修复后，记得把同步日志打开并调整自动更新时段，能显著降低再次撞墙概率。下一步，你可以把本文最佳实践清单保存为备忘录，下次空列表 30 秒就能自检完毕。
