トラブルシューティングとヘルプ

まず、ページ、だいたいの時刻、ブラウザー、OS、問題を再現する最短手順を記録します。公開報告にアクセストークン、非公開カード内容、完全な学習ファイルを含めないでください。

データを守る復旧手順から始める

警告と最小手順を記録し、ヘルプと復旧でネットワーク／API を確認し、同じ操作を再試行します（インポートは既存ジョブを再開）。一度再読込し、拡張機能なしの最新ブラウザーで試します。サイトデータを早期に消さないでください。未確認のローカル復習があり得るため、先に同期またはバックアップを確認します。

プラットフォームとオフラインの表

プラットフォーム	利用方法	オフライン境界
ウェブブラウザー	app.repeto.ai を開いてログイン。	シェル、キャッシュ済み読取、復習送信箱は利用可。ログイン、インポート、アップロード、新規読取は API が必要。
インストール PWA	インストール／ホーム画面に追加。	ウェブと同じ。ローカル復習同期までオンラインで開く。
iPhone/iPad	現行 App Store 版または PWA。Repeto 2.2 は準備中。	ネイティブの公開状態は別。端末限定アカウントは紛失前にメール連携。
Android	ブラウザー／PWA。ネイティブ版は未公開。	電池方針で背景処理が止まるため、開いた状態で同期確認。

ログインできない

ログインページを一度再読み込みし、app.repeto.ai のファーストパーティ Cookie が許可されているか確認します。OAuth ウィンドウがブロックされた場合、古い callback URL を再利用せず、表示中のログインボタンからもう一度開始してください。

API に接続できないと表示された場合、アプリ画面は読み込めましたが api.repeto.ai が応答していません。接続を確認して再試行します。サービス障害は別アカウントを作っても解決しません。

ローカル開発プレビューは異なります。ウェブと API の両方が起動し、プレビューがローカル API を参照する必要があります。Vite フロントエンドだけでは ローカルプレビューを開く は動作しません。

復習が保存されていないように見える

オフライン表示が消えるまでタブを開いたままにします。ウェブレビュアーは次へ進む前に IndexedDB のローカル送信キューへ評価を書き込み、再接続後に冪等に再送します。

カードがすぐ戻るなら、同期失敗ではなく学習ステップかもしれません。間隔プレビューとデッキの学習ステップを確認します。複数タブで同じコレクションを復習している場合、古いタブを閉じて最新を再読み込みします。

件数とセッション合計が一致しない

デッキ一覧はサブツリー内の期限、学習中、新規をすべて表示できます。セッションでは日次上限、キュー対象、一時停止、選択範囲がさらに適用されます。親合計は子孫を含むため、見えている親と子を足すと同じカードを二重計上します。

不自然な切りのよい数で止まる場合、デッキ設定 → 1 日の復習上限 を確認します。API セッション上限は 200 ではなく 9,999 です。

インポートが止まっている

インポートへ戻ります。Repeto は有効なジョブを保存しており、処理またはプレビューページを再表示します。最初のジョブが有効な間は重複アップロードしないでください。

繰り返し失敗する場合：

1. 元アプリから新しい .apkg を出力する。
2. 元アプリでファイルが開くか確認する。
3. 新しいパッケージで再試行する。
4. 失敗したファイル名と警告文をサポート用に残す。

インポートしたカードの見た目がおかしい

インポート時に Repeto のスタイルを使用 を試すか、外観でテンプレート色の保持を切り替えます。ノートタイプのプレビューで、非対応フィルター、固定寸法、スクリプト、Anki Desktop 前提のセレクターが表裏にないか調べます。

大きな画像はカード内で幅に合わせて縮小されるはずです。小さいままなら、テンプレート自体が狭い幅を指定していないか確認します。固定サイズの HTML メディアはアプリの画像規則を上書きします。

画像または音声がない

インポートプレビューにメディアが報告されたか確認します。パッケージがマニフェストにないファイル名を参照する場合があります。内部ファイル名を手動変更するより、メディア込みで元から再出力するほうが安全です。

新しいメディアを添付したら、アップロード完了までエディターを閉じないでください。ブラウザーのオフラインキャッシュはサーバーへの完了済みアップロードの代わりではありません。

設定 → メディアの健全性で読み取り専用走査と、安全な壊れた参照の除去、ノートタグ、未使用媒体の復元可能ゴミ箱移動をプレビューします。外部 URL を追跡／取得せず、バイトを永久削除しません。古いプレビューは拒否し、修復は安全な取り消しを提供します。

コレクションを復旧または置換する

データと復旧でネイティブアーカイブをダウンロード／検証し、空コレクションへ復元または明示的に置換します。置換前に復旧点を作り、最新 5 点を保持します。マージ復元と時刻指定自動バックアップはありません。

検索やフィルターでカードが見つからない

フィルターを消し、最初のフィールドの文字を検索します。状態、タグ、画像フィルターは読み込み済みページを絞るため、大きなデッキをすべて対象にしたと考える前に追加読み込みしてください。構造化 Anki クエリはまだ完全公開されていません。

単語境界は w: を使い、不正クエリは診断を表示します。アクセント無視、表示済み Cloze、正規表現、preset、introduced、custom-data は未対応です。

サポートへ連絡する

アカウント、プライバシー、請求、製品の問題はRepeto サポートへ連絡し、次を含めます。

• 対象ページとデッキ名（非公開カード本文は除く）。
• ブラウザー／アプリ版と OS。
• オンラインとオフラインで再現するか。
• 正確な警告またはエラー文。
• 見た目の挙動が重要なら短い画面録画。

手動 API トークン、OAuth コード、パスワード、非公開コレクション全体をメールで送らないでください。必要な場合、サポートが範囲を限定した診断を依頼します。