sub2api/backend/docs/GROK_INTEGRATION_PROGRESS.md

Grok 完整整合进度（单 PR）

分支：feat/grok-complete-integration（基准 upstream/main）

已完成阶段

1. 模型目录与可配置映射 — 默认禁止 gpt/claude→grok-4.5；设置项 grok_default_text_model / grok_cross_client_model_map_enabled
2. 密码登录 + SSO 校验 — POST .../oauth/password、.../oauth/sso-token；不落库密码/raw SSO
3. 视频按模型族定价 — groups.video_model_prices JSONB；计费顺序：模型×分辨率 → 旧三列 → 官方默认
4. free 档本地用量软门禁 + 支付失败临时下线 — gateway.grok.free_quota_*；仅明确 free 的 OAuth 走调度过滤器；402 / spending-limit 403 tempUnschedule；管理端探测不走门禁

待续阶段

• media/voice 增量与错误语义
• 网关 tool_choice / active-delta（默认关）/ web_search
• 前端 CreateAccount SSO/密码入口
• 详见子代理审计结论（对照 personal-dev vs main）

原则

以 main 为底重写，不整文件 pick personal-dev；migration 使用新序号（如 217）。

续：阶段 4–6

4. free 档软门禁 + 402/消费上限临时下线（config gateway.grok.free_quota_*）
5. 媒体 usage 门控 + 分组 VideoModelPrices 输入（voice 暂缓）
6. 前端 SSO/密码 API + 凭证安全（active-delta 默认关：main 未整包移植）

续：阶段 7（本地，未向上游开 PR）

7. CreateAccountModal + OAuthAuthorizationFlow 接入邮箱密码建号
   • 展示「邮箱密码登录」选项（Grok）
   • 每行 email----password → authorizePassword → buildCredentials → create
   • 中英文 i18n 补齐

续：阶段 8 ReAuth（本地，未向上游开 PR）

8. admin ReAuthAccountModal
   • show SSO / email-password / refresh-token for Grok
   • validateSSOToken / authorizePassword / validateRefreshToken → applyOAuthCredentials
   • footer code-exchange hidden for those input methods