功能说明
什麼時候需要
當 Primuse 崩潰、卡住不動、掃描不全、某個音樂來源連不上或播放中斷，作者往往需要看到出問題那一刻的記錄。診斷資訊只儲存在你的裝置上，不會自動發出，只有你親手傳送時才會離開裝置。
開始之前
- 先確認 App 版本：設定 → 關於，可以看到版本號與組建號。回饋時請一併說明。
- 想上傳給作者，裝置需要能連網；每台裝置每天最多上傳 5 次，一次打包不超過 8 MB。
第 1 步：開啟診斷模式（建議）
- 開啟 設定 → 關於 → 「診斷報告」。
- Mac：設定 → 關於 → 「診斷記錄…」，在開啟的視窗裡點「診斷報告」。
- Apple TV：在 設定 裡開啟「診斷報告」。
- 開啟「記錄詳細日誌」。接下來 24 小時，App 會多記錄一些排查用的細節，到時間自動關閉。
- 讓問題再發生一次（例如重新掃描、重新播放那首歌、重新連線那個音樂來源），記下大概時間。
開啟診斷模式之前發生的事情，只有普通日誌，細節可能不夠；所以最好開著它重現一次。
第 2 步：上傳給作者
- 回到「診斷報告」頁，點頁面上方工具列裡的「傳送給作者」。
- 在「附件（可選）」裡選擇要帶上的內容：「診斷報告」（崩潰與卡頓報告、執行指標報告）和「日誌」。
- 需要的話，在「圖片（可選）」裡新增截圖（最多 6 張，會自動縮小），並在「需求或建議」裡寫下：你做了什麼、期望什麼、實際發生了什麼、大概幾點。
- 點底部的「上傳給作者」。會依次顯示「正在打包…」「正在上傳 …%」「正在確認…」。
- 看到「已上傳給作者」後，點「複製編號」，在 GitHub 或郵件裡回饋時附上這個編號。
預期結果： 頁面顯示一個報告編號。上傳成功後，已上傳的本機報告和日誌會被清理。
Apple TV 上沒有系統的崩潰報告，上傳的只有日誌和留言；完成後會顯示編號，可以用「再傳一份」再傳一份。
不能上傳時：改用郵件或分享
- 上傳按鈕下方有「改用郵件傳送」或「改用系統分享」。郵件會附上你選擇的報告或日誌，由你確認後傳送。
- 如果上傳服務不可用，頁面不會顯示上傳按鈕，工具列按鈕會變成「開啟郵件」或「分享」，並顯示作者的郵箱位址。
- 1.12.2 之前的版本沒有上傳功能，直接用「傳送給作者」走郵件或分享即可。
只想單獨分享某一份報告
在「診斷報告」頁點一份報告即可單獨分享。Mac 上還可以用「匯出紀錄」在訪達中找到日誌檔案。
選項說明
| 選項 | 含義 |
|---|---|
| 當機與卡頓報告 | 系統在 App 崩潰或長時間卡住後留下的報告，通常要到下次開啟 App 後才會出現 |
| 執行指標報告 | 系統定期提供的執行資料（例如記憶體峰值、退出原因） |
| 日誌 | App 自己記錄的最近播放、掃描和同步過程；上傳或分享時只帶最近的一段 |
| 記錄詳細日誌 | 24 小時內記錄更多細節，之後自動關閉 |
| 清除日誌 | 刪除本機日誌，刪除後無法找回 |
隱私
日誌裡會有歌名、檔案路徑，以及折成短標記的音樂來源位址和帳號；密碼、權杖等憑證在寫入前就會去掉。上傳的內容只用於排查問題，在作者的伺服器上儲存 30 天后刪除（伺服器空間不足時可能更早刪除）。傳送前你可以取消勾選「日誌」或不新增截圖。
限制
- 一次上傳打包後不超過 8 MB；每台裝置每天 5 次，未完成的嘗試也會佔用次數。
- 本機的報告和日誌大約保留 7 天。
- Apple TV 沒有崩潰與卡頓報告；Apple Watch 沒有診斷入口，請在配對的 iPhone 上回饋。