diff --git a/backend/docs/GROK_INTEGRATION_PROGRESS.md b/backend/docs/GROK_INTEGRATION_PROGRESS.md index 0e8f20c75e..1deed56302 100644 --- a/backend/docs/GROK_INTEGRATION_PROGRESS.md +++ b/backend/docs/GROK_INTEGRATION_PROGRESS.md @@ -9,33 +9,28 @@ 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) +5. **媒体与 Voice** — image/video/voice 路由、模型与分辨率计价、异步 video status 完成后一次性计费、错误语义与请求参数规范化。 +6. **网关协议** — Grok Responses/chat bridge、tool protocol、cache、web_search、SSE/错误过滤均以 `upstream/main` 实现为底完成;不删除 main 的 compact。 +7. **管理端与前端** — OAuth/SSO/密码建号、重新授权、quota probe、调度阈值、模型映射配置和 monitor 入口已对齐。 +8. **运行安全** — Redis 跨实例 OAuth 会话与一次性消费、SSO Cookie 域/路径隔离、导入 probe 有界去重队列、媒体资格失败关闭。 + +## 明确不纳入 + +- `openai_gateway_grok_active_delta.go`:legacy 的实验性 HTTP 增量优化,依赖独立设置与会话状态存储;其默认开启、强制 store 和多副本一致性风险不满足当前基线。main 的完整请求与 compact 路径保留,故不构成功能回退。 +- `openai_grok_timeline.go`:跨平台网关调试时间线基础设施,不是 Grok 协议能力,且 main 无对应依赖。 +- `capacity_provider_grok.go`:依赖 legacy 的通用容量预测子系统与迁移,无法独立纳入 Grok PR。 +- legacy merge/CI、重复 compact、跨平台大包和删除 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 未整包移植) +- Backend Grok/xAI/redissession、service、repository、admin probe 定向单测通过。 +- Frontend typecheck 通过;Grok 定向 Vitest 16/16 通过。 +- 全量 frontend 仍有 upstream/main 已存在的 `GroupsView.getLiveCapability` mock 失败,不属于本 PR 引入。 -## 续:阶段 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 +历史阶段 4–8 的本地实现已在上述收尾阶段合并记录;本文件不再保留“待完成”状态,避免与当前单 PR 内容冲突。