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

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

实现：提交成功后保存安全版本映射，映射失败不误报上传失败；同步新会话测试契约和集成态项目文档。

.project-docs/20-architecture/data-flow.md

@@ -4,15 +4,21 @@
 
 | Flow | Source | Destination | Notes |
 |---|---|---|---|
+| 登录续期 | Renderer 活动信号 | Main Works Session | 连续 7 天未使用才清除会话 |
+| 一键提交 | 项目配置 | Main → Works Square | Main 打包、自动版本、幂等重试和脱敏 |
+| 运营发布 | Works Square 审核 | 公共 Runtime | 审核通过后服务端直接发布 |
+| 真机预览 | 项目空间 | Main → Owner preview / Runtime | 核对 app、version、release 和同源 HTTPS |
 
 ## State Ownership
 
-- {state owner or persistence rule}
+- Main 持有刷新凭据、发布 Token、临时 ZIP、幂等键和本地 app/version/review 映射。
+- Renderer 仅持有短效公开会话状态、提交展示状态和短时预览 URL。
 
 ## External Interfaces
 
-- {API, file, service, or user-facing boundary}
+- Works Square 项目创建、版本上传、Owner 状态与 Release preview API。
+- 本机 Host API 的发布与真机预览路由。
 
 ## Last Updated
 
-{YYYY-MM-DD}
+2026-08-08

.project-docs/20-architecture/system-overview.md

@@ -2,21 +2,28 @@
 
 ## Current Architecture
 
-{short description of the current system shape}
+Makelore 是 Electron 桌面客户端。Renderer 负责项目操作与状态展示；Electron Main 持有认证、文件系统、安全打包、Works Square 网络访问和预览 URL 校验。
 
 ## Main Components
 
 | Component | Responsibility | Notes |
 |---|---|---|
+| Renderer | 项目配置、一键提交状态、真机二维码 | 不接触账号 Token、ZIP、幂等键或本地绝对路径 |
+| Host API | 校验本地项目请求并投影安全响应 | 只接受回环来源和 JSON mutation |
+| Project Packager | 确定性扫描、敏感文件排除与 ZIP 生成 | 限制文件数、包体和目录替换 |
+| Works Session | 七天真实活动滑动续期 | 刷新凭据由 Main 安全持有 |
+| Device Preview | 核对本地映射、远端版本和 Release | 待审使用短时 Owner preview；已发布使用精确 Runtime |
 
 ## Important Boundaries
 
-- {boundary that future work should respect}
+- 发布只有现有项目配置底部的一个入口，不新增发布工作台、侧栏或资源卡。
+- 云端确认上传成功后，本地映射失败不能把请求改判为失败；否则会诱导重复提交。
+- Renderer 只能获得安全状态字段和可展示的短时预览 URL。
 
 ## Related Decisions
 
-- {ADR reference}
+- 当前长期边界记录于 README 与集成任务 `20260807-integrate-login-client-a4f8`；后续如改变入口或凭据所有权，应新增 ADR。
 
 ## Last Updated
 
-{YYYY-MM-DD}
+2026-08-08