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

サイドパネルの問題

「サイドパネルが開きません」

症状：ツールバーアイコンをクリックしても何も起きないか、Chromeの右側のサイドパネルエリアが空白のままです。

原因の可能性：Chromeのバージョンが古すぎる。サイドパネルAPIはChrome 114以降が必要です；現在の安定版でテストしています。

解決策：chrome://settings/helpを開いてChromeを更新。再起動。アイコンを再度クリック。

「grok.comにいるのに『開始するにはGrokを開いてください』と表示される」

症状：URLバーにgrok.comと表示されているのに、Open grok.com/imagineボタン付きのGrok上でないモーダルが表示されます。

原因の可能性：拡張機能がimagineサーフェスとして認識しないGrokのサブページにいます — 例えばgrok.com/chat/...や設定ページ。

解決策：モーダルのOpen grok.com/imagineボタンをクリック。サイドパネルが監視するページであるgrok.com/imagineに移動します。

「パネルが空白のクリーム色の画面でスタックしている」

症状：サイドパネルは開くが、サインイン画面もメインUIも表示されず — 空のクリーム色の背景だけ。

原因の可能性：セッションチェックがハングしています。通常、前回のサインイン試行からのOAuthウィンドウがバックグラウンドで開いたままの場合に発生します。

解決策：バックグラウンドに小さなGoogleサインインポップアップがないかChromeウィンドウを確認。閉じる。ツールバーアイコンをクリックして閉じてから再度クリックしてサイドパネルをリロード。

サインインの問題

「サインインに失敗しました。再試行してください。」

一般的なOAuthの失敗。よくある原因、順番に：

1. 完了前にポップアップを閉じた。 Googleでサインインを再度クリック；ポップアップが再表示されます。
2. ブラウザがポップアップをブロックした。 Chromeのアドレスバーに「ポップアップがブロックされました」アイコンがないか確認；拡張機能のポップアップを許可。
3. 間違ったGoogleアカウントを選んだ。 無料クォータが別のGoogleアカウントにある場合は、サインアウトして正しいアカウントで再サインイン。

「別のタブでサインインしたのにサイドパネルがまだサインインを要求する」

症状：ウェルカムページのサインインフローを通過したがサイドパネルがまだGoogleでサインインを表示している。

解決策：パネルはchrome.storageイベントを通じて新しいサインインを自動検出します。取得されなかった場合は、パネルを閉じて（ツールバーアイコンをクリック）再度開く。メインUIが表示されるはずです。

実行中の失敗

「無料クォータを使い果たしました」

クォータ枯渇モーダルがバッチ途中で表示されます。Grok Automationは1件分のプロンプトのクォータを前払いし、次のプロンプトが払えず、キューが一時停止しました。

2つのオプション：

• Proにアップグレード — モーダルのプライマリボタンをクリックして料金ページを開く。アップグレード後、サイドパネルの続行をクリックして未実行のプロンプトを再開。
• 毎日のリセットを待って後で続行をクリック。

スナップショットは再起動をまたいで保持されるため、パネルを開いたままにする必要はありません。

「Grokのレートリミットに達しました」

Grokのレートリミットモーダルが表示されます。これはGrokの制限（私たちのものではない）— xAIアカウントがgrok.com自体での時間ごとまたは毎日の生成上限に達しました。

• Super GrokにアップグレードでGrok独自のサブスクリプションページが開きます。アップグレード後、サイドパネルに戻って続行をクリック。
• 了解でモーダルを閉じる。Grokの上限がリセットされるまで待って（通常1時間）続行。

長いバッチでこれに当たる可能性を減らすには、開始前に設定 → キューで遅延最大を12〜20秒に上げてください。遅いペースによってGrokのレートウィンドウが消化される時間ができます。

「エラーで実行が終了しました」 — 何が失敗してなぜか

バッチが一部の行に赤バッジで終了した場合、プロンプト行をクリックしてエラーメッセージを展開。よくあるもの：

参照画像の問題

「自動マッチが何もマッチしない」

