9c910c2049
- OpenAI OAuth/API Key 统一支持自动透传开关，编辑页可开关\n- 透传模式仅替换认证并保留计费/并发/审计，修复 API Key responses 端点拼接\n- Usage 页面显示原始 User-Agent 且不截断，补充回归测试与清单
56 lines
2.2 KiB
Markdown
56 lines
2.2 KiB
Markdown
# OpenAI 自动透传回归测试清单（2026-02-12）
|
||
|
||
## 目标
|
||
- 验证 OpenAI 账号（OAuth/API Key）“自动透传”开关在创建页与编辑页可正确开关。
|
||
- 验证开启后请求透传（仅替换认证），并保留计费/并发/审计等网关能力。
|
||
- 验证 `User-Agent` 头透传到上游，且 Usage 页面展示原始 UA（不映射、不截断）。
|
||
|
||
## 自动化测试
|
||
在仓库根目录执行：
|
||
|
||
```bash
|
||
(cd backend && go test ./internal/service -run 'OpenAIGatewayService_.*Passthrough|TestAccount_IsOpenAIPassthroughEnabled|TestAccount_IsOpenAIOAuthPassthroughEnabled' -count=1)
|
||
(cd backend && go test ./internal/handler -run OpenAI -count=1)
|
||
pnpm --dir frontend run typecheck
|
||
pnpm --dir frontend run lint:check
|
||
```
|
||
|
||
预期：
|
||
- 所有命令退出码为 `0`。
|
||
|
||
## 手工回归场景
|
||
|
||
### 场景1：创建 OpenAI API Key 账号并开启自动透传
|
||
1. 进入管理端账号创建弹窗，平台选择 OpenAI，类型选择 API Key。
|
||
2. 打开“自动透传（仅替换认证）”开关并保存。
|
||
3. 检查创建后的账号详情。
|
||
|
||
预期：
|
||
- `extra.openai_passthrough = true`。
|
||
- 模型白名单/映射区域显示“不会生效”的提示。
|
||
|
||
### 场景2：编辑 OpenAI OAuth 账号开关可开可关
|
||
1. 打开已有 OpenAI OAuth 账号编辑弹窗。
|
||
2. 将“自动透传（仅替换认证）”从关切到开并保存。
|
||
3. 再次进入编辑页，将开关从开切到关并保存。
|
||
|
||
预期：
|
||
- 开启后：`extra.openai_passthrough = true`。
|
||
- 关闭后：`extra.openai_passthrough` 与 `extra.openai_oauth_passthrough` 均被清理。
|
||
|
||
### 场景3：请求链路透传（含 User-Agent）
|
||
1. 使用设置为“自动透传=开启”的 OpenAI 账号发起 `/v1/responses` 请求。
|
||
2. 请求头设置 `User-Agent: codex_cli_rs/0.1.0`（或任意自定义 UA）。
|
||
|
||
预期：
|
||
- 上游收到与下游一致的 `User-Agent`。
|
||
- 请求体保持原样透传，仅认证头被替换为目标账号令牌。
|
||
|
||
### 场景4：Usage 页面原样显示 User-Agent
|
||
1. 进入管理端用量表（Admin Usage）与用户侧用量页（User Usage）。
|
||
2. 查找包含长 UA 的记录。
|
||
|
||
预期：
|
||
- 显示原始 UA 文本（不再映射为 VS Code/Cursor 等）。
|
||
- 文本可换行完整展示，不被 `...` 截断。
|