跳转到内容
Codux Codux AI

反馈与诊断

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

帮助 → Export Diagnostics… 会保存一个 JSON 文件(codux-diagnostics-<时间戳>.json),里面是一份脱敏快照:

  • 应用与更新信息
  • 关键路径(应用数据目录、运行时临时目录、runtime 日志、live 日志)
  • 脱敏后的设置、你的项目列表、AI 状态
  • 性能快照(最近的主线程卡顿)
  • 脱敏后的 SSH 配置与基础环境信息(系统、架构)

把这个 JSON 附在 GitHub issue 里即可。注意它记录的是日志文件的路径,不是日志内容——如果我们需要,请另外附上日志文件本身。

Codux 写两份日志:

  • runtime-rust.log —— 主运行时日志,在应用数据目录
  • live-rust.log —— 实时运行桥接日志,在系统临时目录
平台应用数据目录临时目录
macOS~/Library/Application Support/Codux$TMPDIR/codux
Windows%APPDATA%\Codux%TEMP%\codux
Linux~/.config/Codux(或 $XDG_CONFIG_HOME/Codux/tmp/codux

所以在 macOS 上这两个文件是 ~/Library/Application Support/Codux/runtime-rust.log$TMPDIR/codux/live-rust.log

Codux 在每次会话开始时清空 runtime 日志;更早的运行会轮转成 runtime-rust.log.1runtime-rust.log.5。macOS 上打开应用数据目录:

Terminal window
open ~/Library/Application\ Support/Codux

如果应用启动后立刻崩溃或卡死,macOS 可能把崩溃报告写到 ~/Library/Logs/DiagnosticReports/(找 Codux-*.ips)。挑时间戳与崩溃最接近的那一个附上——导出诊断不会自动打包这些。

Terminal window
open ~/Library/Logs/DiagnosticReports

提交 issue 时请附上:

  • 系统版本 + Codux 版本
  • 复现步骤
  • 诊断 JSON(帮助 → Export Diagnostics…
  • runtime-rust.log(必要时再加轮转的 runtime-rust.log.1
  • live-rust.log(若存在)
  • 匹配的崩溃报告(若有)