日期:2026-10-12。工作区没有Git仓库,本轮不记录虚构提交号。本轮仅新增/更新文档与入口,不修改现有交易、认证、前端、脚本或部署实现。
新增 从零教程:23章,Windows PowerShell主路线,从工具/空目录/Go与HTTP基础开始,给出可运行教学核心、资金、单写者日志、三库、注册登录、管理员、React与测试;随后逐项升级到当前架构,覆盖增量批投影、预算、契约、分页、实时行情、原键恢复、完整测试、注释规范、Windows、容器/云与备份恢复。README、文档入口、goal与开发记录同步。
教学代码实际验证#
完整文件从最终Markdown代码块重新提取到 /tmp/exchange-tutorial-extracted,不是只编译最初草稿。共14个完整文件(7个Go文件含2个测试文件、7个前端文件);另提取初期Hello和health里程碑。执行环境:Go 1.26.9 linux/amd64、Node v22.22.3、npm 12.0.2。使用独立module exchangelearn、五项直接依赖与go mod tidy生成间接依赖,不共享用户数据目录;未把生成的data/node_modules提交到项目。
| 检查 | 实际结果 | 证明范围 |
|---|---|---|
| go mod tidy | 通过 | 五项固定依赖可解析 |
| go test -count=1 -v ./… | 通过;TestTradeAndCancel、TestParse、TestFIFOAndSelfTrade、TestHTTPAndRestart | 资金算例/FIFO/自成交、幂等/对象隔离、输入、真实HTTP/三库/Cookie/权限、正常重启视图/会话 |
| go vet ./… | 通过 | 教学Go静态检查 |
| 初次npm install生成锁文件、npm ci | 通过 | 独立前端固定依赖可安装、锁文件可复现 |
| npm run build | 通过 | 教学React/TS类型检查与Vite实际打包 |
| Hello/health运行 | 通过 | 第3章可执行程序与实际health请求;验证器仅替换为随机空闲回环端口,避免占用用户8080 |
| 本地Markdown链接/锚点、围栏、JSON | 通过;30份Markdown、440个本地链接/锚点、100个围栏块 | 本地引用有效、23章锚点有效、完整文件代码块可提取;文中最终Test名称均存在于源码 |
前端安装复核中先使用 npm install --ignore-scripts 创建锁文件,随后 npm ci 重新安装并构建。当前 npm 的 allowScripts 策略阻止 esbuild postinstall,平台二进制依赖仍成功安装且实际构建通过;不声称所有依赖安装脚本均被执行;第一次草稿构建使用仓库依赖,正式复核使用隔离目录独立安装,不依赖源码复制的node_modules。本轮执行环境为Linux/WSL,不称为本轮原生Windows重新执行;Windows最终启动指南关联上一轮原生验证。
原始输出/文件摘要见 独立证据目录、Go测试、前端安装、构建与安装复核、里程碑、文档检查。最终教程提取文件摘要用于复核代码块,不是当前应用发布包摘要。
边界与历史证据#
教学版只支持LIMIT GTC、全量视图、单条FULL日志,未具备完整fail-fast、dataset/版本、并发关闭和资源治理;教程明确后续替换顺序及最终测试入口。教学数据格式不能直接迁移为最终日志,练习目录与现有项目分开。教学HTTP接口是/api,最终是/api/v1;两套类型与函数不能混着编译。
与上一轮Windows报告的source-SHA256SUMS比对,74个既有源码/配置文件摘要全部一致,结果记录在本轮evidence-from-zero-tutorial/source-unchanged.json;此比较只证明本轮未改应用代码,不替代测试。
本轮未重新执行最终项目全套race/故障/浏览器/性能/容器验证,未改写旧报告、源码摘要、发布包/镜像/容量成绩;未运行云服务器、TLS实机、真实断电或远程CI。教学前端实际完成类型检查/构建,未新增真实浏览器教学界面验证。后半章命令提供可执行步骤和已有源码/测试映射,不自动表示所有环境均已本轮执行。