构建与发布

统一构建与检查

npm run platform:plan 只查看流程；npm run platform:verify 执行生成、源码测试、发布产物与浏览器检查。检查失败时先阅读失败摘要和对应日志，修复后重新验证，不跳过失败步骤。

npm run platform:plan
npm run platform:verify

网站发布目录

完整检查已包含 release:prepare 和 release:check，日常不必重复运行。它们分别生成和核对 .local/publish；单项诊断时才独立执行。源码提交成功与 Pages 部署完成是两个结果，上线后仍需检查实际网址。

npm run release:prepare
npm run release:check

提交改动

查看 Git 差异，确认只包含本次修改。使用普通提交和推送；如远端有新提交，应先重新对齐，不要强制覆盖。

部署工作流成功后，在浏览器确认主要入口、前进后退和移动端布局。自动检查不等于真实设备体验。

增量更新包

在完整仓库验证通过后，用明确的提交基线生成增量包。验证后再次修改文件，需要重新验证。接收端在独立工作区检查，遇到文件冲突或远端新提交会停止；游戏、字体和已有源码档案继续使用各自发布流程。

npm run platform:pack -- --base <完整提交SHA> --out ../XiaoQ_Site_Update.zip