功能說明
適用範圍
- 版本：Viozi 1.0（依據截至 2026-10-31 的原始碼整理，後續版本介面可能變化）。
- 平臺：iPhone、iPad、Mac。Apple TV 的「設定」裡沒有診斷入口，Apple TV 上的問題請在 iPhone 或 Mac 上用文字描述後反饋。
準備工作
- 能上網。上傳需要連線作者的伺服器。
- 儘量先把問題再復現一次，再立即上傳，這樣日誌裡會有剛發生的記錄。
- 想好一句話描述：在哪個媒體來源、做了什麼操作、看到了什麼現象、大約幾點發生。不要寫密碼、帳號或伺服器地址。
入口
- iPhone / iPad：底部「設定」→ 列表最下方「關於」分組 →「診斷報告」。
- Mac：「設定」→「關於」→「診斷記錄…」，會開啟一個診斷視窗，視窗右上角有「傳送給作者」和「匯出記錄」。
步驟（iPhone / iPad）
- 開啟「診斷報告」。如果 Viozi 之前崩潰或卡頓過，列表裡會有系統留下的報告，標有日期和大小；沒有時顯示「目前沒有診斷報告」。
- 點右上角「傳送給作者」。
- 在「附件（可選）」裡選擇要帶上的內容：
- 「診斷報告」：本機儲存的崩潰 / 卡頓報告。沒有報告時這個開關不能開啟。
- 「日誌」：Viozi 的執行日誌。上傳時只帶最近的一段。
- 在「需求或建議」裡寫下問題描述。
- 閱讀按鈕下方的說明：內容會上傳到作者的伺服器，只用來排查問題，30 天後刪除。同意後點「上傳給作者」。
- 依次顯示「正在打包…」「正在上傳 …%」「正在確認…」。
- 成功後顯示「已上傳給作者」和一個編號。點「複製編號」。
預期結果
- 你得到一個報告編號。在 palveni.com 留言板或郵件裡反饋時附上這個編號，作者就能找到這份報告。
- 報告在作者的伺服器上儲存 30 天。
可選項與差異
- 正式版（App Store）與測試版（TestFlight）：
- 正式版的「診斷報告」頁面沒有「匯出記錄」這一行，日誌只能透過「上傳給作者」附帶最近一段。
- 測試版多一行「匯出記錄」，可以把完整日誌透過分享面板（隔空投送、郵件、儲存到「檔案」）交給作者。
- 改用郵件傳送：上傳面板裡的「改用郵件傳送」會開啟系統郵件，收件地址在 App 裡顯示。正式版的郵件只附診斷報告，不附日誌。裝置沒有設定郵件賬戶時會提示「無法寄送郵件」，這時請改用上傳。
- Mac：診斷視窗裡的「匯出記錄」會在訪達中顯示日誌檔案，你可以自己決定要不要發出去。視窗還顯示記憶體、CPU、快取佔用和最近 30 天的崩潰次數。
- 只寫文字也可以上傳：不選任何附件、只填寫「需求或建議」也能提交。
限制
- 打包後不能超過 8 MB。
- 每臺裝置每天的上傳次數有限（目前預設 5 次），用完後要等到 App 提示的時間之後才能再傳。
- 上傳服務暫時不可用時，App 會提示，不會傳出任何內容。
- 上傳的是你選中的內容。日誌會去掉常見的敏感資訊，但仍請不要在描述裡寫密碼、令牌或私有地址。
出現問題時
- 上傳失敗：見 診斷報告上傳失敗。
- 應用打不開、閃退或卡住：見 閃退、卡住或進入安全模式時怎麼辦。
- 找不到報告或日誌：見 找不到診斷報告或日誌。