本地必须走 HTTP
使用 127.0.0.1 的真实项目入口。禁止用 file:// 作为接口和 CORS 验收。
DELIVERY RUNBOOK · 2026-08-04
本地预览 → 流水线 → APK 交付
先证明代码在本机真实 HTTP 入口可用，再推送、部署、回验。APK 是最后的交付分支，不是绕过环境部署的捷径。
01 开发任务分支最小改动
02 本机127 页面/API 验收
03 Git提交、推送、SHA 回读
04 流水线指定提交部署环境
05 环境精确 URL/资产/API 回验
06 交付PC URL 或正式 APK
六道门禁
推送必须回读 SHA
只有本地验收通过才提交；远程 SHA 必须与接受测试的提交一致。
流水线必须有结果
记录分支、commit、目标环境、运行 ID 和状态。Git 推送不等于流水线运行。
环境必须回验
访问精确 URL，并检查资产、API 和版本标记。流水线绿色不等于路由正确。
APK 必须后置
目标页面先达到 HTTP 200，再写入 APK；404 页面打进包里仍然只会得到 404。
真机结果单独标记
签名、Manifest、DEX 检查是自动证据；安装、重启、厂商自启动策略属于真机证据。
PC / APK 分流
| 交付目标 | 最终动作 | 完成定义 |
|---|---|---|
| PC 网页版 | 流水线部署后回验环境 URL | 页面、资产、接口和版本均正确 |
| Android 一体机 | 环境回验后打正式签名 APK | 版本递增、签名连续、URL 正确、SHA 可核验；有设备时完成安装与重启 |
本次金斯瑞证据
| 本地 127 | 通过：页面、主 JS HTTP 200；6 个接口返回有效业务 JSON |
|---|---|
| 远程分支 | 一致：e0f2889a2b5f8604220a00683640e14bea4ae7a6 |
| APK | 已构建：v1.0.2、正式签名、开机广播、SHA-256 已核验 |
| 生产页面 | 未通过：目标页面当前 HTTP 404 |
| 流水线/真机 | 待补证：暂无成功运行记录；无连接设备的重启验收 |
结论：当前不能把 APK 称为最终上线包。先完成流水线和生产 URL 回验，再做最终真机交付。