怎么在Windows端将快连日志导出为文件用于排错？

功能定位：为什么排错要先拿到本地日志

在快连加速器（QuickLink）的 Windows 客户端里，每一次连接事件、节点漂移、协议回退乃至虚拟网卡报错，都会实时写进本地日志。官方论坛与工单系统默认要求上传这份日志，才能判断是本地驱动冲突还是远端节点故障。换句话说，导出日志是后续一切排查的“入场券”。

版本演进也围绕“更快拿到日志”做文章：5.3.0 之前文件深埋 Roaming，5.4.0 起与可执行文件同级，5.5.0 又新增“日志分级”开关，可先关闭 DEBUG 级写入再拷贝，避免单文件上百兆的尴尬。下文路径与按钮名称均以截至当前的最新版本为准，旧版用户建议先升级，或在对应老路径里翻找。

一分钟决策树：我该用哪种导出方式

1. 客户端还能打开 → 右上角“日志目录”按钮一键跳转，复制当天 .log 即可。
2. 客户端已崩溃 → 手动进入安装目录，把 logs 整个文件夹打包。
3. 仅需最近一次连接片段 → 主界面右上角“连接记录”右键“导出此次日志”，系统会单独生成时间戳文件，体积最小。

经验性观察：方式 3 生成的片段约数十 KB，邮件附件最不容易被拦截；方式 2 整包可能上百 MB，适合先传网盘再把链接贴给客服。

操作路径（Windows 10/11 通用）

路径A：客户端内一键跳转

1. 启动快连加速器，等待主界面加载完成。
2. 右上角“设置”齿轮 → 左侧栏“诊断工具” → 点击“打开日志目录”。
3. 资源管理器自动定位到 logs 文件夹，内按日期排列 quicklink-yyyy-mm-dd.log。
4. 选中所需日期，Ctrl+C → 粘贴到桌面 → 用记事本或 VS Code 打开，检查文件头几行是否含敏感 token，如有可手动打码再外发。

路径B：崩溃后手动捞文件

1. Win+R 输入 %ProgramFiles%\QuickLink（64 位默认）或 %ProgramFiles(x86)%\QuickLink（32 位）。
2. 进入 logs 子目录，若看到 .dmp 与 .log 并列，说明程序曾异常退出，优先把同名 .log 与 .dmp 一起打包。
3. 若系统提示“文件正被占用”，先在任务管理器结束 QuickLink.exe 与 klink-tap6.sys 相关进程，再复制即可。

关闭 DEBUG 写入：让日志瘦身

5.5.0 起，设置 → 诊断工具 → 日志级别 默认是“信息”。若你曾打开“调试”模式协助开发组复现问题，文件会在数小时内膨胀到上百兆。上传前先把级别切回“信息”，再点击“清理旧日志”，系统会仅保留最近 3 天，体积可缩小到原来十分之一。

工作假设：清理后再复现一次问题，重新生成的单日志更容易被客服工具解析，来回邮件次数平均减少一次。

常见失败分支与回退方案

• 现象：点击“打开日志目录”无响应。原因：资源管理器被组策略禁用自动打开。处置：手动把路径贴到地址栏；或换路径 B。
• 现象：logs 文件夹为空。原因：安装时选择“便携模式”，日志被写到 exe 同级但被杀软隔离。处置：把快连加入杀软白名单，重启客户端，再试。
• 现象：日志里出现大量“send_ping error 10054”。经验性观察：本地网络对 ICMP 有 QoS 丢弃，不影响实际加速，可忽略。

与第三方工具协同：VS Code 正则脱敏

如果你担心日志里出现 UUID 或 token，可用 VS Code 打开后，Ctrl+H 勾选“正则”，输入 [a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}，替换为 [uuid]，一键匿名化。该操作不改变日志结构，官方仍可正常解析。

何时不该导出完整日志

1. 仅想确认节点延迟——用主界面“测速”即可，无需动文件。
2. 公司电脑对导出敏感文件有审计——优先使用“导出此次日志”片段，或先内部加密再打码。
3. 日志超过 500 MB——先清理旧文件，再复现一次，减少上传时间。

验证与观测：怎么确认日志已包含关键事件

1. 打开日志，搜索“CONNECT_SUCCESS”或“CONNECT_FAIL”，能看到时间戳与目标节点。
2. 若遇到蓝屏，搜索“klink-tap6”，若其后出现“BugCheck”字段，说明驱动触发系统崩溃，把这段前后 50 行单独复制给客服即可。
3. 想确认是否触发 AI 拥堵预判，搜索“predict_congestion”，若返回 action=switch，表明系统已提前切换节点。

适用/不适用场景清单

场景	建议
家用宽带偶发卡顿	导出单日志，定位是否节点漂移
公司网络禁止外发文件	仅截取错误段，内部审阅后再决定
Vision Pro 空间模式闪退	需连同 .dmp 一并打包，官方要看调用栈
Android 端问题	本文路径仅适用 Windows，请改用 Android 日志工具

最佳实践速查表

• 升级最新版 → 复现问题 → 调日志级别为“信息” → 清理旧日志 → 再复现一次 → 导出单日期文件 → VS Code 脱敏 → 上传网盘 → 把链接与时间点写进工单。
• 若客服要求补充 .dmp，记得把同名的 .log 与 .dmp 放在同一压缩包，避免来回补件。
• 上传后本地留一份备份，7 天后再删，防止客服二次索要。

FAQ：导出日志常见疑问

收尾：下一步行动

读完本文，你已知道快连日志导出的三种路径、两种清理方法与脱敏技巧。下次遇到节点漂移或虚拟网卡蓝屏，不必再截图零星报错——按“升级→复现→导出→脱敏→上传”五步走，客服一次就能定位。把这条流程收藏到浏览器书签，或转发给团队同事，排错时间平均可缩短一半。

未来版本若继续细化“分级日志”或增加“自动脱敏”开关，官方大概率会在更新公告里提前预告。保持客户端自动更新，第一时间体验新工具，你的工单往返只会更少。