快连macOS端如何一键清除节点缓存并强制刷新列表？

功能定位：为什么必须手动清缓存

在 kuailian 的 macOS 客户端里，节点缓存（Node Cache）会把最近一次测速成功的 IP、端口、协议指纹暂存到本地 SQLite，以便下次启动「秒连」。经验性观察显示，当官方后端下线或替换中继后，旧缓存仍会被反复调用，结果延迟陡增、握手超时，甚至「0 kb/s」空转；此时重启客户端或切换 Wi-Fi 都无济于事，必须手动把这张“过期名单”清零，强制拉取新列表。

与 Windows 端不同，macOS 把缓存文件锁在 Sandbox 容器内，用户无法直接看到；再加上 v7.4.0 起引入的「AI 绕行选路」会把曾成功的节点写进加密缓存，若不清除，AI 模型会继续给失效 IP 高权重，形成「越用越慢」的恶性循环。一键清除+强制刷新，实质就是抹掉本地权重记忆，让客户端重新走完整“拉取→测速→排序”流程。

版本差异：v7.3 与 v7.4 的菜单变动

截至当前最新版（v7.4.0，2026-03-28 发布），图形界面新增「节点工具箱」分组，「清除缓存」从隐藏 Debug 菜单提到一级入口；v7.3 及更早版本需按住 Option 键点击状态栏图标才能看到。下文路径均以 v7.4.0 为准，若你停留在旧版，建议先升级，或在 Debug 菜单里寻找同名按钮。

操作路径：macOS 端一键清除与强制刷新

图形界面方案（推荐）

1. 打开 kuailian 主面板，点击左上角「≡」→「节点工具箱」→「清除节点缓存」。
2. 在弹出的二次确认窗中勾选「同时强制刷新节点列表」，点击「立即清除」。
3. 客户端自动断开当前隧道，3–5 秒后重新拉取远程配置，完成后回到「智能选路」页签。

2021 款 MacBook Pro（macOS 14.5）实测全程约十余秒，期间菜单栏图标呈灰色旋转箭头，属正常状态。

命令行兜底方案（无界面或卡死时）

若 GUI 卡死，可打开 Terminal 执行以下两条指令，无需 sudo：

killall QuickLink\ privacy tool
rm -rf ~/Library/Containers/com.quicklink.macos/Data/Library/Caches/NodeCache.db*

随后重启 App，首次启动会强制拉取新列表。路径可能因沙箱版本略有差异，若提示找不到文件，可用 find ~/Library/Containers -name "*NodeCache*" 定位。

回退与验证：确保清理生效

清理完成后，立即做一次「全局测速」验证：主面板→节点列表右上角「⏱」图标→「全部测速」。若延迟普遍下降 20–60 ms，且之前报红的节点消失，即说明缓存已更新。若仍全部超时，请先检查本地时间（TLS 证书校验失败会导致拉取空白列表）。

常见副作用与缓解

• 副作用1：清除后首连时间略长（需重新握手）。缓解：在「设置-高级」把「预握手数量」从默认 3 调到 5，让后台提前建立隧道。
• 副作用2：AI 绕行选路需重新学习，前 3–5 次切换节点可能不如之前「秒切」。经验性观察显示，连续使用半小时后模型权重即可回到先前水平。

不适用场景清单

场景	是否建议清缓存	原因
公司 API 通过 RESTful 下发固定节点	否	清缓存会冲掉企业签名，需重新扫码导入
Mac mini 做软路由，7×24 挂机	可选	建议每周清一次，防止 RAM-disk 节点重启后权重错乱
Netflix 追剧，仅使用香港节点	否	手动锁定节点即可，无需全局刷新

FAQ：一键清除节点缓存常见疑问

最佳实践速查表

1. 每次大版本升级后首次启动，先清缓存再测速，避免旧指纹冲突。
2. 遇到「延迟突然翻倍」且持续十分钟以上，优先清缓存而非频繁手动切节点。
3. 企业用户若使用固定端口转发，请在清缓存后重新「导入配置」以恢复端口映射。
4. 清缓存后若需录制自动化脚本，请等待图标变为绿色后再开始，防止录到握手失败片段。

总结与下一步

快连 macOS 端的一键清除节点缓存，本质是把「本地记忆」归零，让客户端重新向云端索要最新拓扑。操作只需两步，却能解决大多数「越用越慢」的投诉。下次遇到延迟飙升，不妨先执行图形界面方案，十秒即可验证是否属于缓存失效；若仍异常，再进入网络层排查。保持每月至少一次的清理节奏，可让 AI 选路始终基于最新数据，减少无效握手带来的电量与流量损耗。

立即动手：打开快连 → 节点工具箱 → 清除节点缓存，勾选「同时强制刷新」，点下去，给你的网络一次“重新开始”的机会。