功能定位：为什么必须手动刷新
在快连（QuickLink privacy tool）里，「订阅节点列表」是客户端与云端调度中心的契约文件，包含 240+ 中继入口的域名、端口、混淆插件及公钥指纹。云端每小时滚动更新一次，客户端默认每 6 小时拉取一次；若你刚续费、刚切换套餐或身处晚高峰，6 小时的空档可能刚好遇到一批节点被运营商临时屏蔽，表现就是「能连但秒断」或「握手超时」。手动刷新相当于把契约提前对齐，把已被云端标记为 dead 的条目就地剔除，降低空连概率。
与「AI 链路预判」不同，刷新操作只负责「名单」层面，不负责「选路」；它解决的是「有没有」，而非「快不快」。因此刷新后若仍觉慢，再去开关「AI 预判」才有意义。
前置检查：确认客户端版本与网络可达
截至当前最新版本（v7.3.1）起，订阅接口强制校验 TLS 1.3 与 ESNI 扩展，若系统层被公司代理或本地抓根证书拦截，会返回 subscription_fetch_error。验证办法：在系统浏览器里直接访问 https://subs.quicklinkprivacytool.com/health，若能看到「ok」字样即说明网络层无拦截，可继续下一步；若提示证书无效，请先关闭本地代理或把 subs 域名加入绕行名单。
操作路径：三平台最短入口
Android
- 打开快连，点击右下角「我的」→「节点管理」→右上角 ⋮→「刷新订阅」。
- 弹出进度条，约 2–3 秒后显示「已更新 X 个节点」。若提示「无更新」代表云端与本地一致。
- 返回主界面，下拉节点列表，失效条目会被自动置灰并沉底，继续留在列表但不再参与智能选路。
iOS
- 底部导航进入「Profile」页→「Node Subscription」→「Refresh Now」。
- Face ID 验证后，客户端会强制走 iOS 系统 DNS，不再经过分应用代理，确保拉取成功。
- 刷新完成后，若出现「X nodes retired」横幅，向左滑即可一键「Sweep Out」清理置灰节点。
Windows / macOS
- 主界面右上角「⚙」→「Advanced」→「Subscription」→「Refresh」。
- 若公司网络使用 PAC 脚本，建议先切到「全局模式」再点刷新，避免 PAC 把 subs 域名指向内网假 IP。
- 刷新结束会弹日志窗，显示
removed: 7, added: 3, modified: 12，点击「Apply」即生效。
清理失效节点：两种策略与取舍
自动清理（默认开启）
客户端在每次刷新后，会把云端返回的 retired=true 条目本地标记为「失效」。这些条目不再参与 AI 选路，也不会被「最快节点」按钮命中，但仍保留原名，方便用户手动回退到旧版本安装包时仍能识别。经验性观察：保留失效条目对启动速度影响 <1%，对列表滑动手感无感，但能让回滚旧版时不至于出现「空白节点」。
手动清理（彻底删除）
若你运营一个 10 人以内的小团队，需要把自建订阅地址通过「二维码分享」给同事，失效条目会造成视觉干扰。此时可在刷新完成后，点击「Sweep Out / 清理失效」按钮，客户端会把本地 retired=true 条目连同缓存的 ping 记录一并删除。副作用：一旦删除，回退旧版客户端时将看不到这些节点，只能重新刷新订阅才能恢复。
警告
清理失效节点不会释放磁盘空间（节点信息只占几十 KB），但会清空本地测速缓存。若你下次想对比「新旧节点速度差异」，建议先导出测速报告再清理。
验证与回退：如何确认刷新真的生效
- 看数量：主界面顶部搜索框左侧有「全部/可用」切换，可用数应等于云端返回的
active字段。 - 看时间：进入「设置→关于」最底部「Subscription Updated At」应显示刚刚的时间戳。
- 看 IP：连接后访问
https://ipinfo.io，出口应与列表中标注的城市一致，若仍落在旧节点，可能是 DNS 缓存，重启客户端即可。
若刷新后发现可用节点反而减少，多半是云端刚上线「白名单审计」——部分中继只向付费 Pro 套餐开放。此时回退办法：点击「刷新」按钮旁的「↺」→「Fallback to last」可回滚到上一次本地快照，该快照保留最近 3 次记录。
例外场景：什么时候不该手动刷新
- 正在使用「多跳链路」且已手动指定第二跳：刷新后云端可能把第二跳标记为 retired，导致整条链路失效。
- 公司内网使用自建订阅网关：网关本身做了版本锁定，刷新会被 302 重定向回旧文件，徒增一次请求。
- 参加官方「灰度通道」测试：灰度用户会被分配到独立 subs 子域，手动刷新可能把你踢出灰度名单，需重新报名。
与第三方机器人协同的最小权限原则
经验性观察：部分技术社群使用「订阅转换机器人」把快连原生格式转成 Clash/YAML 供网关侧负载。若你打算让机器人自动刷新，请单独创建「只读 API 口令」，并在机器人端关闭「写入本地配置」权限，避免机器人误删你本地的分流规则。验证办法：在机器人日志里应只看到 GET /subs/xxxx，不应出现 POST /config。
故障排查：刷新失败常见原因与处置
| 现象 | 可能原因 | 验证步骤 | 处置 |
|---|---|---|---|
| 提示「网络超时」 | 本地 DNS 把 subs 域名解析到被污染 IP | nslookup subs.quicklinkprivacytool.com | 改用 8.8.8.8 或切换至移动数据再刷新 |
| 提示「签名验证失败」 | 本地系统时间偏差 >5 分钟 | 对比 time.is | 打开「自动设置日期与时间」 |
| 提示「套餐不匹配」 | 账号已降级为 Free | 官网个人中心查看有效期 | 续费后等待 10 分钟再刷新 |
适用/不适用场景清单
适用：晚高峰前、续费后、切换套餐后、分享二维码前、发现「全部节点握手失败」时。
不适用：已锁定自建订阅网关、正在多跳链路、处于官方灰度通道、本地网络强制代理且无法绕行。
最佳实践速查表
- 每天固定时段（如午休）刷新一次，比频繁刷新更能平衡「节点新鲜度」与「云端 QPS」。
- 刷新后先连「可用」里延迟最低的 3 个节点各跑 100 MB，记录速度，再决定是否清理失效条目，以免误删潜在优质候补。
- 若你使用 Clash 网关+第三方转换，请把刷新动作放在「转换前」，确保转换器拿到的是最新名单，避免缓存污染。
- 出差前导出一份「节点+测速」CSV 到本地，飞机落地后若无法刷新，还能手动导入旧节点应急。
FAQ（Must Use FAQPage Schema）
刷新后可用节点反而变少，是故障吗？
不是。云端可能刚上线白名单，仅 Pro 套餐可见新入口。可回滚到上一次快照或确认账号等级。
清理失效节点会释放存储空间吗？
几乎不会，节点信息仅几十 KB。清理主要目的是视觉整洁，对性能无感。
iOS 端为何每次刷新都要 Face ID？
苹果强制策略：任何改写系统 privacy tool 配置描述文件的操作都需生物验证，防止恶意后台偷偷改节点。
能否设置自动刷新间隔小于 6 小时？
客户端最小间隔被硬编码为 6 小时，防止滥用。如需更实时，可在网关层自己做定时拉取。
导出测速报告的路径在哪？
Windows/macOS：主菜单「Help」→「Export Diagnosis」→勾选「Include speedtest.csv」。Android/iOS 暂不支持本地导出，可复制日志到剪贴板后自行过滤。
总结与下一步行动
手动刷新订阅节点列表并清理失效节点，是快连用户保持「可用入口」与「视觉整洁」之间的低成本例行操作。记住「先验证网络-再刷新-后验证 IP」三步走，遇到异常优先回滚快照，不盲目清理。下一步，把「每天午休刷新一次」加入日历提醒，并顺手导出测速 CSV，两周后你就能拥有私人节点质量趋势图，为是否升级 Pro 套餐提供量化依据。
