快连macOS端如何导出日志并发送给技术支持？

功能定位：为什么需要手动导出日志

在快连（QuickLink）macOS 客户端中，导出日志是官方唯一认可的排障入口。与 Windows 端“一键反馈”不同，macOS 因沙箱与签名限制，日志必须经用户手动打包后，才能通过加密邮件通道送达技术支持。该流程既满足 Apple 隐私指引，也避免第三方 IM 压缩导致关键时间戳丢失。

经验性观察：若仅截图「连接失败」弹窗，工程师只能看到 UI 层错误码；而完整日志包含 TUN 驱动状态、AI 线路切换记录与 Token 补贴节点轨迹，可将定位时间从数小时压缩到数十分钟。

操作路径：最短3步完成导出

图形界面（推荐）

1. 顶部菜单栏点击快连图标→「帮助」→「导出诊断日志…」
2. 在弹出的保存面板中，选择「桌面」或「下载」文件夹，文件名自动生成QuickLink-Logs-日期时间.zip
3. 压缩包生成后，系统会提示「是否立即打开邮件客户端」；点击「打开」即可自动填入收件人与 PGP 公钥，发送即可。

命令行兜底（当 GUI 卡死）

若客户端处于「初始化驱动」假死状态，图形菜单可能无法响应。此时可打开终端执行：

sudo /Applications/QuickLink.app/Contents/MacOS/QuickLink --export-logs ~/Desktop

命令执行完毕会返回Export path: /Users/xxx/Desktop/QuickLink-Logs-xxx.zip，即可手动附加到邮件。

平台差异与版本前提

系统版本	快连最低要求	导出入口差异
macOS 12 Monterey	7.2.0	无「帮助」菜单，需按住 Option 键点击状态图标
macOS 13 Ventura	7.3.0	菜单栏图标右键即可见「导出诊断日志」
macOS 14 Sonoma	7.4.0	与 Ventura 一致，但压缩包自动附带系统 Profile
macOS 15 Sequoia	7.4.0+	若启用 SIP，需先签名日志工具，否则命令行会报「Killed: 9」

回退方案：当导出按钮灰色

经验性观察：在以下两种场景，「导出诊断日志」呈灰色：

• 客户端未完全启动（图标仍在弹跳）
• 上次导出任务未完成，/tmp/ql-export.lock残留

此时可：

1. 退出客户端（Cmd+Q）
2. 终端执行rm /tmp/ql-export.lock
3. 重新打开客户端，按钮即恢复可用。

隐私边界：日志里到底有什么

官方文档声明，压缩包仅含：

• 连接时间戳与所选节点编号（非 IP）
• TUN 驱动加载结果与错误码
• AI 线路评分（延迟、丢包、带宽利用率）
• 分应用代理规则命中计数（无具体域名）

不会包含：浏览历史、Token 钱包地址、MAC 地址或用户文件。若仍担心，可在发送前解压删除user_prefs.json（仅保存本地主题与语言设置），再重新压缩。

发送给技术支持的最佳实践

1. 邮件标题统一格式：[macOS日志] 无法连接新加坡5-CN2节点，方便工单自动分拣。
2. 正文附上「问题发生时段」与「可复现步骤」，例如「每周三22:00固定丢包」。
3. 若已尝试回退方案，请说明结果，避免重复建议。
4. 压缩包若>10MB，使用官方 Nextcloud 临时上传，避免企业邮箱拒收。

验证与观测方法

发送日志后，可在客户端「帮助→工单状态」查看工程师是否已拉取文件。若状态 48 小时仍显示「等待日志」，大概率是邮件网关拦截，可改用命令行导出后上传 Nextcloud，并在工单追加链接。

不适用场景清单

• macOS Beta 版：因内核 API 每日变动，官方拒收日志，需回退正式版后再提交。
• 侧载破解客户端：签名无效，日志缺少关键 TUN 字段，工程师无法分析。
• 企业 API 接入场景：日志里无 SASE 零信任握手详情，需改用企业控制台「批量诊断」功能。

FAQ（FAQPage Schema）

下一步行动建议

若你正被「连接超时」困扰，立即按本文图形界面 3 步导出日志，并在邮件正文注明复现时段。发送后，用「工单状态」跟踪工程师是否已拉取；若 48 小时无更新，通过 Nextcloud 二次上传即可。保持客户端为截至当前的最新版本，可避免多数权限与签名问题。