功能定位：为什么客服非要完整的连接日志
在 kuailian（QuickLink）工单系统里，“连接日志”被标记为最高优先级的附件。它记录了客户端从拨号到断线的全链路事件：选路策略、握手耗时、中继跳变、错误码、本地网络切换等。没有这份文件，一线客服只能让用户反复“换节点再试”，平均来回 3.4 轮才能定位问题；日志齐全时，首次回复即可给出根因，整体解决时长缩短约 60%。
官方在 v7.3.0 之后把“一键导出”做成显性按钮，并默认剔除敏感字段（如 Token 明文、真实 IP），既满足 GDPR 与中国个人信息保护法要求，也避免用户手动删减时误删关键时间戳。
版本差异：什么时候你一定能看到“导出日志”按钮
移动端
Android：v7.3.0 及以上，侧边栏「诊断工具」→「连接日志」→右下角悬浮“导出”图标。
iOS：v7.3.2 及以上，因 App Store 审核条款，入口放在「设置」→「帮助与反馈」→「导出诊断日志」。若版本低于 v7.3.2，只能截图后手动拼接，客服常因缺少时间轴而退回补充。
桌面端
Windows：v7.4.0 开始，主界面右上角“···”→「诊断」→「一键导出」。若使用绿色版（Portable），需先授予写入权限，否则按钮呈灰色。
macOS：与 Win 同版本号，但路径在菜单栏「QuickLink」→「诊断」→「Export Logs…」。若系统完整性保护（SIP）关闭，导出后不会自动打开 Finder，需要手动进入 ~/Documents/QuickLink_Logs/ 领取。
最短操作路径：三步完成打包
- 复现问题：先让客户端出现目标故障（如节点超时、游戏丢包），保持界面不要退出。
- 立即导出：按上文入口点击“一键导出”，系统会弹出进度条，通常 5–10 秒生成完成。
- 选择分享：移动端直接调用系统分享面板，可发送到邮件、Telegram 或保存到本地文件；桌面端会生成 .zip，命名格式 QuickLink_Log_YYYYMMDD_HHMMSS.zip，附带 readme.txt 说明文件结构。
经验性观察：在部分国产 ROM（如 ColorOS 14）上，如果未给快连开启“所有文件访问”权限，分享面板会提示“无可用应用”，此时需先进入系统设置手动授权，再返回重按导出。
文件里到底有什么：字段速读与隐私裁剪
官方 readme 把压缩包拆成四部分：
- connection.log：核心，含时间戳、节点别名、RTT、错误码，已做 Token 脱敏。
- routing.json：记录 AI 选路决策，方便工程师判断“是否绕路”。
- system_info.txt：系统版本、运营商、DNS 设置，不含硬件序列号。
- netstat.txt（桌面端独有）：当前路由表与监听端口，用于排查本地冲突。
如果企业用户需要额外隐藏内网 IP 段，可在导出前进入「设置」→「隐私」→「日志可见范围」把“局域网地址”开关关闭，再生成日志；该操作属于客户端本地裁剪，不会触发云端同步。
常见失败分支与回退方案
失败现象A：导出按钮灰色，提示“日志写入失败”
可能原因：Android 13 及以上默认禁止应用写入根目录。回退：进入系统「文件」→「内部存储」手动新建 QuickLink 文件夹，授予读写权限后重启客户端。
失败现象B：压缩包仅 1 KB，解压为空
可能原因：日志缓存被系统清理。回退：先在「设置」→「高级」→「调试模式」打开“持久化日志”，重新连接一次节点，再导出即可。
失败现象C：iOS 导出后无法通过企业微信发送
可能原因：企业微信策略屏蔽 .zip。回退：使用系统“邮件”发送给自己，或改存到“文件”后通过电脑端转发。
常见失败分支与回退方案
与客服协同：如何写一封一次到位的邮件
标题格式：QuickLink 日志 + 节点别名 + 问题关键词，例如「QuickLink 日志_US-LA05_晚高峰丢包 8%」。
正文三行即可：①出现时间段；②已尝试的节点与协议；③附件已含完整日志，无需额外截图。经验性观察：按此模板提交，工单首次响应时间从平均 6 小时降至 45 分钟。
不适用场景：什么时候别急着导出
- 仅偶尔一次 Speedtest 速率不达标，而后续 10 分钟自动恢复——大概率是节点例行负载均衡，无需日志。
- 本地宽带本身丢包（如光猫红灯）——应先排查运营商，日志里只会看到“ICMP unreachable”，对客服无增量信息。
- 公司网络已部署防火墙白名单，禁止 UDP 500–5000 端口——日志会显示“Handshake timeout”，但解决权在网络管理员，客服无法推送新端口。
最佳实践清单：提交前自检四步
- 时间对齐：确保手机系统时区与本地一致，否则日志时间戳与描述对不上。
- 版本写明：在邮件正文附带客户端版本号（可在「设置」→「关于」复制）。
- 文件完整：压缩包应 ≥20 KB 且含 readme.txt，若不足基本属于空包，会被退回。
- 隐私二次确认：若含公司内网地址，用官方裁剪开关处理，勿手动改文件，避免格式损坏。
FAQ：一键导出连接日志
日志会保存多久？
本地循环覆盖最近 7 天，导出动作只是复制，不会增加额外留存时间。
能否自动上传云端？
官方未提供自动上传，需用户手动发送；此举可防止非授权访问。
导出后网速变慢？
经验性观察：部分低端安卓机型在写大文件时 CPU 调度吃紧，可能出现数十秒速率下降，导出完成后自动恢复。
收尾行动建议
下次遇到节点异常，先别急着切换——保持现场，用本文路径一键导出日志，按模板提交客服，通常一个工作日内即可收到根因分析与补偿时长。把这份教程收藏在“收藏夹”，比反复问“为什么又卡了”更节省时间。