功能定位：为什么需要“带时间戳的完整连接日志”
在快连Windows端（Kuailian privacy tool）中，连接日志是排查延迟抖动、协议���手失败、节点被重置的第一手材料。默认只保留最近数百行，且时间戳被截断到分钟级；一旦需要回溯“昨晚 23:17 为什么掉线”，就必须提前导出完整日志。2026-02-28 发布的 v6.14.1 在桌面端补上了“一键导出”按钮，并允许附加毫秒级时间戳，本文围绕这一入口展开。
版本与入口差异：v6.14.1 前后行为对比
截至当前的最新版本（v6.14.1 及以上）才在图形界面提供“导出完整日志”复选框；旧版只能手动复制 logs\connection.log，时间戳精度缺失，且易被循环覆盖。若您仍在 v6.12 或更早，建议先升级，否则后文“一键”步骤不适用。
升级验证方法
主界面 → 右上角「⚙」→ 关于 → 版本号；点击“检查更新”后，若提示“已经是最新版”却仍显示 v6.12，说明通道未推送，可去官网下载完整包覆盖安装，配置不会丢失。
操作路径：一键导出完整时间戳日志（Windows 端）
步骤 1：打开“日志中心”
主面板 → 左侧边栏「日志中心」（Log Center）。若侧边栏被折叠，点击左上角「≡」展开。
步骤 2：勾选“包含毫秒时间戳”
在日志中心顶部工具栏，可见「导出」图标（↓）。点击后弹出对话框，默认仅勾选“最近 1000 行”；此时再勾第二项「包含毫秒时间戳 (UTC+8)」。
步骤 3：选择存储位置与文件名
系统会弹起 Windows 通用保存对话框，文件名自动带入当天日期，例如 Kuailian_Log_20260409_142236.json。推荐保留 JSON 后缀，方便后续用 VS Code 或 Excel Power Query 解析。
步骤 4：验证导出是否完整
用记事本打开刚导出的文件，首行应出现 {"ts":"2026-04-09T14:22:36.847+08:00",... 字样，其中 ts 字段即毫秒级时间戳；若只有 14:22 说明复选框未生效，需回退到步骤 2。
提示：JSON 格式便于筛选“协议类型=WireGuard 且延迟>300 ms”的记录，可直接在 VS Code 里 Ctrl+F 搜索。
命令行补充方案：当 GUI 无法拉起时
经验性观察：部分精简版 Windows 10 LTSC 缺失 WebView2 运行时，会导致导出对话框空白。此时可改用内置 CLI：
- 关闭快连主程序（必须完全退出，避免文件占用）。
- Win+R → 输入
cmd→ 回车。 - cd 到安装目录（默认在
%ProgramFiles%\Kuailian，具体路径因版本和安装方式而异，请以实际为准）。 - 执行：
Kuailian.exe /export-log outfile=C:\Users\%USERNAME%\Desktop\ ull.json ts_format=milli
命令完成后返回码为 0 即成功；若提示 0x80004005，说明日志文件被占用，需检查后台是否残留 KuailianDaemon.exe 进程。
与 macOS、Linux 端的行为差异
快连 macOS 版在 v6.14.1 同样提供 GUI 导出，但时间戳字段名称为 timestamp_iso，而非 Windows 的 ts，解析脚本需做兼容。Linux 版（截至当前的最新版本）尚未集成一键按钮，只能读取 ~/.local/share/Kuailian/logs/connection.log，时间戳精度仍为秒级；若需毫秒，必须改用 Windows 端或等待后续更新。
常见失败分支与回退方案
现象 A：导出按钮灰色不可点
原因：软件正以“零日志模式”运行（企业零信任策略强制开启）。回退：联系管理员在 Enterprise Console 关闭“禁止本地日志”策略，客户端重新登录后生效。
现象 B：文件只有 2 KB，明显缺失历史记录
原因：循环覆盖间隔设置过短。可在「设置→高级→日志保留时长」将默认值 24 h 调高至 168 h（7 天），此后新产生的日志才会累积；旧记录无法恢复。
现象 C：JSON 打开为乱码
原因：系统缺少 UTF-8 编码字体。用 VS Code 或 Notepad++ 选择“以 UTF-8 无 BOM”打开即可；切勿直接用 Windows 写字板，会误把中文节点名显示为方块。
日志字段速查表
| 字段 | 含义 | 示例 |
|---|---|---|
| ts | 毫秒级时间戳（UTC+8） | 2026-04-09T14:22:36.847+08:00 |
| proto | 协议类型 | WireGuard / Trojan / Hysteria2 |
| node | 节点别名 | Tokyo-Anycast-03 |
| latency | 握手延迟 | 43 ms |
| rx_bytes | 下行累计流量 | 1,337,488,192 |
| event | 事件类型 | connected / handshake_timeout / disconnected |
何时不该导出完整日志？
- 电脑剩余磁盘空间 < 1 GB 时，导出 7 天日志可能生成 500 MB 以上文件，导致 SSD 写满；先清理或缩短保留期。
- 在公共网吧等临时环境，导出文件易遗忘在桌面，含节点 IP 与协议特征，可能泄露业务隐私；如无必要，仅截取最近 100 行即可。
- 企业零信任场景下，管理员已启用“禁止本地日志”，强行用 CLI 导出会触发合规告警，可能被封号；请优先走工单流程。
验证与观测方法：如何确认日志已含毫秒
1. PowerShell 一行校验：Get-Content 'Kuailian_Log_20260409_142236.json' -TotalCount 1 | ConvertFrom-Json | % ts
若返回字段带小数点“.847”即成功。
2. Excel 导入：数据 → 获取数据 → 从 JSON → 转换后，ts 列设置自定义格式 yyyy-mm-dd hh:mm:ss.000，可绘制亚秒级延迟抖动折线。
与第三方分析工具协同
可将 JSON 喂给 ELK（Elasticsearch+Kibana）或 Grafana Loki，字段无需额外 Grok 规则即可索引。经验性观察：在 10 万行级别，Elasticsearch 默认分片查询耗时 < 1 s，适合小型团队自建观测台。导入前请删除 rx_bytes、tx_bytes 字段，可节省 30% 存储。
最佳实践清单（可打印）
- 每周一导出过去 7 天日志，文件名带周数，方便回溯。
- 开启“毫秒时间戳”后不要再开“零日志模式”，二者互斥。
- 导出后立即压缩为 7z 并加密码，避免节点 IP 裸奔。
- 企业用户把日志保留期设为 168 h，既满足排错，又符合多数合规“最短 6 天”要求。
- 脚本化：PowerShell 遍历多台电脑，统一拷贝到 \\NAS\KuailianLogs，减少人工遗漏。
故障排查速查
现象：ts 字段总是 1970-01-01
可能：本机 CMOS 电池失效，系统时间未同步
验证：cmd 执行w32tm /query /status
处置：更换电池或启用 NTP 自动同步后再重启快连
FAQ（结构化数据）
导出按钮灰色，且无企业策略提示？
通常是 WebView2 缺失，安装微软运行时或改用 CLI 命令即可解决。
毫秒时间戳为什么是 UTC+8 而不是 UTC？
快连客户端读取系统当前时区，若需 UTC，可在 PowerShell 用 DateTime.ToUniversalTime() 批量转换。
能否自动每天导出？
官方未提供计划任务接口，可用 Windows 任务计划调用 CLI 命令 /export-log 实现，注意加 -hide 参数避免弹窗。
总结与下一步行动
快连Windows端在 v6.14.1 之后真正做到了“一键导出+毫秒时间戳”，排障效率相比旧版秒级日志提升一个量级。若您还在手动复制片段，不妨立即升级到截至当前的最新版本，按本文四步导出第一份完整日志，并用 PowerShell 验证毫秒字段。企业用户记得与管理员确认“零日志”策略，避免导出按钮被禁用。把这份最佳实践清单贴在团队 Wiki，下次遇到“昨晚为什么掉线”的疑问，五分钟就能定位到具体节点与协议，再也不用靠回忆。
