feat: 整理

README_CN.md

@@ -139,6 +139,8 @@ curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install
 
 使用 Docker Compose 部署，包含 PostgreSQL 和 Redis 容器。
 
+如果你的服务器是 **Ubuntu 24.04**，建议直接参考：`deploy/ubuntu24-docker-compose-aicodex.md`，其中包含「安装最新版 Docker + docker-compose-aicodex.yml 部署」的完整步骤。
+
 #### 前置条件
 
 - Docker 20.10+

deploy/docker-compose-aicodex.yml

@@ -1,10 +1,10 @@
 # =============================================================================
-# Sub2API Docker Compose Host Configuration (Local Build)
+# aicodex2api Docker Compose Host Configuration (Local Build)
 # =============================================================================
 # Quick Start:
 #   1. Copy .env.example to .env and configure
 #   2. docker-compose -f docker-compose-host.yml up -d --build
-#   3. Check logs: docker-compose -f docker-compose-host.yml logs -f sub2api
+#   3. Check logs: docker-compose -f docker-compose-host.yml logs -f aicodex2api
 #   4. Access: http://localhost:8080
 #
 # This configuration builds the image from source (Dockerfile in project root).
@@ -14,15 +14,14 @@
 
 services:
   # ===========================================================================
-  # Sub2API Application
+  # aicodex2api Application
   # ===========================================================================
-  sub2api:
+  aicodex2api:
-    #image: weishaw/sub2api:latest
     image: yangjianbo/aicodex2api:latest
     build:
       context: ..
       dockerfile: Dockerfile
-    container_name: sub2api
+    container_name: aicodex2api
     restart: unless-stopped
     network_mode: host
     ulimits:
@@ -31,7 +30,7 @@ services:
         hard: 800000
     volumes:
       # Data persistence (config.yaml will be auto-generated here)
-      - sub2api_data:/app/data
+      - aicodex2api_data:/app/data
       # Mount custom config.yaml (optional, overrides auto-generated config)
       #- ./config.yaml:/app/data/config.yaml:ro
     environment:
@@ -54,9 +53,9 @@ services:
       # Using host network: point to host/external DB by DATABASE_HOST/DATABASE_PORT
       - DATABASE_HOST=${DATABASE_HOST:-127.0.0.1}
       - DATABASE_PORT=${DATABASE_PORT:-5432}
-      - DATABASE_USER=${POSTGRES_USER:-sub2api}
+      - DATABASE_USER=${POSTGRES_USER:-aicodex2api}
       - DATABASE_PASSWORD=${POSTGRES_PASSWORD:?POSTGRES_PASSWORD is required}
-      - DATABASE_DBNAME=${POSTGRES_DB:-sub2api}
+      - DATABASE_DBNAME=${POSTGRES_DB:-aicodex2api}
       - DATABASE_SSLMODE=disable
       - DATABASE_MAX_OPEN_CONNS=${DATABASE_MAX_OPEN_CONNS:-50}
       - DATABASE_MAX_IDLE_CONNS=${DATABASE_MAX_IDLE_CONNS:-10}
@@ -86,7 +85,7 @@ services:
       # =======================================================================
       # Admin Account (auto-created on first run)
       # =======================================================================
-      - ADMIN_EMAIL=${ADMIN_EMAIL:-admin@sub2api.local}
+      - ADMIN_EMAIL=${ADMIN_EMAIL:-admin@aicodex2api.local}
       - ADMIN_PASSWORD=${ADMIN_PASSWORD:-}
 
       # =======================================================================
@@ -152,7 +151,7 @@ services:
   # ===========================================================================
   postgres:
     image: postgres:18-alpine
-    container_name: sub2api-postgres
+    container_name: aicodex2api-postgres
     restart: unless-stopped
     network_mode: host
     ulimits:
@@ -166,9 +165,9 @@ services:
       # 若不显式设置 PGDATA，则即使挂载了 postgres_data 到 /var/lib/postgresql/data，数据也不会落盘到该命名卷，
       # docker compose down/up 后会触发 initdb 重新初始化，导致用户/密码等数据丢失。
       - PGDATA=/var/lib/postgresql/data
-      - POSTGRES_USER=${POSTGRES_USER:-sub2api}
+      - POSTGRES_USER=${POSTGRES_USER:-aicodex2api}
       - POSTGRES_PASSWORD=${POSTGRES_PASSWORD:?POSTGRES_PASSWORD is required}
-      - POSTGRES_DB=${POSTGRES_DB:-sub2api}
+      - POSTGRES_DB=${POSTGRES_DB:-aicodex2api}
       - TZ=${TZ:-Asia/Shanghai}
     command:
       - "postgres"
@@ -189,7 +188,7 @@ services:
       - "-c"
       - "maintenance_work_mem=${POSTGRES_MAINTENANCE_WORK_MEM:-128MB}"
     healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-sub2api} -d ${POSTGRES_DB:-sub2api} -p ${DATABASE_PORT:-5432}"]
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-aicodex2api} -d ${POSTGRES_DB:-aicodex2api} -p ${DATABASE_PORT:-5432}"]
       interval: 10s
       timeout: 5s
       retries: 5
@@ -201,7 +200,7 @@ services:
   # ===========================================================================
   redis:
     image: redis:8-alpine
-    container_name: sub2api-redis
+    container_name: aicodex2api-redis
     restart: unless-stopped
     network_mode: host
     ulimits:
@@ -234,7 +233,7 @@ services:
 # Volumes
 # =============================================================================
 volumes:
-  sub2api_data:
+  aicodex2api_data:
     driver: local
   postgres_data:
     driver: local

openai-passthrough-regression-checklist-20260212.md

@@ -1,55 +0,0 @@
-# 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 等）。
-- 文本可换行完整展示，不被 `...` 截断。