反馈与诊断

发现 bug 或想提需求？请在 GitHub 上提 issue。

最快路径：导出诊断包

帮助 → Export Diagnostics… 会生成一个 .zip，里面包含我们需要的一切：

• runtime、previous runtime、live、previous live 日志（如果存在）。
• 性能摘要（最近的主线程卡顿）。
• 已保存的应用状态与异常状态备份。
• Codex / Claude / Gemini 的 hook/config 文件，以及对应 invalid 备份（如果存在）。
• 最多 12 个匹配的桌面端崩溃 / 卡死 / spin 报告（如果存在）。

把这个 .zip 附在 GitHub issue 里就好。

手动收集日志

如果你愿意自己收集，Codux 把日志写到：

• ~/Library/Application Support/Codux/logs/runtime.log
• ~/Library/Application Support/Codux/logs/runtime.previous.log
• ~/Library/Application Support/Codux/logs/live.log
• ~/Library/Application Support/Codux/logs/live.previous.log
• ~/Library/Application Support/Codux/logs/performance-summary.json

打开日志目录：

open ~/Library/Application\ Support/Codux/logs

注意：

• Codux 在每次启动时清理上次会话的日志。
• runtime.previous.log 仅在当前会话日志轮转后出现。
• live.log 用于记录可用时的实时运行桥接链路。
• performance-summary.json 覆盖最近的性能尖峰 / 主线程卡顿。

崩溃报告

如果应用在 macOS 上启动后立刻崩溃或卡死，系统可能会把崩溃报告写到 ~/Library/Logs/DiagnosticReports/（找 Codux-*.ips）。挑时间戳与崩溃最接近的那一个附上。

open ~/Library/Logs/DiagnosticReports

Issue Checklist

提交 issue 时请附上：

• 系统版本 + Codux 版本
• 复现步骤
• runtime.log
• runtime.previous.log（若存在）
• live.log / live.previous.log（若存在）
• performance-summary.json（若存在）
• 匹配的崩溃报告（若存在）