症状：自動添付がオンの画像→画像で、すべての行にunmatched警告チップが表示される。

原因の可能性、順番に：

1. ファイル名がプロンプトに表示されていない。 自動マッチはファイル名（拡張子なし）をプロンプトテキストのサブストリングとして探します。hero-frontal.pngはプロンプト「hero frontal...」にマッチしますが、「the hero looks frontal」にはマッチしません。
2. ファイル名が汎用的すぎる。 image-1.pngは「image」を含む任意のプロンプトにマッチします — そして おそらく間違ったもの。説明的なものにリネーム。
3. 手動モードを使いたかった。 プロンプトごとのマッチングが不要な場合は自動添付をオフにしてください — すべてのプロンプトが名前に関係なく最初のN枚の画像を取得します。

「Reference to Videoがunknown @referenceと表示する」

プロンプトに@heroと入力したが、ライブラリにファイル名（拡張子なし）がheroの画像がありません。大文字小文字は無視されますが、ハイフンとアンダースコアは重要です — @hero-frontal ≠ hero_frontal.png。

解決策：ライブラリ内のファイルをリネームする（ドロップアウトしてディスクでリネームして再ドロップ）か、プロンプトの@トークンを修正。

「アップロードした画像がブラウザの再起動後に消えた」

症状：昨日のライブラリが今日は空です。

参照画像はbase64サムネイルでローカルストレージのクォータを使い切るのを避けるため、コンポーネントの状態（chrome.storageに保持されない）に保存されます。タブの再起動は乗り越えますが、ブラウザの再起動は乗り越えません。各セッションの開始時に再アップロードするか、ライブラリフォルダーをディスク上に手元に置いておいてください。

ダウンロードの問題

「自動ダウンロードがオンなのにファイルがフォルダーに表示されない」

順番に確認する3つのこと：

1. Chromeのダウンロードプロンプトが待っている。 chrome://downloadsを開く — 「名前を付けて保存」ダイアログが待っている可能性があります。
2. フォルダー名に不正な文字がある。 スラッシュ、コロン、先頭/末尾のスペース。文字、数字、ハイフンのみ使用。
3. 間違ったフォルダーを確認している。 Chromeはダウンロードルート + 設定したサブフォルダーに保存します。macOSでは~/Downloads/<folder>/；Windowsでは%USERPROFILE%\Downloads\<folder>\。

「ファイルが(1).png、(2).pngなどと命名されている」

症状：2つのプロンプトが同じ名前のファイルを生成したため、ChromeがファイルをC(1)、(2)サフィックスで重複排除した。

原因の可能性：プロンプトテキストをファイル名として使用がオンで、バッチに重複したプロンプトがあります。重複を修正するか、トグルをオフにしてください — 連番名（prefix-001.png）は衝突しません。

パフォーマンスとペーシング

「50件のプロンプトのバッチが永遠にかかっている」

予想通りです。プロンプト間のデフォルト遅延2〜5秒と1枚のSpeedティア画像につき約30秒で、50枚の画像バッチは壁時計で約30分かかります。720pの動画はその倍。一晩の実行は計画的に。

速くするために（レートリミットのリスクを冒して）、設定 → キューで遅延最小 / 遅延最大を1 / 3に下げてください。レートリミットされ始めたら、すぐにその変更を元に戻して余裕を持たせてください（5 / 12はより安全な一晩の設定です）。

「リトライがクォータを使い果たしている」

設定 → キュー → プロンプトごとのリトライが4に設定されていて、バッチに多くの失敗するプロンプトがある場合、それぞれが予想の最大5倍のクォータを消費します。コスト重視の実行ではリトライを1または2に下げてください。

まだ解決しない場合

上記の解決策のいずれも問題を解決しない場合、2つのことが助けになります：

1. サイドパネルフッターの右下にあるログボタンをクリックし、ログをエクスポート。ランナーの最近の活動を含むJSONファイルがダンプされます。
2. JSONを[email protected]に壊れたときに何をしていたかの1行の説明を添えてメール。1営業日以内に返信します。