Initial commit: grok-free-register-oss

Open-source Grok free registration CLI, xai_enroller auth pipeline,
local auth service, tests and docs.

docs/guides/runtime-troubleshooting.md

@@ -0,0 +1,38 @@
+# 运行状态与排障
+
+## 普通模式
+
+普通模式的每一行都对应一次状态变化：
+
+- `[→]`：新任务开始；
+- `[✓]`：任务成功或来源连接完成；
+- `[✗]`：当前任务失败或被跳过；
+- `[⏸]`：进入限流冷却或服务暂停；
+- `[▶]`：限流解除或服务恢复；
+- `[!]`：来源、配置或流水线出现需要关注的问题。
+
+认证端输入 `s` 可查看运行状态、待处理数量、当前阶段、本次运行平均速率、累计成功、可用和已取用凭据，以及是否处于限流。
+
+## Debug 模式
+
+注册端：
+
+```bash
+bash start.sh --debug
+```
+
+认证端：
+
+```bash
+bash auth-service.sh --debug
+```
+
+注册 Debug 面板包含 T/Q 库存、物理并发、S/P/C 阶段耗时和 token 求解时间。认证 Debug 状态包含 source/prepared/completion 队列、重试、授权节拍、冷却、单次探针和近五分钟滚动速率。
+
+## 常见状态
+
+限流后不会持续重试。认证端默认等待 60 秒，再只放行一个恢复探针；探针仍被限流时重新等待。注册端同样通过全局冷却闸门阻止并发任务漏过等待周期。
+
+远端来源暂时断开时，本地认证服务继续使用上一份完整有效快照。恢复连接后会自动同步，不需要重启。
+
+配置错误会指出缺少或非法的配置名，不输出 traceback。按提示检查 [注册配置](registration.md#配置邮箱) 或 [认证同步配置](auth-service.md#配置远端同步)。