Files
grok-free-register-oss/docs/guides/runtime-troubleshooting.md
chaos d10009d639 Initial commit: grok-free-register-oss
Open-source Grok free registration CLI, xai_enroller auth pipeline,
local auth service, tests and docs.
2026-07-16 21:04:05 +08:00

1.5 KiB

运行状态与排障

普通模式

普通模式的每一行都对应一次状态变化:

  • [→]:新任务开始;
  • [✓]:任务成功或来源连接完成;
  • [✗]:当前任务失败或被跳过;
  • [⏸]:进入限流冷却或服务暂停;
  • [▶]:限流解除或服务恢复;
  • [!]:来源、配置或流水线出现需要关注的问题。

认证端输入 s 可查看运行状态、待处理数量、当前阶段、本次运行平均速率、累计成功、可用和已取用凭据,以及是否处于限流。

Debug 模式

注册端:

bash start.sh --debug

认证端:

bash auth-service.sh --debug

注册 Debug 面板包含 T/Q 库存、物理并发、S/P/C 阶段耗时和 token 求解时间。认证 Debug 状态包含 source/prepared/completion 队列、重试、授权节拍、冷却、单次探针和近五分钟滚动速率。

常见状态

限流后不会持续重试。认证端默认等待 60 秒,再只放行一个恢复探针;探针仍被限流时重新等待。注册端同样通过全局冷却闸门阻止并发任务漏过等待周期。

远端来源暂时断开时,本地认证服务继续使用上一份完整有效快照。恢复连接后会自动同步,不需要重启。

配置错误会指出缺少或非法的配置名,不输出 traceback。按提示检查 注册配置认证同步配置