# 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