release-ridgelisted

# 发布 Ridge 把发布当成五个有门禁的阶段：同步、桌面构建、ridge-cloud 部署、remote 产物发布、生产验收。开始前完整阅读 [references/ridge-release-runbook.md](references/ridge-release-runbook.md)。 ## 执行纪律 1. 先记录 `wind` 与 `ridge-cloud` 的分支、HEAD、远端和脏文件；保留所有既有修改与未跟踪文件。 2. 按阶段执行。上一个阶段未验收，不进入下一个阶段。 3. 把普通发布授权限制在拉取、构建、常规 Dokku 推送和产物上���。直接强推、解锁、修改 Nginx、修改持久卷属主仍需明确授权；用户已在当前请求授权时不重复询问。 4. 不打印、写盘或提交 `RIDGE_ARTIFACT_TOKEN`。只在当前进程环境中短暂设置，用完立即清除。 5. 长时间无新日志不等于失败。Windows release 或首次 CI 镜像构建可能持续数十分钟；先查 Action job、Dokku build record 与 deploy lock。 6. 任何失败先保留原始症状，再按 runbook 的“症状 → 根因 → 恢复”处理；不要用 `git reset --hard`、删除缓存或直接强推掩盖问题。 ## 阶段门禁 ### 1. 同步 - 对两个仓库执行只读预检。 - 处理会被上游覆盖的未跟踪文件时，先复制/改名保留，再 `pull --ff-only`。 - 验收：本地目标分支与 `origin` 一致，原有用户改动仍在。 ### 2. 构建 release - 使用锁文件安装依赖，并显式绑定 `C:\DevKit\Rust` 工具链和 Cargo 缓存。 - 先验证 `rustc`、`cargo metadata --offline --locked`，再构建。 - 并行 Rust release 出现无诊断 exit code 1 或内存压力时改用 `-j 1`；Rust 主产物已成功时直接 bundle，避免重复全量前端构建。 - 验收：`release/ridge_<version>_x64-setup.exe` 存在，记录大小与 SHA-256；构建未留下意外 tracked diff。 ### 3. 发布 ridge-cloud - 以精确源 SHA 手动触发 `ridge-cloud` 的 `deploy-dokku.yml`；禁止恢复源码 `git push` 冷构建。 - 工作流须在 CI 用 BuildKit 缓存构建镜像，经 SSH `git:load-image` 直传；镜像内 `/app/CHECKS` 保留 HTTP 就绪闸。 - 工作流须验证 `/data/remote-apps` 持久卷，并固定 `REMOTE_APP_DIR=/data/remote-apps/remote-app`；上传根与静态读取根不可分叉。 - 首次缓存预热可较久；后续若仍异常慢，查 Action build 分层命中率与 Dokku build record，不以盲等代替诊断。 - 验收：Action 成功、镜像 revision 等于预期 SHA、生产健康接口返回 200。 ### 4. 发布 remote 产物 - 先确保新 artifact API 已随 ridge-cloud 上线。 - 安全读取 token，构建并上传 desktop/mobile bundle。上传失败而