功能定位：为什么日志是排障唯一可信证据
在 kuailian 安卓端，连接失败原因可能藏在系统层、网络层或协议层。客户端提供的「一键诊断」只能给出表层结论，而完整日志（含时间戳、节点 IP、协议握手码）才是客服定位根因的「可审计证据」。2026 年 3 月更新的毕马威零日志审计报告明确：用户主动回传的诊断日志不在「零日志」范畴，因此官方鼓励用户自助抓取并加密上传，既满足合规，又缩短工单平均响应时间。
前置检查：先确认你确实需要抓日志
经验性观察：约 30 % 的「连接失败」其实是本地网络被 QoS 或 DNS 污染，重启客户端或切换 443-UDP 端口即可恢复。建议先走完以下两步，再决定是否抓日志：
- 设置-协议-备用端口，勾选 80-UDP 与 443-UDP，重连一次；
- 如仍失败，记录失败发生的确切北京时间（用于后续日志对齐）。
只有以上快速通道无效，才进入正式日志抓取流程，避免上传无效数据。
最短路径：Android 14 官方日志抓取入口
以截至当前的最新版本为例，路径已经固化为「四级菜单」，无需 ADB 或 root：
- 打开 kuailian → 右上角⚙️设置 → 帮助与反馈 → 诊断工具 → 抓取日志（Debug Log）。
- 系统会弹出「是否允许存储权限」，点允许后倒计时 10 秒，期间请复现一次连接失败动作，确保日志写入失败堆栈。
- 倒计时结束自动生成 .qklx 加密包，保存在 /Android/data/com.quicklink.privacy/files/log/，文件名含时间戳。
注意：Android 11 及以上，第三方文件管理器无法直接访问该目录，需用系统自带「文件」应用查看，或通过客户端内「分享」按钮直接调用邮件/工单系统上传。
例外场景：无法进入客户端怎么办
若客户端闪退或卡在启动页，可通过系统层抓取「应用日志」作为补充：
警告
此方法包含设备标识符，需自行脱敏。官方客服仅在用户主动勾选「同意上传系统日志」后才接受此类附件。
- 拨号界面输入 *#*#284#*#*，等待系统提示「错误报告已捕获」；
- 通知栏点击生成的 BugReport 通知，选择「仅共享应用日志」；
- 用系统邮件发送给自己，手动删除顶部 Device-ID 段，再转发给客服。
加密与回传：两步防止隐私泄露
快连在 v9.8.1 引入「本地加密上传」开关，默认开启。机制是：在客户端内调用 OpenSSL 3.2，用客服公钥对 .qklx 包再做一次 SM4+RSA 混合加密，上传通道走 443 端口 TLS1.3 ESNI，避免中间人二次解密。
回传路径：诊断工具 → 上传日志 → 选择「已复现问题」标签 → 填写工单号（若无工单可留空，系统会分配临时 ID 并通过邮件回执）。
桌面端差异：Windows/macOS 如何对齐日志
若你同时在桌面端遇到相同节点失败，可并行抓取供客服交叉验证：
- Windows：托盘图标右键 → 诊断 → 导出日志，生成 .qklx 包，路径在 %LOCALAPPDATA%\QuickLink\log\（具体路径因版本和安装方式而异，请以实际为准）。
- macOS：顶部菜单栏 → Help → Diagnostic → Export Log，保存在 ~/Library/Logs/QuickLink/。
上传时，在工单备注「多端同步失败」，客服会优先比对同一时段 UDP/TCP 握手差异。
验证与回退：如何确认日志已有效送达
上传成功后，客户端会返回一串 16 位校验码（如 QL9B-7CD3-XX...）。请复制并粘贴到工单，客服系统会自动匹配。若 24 小时内未收到「已受理」邮件，可：
- 检查垃圾邮件；
- 在客户端 → 设置 → 诊断工具 → 上传历史中重发，历史记录保留 7 天。
不适用场景：什么时候不该抓日志
提示
以下情况抓日志对排障帮助极小，反而增加上传耗时：
- 仅流媒体解锁失败（如 Netflix 代理检测），属于 IP 层面问题，客服可直接更换住宅 IP 节点；
- AI 节点预加载导致后台耗电异常，属于调度策略，关闭开关即可，无需日志；
- 账号同时在线数达上限，客户端会明确提示「设备数超限」，此时只需在控制台踢出旧设备。
最佳实践清单：10 分钟完成一次高质量反馈
- 记录失败时间（北京时间精确到分）；
- 先切换 443-UDP 端口，确认非本地 QoS；
- 在客户端内连续失败两次后立即抓日志，避免缓存被覆盖；
- 复制 16 位校验码，粘贴到工单标题前，方便客服系统秒级匹配；
- 若涉及多端，同步上传 Windows/macOS 日志，并标注「多端对比」。
FAQ：客服最常被问到的 3 个问题
日志会保存多久？
客服侧仅保留加密包 90 天，到期自动粉碎。用户本地文件需手动清理，路径见上文。
上传失败怎么办？
可改用邮件附件发送，邮件标题注明工单号，附件不得超过 15 MB。
抓日志会增加流量消耗吗？
单次 .qklx 包约 200-500 KB，仅在上传时走加密 HTTPS，几乎可忽略。
收尾：把日志变成有效对话
快连安卓端连接失败时，日志是唯一能被客服快速审计的「客观证据」。掌握「失败即抓、抓完即传、传后附码」的三步节奏，可将平均工单往返从 48 小时压缩到 6 小时以内。下次再遇连接失败，不妨先深呼吸，10 分钟后把加密日志和 16 位校验码一起丢给客服，让排障变成一次高效对话，而不是漫长等待。
