日志查看器

日志查看器让您可以查看 Ren’Py 在游戏遇到错误或崩溃时生成的错误追踪日志。

当 Ren’Py 游戏在游戏过程中崩溃或遇到 Python 错误时，引擎会将 traceback.txt 文件写入游戏目录。当游戏关闭时，Spark 会自动：

1. 检测 traceback.txt 文件
2. 附加 Spark 系统信息（iOS 版本、Spark 版本、引擎版本、游戏设置和设备配置）
3. 使用时间戳重命名文件（例如 traceback_20260311_143022.txt）
4. 将其移动到游戏目录内的 logs/ 文件夹

每次崩溃都会生成一个单独的日志文件，因此您可以查看游戏的错误历史记录。

日志查看器可从游戏详情界面访问。当游戏有一个或多个错误追踪日志可用时，会显示一个绿色的日志按钮。

如果在游戏退出后立即检测到错误追踪，Spark 会提醒您有日志文件可供查看，并提供立即查看的选项。

日志包含 Ren’Py 错误追踪 — Python 错误消息和堆栈跟踪，描述游戏执行过程中出了什么问题。每个日志末尾还附有 Spark 系统信息：

• 使用的 Ren’Py 引擎版本
• iOS 版本和 Spark 版本/构建号
• 完整的应用和游戏设置配置
• 翻译设置（如果已启用）
• 设备变体覆盖（如果已设置）

日志浏览器按最新优先的顺序显示所选游戏的所有已保存错误追踪文件。每个条目显示文件名和创建日期。点击日志以查看其完整内容。

查看日志时，您可以与支持团队共享：

• 共享按钮 — 打开 iOS 共享面板，通过任何应用导出错误追踪（邮件、云存储、消息等）
• 发送邮件至支持团队 — 将日志直接发送到 Spark 支持邮箱，并附带错误追踪文件

您可以从日志浏览器菜单中删除游戏的所有日志。这将移除该游戏的整个 logs/ 文件夹。

向支持团队报告问题时：

1. 通过启动游戏来重现问题
2. 崩溃后，从游戏详情界面打开日志查看器
3. 在 Discord 上或通过邮件共享最新的错误追踪日志

错误追踪和附加的系统信息为支持团队提供了诊断问题所需的详细信息。