help

测试方案

聚焦当前本机与 staging 二级域名测试路径,并补上模块二 Day 7 的 local D1 bootstrap 与 API shape lock 验证命令。

Audience

开发 / 测试

Updated

2026-03-26

Source

docs/testing-playbook.zh-CN.md

当前范围

  • 先验证 Workflow、Profiles、Targets 与 Autofill MVP 的基础路径
  • staging 默认使用 toolplane.fluentreact.com,追求更接近真实域名环境的测试效果
  • 浏览器 smoke 默认走 Windows 主机浏览器;只有需要 Linux 浏览器一致性时才进入 WSL

自动化命令

  • npm run d1:migrate:local:windows
  • npm run d1:seed:local:windows
  • npm run verify:module1:staging
  • npm run verify:module1:browser
  • npm run verify:module1:browser:headed
  • npm run verify:module1:browser:wsl
  • npm run verify:module2:contracts:staging
  • npm run verify:module2:contracts:local
  • npm run verify:module3:d1:staging
  • npm run verify:module3:d1:local

合同锁形与 D1 查询证明

  • Windows 本机现在可先跑 d1:migrate:local:windows 与 d1:seed:local:windows,再启动本地服务并执行 verify:module2:contracts:local
  • verify:module2:contracts:staging 当前会验证 workflow / profiles / targets / runs detail、错误语义与 D1-backed accept-run / complete-run 合同
  • verify:module3:d1:staging 与 verify:module3:d1:local 当前会对齐 workflow / profiles / targets / runs / usage 的 query path、wallet balance 与 run detail 边界
  • 这一步的目标是锁定 API 形状,而不是只做页面可访问性 smoke

运行分工

  • 为什么构建走 WSL2,浏览器走 Windows:因为 OpenNext / Cloudflare 构建链路在 Ubuntu / WSL2 下更接近线上,也更稳定
  • Windows 主机浏览器优先负责 workflow 画布交互回归,更适合人工确认拖拽 / 连线视觉反馈
  • 只有在需要 Linux 浏览器环境对照时,才使用 npm run verify:module1:browser:wsl

当前检查点

  • Workflow 抽屉支持新建 workflow、切换 workflowId 与 per-workflow 草稿隔离
  • Profiles / Targets 页面支持 live API 创建、更新与刷新回读
  • 浏览器 smoke 已覆盖 drawer、library add、drag、restore、preview approve/reset、save persistence 与 cleanup restore
  • Review 预演会重新请求 run-preview,并返回结构化 Review gate / Result gate
  • 模块三 Day 7 的 D1 query proof 已覆盖 workflow / profiles / targets / runs / usage 数量对齐、wallet balance 与 run detail 边界
  • 模块三 Day 8 已把 data-foundation 文档与数据库验收记录补齐,帮助面与文档面都不再停留在 Day 7 口径
  • Help Center 与 Docs Center 已接到统一导航
  • 如需看真实窗口,可用 headed 方式补看拖拽 / 连线视觉反馈
  • 二级域名上线后复跑同一路径,确认线上与本机结果一致