側邊面板問題
「側邊面板無法開啟」
症狀：您點擊工具列圖示，什麼都沒發生，或 Chrome 右側的側邊面板區域保持空白。
可能原因：Chrome 版本太舊。側邊面板 API 需要 Chrome 114 或更新版本；我們針對目前穩定版本進行測試。
修復方法：開啟 chrome://settings/help，讓 Chrome 更新。重新啟動。再次點擊圖示。
「即使我在 grok.com 上，也看到『開啟 Grok 以開始』」
症狀：即使您的網址列顯示 grok.com，不在 Grok 上的對話框也出現，並附有開啟 grok.com/imagine 按鈕。
可能原因：您在擴充功能無法識別為 imagine 介面的 Grok 子頁面上——例如 grok.com/chat/... 或設定頁面。
修復方法：點擊對話框的開啟 grok.com/imagine 按鈕。它會帶您到 grok.com/imagine，這是側邊面板監聽的頁面。
「面板卡在空白乳白色畫面」
症狀：側邊面板開啟，但從未顯示登入畫面或主要 UI——只是空白的乳白色背景。
可能原因：工作階段檢查掛起。這通常發生在之前登入嘗試的 OAuth 視窗仍在背景中開啟時。
修復方法：檢查您的 Chrome 視窗是否有一個小型 Google 登入彈出視窗。關閉它。透過點擊工具列圖示關閉側邊面板，然後再次點擊重新開啟，以重新載入側邊面板。
登入問題
「登入失敗。請再試一次。」
一般 OAuth 失敗。最常見的原因，按順序：
- 您在完成之前關閉了彈出視窗。 再次點擊以 Google 帳號登入；彈出視窗會重新出現。
- 瀏覽器封鎖了彈出視窗。 檢查 Chrome 網址列是否有「彈出視窗已封鎖」圖示；允許擴充功能的彈出視窗。
- 選擇了錯誤的 Google 帳號。 如果您的免費配額在不同的 Google 帳號上，請登出並以正確的帳號重新登入。
「我在另一個分頁登入了，但側邊面板仍然要求我登入」
症狀：您完成了歡迎頁面的登入流程，但側邊面板仍然顯示以 Google 帳號登入。
修復方法：面板確實透過 chrome.storage 事件自動偵測新登入。如果沒有偵測到您的登入，關閉面板（點擊工具列圖示）並重新開啟。現在應該顯示主要 UI。
執行中途失敗
「免費配額已用完」
配額耗盡對話框在批次執行中途出現。Grok Automation 預付了一條提示詞的配額，下一條提示詞無法付款，佇列暫停。
兩個選項：
- 升級到 Pro——點擊對話框的主要按鈕開啟定價頁面。升級後，在側邊面板中點擊繼續以恢復未執行的提示詞。
- 等待每日重置，之後點擊繼續。
快照在重新啟動後仍然保留，所以您不需要保持面板開啟。
「達到 Grok 速率限制」
Grok 速率限制對話框出現。這是 Grok 的限制（不是我們的）——您的 xAI 帳號已達到 grok.com 本身的每小時或每日生成上限。
- 升級 SuperGrok 會開啟 Grok 自己的訂閱頁面。升級後，返回側邊面板並點擊繼續。
- 知道了關閉對話框。等待 Grok 的上限重置（通常一小時）並點擊繼續。
為了減少在長批次中遭遇此問題的機會，在開始前在設定 → 佇列中將最長延遲提高到 12–20 秒。較慢的節奏讓 Grok 的速率窗口有時間排空。
「執行結束並有錯誤」——什麼失敗了，為什麼
當批次以某些列上的紅色徽章結束時，點擊提示詞列展開其錯誤訊息。常見的幾個：
| 錯誤文字開頭… | 含義 | 該怎麼做 |
|---|---|---|
timeout | Grok 花費的時間超過執行器等待的時間。通常是忙碌時段。 | 用繼續重新執行；重試通常會成功。 |
download failed | 生成成功，但自動下載無法寫入磁碟。 | 檢查您的 Chrome 下載設定；可能有一個權限提示在等待。 |
unknown @reference | （參考到影片）一條提示詞使用了不配對任何庫圖像的 @filename。 | 修正拼寫錯誤並重新執行。 |
no image attached | （圖生影片 / 參考到影片）庫比提示詞需要的短。 | 新增更多參考圖像或縮短提示詞清單。 |
skipped: | 前一個串接步驟失敗，所以這個步驟沒有可串接的東西。 | 用繼續重新執行——執行器將重試失敗的步驟，然後重新向前串接。 |
參考圖像問題
「自動配對什麼都配對不到」
症狀：在開啟自動附加的圖生圖中，每一列都顯示 unmatched 警告徽章。
可能原因，按順序：
- 檔名沒有出現在提示詞中。 自動配對在提示詞文字中尋找檔名（不含副檔名）作為子字串。
hero-frontal.png配對提示詞「hero frontal...」但不配對「the hero looks frontal」。 - 檔名太通用。
image-1.png會配對任何包含「image」的提示詞——很可能是錯誤的那個。重新命名為描述性的名稱。 - 您本來打算使用手動模式。 如果您不在乎每條提示詞的配對，關閉自動附加——每條提示詞無論名稱如何都會取得前 N 張圖像。
「參考到影片顯示 unknown @reference」
您在提示詞中輸入了 @hero，但庫中沒有任何檔名（不含副檔名）為 hero 的圖像。不區分大小寫，但連字號與底線很重要——@hero-frontal ≠ hero_frontal.png。
修復方法：重新命名庫中的檔案（拖出來，在磁碟上重新命名，拖回去）或修正提示詞中的 @ 標記。
「瀏覽器重新啟動後我上傳的圖像消失了」
症狀：昨天的庫今天是空的。
參考圖像儲存在元件狀態中（不持久化到 chrome.storage），以避免用 base64 縮圖耗盡本機儲存配額。它們在分頁重新啟動後仍然保留，但不在瀏覽器重新啟動後。在每個工作階段開始時重新上傳，或在磁碟上保留您的庫資料夾備用。
下載問題
「自動下載已開啟，但我的資料夾中沒有檔案出現」
按順序確認三件事：
- Chrome 的下載提示正在等待。 開啟
chrome://downloads——可能有一個「另存為」對話框在等待。 - 資料夾名稱包含非法字元。 斜線、冒號、開頭/結尾空格。只使用字母、數字、連字號。
- 您在查看錯誤的資料夾。 Chrome 儲存到您的下載根目錄 + 您設定的子資料夾。在 macOS 上是
~/Downloads/<folder>/；在 Windows 上是%USERPROFILE%\Downloads\<folder>\。
「檔案命名為 (1).png、(2).png 等」
症狀：Chrome 以 (1)、(2) 後綴去重複化您的檔名，因為兩條提示詞產生了名稱相同的檔案。
可能原因：使用提示詞文字作為檔名已開啟，且批次中有重複的提示詞。修正重複的提示詞，或關閉此切換——循序名稱（prefix-001.png）不會衝突。
效能與節奏
「一個 50 條提示詞的批次花了很長時間」
在預期之內。使用預設的 2–5 秒提示詞間延遲和每張速度層級圖像 ~30 秒，一個 50 張圖像的批次需要 ~30 分鐘掛鐘時間。720p 影片是兩倍。請相應地規劃隔夜執行。
要讓它更快（以增加速率限制風險），在設定 → 佇列中將最短延遲 / 最長延遲降到 1 / 3。如果開始遭到限速，立即撤銷該變更並增加一些緩衝（5 / 12 是更安全的隔夜設定）。
「重試正在消耗我的配額」
如果您的設定 → 佇列 → 每條提示詞重試次數設為 4，且您的批次有很多失敗的提示詞，每個提示詞消耗最多 5 倍您預期的配額。對成本敏感的執行，將重試次數降至 1 或 2。
仍然卡住
如果以上都沒有解決您的問題，兩件事可以幫助我們幫助您：
- 點擊側邊面板底部右側的記錄按鈕，然後匯出記錄。這會輸出一個包含執行器最近活動的 JSON 檔案。
- 將 JSON 用一行描述您出問題時正在做什麼的說明，寄送到
[email protected]。我們在一個工作日內回覆。