記錄檢視器

記錄檢視器讓您檢閱遊戲遇到錯誤或當機時產生的 Ren’Py 錯誤追蹤記錄。

當 Ren’Py 遊戲在遊戲過程中當機或遇到 Python 錯誤時，引擎會將 traceback.txt 檔案寫入遊戲的目錄。當遊戲關閉時，Spark 會自動：

1. 偵測 traceback.txt 檔案
2. 附加 Spark 系統資訊（iOS 版本、Spark 版本、引擎版本、遊戲設定和裝置設定）
3. 以時間戳記重新命名檔案（例如 traceback_20260311_143022.txt）
4. 將其移動到遊戲目錄中的 logs/ 資料夾

每次當機都會產生一個獨立的記錄檔，因此您可以檢閱遊戲的錯誤歷史記錄。

記錄檢視器可從遊戲詳情畫面存取。當遊戲有一個或多個可用的錯誤追蹤記錄時，會出現綠色的 Logs 按鈕。

如果在遊戲結束後立即偵測到錯誤追蹤，Spark 會提醒您有記錄檔可供檢閱，並提供立即檢視的選項。

記錄包含 Ren’Py 錯誤追蹤 — Python 錯誤訊息和堆疊追蹤，描述遊戲執行過程中出了什麼問題。每個記錄還包含附加在末尾的 Spark 系統資訊：

• 使用的 Ren’Py 引擎版本
• iOS 版本和 Spark 版本/建置號碼
• 完整的應用程式和遊戲設定
• 翻譯設定（如已啟用）
• 裝置變體覆蓋（如已設定）

記錄瀏覽器顯示所選遊戲的所有已儲存的錯誤追蹤檔案，按最新排序。每個項目顯示檔名和建立日期。點選記錄以檢視其完整內容。

檢視記錄時，您可以與支援團隊分享：

• 分享按鈕 — 開啟 iOS 分享表單，可透過任何應用程式（電子郵件、雲端儲存、訊息等）匯出錯誤追蹤
• 傳送郵件至支援 — 將記錄直接傳送到 Spark 支援電子郵件，並附加錯誤追蹤檔案

您可以從記錄瀏覽器選單中刪除某遊戲的所有記錄。這會移除該遊戲的整個 logs/ 資料夾。

向支援團隊回報問題時：

1. 啟動遊戲以重現問題
2. 當機後，從遊戲詳情畫面開啟記錄檢視器
3. 在 Discord 上或透過電子郵件分享最新的錯誤追蹤記錄

錯誤追蹤和附加的系統資訊為支援團隊提供診斷問題所需的詳細資訊。