晋升客户端项目类型文档
This commit is contained in:
@@ -5,13 +5,15 @@
|
||||
| Flow | Source | Destination | Notes |
|
||||
|---|---|---|---|
|
||||
| 登录续期 | Renderer 活动信号 | Main Works Session | 连续 7 天未使用才清除会话 |
|
||||
| 一键提交 | 项目配置 | Main → Works Square | Main 打包、自动版本、幂等重试和脱敏 |
|
||||
| 项目创建 | 新建项目对话框 | Host API → Main 项目初始化 | 创建时固定 `ProjectType`;小游戏/小程序原子生成受控模板,自定义只生成项目空间 |
|
||||
| 一键提交 | 可发布项目配置 | Main → Works Square | 只对小游戏/小程序开放;Main 打包、自动版本、幂等重试和脱敏 |
|
||||
| 运营发布 | Works Square 审核 | 公共 Runtime | 审核通过后服务端直接发布 |
|
||||
| 真机预览 | 项目空间 | Main → Owner preview / Runtime | 核对 app、version、release 和同源 HTTPS |
|
||||
|
||||
## State Ownership
|
||||
|
||||
- Main 持有刷新凭据、发布 Token、临时 ZIP、幂等键和本地 app/version/review 映射。
|
||||
- 项目内 `.niancode/project.json` 保存 `ProjectType`;Main 在配置写入和目录复用时保持其不可变,并在打包时重新读取校验。
|
||||
- Renderer 仅持有短效公开会话状态、提交展示状态和短时预览 URL。
|
||||
|
||||
## External Interfaces
|
||||
@@ -21,4 +23,4 @@
|
||||
|
||||
## Last Updated
|
||||
|
||||
2026-08-08
|
||||
2026-08-09
|
||||
|
||||
@@ -10,6 +10,7 @@ Makelore 是 Electron 桌面客户端。Renderer 负责项目操作与状态展
|
||||
|---|---|---|
|
||||
| Renderer | 项目配置、一键提交状态、真机二维码 | 不接触账号 Token、ZIP、幂等键或本地绝对路径 |
|
||||
| Host API | 校验本地项目请求并投影安全响应 | 只接受回环来源和 JSON mutation |
|
||||
| Project Configuration & Template | 保存不可变 `ProjectType`,原子生成新项目骨架 | 小游戏/小程序生成受控 Vite 模板;自定义保持最小项目空间 |
|
||||
| Project Packager | 确定性扫描、敏感文件排除与 ZIP 生成 | 限制文件数、包体和目录替换 |
|
||||
| Works Session | 七天真实活动滑动续期 | 刷新凭据由 Main 安全持有 |
|
||||
| Device Preview | 核对本地映射、远端版本和 Release | 待审使用短时 Owner preview;已发布使用精确 Runtime |
|
||||
@@ -17,6 +18,8 @@ Makelore 是 Electron 桌面客户端。Renderer 负责项目操作与状态展
|
||||
## Important Boundaries
|
||||
|
||||
- 发布只有现有项目配置底部的一个入口,不新增发布工作台、侧栏或资源卡。
|
||||
- `ProjectType` 由创建请求写入项目配置,UI 与 Host API 不提供类型变更;缺少类型的旧配置归一为 `custom`。
|
||||
- 本地 `projectType` 只选择产品路径和内部构建 preset,不是可信授权声明;Main 仍需安全打包,服务端仍需独立校验清单和包体。
|
||||
- 云端确认上传成功后,本地映射失败不能把请求改判为失败;否则会诱导重复提交。
|
||||
- Renderer 只能获得安全状态字段和可展示的短时预览 URL。
|
||||
|
||||
@@ -26,4 +29,4 @@ Makelore 是 Electron 桌面客户端。Renderer 负责项目操作与状态展
|
||||
|
||||
## Last Updated
|
||||
|
||||
2026-08-08
|
||||
2026-08-09
|
||||
|
||||
Reference in New Issue
Block a user