打通一键发布与真机预览集成

需求:将登录续期、一键提交审核和精确 Release 真机预览合为可推进主分支的完整客户端链路。

实现:提交成功后保存安全版本映射,映射失败不误报上传失败;同步新会话测试契约和集成态项目文档。
This commit is contained in:
2026-08-08 18:06:46 +08:00
parent f02e99ea9b
commit 52626b332d
9 changed files with 144 additions and 52 deletions

View File

@@ -4,35 +4,38 @@ This file is the integrated default-branch snapshot. Feature tasks record progre
## Integrated Through
- `86ece3a`:客户端登录七天滑动续期来源提交。
- `4dde8f32678baa81fd3ae3f6e7bd0d34b17885d6`:集成合并提交。
- `86ece3a` / `4dde8f3`:客户端登录七天滑动续期及集成提交。
- `724290e` / `dcc92fc`Main-owned 一键打包提交审核及集成提交。
- `1a19ad9` / `f02e99e`:项目真机预览、待审 Release Owner preview 及集成提交。
## Current Focus
客户端认证由 Electron Main 统一管理刷新凭据,并按真实用户活动维护七天闲置窗口
客户端面向非专业用户提供“项目配置中一键提交 → 运营审核通过即发布”的单入口链路,并以项目级真机预览完成待审版本扫码验收
## Recently Completed
- 2026-08-07集成客户端登录滑动续期、刷新令牌轮换持久化和终态清理保护
- 2026-08-08合并登录续期、一键发布和真机预览发布成功后保存精确 app/version/review 映射Renderer 不接触 Token、ZIP 或本地路径
- 2026-08-08补齐跨平台 Electron E2E fixture、Windows ZIP 预检和异常成功响应安全投影。
## In Progress
- 协调认证服务端七天刷新令牌配置及共享 `app` OAuth 客户端发布
- 使用真实 Works Square、Builder 与 Static Gateway 环境执行客户端提交到运营发布的生产整链验收
## Next Recommended Steps
1. 确认所有共享 `app` 客户端支持原子保存轮换后的刷新令牌
2. 发布兼容客户端与认证服务后执行数据库迁移,并刷新 RegisteredClient Redis 缓存
1. 配置真实生产环境,执行“客户端提交 → 构建与浏览器门禁 → 运营批准 → 公共访问”
2. 核对待审 Owner preview 的到期刷新、生产监控和告警证据
## Open Questions / Blockers
- 存量刷新令牌不会被数据库迁移追溯缩短为七天
- 本地与模拟上游回归已完成;生产账号和环境变量仍由部署环境提供
## Risky Areas
- 刷新响应返回新令牌后、客户端安全落盘前的进程崩溃窗口会要求重新授权
- Linux 缺少受保护系统 keyring 时不会跨重启保存刷新凭据
- 一键提交已成功但本地预览映射落盘失败时必须保持提交成功,避免用户重复提交;真机预览会明确显示尚不可用
- 预览 URL 必须绑定当前项目、精确版本和 Release并保持 Works Square 同源 HTTPS
- 刷新凭据、发布 Token、ZIP、幂等键和重试只能由 Electron Main 持有。
## Last Updated
2026-08-07
2026-08-08