快连安卓端无法连接时如何导出日志给客服？
快连安卓端无法连接时，三步导出日志发给客服，定位握手失败、混淆被拦等根因。
问题定义：为什么客服一定要日志？
快连（QuickLink）安卓端出现“连接中→断开”或“Code 514 节点空白”时，界面只抛结果码，真正原因却埋在本地日志：握手超时、混淆被 DPI 重置、后台杀进程等。客服没有远程桌面权限，只能依赖用户主动提取的日志文件做二次解码，否则只能陷入“换节点→重装”式盲猜。
功能边界：哪些信息会被记录？
日志默认级别为 INFO，含时间戳、选中节点 IP、协议类型、握手往返值、混淆插件版本、系统电量状态，不会记录访问网址与明文流量。若你曾手动打开“实验室-量子密钥前向保护”，额外会出现 qkfp_version=1 标记，同样不含密钥本体。
最短路径：安卓端 3 步导出日志
1. 复现故障并保留现场
先别急着卸载或清缓存。打开快连 → 主界面下拉两次，确认故障码已出现 → 点击右上角「⋯」→「问题反馈」→ 勾选「附加日志」。此时系统会把最近 30 min 的缓存日志打包成 .zip，命名规则：QuickLinkLog_年月日时分.zip。
2. 选择导出通道
在弹出的系统分享面板里，优先使用邮件（可直接填写 [email protected]），其次可用 Telegram 收藏或 Google Drive。若公司网络屏蔽外发，可先把 zip 保存到「下载」目录，随后用 USB 拷到电脑再传。
3. 填写上下文并发送
邮件标题统一写「Android 无法连接 + 故障码 + 节点城市」，正文交代：系统版本（如 Android 14）、快连版本（可在「我的-关于」查看）、是否校园网/公司网、是否启用电池优化。经验性观察：提供完整上下文的工单，客服首次回复平均缩短 4 h。
例外场景：导出按钮灰色怎么办？
若 App 崩溃到无法进入界面，可尝试系统级抓取：设置 → 应用 → 快连 → 存储 → 「导出诊断数据」（Android 13+ 原生才有）。部分国产 ROM 阉割了该入口，只能借助 ADB：
adb shell bugreportz
完成后会在 /sdcard/BugReports/ 得到 .zip，记得把里面的 QUICKLINK 目录单独截出再上传，否则文件过大容易被客服邮箱拒收。
验证与回退：如何确认日志已包含关键字段？
用任意文本编辑器打开 zip 中的 ql_client.log，搜索「handshake_done」或「tls13_finished」。若找不到，说明日志等级被意外调到 WARN，可在「实验室-日志等级」切回 INFO 后重新复现一次。
常见副作用与缓解
- 日志 zip 含大约 1.5 MB，移动数据上传会耗流量，建议在 Wi-Fi 下操作。
- 部分企业 MDM 会审计外发附件，若含“privacy tool”关键字可能被拦截，可把文件名改为 qlog.zip。
示例：某用户在公司内网通过企业微信发送原文件名被网关拦回，改名 qlog.zip 后 5 秒即送达。
平台差异速查
| 平台 | 入口差异 | 备注 |
|---|---|---|
| Android 10 以下 | 无系统分享，需手动复制到 /sdcard | 记得开存储权限 |
| Android 11+ | Scoped Storage，分享面板可直接调 Gmail | 无需额外权限 |
| HarmonyOS 4 | 路径相同，但邮件客户端需手动添附件 | 不支持 Telegram 分享 |
最佳实践清单
- 每次升级版本后首次失败，立即导出日志，避免缓存被二次覆盖。
- 若当天多次失败，按时间分多个 zip 发送，方便客服对比节点调度差异。
- 勿用压缩软件二次打包，官方脚本按文件名排序解析，二次压缩会打乱时序。
FAQ：客服最常被问到的 5 个问题
日志会泄露浏览记录吗？
不会。INFO 级日志仅记录协议握手、选路评分与系统状态，不含 URL 与明文流量。
附件太大被邮箱退回怎么办？
可把 zip 上传至 Google Drive 后开“任何知道链接者可读”，将链接贴到工单即可。
为什么客服回复让我再抓一次？
大概率是日志时段没覆盖到故障点，或你清过缓存。请按“复现→立即导出”节奏重抓。
iOS 能否用同样方法？
iOS 无文件级导出，需在「设置-隐私-分析与改进」里找 QuickLink-YYYY-MM-DD.ips，同步到 Mac 后发送。
日志里出现 kill_by_system_oom 代表什么？
系统低内存杀后台，按本文「电池优化+任务加锁」章节设置即可缓解。
总结与下一步
导出日志不是“可选动作”，而是快连安卓端无法连接时最高效的根因定位手段。记住「复现→立即打包→邮件标题带故障码」三步，可把平均工单往返从 48 h 压到 6 h 以内。下次再遇到连接失败，别再盲目换节点，先抓日志，再让数据说话。
未来版本若引入“自动日志上传”实验开关，用户侧只需一键授权即可后台同步，预计再缩短 30 % 定位时间；目前该特性仍在灰度，敬请期待官方更新公告。