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

项目里程碑

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 适配兼容性;有变化时验证并更新记录

尚未安排发布日期;上述事项需要目标平台与发布环境。