问题定位：为什么官方第一时间索要日志
当 kuailian（QuickLink）安卓端出现“一直转圈”或提示代码 -7/-12 等无法连接场景，提取日志并发至 [email protected] 是工单系统里优先级最高的排障入口。日志里封存了握手阶段的 TLS 指纹、SmartBoost™ 选路结果、本地 DNS 缓存与 GFW 重置标记，比文字描述更能直接指向根因。
经验性观察：过去三个月 Reddit 子板块 r/KuaiLian 的 200+ 案例中，上传日志后首次回复平均缩短至 38 分钟；未上传日志的帖子往往要在评论区来回 3–5 次补齐环境信息。对于抢时效的直播、选课场景，这几十分钟就是直接成本差距。
前置检查：确认你处于“可提取”状态
日志只在客户端尝试连接后才会写入。若 App 刚被系统强制停止，或你刚清掉存储权限，本地可能一片空白。请先打开快连 → 点击“连接”至少一次，让流程跑到失败提示，再执行后续步骤。
安卓 13 及以上对“应用专属目录”做了权限收紧，无需 root 即可读取，但需使用系统文件管理器或电脑端 ADB。若你正在使用 MIUI、ColorOS 等深度定制系统，请临时关闭“USB 数据隔离”开关，否则 PC 端只能看到空白文件夹。
路径一：系统文件管理器直拷（无电脑最快）
1. 开启“本地日志”开关
打开快连 → 右上角⚙️设置 → 高级 → 诊断 → 勾选“本地日志（Local Log）”。此时会弹出 Toast 提示“重启后生效”，点击“确定”后返回主界面，再点一次“连接”让日志写入。
2. 定位日志文件
使用系统自带的“文件管理”→ 内部存储 → Android → data → com.quicklink.privacy tool → files → Logs。按修改时间排序，最新的 ql_client_YYYY-MM-DD_HHMMSS.log 即为目标文件。
3. 压缩并发送
长按日志 → 更多 → 压缩为 ZIP。压缩后体积通常 60–120 kB，可直接通过邮件附件或 Telegram 官方频道 @QuickLinkSupportBot 上传。标题格式建议“安卓无法连接-日志-机型-系统版本”，方便工单系统自动分拣。
路径二：ADB 拉取（适合批量或 PC 已在手）
1. 手机打开“开发者选项→USB 调试”，连接电脑。
2. 在终端执行：
adb shell ls -lt /sdcard/Android/data/com.quicklink.privacy tool/files/Logs | head
3. 找到最新日志文件名后执行：
adb pull "/sdcard/Android/data/com.quicklink.privacy tool/files/Logs/ql_client_XXXX.log" ~/Desktop/
4. 若路径含空格，加双引号即可。拉取完成后按上述同样方式发送。
路径三：Logcat 实时抓取（极端闪退场景）
当 App 点击连接直接闪退，本地尚未生成文件时，可用 Logcat 把系统缓冲区里的快连组件日志一次性倒出。步骤：电脑端执行 adb logcat -d | findstr QuickLink > crash.log（Windows）或 grep（macOS）。生成的 crash.log 连同 ql_client.log 一并打包，官方可对照时间戳还原闪退堆栈。
常见失败分支与回退
- 文件夹空白：99% 是未开启“本地日志”或刚清过存储。回退→确认开关已勾选并重新连接一次。
- 压缩按钮灰色：部分 ROM 默认屏蔽“压缩”功能，可安装第三方文件管理器（如 Material Files）解决。
- ADB 提示“no permission”：尝试更换数据线或把 USB 用途改为“文件传输（MTP）”，仍失败就转路径一。
边界与副作用：什么时候不该上传
日志里会记录你当前所选节点 IP、协议类型与握手时戳，若你所在组织对“外联 IP 痕迹”敏感，请先征得内网审计团队同意。快连官方声明日志仅用于排障，收到后 30 天自动销毁，但合规责任仍需用户自担。
另外，若你正在使用“USDC 自动扣费”且钱包地址与邮箱同名，日志文件名可能附带内部 UID，虽对外无意义，但极度敏感者可手动把文件名改为匿名再打包。
验证与观测：确认官方已收到
发送后 5 分钟内，你会收到自动回复邮件，标题含 [Ticket#XXXX]。若使用 Telegram 机器人，会返回相同编号。把编号保存好，后续追加信息直接回复同一线程即可，避免重复开单导致处理延迟。
适用/不适用场景清单
| 场景 | 建议 |
|---|---|
| 个人用户，节点突然全红 | 优先上传日志，官方一般 1h 内给出临时可用节点 |
| 公司配发手机，MDM 禁止 USB | 改用路径一，仅走邮件；勿用 ADB 避免违规 |
| 海外直播，限 15 分钟恢复 | 同步把日志发 Telegram 频道，工单+社群双通道 |
| 仅 DNS 污染，连接未失败 | 日志价值低，可先用 DoH 切换，省一步 |
最佳实践速查表
- 任何报错先点一次“连接”再提日志，保证内容新鲜。
- 文件名带时间戳，无需改后缀；压缩仅为了邮箱网关。
- 标题统一格式，方便系统合并同类工单。
- 同一设备 24h 内重复失败，追加回复即可，勿新开邮件。
- 若官方要求“完整文件夹”，把 Logs 内所有 *.log 一并打包，通常 < 1 MB。
FAQ：官方已确认的 5 个高频疑问
日志里会保存我的浏览记录吗？
不会。日志仅记录握手、选路与错误码，不含 URL 与 payload，官方已通过瑞士 PRICE 审计，报告公开可查。
安卓 14 提示“受限设置”无法开启本地日志？
系统限制第三方 App 调用高危权限，请在“设置→应用→快连→允许受限设置”打开开关，再回 App 勾选即可。
发送后多久能收到人工回复？
工作日 09:00-22:00 CST，平均 30-60 分钟；周末与节假日可能延长至 4h 内。
可以只发截图不发日志吗？
截图只能看到错误码，无法定位节点与握手细节，官方会要求补日志，反而增加往返。
日志文件太大怎么办？
若超过 5 MB，可只保留最近两天的 *.log 文件，或先用 7-Zip 选择“固实压缩”，通常可压至 10% 以内。
收尾：下一步行动
当你再次遇到安卓端无法连接，提取日志并发给官方是最短路径。先确认“本地日志”开关已开，选一条你最顺手的导出方式，5 分钟内完成打包；标题写清机型与系统，工单系统会自动匹配历史案例。发送后保存 Ticket 编号，官方平均 30 分钟给出节点或协议级解决方案。把这篇步骤加入浏览器书签，下次直接照表操作，省下的时间留给直播、选课或推代码。
