77 lines (51 loc) · 1.63 KB

测试与验证

本文档汇总仓库当前可用的基础验证方式与本地 E2E 测试脚本。

最小验证

日常改动后，至少执行以下检查：

bun run build
cd frontend && bun run lint

说明：

bun run build：构建前端产物到 public/
cd frontend && bun run lint：执行前端 ESLint 检查

本地 E2E

仓库内置了一套基于 mock upstream 的本地端到端验证脚本：

tests/mock-upstream.ts：启动本地模拟上游服务
tests/setup-test-data.sh：向本地 D1 写入测试渠道和 Token
tests/run-e2e.sh：验证代理链路、模型列表、认证失败、请求头清洗等行为

覆盖范围

当前 E2E 主要覆盖：

/v1/models
/v1/chat/completions
/v1/messages
/v1/responses
上游请求头白名单与敏感头剥离
管理员登录相关限速与系统配置场景

前置条件

执行前请确保以下服务可用：

本地 Worker 已启动
本地 mock upstream 已启动在 :9999
.dev.vars 或当前 shell 中已提供必要环境变量
本地 D1 可通过 wrangler.local.jsonc 正常访问

推荐执行顺序

启动 mock upstream

bun run tests/mock-upstream.ts

启动本地 Worker

bun run dev:worker

写入测试数据

bash tests/setup-test-data.sh

运行 E2E

bash tests/run-e2e.sh

注意事项

测试脚本默认依赖本地端口和 wrangler.local.jsonc
tests/setup-test-data.sh 会写入并清理部分本地测试数据，不要直接对生产库执行
如果只改了文档或纯前端静态内容，通常不需要跑完整 E2E