功能定位：订阅刷新到底解决什么问题
在快连 macOS 客户端里，订阅刷新（又称「更新订阅」或「拉取节点」）是把你账号下的最新节点列表、分流规则、DNS 白名单一次性同步到本地的唯一入口。与 Windows 端不同的是，macOS 版默认采用「懒加载」策略：首次启动只拉取 50 条延迟最低的节点，剩余节点在你手动刷新或触发「AI 调度 3.0」时才会补齐。若长期不刷新，可能出现「明明官网显示 3000+ 节点，本地却只看到 200 条」的落差，这也是 Reddit 热帖里「更新 v6.4.2 后节点消失」的真正原因——并非官方删减，而是本地缓存过期。
因此，手动刷新订阅的核心价值是：强制覆盖本地缓存，让 AI 调度拿到完整候选集，从而在游戏/流媒体场景下选到真正最优的出口。经验性观察：在晚高峰（21:00-23:00）手动刷新后，4K 视频加载速度平均可提升一档，从 30 Mbps 爬升至 50 Mbps 左右（样本：校园网 100 Mbps 出口，n=10，仅供参考）。
版本演进：从「一键更新」到「增量同步」
截至当前的最新版本（v6.4.2，2026-03-31），macOS 端订阅逻辑已经历三次迭代：
- v6.2.x 及之前：全量拉取，节点数 >2000 时耗时 20-40 s，且会阻塞主线程，UI 假死。
- v6.3.x：引入「增量 diff」机制，仅下载变更的节点，耗时降至 5-8 s；但首次订阅仍需全量。
- v6.4.x：新增「IPv6 Only 模式」与「国内直连白名单 2.0」，刷新时同时下发双栈路由表，若本地网络为 IPv6 Only，可节省 30% 握手时间。
迁移建议：若你仍在 v6.2.x，务必先「导出配置」再升级，否则老版本的全量缓存会被新版本视为「脏数据」而强制清空，导致首次刷新后节点列表短暂为空（可复现步骤见文末 FAQ）。
操作路径：三步完成手动刷新
1. 最短入口
顶部菜单栏图标 → 右键 →「更新订阅」→ 看到「✔ 已同步 78 个国家/地区」提示即完成。全程无需打开主面板，适合游戏全屏时快速操作。
2 备选入口
主界面 → 左侧「订阅管理」→ 右上角 ⟳ 按钮 → 选择「立即刷新」。此处额外显示「上次更新：18 分钟前」时间戳，适合排查缓存是否过期。
3 失败分支与回退
若提示「订阅链接失效 410 Gone」，99% 是登录态过期。回退方案：点击「账号登出」→ 重新扫码登录 → 再次刷新，全程不超过 30 秒。切勿反复点击刷新，否则会触发限速「5 分钟内最多 3 次」，被临时锁 IP（经验性观察：锁定时长 3-5 分钟）。
立即同步节点：让 AI 调度立刻生效
刷新订阅只是「下载列表」，若想让 AI 调度 3.0 立即重新打分，还需手动触发「节点重测」：
- 在节点列表页顶部点击「延迟测速」图标（⚡）。
- 等待进度条跑完（约 8-12 s，视节点数而定）。
- 看到「已自动选择最优：东京-Anycast-03」横幅，即完成同步。
边界注意：若你正在观看 Netflix，重测会导致当前 TCP 连接重置，出现 3 秒左右黑屏。建议先在播放器里暂停，再执行重测。
例外与取舍：哪些情况不该手动刷新
1. 公司内网屏蔽 GitHub raw 域名：订阅文件托管在 raw.githubusercontent.com，一旦 DNS 被污染，刷新会报「网络错误 6」。此时应切到手机热点再刷新，或把「私有DNS over QUIC」开关打开。
2. 流量倍率 >1.0 的节点：v6.4.2 新增「倍率标识」，若你只想省流量，可先在「订阅管理」里取消「高倍率节点」勾选，再刷新，否则会把 1.3× 节点也拉下来。
3. 路由器旁路代理：当 macOS 仅作为「下级设备」、网关已由 OpenWrt 固件负责分流时，本地刷新订阅会覆盖路由器规则，导致全家断网 5 秒。工作假设：若路由器已启用「快速订阅同步」，建议关闭 macOS 端的「自动更新」开关，统一在路由器端管理。
验证与观测：如何确认刷新成功
| 观测指标 | 预期结果 | 验证路径 |
|---|---|---|
| 节点数量 | 与官网公告差异 <5% | 主界面 → 节点 → 右上角「共 3120 节点」 |
| 订阅时间戳 | 与系统时间差 <2 分钟 | 订阅管理 → 上次更新 |
| AI 调度日志 | 出现「score=98, selected=Tokyo-03」 | 设置 → 高级 → 导出日志 → 检索「selected」 |
若三项均达标，即可认定刷新+同步链路正常；任一失败，按上表顺序逐级回退排查。
最佳实践清单：什么时候该刷新
- 每日首次启动游戏前刷新一次，确保拿到当日凌晨新增的 ChatGPT 解锁节点。
- 观看区域限定流媒体前 2 分钟刷新，可规避「检测代理 319」错误。
- 公司/学校网络切换后（如从 Wi-Fi 到热点）立即刷新，防止旧节点被 ACL 屏蔽。
- 发现延迟突增 50 ms 以上且持续 10 分钟，先刷新再重测，排除本地缓存失效。
- 不要高频刷新：>3 次/5 分钟会触发限速；>20 次/小时可能被判定为「滥用」而冻结账号 30 分钟（官方公告 2026-02-10）。
不适用场景清单
1. macOS 版本低于 11.0（Big Sur）：v6.4.x 依赖系统 Network Extension 原生 IPv6 支持，旧版系统刷新后会闪退，只能停留在 v6.2.x，节点数上限 1500。
2. 使用第三方克隆客户端（如「NetQuick Lite」）：此类客户端去掉了订阅校验签名，刷新后可能拿到被篡改的节点，导致 DNS 污染回退。
3. 网络环境为「IPv6 Only + 企业出口强制 NAT64」：虽然 v6.4.2 支持 IPv6 Only，但部分企业 NAT64 会丢弃 UDP 443，导致 WireGuard 节点全红，刷新后体验反而下降，建议关闭 IPv6 Only 开关。
FAQ：常见疑问与可复现验证
刷新后节点列表为空怎么办？
先检查系统时间是否准确（偏差>5 分钟会导致 TLS 握手失败）；确认无误后，退出账号→重新扫码登录→再次刷新，节点即可恢复。可复现：手动把系统时间调慢 10 分钟，100% 出现空列表。
AI 调度选中的节点延迟反而更高？
AI 调度 3.0 综合打分含「带宽」「丢包」两项，不单看延迟。验证：在节点列表手动按「延迟」排序，若最优延迟节点丢包 10%，而 AI 选中节点丢包 0%，即符合预期。
刷新按钮灰色无法点击？
说明正在后台自动刷新，等待右上角转圈消失即可。若持续 >30 秒，强制退出客户端（Cmd+Q）重开，再次点击即可恢复。
收尾：下一步行动建议
手动刷新订阅并立即同步节点，本质上是把「缓存生命周期」掌握在自己手里。读完本文，你只需记住「右键更新→⚡重测」两步，就能在 macOS 端获得与官网完全一致的节点视图。下次遇到「节点突然变少」「ChatGPT 无法登录」时，先别急着发工单，花 10 秒刷新一下，大概率就能自愈。若仍异常，按表格逐项验证并导出日志，官方 Ticket 回复速度会快得多——因为你能给出「时间戳+节点数+日志 selected 行」三件套，技术同学一眼就能定位。
