功能定位：为什么需要手动导出日志
在 kuailian（Kuailian privacy tool）安卓端，连接日志默认只在本地循环存储，不会自动上传。当客服要求“完整日志”时，实质是让你把 /Android/data/com.kuailian.privacy tool/files/logs/ 目录下的 .log 与 .pcap 打包回传，用于定位握手失败、节点超时或分流失效等问题。自 v6.4.2 起，官方把这一流程固化为“一键导出”，但入口藏得深，加上各 ROM 对 SAF（存储访问框架）权限限制不一，不少用户点了导出却找不到文件。
版本演进：从隐藏目录到实验室开关
v6.2 及以前——需 root 或电脑端 ADB
早期版本把日志锁在私有目录，普通文件管理器无法触碰，只能借助 adb shell 拉取。客服常给出的命令是：
adb pull /sdcard/Android/data/com.kuailian.privacy tool/files/logs/
然而 MIUI 11+ 与 ColorOS 7+ 默认开启“隔离存储”，adb pull 会报 Permission denied，得先关“权限监控”，步骤繁琐，劝退新手。
v6.3——引入实验室开关，但仍需手动压缩
v6.3 在“设置-实验室”里放了导出诊断文件按钮，点击后在 /sdcard/KuailianDiag/ 生成时间戳文件夹，内含 connection.log、route table、dns.log 三枚文本。好处是免 root；坏处是日志一旦超过 20 MB，系统邮件无法一次性发送，用户得再手动压缩，而压缩路径选错，客服就找不到关键文件。
v6.4.2——一键打包 ZIP 并调用系统分享
最新版把流程缩成两步：① 点击导出 ② 选邮件/微信/QQ 发送。ZIP 命名格式 KuailianDiag_IMEI后四位_年月日时分.zip，体积被压到 10 MB 以内，并自动剔除 48 小时前的冗余抓包，减少隐私暴露。若导出失败，通知栏会留一条“导出失败：存储权限未授予”，点通知可直接跳权限设置页。
最短操作路径（原生 Android 14 为例）
- 打开 kuailian，点击右下角 我的
- 依次进入 设置 → 实验室功能 → 导出诊断日志
- 在弹出的“存储访问框架”面板里，点右上角“允许访问 KuailianDiag”
- 等待 3–5 秒，系统分享面板弹出，选常用邮件客户端
- 收件人填
[email protected]，主题保持默认，发送即可
经验性观察：ColorOS 14 用户若在第 3 步遇到“存储授权灰显”，需先退出实验室页，前往系统设置-应用-kuailian-权限-文件和媒体，改为“允许管理所有文件”，再回退重试即可。
失败分支与回退方案
场景 A：导出按钮直接闪退
多见于安卓 16 预览版，因系统对 QUERY_ALL_PACKAGES 权限加前台限制，kuailian 临时进程被回收。缓解：先把 kuailian 加入“电池无限制”名单，再关系统“高级内存保护”开关，重进实验室即可。
场景 B：ZIP 生成成功，但邮件附件提示“文件不可用”
华为鸿蒙 4.0 的“文件中转站”会二次加密，邮件客户端拿不到真实路径。改用微信“文件传输助手”把 ZIP 发给自己，再在电脑端另存为，然后上传工单。
场景 C：客服反馈“日志内容为空”
多半因为你刚清过缓存。kuailian 的日志在应用重启时会被截断，若问题发生在昨天而今天才导出，就只剩启动日志。正确姿势：复现问题后立即导出；若必须过夜，先在“实验室”打开“持久化日志”开关，可保留最近 72 小时全量数据，但会多占约 30 MB 空间。
隐私边界：哪些信息会被打包
| 文件 | 是否含个人标识 | 客服用途 |
|---|---|---|
| connection.log | 仅 IMEI 后四位 | 握手时序、节点 IP、错误码 |
| dns.log | 无 | 解析耗时、DoH 缓存命中 |
| route table.txt | 无 | Split-App 分流规则命中 |
| *.pcap | 无 | 仅前 100 个数据包，用于确认 TLS 指纹 |
提示：若仍担心隐私，可在导出前把“持久化日志”关闭，再手动删除 /sdcard/KuailianDiag/ 历史目录，然后重新导出，即可确保只含当次会话数据。
与第三方 Bot 协同（可选）
部分企业用户把工单系统接进 Telegram 群，通过第三方“归档机器人”自动收集日志。做法是让机器人发送邮箱地址（如 [email protected]），用户在系统分享面板选中即可。机器人无权读文件，仅聚合邮件，满足“权限最小化”。若用类似流程，务必把主题前缀统一成 [Kuailian-安卓-日志]，方便自动分拣。
验证与观测方法
- 导出完成，用系统“文件”App 进入
/sdcard/KuailianDiag/，确认 ZIP 大小 > 500 KB（仅几十 KB 说明日志被截断）。 - 解压后打开 connection.log，搜索关键字
handshake_timeout，若时间戳与复现场象吻合，即抓到有效日志。 - 电脑端用 7-Zip 打开 ZIP，确认根目录只有三枚文本与一枚 pcap，无 userdata 等敏感目录，即可放心发送。
适用/不适用场景清单
- 适合：连接节点提示“协议错误”、Split-App 分流突然失效、AI 分流引擎误判国内流量。
- 不适合：账号登录失败（应提供 UID 截图）、支付未到账（需订单号）、网速慢但无掉线（建议先用内置测速）。
- 慎用：公司合规要求“任何文件不得外发”——可把日志先拉到内网电脑，用 Wireshark 脱敏后再传。
最佳实践 5 条速查表
- 复现问题后立刻导出，避免日志被循环覆盖。
- 导出前确认存储权限为“允许管理所有文件”，防止生成空包。
- 邮件主题保持默认，客服系统依赖关键词自动分拣。
- 若文件 > 10 MB，先用微信传给自己再转电脑，绕开企业邮箱附件限制。
- 发送后在工单里补充“问题发生时间+节点名称”，可缩短排查周期。
FAQ（结构化数据）
导出日志会泄露浏览记录吗？
不会。connection.log 仅记录握手阶段的目标节点 IP 与错误码，不含具体网址；pcap 只抓前 100 包，且过滤掉 HTTP 明文。
为什么我的导出按钮是灰色？
首次使用需授予“所有文件访问”权限；部分鸿蒙机型需额外关闭“文件隔离”开关。
客服多久会回复日志分析结果？
经验性观察：工作日 8 小时内给出初步结论，若涉及 ShadowTLS 指纹更新，可能需要 24 小时。
收尾：下一步行动
日志导出不是“万能回传”，而是精准排障的敲门砖。按本文路径，你能在 2 分钟内完成无 root 导出，并确保隐私最小暴露。客服一旦反馈“日志已足够”，记得关闭“持久化日志”开关，释放存储。下次节点突然掉速，别急着换区服——先抓日志，你会比 90% 的用户更快拿到解决方案。