快连安卓端如何导出日志供技术支持排查？
快连安卓端导出日志完整路径，含隐藏入口、版本差异与回退方案，助技术支持秒级定位故障。
功能定位：为什么需要手动导出日志
在快连（QuickLink）Android 客户端里，「导出日志」并不是日常开关，而是技术支持在排障时最后一环。它把本地缓存的链路握手、节点漂移、加密协商、系统权限等事件一次性打包成 .zip，方便研发还原现场。与「实时网络诊断」面板不同，日志文件包含时间戳、线程号、原始错误码，能定位偶发的 1401、1503 等更新后异常。
经验性观察：2026 年 2 月 v7.4.0 引入量子加密隧道后，论坛反馈「无法连接」概率上升，但关闭 Quantum-Mode 后复现率明显下降。官方建议遇到此类问题时，先手动抓取日志再回退加密方式，可缩短工单往返 1～2 轮。
版本演进：入口变迁与权限收紧
v7.2 及更早：双入口时代
早期版本在「我的→设置→关于」与「连接失败弹窗」均放置「导出日志」按钮，无需系统额外权限。随着 Android 13 收紧 MANAGE_EXTERNAL_STORAGE，旧入口在 targetSdk 33 编译下被隐藏。
v7.3：隐藏式入口
7.3 起官方把按钮收进「关于」页面底部，连续点击版本号 5 次后才会浮现。此改动是为降低误触，但也导致大量用户找不到路径，春节后工单量环比增加约三成。
v7.4.0：分区存储适配
7.4.0 全面改用 SAF（Storage Access Framework），日志不再写入公共 Download，而是落入包内私有目录 Android/data/com.kuailian.privacy tool/files/LogsExport/，用户需手动通过系统文件管理器或邮件客户端分享。
操作路径：最短可达步骤（Android）
- 打开快连，确保已重现问题（日志循环缓存默认 3 MB，过早导出可能截断关键信息）。
- 依次进入「我的→关于 QuickLink→连续点击版本号 5 次」，页面底部出现「导出日志」。
- 点击后，系统弹出 SAF 目录选择器；建议直接选中「Documents」文件夹，便于下一步邮件上传。
- 导出完成后，通知栏会生成「日志已保存」提示，点击即可调用系统分享面板，选择邮件或 Telegram 附件发送给客服。
提示
若点击版本号无反应，请确认网络已连接：首次触发需要拉取最小化配置，离线状态下按钮不会浮现。
失败分支与回退方案
场景 A：导出按钮灰色
原因：日志缓存正在被写入，后台有未断开的隧道。解决：先断开加速，等待 3 秒让写锁释放，再重试。
场景 B：SAF 选择器空白
原因：Android 14 限制了 All Files 权限。解决：手动授予「文件与媒体」权限，或改用「系统文件管理器→侧边栏→Documents」路径。
场景 C：导出后找不到文件
原因：部分国产 ROM 把 SAF 映射到「手机存储/Android/media」而非「Documents」。解决：使用系统搜索关键字 QuickLinkLogs，或通过电脑 MTP 浏览。
兼容性表：机型与系统差异
| 系统版本 | 最小快连版本 | 额外权限 | 备注 |
|---|---|---|---|
| Android 11 及以下 | 7.2 | 无 | 旧入口仍可见 |
| Android 12/13 | 7.3 | 附近设备（用于心跳） | 需连续点版本号 |
| Android 14 | 7.4.0 | 仅 SAF | 无 All Files 选项 |
| HarmonyOS NEXT | 7.4.1 | 文件管理权限 | 需关闭「自动管理」 |
风险控制：什么时候不该导出
1. 手机剩余空间低于 200 MB 时，日志 zip 可能因写入失败导致客户端崩溃。解决：先清理缓存再操作。
2. 企业定制 ROM 开启「数据防泄漏」策略后，SAF 分享面板会被禁用，此时导出文件无法外发。解决：改用电脑端 adb pull：
adb shell tar -czf /sdcard/ql.tgz /sdcard/Android/data/com.kuailian.privacy tool/files/LogsExport/ adb pull /sdcard/ql.tgz
3. 日志内含设备 UUID、局域网 IP 等标识，若对隐私敏感，可在发送前删除文件名中的 UUID 段落（日志仍能被官方解析）。
验证与观测：确保日志有效
- 检查 zip 大小：正常应在 100 kB–3 MB 之间，过小可能未包含 native 层日志。
- 用文本编辑器打开
logcat.txt，搜索「quantum」，若出现「ML-KEM handshake failed」即证明已抓到量子加密错误。 - 确认时间戳覆盖故障发生点：日志命名格式
QuickLink-YYYY-MM-DD-HHMMSS，确保与重现步骤对齐。
与第三方协同：最小权限原则
若使用第三方归档机器人（如 Telegram 自动收件 Bot），建议仅授予「读取 Documents」目录权限，关闭「联系人」与「通话记录」授权，防止日志被二次上传。可复现验证：在 Bot 权限列表里关闭 PHONE，重新发送文件，观察是否仍成功。
适用/不适用场景清单
- 适用：偶发性断流、1401 错误、量子加密握手失败、节点漂移超时、Starlink 卫星节点高丢包。
- 不适用：账号登录失败（需抓账号组件日志）、支付回调异常（需服务端订单号）、路由器插件离线（需 SSH 到路由器抓 daemon）。
最佳实践 5 条
- 出现问题后先复现 2 次，再导出日志，保证栈信息完整。
- 导出前关闭其他 privacy tool 或代理，防止多隧道日志混杂。
- 命名 zip 时手动追加「问题简述+日期」，方便客服归档。
- 上传后保留本地副本 7 天，避免客服要求二次抓取。
- 若日志大于 5 MB，改用分卷压缩或网盘链接，防止邮件被拒。
FAQ：官方电报群高频提问
导出日志会泄露隐私吗？
日志仅含设备 UUID、局域网 IP 与节点握手记录，不含浏览历史。发送前可用文本编辑器删除文件名中的 UUID 段落，官方仍可解析。
为什么 7.4.0 导出后找不到按钮？
Android 14 改用 SAF，文件落在包私有目录，需通过系统文件管理器「Documents」或搜索关键字「QuickLinkLogs」定位。
日志可以自动上传吗？
目前无自动上传开关，官方称系出于 GDPR 合规考虑。所有上传均需用户手动触发。
HarmonyOS NEXT 闪退怎么办？
关闭「自动管理」并手动允许自启动，再锁后台；若仍失败，用电脑端 adb pull 方式获取日志。
日志有效期多久？
本地循环缓存 3 MB，约保留最近 6 小时。故障发生后请尽快导出，防止被新日志覆盖。
总结与下一步行动
快连安卓端导出日志的核心价值在于「把偶发问题变成可复现证据」。记住「复现→断开→连点 5 次→SAF 分享」四步，可让技术支持在数十秒内定位是量子加密握手失败，还是节点漂移超时。下次遇到 1401 或 Starlink 高丢包，不要急着回退版本，先按本文路径导出日志，再附带问题描述与时间点提交，官方通常能在 1 个工单回合内给出加密方式切换或节点白名单方案。
进阶用户可把 adb pull 命令写成批处理，配合 logcat 实时监听，实现「无触摸」后台抓日志；若你管理多台设备，建议部署私有文件收件箱，避免日志散落在个人邮箱。现在就打开快连，连点版本号试试看，把隐藏入口熟记于心，下次故障不再抓瞎。
