日期:2026-10-11。用户指定原生 Windows 一键启动,账号 pinkode 与八字节密码。本轮为实际功能变更,与上一轮仅文档/注释更新区别记录,不更新此前性能/覆盖率/发布包成绩。
交付#
根目录 run-windows.cmd ↗ 调用 PowerShell 脚本 ↗,自动检查依赖、隔离 Windows 前端安装、契约校验/前端构建、编译 exchange.exe,启动独立本地数据并等 ready 后开浏览器。支持 -Port/-NoBrowser/-PrepareOnly/-DataDir;失败保留输出,不停止原有服务、不修改全局环境/依赖源。
本地模式以 EXCHANGE_LOCAL_ADMIN_NAME 启用,打开数据库前拒绝非回环监听/混用常规管理员。后台仍保存 name@localhost 的邮箱身份,登录可用别名,前端登录输入改文本、注册仍邮箱。可信本地初始化允许 8–72 字节,普通注册/常规管理员 12–72 规则不变;bcrypt/会话/CSRF/RBAC 保留,既有 ADMIN 不改密码、USER 不提权。
OpenAPI 为登录新增 LoginCredentials 描述别名,注册 Credentials 邮箱契约保留;生成 TS 同步。核心撮合、journal/投影/资金语义无变更。默认 data-windows 与 bin/windows 忽略版本管理。
验证#
执行环境:Windows NT 10.0.26200.0(系统 API 返回值)、PowerShell 5.1.26100.9444、原生 Go 1.26.9 windows/amd64、Node 24.11.1;另在 WSL/Linux Go 1.26.9、Node 22.22.3 跑常规回归。工作区中文路径实际为 D:\codex小项目\go\web3,Windows 测试数据为新建 TEMP 路径(含空格),测试退出只清理自己的进程/目录。
| 检查 | 实际结果与证据 |
|---|---|
| 原生 Windows 脚本 | PowerShell 5.1 解析通过;首次独立 npm ci 安装 100 个包、契约/前端构建与原生 Go 编译通过,启动后两次使用缓存依赖但重建产物 |
| 本地身份/配置测试 | 新增 4 个顶层 Go 测试;Linux 与原生 Windows 都通过,含密码/别名/注册隔离/ADMIN 权限/契约/IPv4 和 IPv6 回环边界:Linux、Windows |
| CMD 真实一键启动与重启 | 从项目以外工作目录调用入口,九项断言通过:别名管理员、管理查询、原键结果、冻结金额、注册拒绝短密码、会话/数据集重启保留与订单不重复;smoke JSON、首轮输出、重启输出 |
| 原生 Windows Edge | Playwright 启动本机 Edge,实际页面别名/八字节密码登录、管理页用户、刷新会话、注册 email/minlength 保留、无 pageerror:结果 |
| Windows 失败与环境恢复 | 端口冲突、缺 Go 依赖被拒绝,调用者环境/工作目录恢复,无业务数据初始化:结果 |
| 常规回归 | scripts/verify.sh 通过:全 Go 测试、race、vet、六窗口收集、34 前端单元、契约生成一致、格式/build、CGO=0 构建与 SIGKILL 会话/资金/原键恢复;输出 |
| 既有浏览器回归 | 原 8 场景使用同版实际后端/前端回归,8 passed(20.5s),结果见输出 |
| 文档与源码检查 | 独立检查 28 份 Markdown、360 个本地链接/锚点、43 个代码围栏、215 个 Go 函数注释和脚本语法通过;记录、本轮源码摘要 |
测试脚本保存于本轮 evidence 目录,不属于常规自动收集测试。Windows smoke 使用强制终止自己的进程树再恢复,证明指定 Windows 进程故障/重启路径,不声称为 Ctrl+C 优雅排空。Ctrl+C 控制台广播/脚本 65s 退出逻辑已实现但本轮没有自动化模拟;默认浏览器自动弹出也没有触发,只使用 -NoBrowser 和受控 Edge 测试。首次全新系统无 Go/Node 的安装提示、离线安装、ARM Windows 仍需对应机器验证。
历史 source-SHA256SUMS 与先前仅注释的语义检查保留当时快照;本轮新增行为后不宣称继续逐字或语义相同。未部署云、未重新打包原 v0.3 发布包/verified 镜像、未做新容量实验。使用说明见Windows 本地运行。