疑難排解與協助

先記錄頁面、大約時間、瀏覽器、作業系統及能重現問題的最短步驟。公開報告中不要包含存取權杖、私人卡片內容或完整學習檔案。

無法登入

重新整理登入頁一次，確認瀏覽器允許 app.repeto.ai 的第一方 Cookie。若 OAuth 視窗被封鎖，請從可見的登入按鈕重新開始，不要重用舊 callback URL。

若 Repeto 表示無法連線 API，代表應用程式外殼已載入，但 api.repeto.ai 沒有回應。檢查連線後重試。服務中斷無法靠建立其他帳戶解決。

本機開發預覽不同：網頁與 API 都必須執行，且預覽要指向本機 API 來源。只執行 Vite 前端時，開啟本機預覽 無法運作。

複習似乎沒有儲存

保持分頁開啟，直到離線指示消失。網頁複習器會先把評分寫入本機 IndexedDB 寄件佇列，再前進；連線恢復後以冪等方式重試。

卡片立即返回可能是學習步驟，而非同步失敗。檢查間隔預覽及牌組學習步驟。若多個分頁複習同一收藏，請關閉較舊分頁並重新載入最新分頁。

數量與學習總數不符

牌組清單可以顯示子樹所有到期、學習中及新卡。學習接著套用每日上限、佇列資格、暫停及所選範圍。父項總數已含後代，把父子可見列相加會重複計算。

若在可疑的整數停止，檢查 牌組設定 → 每日複習上限。API 上限是 9,999，不是 200。

匯入卡住

回到 匯入。Repeto 保存作用中工作，應重新開啟處理或預覽頁面。第一個工作進行時不要重複上傳。

若反覆失敗：

1. 從來源匯出新的 .apkg；
2. 確認檔案可在來源開啟；
3. 以新套件重試；
4. 保留失敗檔名及警告文字給支援。

匯入卡片顯示不正確

匯入時試用 Repeto 樣式，或在外觀切換是否保留匯入色彩。開啟筆記類型預覽，檢查正反面是否含不支援篩選器、固定尺寸、指令碼或假設 Anki Desktop 的選取器。

大型圖片應在卡片內自動縮放。若仍很小，檢查範本是否設定了窄寬度。固定尺寸 HTML 元素可覆寫應用程式圖片規則。

缺少圖片或音訊

確認匯入預覽是否回報媒體。套件可能引用資訊清單中不存在的檔名。從來源重新匯出並包含媒體，比手動更改封存檔名安全。

新附加媒體請等上傳完成再關閉編輯器。瀏覽器離線快取不能取代完成的伺服器上傳。

搜尋或篩選漏掉卡片

清除篩選，搜尋第一個欄位的文字。狀態、標籤及圖片篩選只縮小已載入頁面；對大型牌組請先載入更多結果。結構化 Anki 查詢語法尚未完全公開。

聯絡支援

帳戶、隱私、計費及產品問題請使用 Repeto 支援，並提供：

• 受影響頁面與牌組名稱，不要提供私人卡片文字；
• 瀏覽器／應用程式版本及作業系統；
• 線上及離線時是否重現；
• 確切警告或錯誤文字；
• 視覺行為重要時的短螢幕錄影。

不要以電子郵件傳送手動 API 權杖、OAuth 代碼、密碼或完整私人收藏。必要時支援會要求範圍受限的診斷。