You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
3.9 KiB
3.9 KiB
项目里程碑
M1 · v0.1.0 · 开发模板基线
封板日期:2026-10-11。Git 标签:v0.1.0。这是可以开始业务开发的模板基线,发布环境的认证与配置仍按下述边界处理。
已完成范围
- 保留独立的 Electron 主进程、preload 与 Vue renderer;core、contracts、desktop、electron-trpc、ui 五个包职责单向。
- 每个 tRPC API 在主进程所属模块定义一次;contracts 只持有共享模型,renderer 通过 AppRouter 类型推导调用。
- 保留配置、多窗口、主题与语言同步、JSON/SQLite、授权文件读写与监听、原生交互、日志、系统加密凭据、手动更新基础能力。
- 可选能力支持部署配置与只减不增的启动开关;服务构造、API 授权和界面入口保持一致。
- 固定 IPC 通道、精确来源与窗口角色验证、输入输出校验、请求及订阅限额、安全错误关联编号和明确的资源清理。
- IPC 超时与取消、订阅快照竞争处理、显式重连;写操作不自动重试。
- renderer 按 app / pages / features / lib 分工;首次读取、空状态、忙碌、失败与恢复按功能处理,草稿读取失败不会覆盖已有数据。
- DESIGN.md 提供结构化设计规范,颜色与窗口尺寸从单一 JSON 来源同步生成;标题栏 37px、原生按钮 36px,内容独立滚动。
- 中英文、浅深色、单列设置、键盘焦点与紧凑窗口布局已落实;组件仍保持纯展示职责。
- 固定依赖版本与 pnpm catalog、模块生成器、重命名工具、单元与真实 Electron 验证、架构及扩展文档。
验收记录
具体命令、结果和运行环境见 validation.md 的 M1 封板验收。已知限制也属于本里程碑的交付说明,不能把替代打包路径视为默认命令已修复。
封板规则
- v0.1.0 标记本次已验收的提交;后续不移动或覆盖该标签。
- 新功能和架构调整进入后续提交;基线缺陷以独立修复提交处理,并按影响验证。
- 基础能力、API 权限、模块边界和设计规则的改动必须同步文档;不再为了示例增加额外抽象层。
- 本地提交与标签不等于远程发布;M1 封板时尚未配置远程地址,后续已配置 origin。
M1.1 · 日志与更新模板基础 · 已完成
验收日期:2026-10-11。已补齐脱敏诊断队列、用户授权与导出、后端接口约定、更新定时检查与下载取消、安装前清理、macOS ZIP 和发布配置检查。模板默认不配置接收端或更新地址;接收服务、证书和发布源由使用模板的应用提供,不属于模板交付范围。
客户端行为测试、真实 Electron 和打包 EXE 验证通过,具体结果见 validation.md。本轮作为独立提交交付,不移动既有 v0.1.0 标签,也不创建新的版本标签。
M2 · 应用发布验证 · 按需开展
以下是使用模板开发具体应用后的上线验收要求,不作为模板封板的前置条件。不继续无需求扩大模板框架。
| 工作 | 完成标准 |
|---|---|
| 目标平台验证 | 在 Windows/macOS/Linux 的实际环境执行对应 CI、窗口和打包测试 |
| 默认打包路径 | 定位并解决本机默认 electron-builder 解压重命名限制,重新验证标准命令 |
| 签名与安装交付 | 配置目标平台签名、macOS notarization,验证安装与卸载 |
| 实际更新链路 | 配置自己的发布源,验证检查、下载、安装、版本保护及失败恢复 |
| 上游维护 | 跟踪构建工具审计告警和 tRPC 适配兼容性;有变化时验证并更新记录 |
尚未安排发布日期;上述事项需要目标平台与发布环境。