快连macOS客户端如何彻底卸载并清理残留配置？

功能定位：为什么“卸载”≠“清理干净”

快连 macOS 客户端（kuailian）在 2026-02 发布的 v6.4.0 采用“系统扩展+登录项+配置缓存”三件套设计，目的是让 AI 中继选路 2.0 能在睡眠唤醒后 2 秒内恢复握手。好处是重连快，副作用是直接把 .plist、日志、WireGuard-R 内核缓存散落到 4 个不同沙盒目录。只把 App 拖到废纸篓，等于留下 3~5 MB 的残留，下次重装会继承旧节点表，甚至把失效的迪拜节点重新导入，导致“刚装完就丢包”。

因此，彻底卸载的核心关键词是“卸载+清理+验证”，缺一不可。下文给出官方推荐路径、终端兜底命令、以及可复现的验证指标，确保“零残留”可量化。

前置检查：先退出，再解除系统扩展

1. 退出客户端

菜单栏图标 → 右键 → Quit kuailian；若图标已冻结，活动监视器搜索“kuailian”→ 强制退出。经验性观察：睡眠唤醒后进程可能进入 zombie 状态，强制退出才允许后续卸载。

2. 解除系统扩展（macOS 13+）

1. 系统设置 → 通用 → 登录项与扩展 → 网络扩展 → 找到“kuailian Packet Filter”→ 左下角“-”移除。
2. 若按钮灰色，说明扩展正在占用，先关闭 Wi-Fi 5 秒再试。

警告：跳过此步直接删 App，会在“系统设置-隐私与安全”留下“已阻止扩展”黄条，重装时会被系统拒绝加载内核驱动。

官方卸载路径：Finder 拖拽+废纸篓

适用于“准备完全弃用，且后续不再回滚配置”的场景。步骤最短，但需手动补清缓存。

1. 打开 Finder → 应用程序 → 将“kuailian”拖入废纸篓。
2. 右上角苹果图标 → 重新启动 → 按住 Shift 进入安全模式（防止扩展残留守护）。
3. 进入正常模式后，继续下一节的“四目录清理”。

回退方案：若误删，可在 30 天内从废纸篓放回原位，再重装同版本安装包，系统会重新注册扩展，无需重新配置节点。

四目录清理：终端一次性删除残留

经验性观察，v6.4.0 在 macOS 上写入 4 类路径，名称均含 kuailian 或 quicklink 关键字。打开终端，逐条复制执行（sudo 需要管理员密码）：

sudo rm -rf ~/Library/Preferences/com.kuailian.mac.plist
sudo rm -rf ~/Library/Application\ Support/kuailian
sudo rm -rf ~/Library/Caches/com.kuailian.mac
sudo rm -rf ~/Library/Logs/DiagnosticReports/kuailian*

说明：第 4 条清理崩溃日志，防止下次重装被“控制台”旧日志干扰排障。

提示：如果你曾开启“零信任分应用隧道”，还会额外写入 /Library/Preferences/com.apple.networkextension.uuid.plist，可用 sudo find /Library/Preferences -iname "*kuailian*" -delete 兜底。

验证是否干净：三指标可复现

1. 文件指标：终端执行 find ~ -iname "*kuailian*" 2>/dev/null | wc -l，结果应为 0。
2. 进程指标：活动监视器搜索“lets”，无结果。
3. 网络扩展指标：系统设置 → 通用 → 登录项与扩展 → 网络扩展，列表中无“kuailian Packet Filter”。

若任一指标非零，回到上一节检查拼写或遗漏目录。

场景映射：什么时候值得大费周章？

场景	残留影响	是否彻底清理
换账号（旧账号被闲鱼封）	设备指纹残留，新账号仍被关联	必须
降级到 v6.3（WireGuard-R 睡眠断流）	缓存格式不兼容，启动崩溃	必须
临时让出磁盘空间（剩余 <5 GB）	仅 3~5 MB，杯水车薪	可选

不适用清单：三种情况别硬删

• 公司 MDM 下发描述文件：删除扩展会导致合规告警，先与 IT 确认。
• 共享电脑，其他用户仍需使用：彻底清理会把“节点订阅二维码”一并删掉， roommate 需重新扫码。
• macOS 版本 ≤12：旧系统无“网络扩展”面板，卸载后残留内核扩展需重启按住 ⌘R 进入恢复模式，执行 kmutil clear-staging，风险高，不建议新手操作。

故障排查：卸载后重装仍提示“扩展已阻止”

现象：重装时弹窗“System Extension Blocked”。

可能原因：上一次的残留 .dext 签名与当前安装包不一致。

验证：终端 systemextensionsctl list | grep lets 出现 activated but not validated。

处置：

1. 终端 sudo systemextensionsctl reset -u 重置用户级扩展数据库。
2. 重启后再次安装，系统会重新请求“允许”按钮。

最佳实践清单：10 秒速查表

1. 退出 App → 活动监视器二次确认。
2. 系统设置 → 网络扩展 → 减号移除。
3. Finder 拖废纸篓 → 安全模式重启。
4. 终端四行命令 → 0 文件验证。
5. 重装前再执行一次 systemextensionsctl list 确认空白。

FAQ：常见疑问一次答

收尾：下一步行动建议

完成上述三步后，你已拥有可复现的“零残留”环境。若计划换号或降级，立即重装对应版本安装包，并在首次启动前用 systemextensionsctl list 确认无旧签名冲突。若只是临时让出空间，可跳过终端命令，把 App 拖废纸篓即可，但请接受“旧节点表可能复活”的副作用。

把本页加入浏览器书签，下次更新 v6.4.1 时，回来看是否有新路径变动，就能继续用同一套验证指标，5 分钟搞定彻底卸载。