快连kuailian如何导出连接日志提供给技术支持？
kuailian日志导出完整步骤，含Android/iOS/桌面三端路径与命名规则，可直接打包发给技术支持
功能定位：日志为何需要手动导出
在 kuailian（Kuailian privacy tool）的「0 日志 + RAM-Only」架构下，本地客户端日志成了排查阻断、掉线、高延迟的唯一现场。官方技术支持在工单里常要求上传连接日志，用于比对节点握手失败码、AI 选线异常与本地网络栈。2026 年 2 月更新的 v9.6.1 起，日志系统从「仅本地缓存 12 小时」改为「用户可主动归档 7 日」，这才催生了手动导出需求。
下文将「日志」与「连接日志」交替使用，避免关键词堆砌，同时保持指代一致。
版本演进：日志菜单的三次迁移
v8.x 及更早版本把日志埋在「设置 → 关于 → 诊断日志」，入口深且无导出按钮，只能截屏；v9.0–v9.5 新增「一键复制」，但粘贴到邮件超过 300 行常被截断；v9.6.1 至今，官方把入口提升到「我的 → 帮助与反馈 → 导出日志」，支持 .zip 打包并附带脱敏后的设备码、系统版本、选线协议，让技术支持一次就能定位。
最短操作路径（分平台）
Android
- 打开 kuailian，确保处于未连接状态，避免日志写入冲突。
- 底部「我的」→ 右上角齿轮进入「设置」。
- 选择「帮助与反馈」→「导出日志」。
- 系统弹出「保存到」对话框，默认文件名：KuailianLog_yyyyMMdd_HHmmss.zip。
- 选择「下载」文件夹，点击「保存」。完成后在「文件管理 → 下载」即可找到压缩包。
经验性观察：若正在连接，压缩包可能提示「日志占用」，稍等 10 秒即可重试。
iOS
- 进入「我的」→「帮助与反馈」→「导出日志」。
- iOS 调用系统 ShareSheet，提供「存储到文件」「隔空投送」「邮件」三种出口。
- 若选「存储到文件」，建议先建子目录「KuailianLogs」，方便后续批量上传。
- 压缩包大小通常 80–200 kB，AirDrop 到 Mac 不会触发 iCloud 同步流量。
Windows / macOS
- 主界面左上角「≡」→「帮助」→「导出日志」。
- 桌面端额外弹出「包含节点测速记录」复选框，默认勾选；若仅需连接日志，可取消以减小体积。
- 保存路径示例：Windows 下载文件夹；macOS 默认在「~/Downloads」。文件名与移动端保持一致。
命名规则与内容结构
导出的 .zip 内含三份文件：
- connection.log：原始日志，时间戳到毫秒。
- node_brief.json：脱敏节点编号、协议类型、握手码，不含 IP。
- sys_info.txt：系统版本、kuailian build 号、是否开启 Kill-Switch。
技术支持要求「文件名带上工单号」时，只需重命名 .zip，内部文件无需改动。
常见失败分支与回退
导出按钮灰色
原因：日志正在被写入。先断开 privacy tool，回到主界面下拉刷新，再次进入菜单即可恢复。
压缩包 0 字节
本地存储权限被系统回收。Android 可「长按 App 图标 → 应用信息 → 权限 → 文件和媒体 → 允许」；iOS 需确认「设置 → 隐私 → 文件系统」未关闭。
邮件附件被退信
某些企业邮箱拒收 .zip。可改传 .macz 或先解压后单独发送 .log，技术支持同样接受。
例外与取舍：哪些场景不该导出
合规白名单企业机若已开启「禁止外传诊断数据」，导出前需在内勤系统报备，否则日志中的内网 IP 片段可能触发审计告警；借用他人设备时，日志里的设备码会与账号绑定，若对方之后超设备上限，原账号会被强制踢线；若只想确认「是否掉线」，直接在「我的 → 连接记录」查看离线事件即可，无需导出完整日志。
验证与观测：确保日志有效
可复现步骤：导出前手动制造一次「节点握手失败」——切换至「WireGuard-NG」协议后立刻开飞行模式 3 秒再关闭，日志里应出现 handshake_timeout 记录。若解压后搜索不到该关键字，说明日志轮询已被清理，需等待下次复现再导出。
与第三方 Bot 协同（仅归档）
经验性观察：部分用户会把 .zip 发送给「第三方归档机器人」做长期保存。该做法无官方 API，存在文件体积限制（<5 MB）。若需批量管理，建议本地建「年月」子目录，用系统定时任务清理 90 天前文件，避免重复占用存储。
适用/不适用场景清单
| 场景 | 是否建议导出 | 备注 |
|---|---|---|
| 偶发掉线，需定位节点 | ✅ 强烈建议 | 含握手码，方便官方比对黑名单 |
| 流媒体解锁失败 | ✅ 建议 | 日志里可查 DNS 解析链 |
| 公司合规电脑 | ⚠️ 需审批 | 日志含内网路由表 |
| 账号设备超限 | ❌ 无需导出 | 直接在后台踢设备即可 |
最佳实践清单（速查表）
- 每次出现「连续掉线 3 次以上」再导出，避免冗余工单。
- 导出前断开 privacy tool，确保日志写入完成。
- 文件名追加工单号，方便技术支持批量检索。
- 若日志 >1 MB，说明含大量测速记录，可在桌面端取消「包含节点测速记录」再导一次。
- 上传后本地保留 7 日即可删除，减少隐私残留。
FAQ：技术支持最常问的四句话
Q1：日志会泄露我的浏览记录吗？
不会。connection.log 仅记录握手、重连、协议切换事件，不含 URL 或内容；node_brief.json 里的节点编号为内部 ID，无法反推出真实 IP。
Q2：技术支持多久能回复？
经验性观察：工作日 18:00 前提交，平均在次日中午前得到节点调整或热修复推送；若遇周末，可能顺延至周一上午。
Q3：忘记在导出前断开 privacy tool，日志还有用吗？
可用，但最后一分钟可能不完整。技术支持会让你再复现一次问题后重新导出。
Q4：iOS 用「隔空投送」失败怎么办？
先检查接收端是否开启「所有人」；若仍失败，改用「邮件」发给自己，再下载到电脑。
收尾：下一步行动
遇到「反复掉线、流媒体突然 403、延迟晚高峰飙升」时，先按本文路径导出日志，再提交工单并附带复现时间。技术支持收到后，会在日志里检索 handshake_timeout、dns_resolve_fail 等关键字，直接给出节点或协议切换建议。把这份速查表收藏，下次不用再翻三层菜单。
未来版本观察：官方在测试通道曾出现「自动上传并 24 小时自毁」的实验开关，若正式上线，手动导出步骤可能简化为「一键授权」。在功能未实装前，掌握本文流程仍是最高效的回退方案。