Part of #88 ## Question Playwright/vitest 基建如何指向 Go server 并保持等价验收:webServer 启动方式换什么、/api/e2e/fixtures 与 scripted-AI 注入怎么移植、auth 套件与 WR_AUTH_DISABLED 语义怎么消化、XDG 隔离与 cgroup 包装存不存续、服务端单测的 Go 化边界划在哪。
Activity
JonasGao commentedon Nov 5, 2026
决议(两轮 answer-board + 收束确认,8 项)
D1 webServer:e2e 只跑生产单二进制;构建入口与发布共享——
go-server.ts(接替next-server.ts,只拼命令)调用与发布同一个 Makefile 生产构建目标(make build:vite build → go build embed);webServer 超时 5min → 2min(vite build 秒级、go build 缓存命中秒级,留冷缓存余量);webServer.env 继续注入 XDG tmp 根 /E2E_FIXTURES=1/WR_AUTH_DISABLED=1。验收工件 = 发布工件,不写 e2e 专属构建脚本。D2 模式矩阵退役:
E2E_SERVER_MODE/E2E_BUNDLER/NODE_OPTIONS堆上限 /webServerTimeout双档全部删除(存在理由——bundler 四象限内存实测——随 Next 消失);SPA 侧调试 =vite dev+ 手工 go serve 组合,不进 playwright 配置;双 config 结构(默认套件 + auth 套件)保留,auth.config.ts 的 cwd hack 与 NODE_OPTIONS 随 Next 退役。D3 fixtures 移植:
/api/e2e/fixtures原样移植 Go——同路径、同{action, marker, ...}请求/响应形状、E2E_FIXTURES=1门控、withAuth 语义、直接写 DB(database/sql);DELETE 清理同形。D4 scripted-AI 不移植:留在 e2e/(Node 测试侧资产,非应用代码)。衍生约束(进 #96 蓝图引擎节):Go openai-compatible 路径必须继续发
/chat/completions,消息历史形状(user instruction 文本 + assistant tool_calls 回放)不变——marker 协议(base64url 剧本 + 步骤序号 = user 轮数 + 已完成工具步数)依赖此形状;现有 e2e 套件零改动通过 = Go 引擎验收标准。D5 auth/env 语义:
WR_AUTH_DISABLED同名同值'1'、boot 时读一次(测试按套件切换、进程级即可);XDG_DATA_HOME/XDG_CONFIG_HOME同名沿用,Go 数据目录解析遵守——e2e 隔离机制不变;preparePassword 预生成 hack 保留(auth.json 文件格式与哈希算法被存量数据冻结——Go 必须能验证既有部署的存量文件——TS 同算法预生成继续可用,测试取密码路径不变)。D6 cgroup 保留:run-e2e.mjs wrapper 与 knobs 原样(MemoryMax 8G / CPUQuota 300% / memory.peak + oom_kill 回读不动);Chromium workers 仍是内存大头,wrapper 继续护整机;memory.peak 回读兼作「内存不劣于 Next 版」动机的量化验收(Next 生产+Turbopack 基线 6.1–6.2G 峰值,记录于 e2e/next-server.ts 注释,蓝图 runbook 引用为对比基准);E2E_WORKERS 放开与 MemoryMax 收紧 = cutover 后实测决策,写进 runbook,不预承诺数值。
D7 服务端单测边界:测试跟着代码走——33 个
route.test.ts→ Go httptest 等价测试(同用例集:同 happy path + 同{error, code}错误形状断言),放 server 侧对应包(布局归 #96);lib 里 server-only 模块(auth guard、db、生成引擎等)→ Go 单测;被 client 代码 import 的任何东西(zod schema、纯函数、类型)→ 留 vitest;批次划分归 #96。D8 验收时点(两段式 + 预切换演练):施工期(Next 仍为运行时)路由族完工验收 = 仅 Go httptest 同用例集全绿,e2e 继续指向 Next 守护现有行为不回退;全部 57 路由移植完成、正式切换之前,runbook 写死一步预切换演练——全套 e2e 对 Go 单二进制跑绿;cutover 门槛 = 全量 e2e 零改动对 Go 二进制跑绿;cutover 后 e2e 永久指向 Go,删除对应 TS server 测试。
对地图的影响
make build须为 e2e/发布共享入口;D7/D8 验收规则作为蓝图施工顺序的验收基线。