Rivya Troubleshooting 指南

當 Rivya chat、uploads、generation tasks、history、notifications、credits 或 billing state 沒有如預期運作時，請使用這份 troubleshooting 指南。

當 Rivya 看起來壞掉時，最快的修復方式是先判斷到底是哪一層失敗。

大多數問題會落在五個地方之一：

• access 和 sign-in
• model 或 input mismatch
• async task state
• wallet 或 payment state
• saved work lookup

這種拆分比把所有問題都當成 generic「bug」有用得多。

1. Chat 無法送出

如果 chat 無法真正執行，請先檢查簡單原因：

• 你可能仍在 public landing flow，需要先登入才能送出
• draft message 可能是空的
• saved session 可能沒有乾淨載入

如果問題和特定 session 有關，請從 History 重新開啟 conversation，而不是猜測你原本在哪條路徑上。

如果任務很窄且重複，從 tool entry 重新開始，也可能比繼續待在寬泛 plain-chat thread 更乾淨。

2. Generation 無法開始

如果 image、video 或 audio generation 在真正開始前就失敗，常見原因是：

• 缺少必要 prompt content
• dialogue-style audio form 不完整
• 所選 model 需要 reference file，但沒有提供
• account credits 不足

目前，insufficient credits 可以在 upstream service 被呼叫前就讓 run 失敗。這就是為什麼「什麼都沒發生」的感覺，仍然可能留下真實 failed record 和 notification。

3. Uploads 失敗

Uploads 是 model-driven，不是 category-driven。

這代表：

• 同一 category 中不是每個 model 都接受相同 reference kinds
• 不是每個 model 都接受相同數量的 files
• size 和 type limits 會在真正 generation request 前執行

如果 upload 失敗，請檢查：

• model 是否完全支援該 file kind
• 是否已經達到目前 reference-file limit
• file type 或 size 是否違反目前 upload rules

如果 workflow 是 audio cleanup 或 isolation，請記得 uploaded-audio paths 和 prompt-first TTS 或 voice generation 在結構上不同。

4. Task 卡在 In Progress

Image、video 和 audio runs 在 Rivya 中是 async tasks。

可見狀態是：

• WAITING
• GENERATING
• SUCCESS
• FAILED

如果 task 看起來卡住，不要只看目前頁面。

也檢查這些介面：

• active Studio
• History
• Notifications Center
• /dashboard recent generations

有些 tasks 透過 callback 完成，有些透過 polling 或 refresh 完成。所以「still generating」本身不代表「lost」。它常常只是 task 仍在等待最終 upstream result settle。

5. Task 失敗

Rivya 中的 failure 通常會被保留，而不是隱藏。

Failed task 可以保留：

• failed status 本身
• error message
• 當 reserved credits 應該 reversal 時的 refund state
• generation-failed notification

所以正確下一步通常是：

1. 讀取 failure state
2. 判斷問題是 credits、prompt，還是 input mismatch
3. 修正該特定原因後才 rerun

不要把每個 failure 都當成 transient UI issue。

6. Result 看起來消失

通常 result 並沒有消失，只是在錯誤介面上。

當問題是：

使用 History。

當問題是：

使用 Notifications Center。

大致規則是：

• chat 回到 chat history
• image、video 和 audio 回到 generation history
• billing 和 credit events 通常在 notifications 中最清楚

7. Payment State 看起來過舊

如果 checkout 已完成，但 wallet 或 billing state 看起來仍然 stale，請先跟著 billing path 檢查，不要假設 payment 遺失。

目前 product flow 是：

1. complete checkout
2. 透過 /payment 返回
3. 讓產品 poll 並 refresh billing 或 wallet state
4. 檢查 /settings/billing 或 /settings/credits

Notifications 也可以保留 billing outcomes，所以當 account state 感覺不同步時，值得檢查。

8. 先檢查哪裡

使用這個 shortcut：

• current Studio：正在進行的 live work
• History：saved outputs 和 saved conversations
• Notifications Center：已發生的 operational events
• /settings/billing：subscription state
• /settings/credits：wallet balance、packs、expiry 和 transactions

大多數混亂來自第一步先檢查了錯誤層。

接著閱讀

• Rivya Task Lifecycle
• Rivya Image Workflows
• Rivya Video Workflows
• Rivya Audio Workflows
• Rivya References 與 Uploads
• Rivya Credits 與 Billing
• Rivya Payment Checkout

Troubleshooting Triage Checklist

重複同一個動作前，先選擇第一個要檢查的位置：

• Chat 無法送出：檢查 sign-in、session state、model availability 和 credit behavior。
• Uploads 失敗：檢查 file type、size、model support，以及 task 是否真的需要 file。
• Generation 卡住：檢查 task status、provider callbacks、polling、history 和 notifications。
• Billing 看起來 stale：檢查 Checkout return、webhook settlement、billing settings 和 credits settings。
• Results 看起來 missing：檢查正確 history kind，以及 task 是否真的 completed。

Escalating 前重新檢查

只有在你能說出 account area、task id 或 payment context、expected result、actual result，以及 last visible state 之後，才 escalate。這會把 support 變成 diagnosis，而不是 guesswork。