功能定位：为什么技术支持只要“连接日志”
在 kuailian（QuickLink privacy tool）的工单系统里，连接日志是官方唯一公开声明可用于“节点连通性诊断”的本地文件。它记录拨号时间、选中协议、握手往返、出口 IP 与断线原因，不包含浏览内容，与“零日志策略”并不冲突。2026-02 版本起，日志默认关闭，需要用户手动触发一次“问题复现”才会写入，避免日常冗余。
经验性观察：上传完整日志可把平均工单响应时间从两天缩短到数小时；若只截屏错误码，客服大概率会回要日志，来回多一轮。
前置检查：确认本地已开启“诊断模式”
导出之前，先验证客户端是否处于“诊断模式”。若关闭，日志文件不会生成，导出按钮呈灰色。
- 打开快连 → 我的 → 设置 → 高级 → 诊断模式，拨到“开启”。
- 返回主页，重新连接一次，让程序写入最新事件。
提示：开启后客户端会在本地保留最近三天、最大 50 MB 的循环日志；超过上限自动覆盖，不必担心硬盘爆掉。
平台差异：Android / iOS / 桌面端最短路径
Android（含 HarmonyOS）
我的 → 帮助与反馈 → 导出连接日志 → 选择“系统文件选择器” → 保存到 Download/QuickLinkLogs。文件名为 QuickLinkLog_[日期]_[随机四位].zip，约数百 KB。
iOS / iPadOS
由于沙箱限制，日志先写入 App 独享区，导出需走“分享面板”。路径：设置 → 诊断 → 导出日志 → 等待“已打包”提示 → 点击“分享” → 选择“存储到文件”或“邮件”。注意：若选 AirDrop 到 Mac，接收后仍为 .zip，切勿解压后单独发送零散文件，客服系统会提示格式不符。
Windows / macOS
顶部菜单 Help → Export Connection Logs → 自动打开资源管理器/Finder 并选中 ZIP。桌面端额外提供“仅上次会话”与“最近三天”两种粒度；若问题间歇性出现，优先选“三天”以提高复现率。
打包内容清单：哪些文件会进 ZIP
以当前最新版本为例，压缩包内常含：
- conn.log：核心连接事件，JSONL 格式。
- route.json：AI-Route 选路结果，含节点 IP（已脱敏最后两段）。
- wg-stats.txt：WireGuard 握手计数。
- meta.xml：生成时间、客户端版本、系统型号。
不含浏览器历史、不含 DNS 查询目标，可放心上传。若仍担心节点 IP 泄露，可用文本编辑器把 route.json 内 IP 最后一组数字手动改成 x，再压缩回包；官方客服表示“轻度脱敏不影响诊断”。
发送通道：工单系统 vs 邮箱 vs 社群
1. 首选工单：官网右上角“提交请求” → 问题类型选“连接失败” → 附件按钮 <20 MB。ZIP 若超尺寸，可拆分成 part1/part2 依次上传，系统会自动合并。
2. 次选邮箱：[email protected]，标题格式“日志+[问题简述]”。经验性观察：邮箱通道排队人数比工单少约三成，但回复会要求你回到工单系统追踪进度。
3. 社群紧急通道：QQ群/钉钉群有“日志机器人”仅做临时收集，客服会给你一个一次性网盘链接，24 h 失效。适合无法翻墙上传官网的情况。
常见失败分支与回退方案
导出按钮灰色
原因：诊断模式未开或刚开启尚未重连。回退：手动断开 → 再连一次 → 等待 10 s 让事件落盘。
iOS 分享面板闪退
工作假设：日志>30 MB 时压缩线程占满内存。缓解：桌面端登录同一账号 → 同步最近会话 → 用电脑端导出。
上传提示“格式不符”
原因：用户把 ZIP 解压后单独上传 conn.log。回退：重新打包成 ZIP，保持顶层文件在根目录，不要嵌套文件夹。
隐私剪裁：如何手动脱敏 yet 保留诊断价值
官方明文允许轻度脱敏，但以下字段若被删除会导致工单被退回：
- 时间戳（相对时间即可，不必删）
- 协议类型（WireGuard/QuickUDP/TCP-TLS）
- 错误代码（如 Handshake Timeout=110）
可安全删除：公网出口 IP 后两段、运营商 DNS 域名、Wi-Fi SSID。剪裁后请用 ZIP 重新压缩，切勿改扩展名为 .txt 上传。
验证与观测：怎么知道日志已足够
在 conn.log 里搜索“disconnect”，若能看到断开原因（如“policy-down”或“keepalive-timeout”），说明已捕获异常；若只有“connecting”没有“connected”，则日志不完整，需再次复现问题。
经验性观察：一次完整的“连接-稳态-断线”日志大约 150–200 行，文件体积 60–120 KB，低于此范围大概率缺少关键信息。
不适用场景：什么时候别折腾日志
1. 账号被封：Security Center 要求的是“手持证件+登录地截图”，日志无用。
2. 本地网络彻底离线（如飞行模式）：客户端写不进日志，导出为空包。
3. 仅流媒体解锁失败：多数情况是节点指纹失效，客服会让你直接换“Quantum-”前缀节点，无需日志。
最佳实践清单：一次就过的 6 步
- 开启诊断模式 → 重连 → 复现问题。
- 立即导出，文件命名保留原始时间戳。
- 检查 ZIP 内是否≥4 个文件，体积 50 KB 以上。
- 轻度脱敏 IP 后两段，勿删时间戳与错误码。
- 上传工单，标题写“日志+无法连接日本节点”之类关键词，方便客服路由。
- 提交后 30 分钟若无自动回复，把工单号复制到 QQ 群@值班客服，加速分拣。
FAQ：导出日志最常见的 5 个疑问
诊断模式会记录流量内容吗？
不会。日志仅记录连接事件、协议握手与断开原因，不含 URL 与 payload。
iOS 导出失败怎么办？
可换用桌面端登录同一账号，同步会话后导出；或在 iOS 设置里暂时关闭“低电量模式”再试。
日志文件太大，工单传不上去？
分卷压缩成 part1.zip、part2.zip，依次上传同一工单，系统会自动合并。
可以删除 route.json 里的 IP 吗？
允许把最后两段改成 x，但别整行删除，否则客服无法确认出口节点。
导出后客户端卡顿正常吗？
压缩瞬间 CPU 占用会升高，属正常现象，10 秒内恢复。
收尾：下一步行动建议
你已经掌握“开启诊断 → 复现 → 导出 → 剪裁 → 上传”的最短路径。下次遇到节点掉线、AI-Route 绕路或量子通道夜间降速，直接按本文 6 步执行，可让技术支持在数小时内给出节点修复或临时降级方案，而无需来回补充材料。
把这篇流程加入浏览器书签，并给桌面端“导出日志”按钮做快捷键，排错效率还能再快一倍。
