侧面板问题
“侧面板无法打开”
症状：点击工具栏图标后没有任何反应，或 Chrome 右侧的侧面板区域始终空白。
可能原因：Chrome 版本过旧。侧面板 API 需要 Chrome 114 或更新版本；我们针对当前稳定版进行测试。
解决方法：打开 chrome://settings/help，让 Chrome 自动更新。重启后再次点击图标。
“我已经在 grok.com 上，但仍看到’打开 Grok 以开始'”
症状：不在 Grok 上的模态框出现，带有打开 grok.com/imagine 按钮，但地址栏显示的是 grok.com。
可能原因：您访问的是扩展无法识别为 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 预付了一条提示词的配额，但无法为下一条提示词付费，队列暂停。
两个选项：
- 升级到专业版 —— 点击模态框的主按钮打开定价页面。升级后，在侧面板中点击继续以恢复未运行的提示词。
- 等待每日重置，之后再点击继续。
快照在重启后保持，所以您不需要让面板一直开着。
“达到 Grok 速率限制”
Grok 速率限制模态框出现。这是 Grok 的限制（不是我们的）—— 您的 xAI 账户已达到 grok.com 本身的每小时或每日生成上限。
- 升级 SuperGrok 打开 Grok 自己的订阅页面。升级后，返回侧面板点击继续。
- 知道了 关闭模态框。等待 Grok 的上限重置（通常一小时），然后继续。
为减少长批次中遭遇此情况的概率，在开始前在设置 → 队列中将最大延迟提高到 12–20 秒。较慢的节奏让 Grok 的速率窗口有时间清空。
“运行结束时有错误” —— 什么失败了，为什么
当批次结束时某些行出现红色标签，点击提示词行展开其错误信息。常见错误：
| 错误文字开头… | 含义 | 处理方法 |
|---|---|---|
timeout | Grok 花费的时间超过了运行器等待的时间。通常是繁忙时段。 | 使用继续重跑；重试通常成功。 |
download failed | 生成成功，但自动下载无法写入磁盘。 | 检查 Chrome 下载设置；可能有"另存为"对话框等待确认。 |
unknown @reference | （素材生视频）提示词使用了与图像库中任何图像都不匹配的 @文件名。 | 修正拼写后重跑。 |
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 保存到您的 Downloads 根目录 + 您设置的子文件夹。在 macOS 上是
~/Downloads/<文件夹>/；在 Windows 上是%USERPROFILE%\Downloads\<文件夹>\。
“文件被命名为 (1).png、(2).png 等”
症状：Chrome 用 (1)、(2) 后缀对文件名进行去重，因为两条提示词产生了同名文件。
可能原因：使用提示词文字作为文件名已开启，且批次中有重复的提示词。修正重复项，或关闭此开关 —— 顺序名称（前缀-001.png）不会冲突。
性能与节奏
“50 条提示词的批次运行了很久”
属于正常情况。在提示词之间 2–5 秒的默认延迟，以及速度档每张图约 30 秒的情况下，50 张图像的批次需要约 30 分钟挂钟时间。720p 视频将其翻倍。请相应安排通宵运行。
想要更快（有遭遇速率限制的风险），在设置 → 队列中将最小延迟 / 最大延迟降到 1 / 3。如果开始遭遇速率限制，立即撤销该更改并增加一些缓冲（5 / 12 是更安全的通宵设置）。
“重试在消耗我的配额”
如果您的设置 → 队列 → 每条提示词重试次数设为 4，且批次中有很多失败的提示词，每条提示词最多消耗您预期配额的 5 倍。对于成本敏感的运行，将重试次数降至 1 或 2。
仍然卡住
如果以上都没有解决您的问题，以下两件事可以帮助我们帮助您：
- 点击侧面板底部右侧的日志按钮，然后点击导出日志。这会输出一个包含运行器近期活动的 JSON 文件。
- 将 JSON 文件发送到
[email protected]，并附上一行描述您当时在做什么。我们在一个工作日内回复。