6.7 KiB
模板整体评估
判断
当前结构适合作为中小型 Electron 应用的开发起点:安全与资源边界有明确归属,新增简单功能不需要维护多份 API 清单,功能页面可以独立替换。它是一套有约束的基础结构,不是所有业务都必须适配的通用平台。
“优秀”不应按分包数量或抽象层数判断。更实际的标准是:一次修改涉及多少地方,代码能否顺着调用找到执行点,失败能否定位,退出能否释放资源,以及规则是否有测试支撑。
本轮发现与修正
| 问题 | 修正 | 意义 |
|---|---|---|
| 页面同时管理 RPC、状态、订阅、展示 | app / pages / features 分工;各功能独立 composable 和面板 | 阅读与修改按功能进行 |
| 一组 busy 状态阻塞整页不相关功能 | 笔记、草稿、原生操作、外观、凭证、更新各自管理任务 | 操作边界与状态边界一致 |
| 应用信息在多个页面重复请求 | Pinia 合并并发请求并缓存 | 初始化依赖更少,窗口角色统一 |
| 初始 hash 被用来判断窗口身份 | app.info 返回主进程注册的角色;路由守卫使用该角色 | 地址变化不能展示错误的功能页;主进程继续执行最终授权 |
| 配置 store 操作 DOM 和 i18n | 外观应用由 app/useAppearance 负责 | 数据同步与展示副作用分开 |
| 旧异步响应可能覆盖新状态 | 作用域检查、事件代次、token 检查 | 离开页面与乱序响应不再污染当前视图 |
| 对话框返回的授权可能迟到 | 授权立即追踪,读取失败和退出释放 | 不丢失处于获取过程中的资源 |
| 更新快照与订阅存在初始化竞争 | 先订阅启动,再读取,较新事件优先 | 不回退到过时状态 |
| 凭证输入等待请求才清空 | 提交即清空,退出再次清空 | 减少敏感输入在 UI 中停留 |
| JS 滚动条默认每帧更新并使用高层级轨道 | 迁移视觉和容器管理思路,使用原生滚动与 CSS | 删除默认持续轮询和嵌套定位复杂度 |
| UI 规范缺失,原生窗口颜色另写一份 | DESIGN.md + 单一 token 来源、生成校验与对比度测试 | 文档、CSS 和原生按钮有可检查的一致性 |
各层是否有必要
- contracts 是跨进程数据模型,不是第二套 API 路由。仅共享的 schema 放在这里。
- main/modules 是 API 的定义处,角色、输入、输出及执行入口放在同一位置。简单操作直接调用服务;复杂业务才增加 repository 或独立业务服务。
- main/trpc 只保留公共运行规则、事件组合和根路由组合,不重复业务职责。
- desktop 封装 Electron、文件、数据库和系统更新的差异;使用参数注入,不反向导入应用。
- electron-trpc 处理传输、取消与监听;来源与容量由 RpcGateway 管理,业务授权由 procedure 管理。
- renderer/features 处理浏览器中的状态、用户操作与功能资源。直接调用推导类型的客户端,不再添一层重述 API 的 service。
- ui 是可复用的纯展示组件;不接触应用状态和通信。
每一层都有独立原因;简单功能的调用链是“功能 composable → tRPC procedure → 服务”,没有 method-name dispatch 或隐式全局 service locator。
保留的取舍
同步 JSON、SQLite 和受限文件操作让简单应用容易理解,但不适合长时间 CPU 工作或大量数据任务。需要这类能力时引入 worker/utility process,不应为了未来可能用到而默认增加任务系统。
当前源码由 electron-vite 直接构建 workspace 包,省去额外包构建前置步骤。独立发布 package 时再增加 dist/export 构建流程。
每个包声明自己实际使用的依赖,版本由 pnpm catalog 统一。共享版本不等于包可以依赖根目录的隐式安装;保留各包的 dependency 声明才能独立理解和发布。
仓库内 electron-trpc 适配避免隐藏补丁,但意味着升级 tRPC 时必须维护兼容性并运行传输测试。这是明确的维护成本,不应宣称无成本。
原生滚动条允许平台差异,暂不默认引入虚拟列表或第三方滚动框架。特定业务确有性能或交互需要时,再在所属功能加入。
验证与交付边界
检查顺序与实际结果见 validation.md。关键保证依靠权限、来源、资源清理、乱序事件、配置持久化及真实 Electron 行为测试,而非只验证文件位置。
Windows 可在本机验证;macOS/Linux 运行效果、签名、notarization 与真实更新服务器仍需平台环境。默认 electron-builder 的本机解压重命名限制及构建工具审计告警单独记录,不能用替代打包验证掩盖它们。
因此,目前可以作为具有明确扩展规则的开发模板使用;跨平台发布前仍需完成目标平台验证与发布配置。
本轮进一步改进与评分
沿用此前的中小型 Electron 模板评价标准,当前主观评估为 89/100:职责与模块化 24/25、安全 23/25、开发维护 17/20、生命周期与异步可靠性 14/15、测试与发布成熟度 11/15。评分是基于代码和已完成验证的工程判断,不是自动审计结论。
已落实:启动时能力开关和只减不增的启动参数;关闭时不构造服务,主进程返回实际能力,界面随之裁剪。IPC 增加查询/修改超时、订阅启动超时、AbortSignal 和可信来源取消;状态同步共享 useSnapshotStream,会话代次与事件版本阻止迟到结果覆盖,失败后明确重连。内部异常保留安全分类与关联编号,启动记录阶段,更新异常也接入诊断。
没有默认增加通用插件容器、service locator、任务队列或 worker。文件授权仍由功能自身追踪;关闭能力不自动删除依赖和数据;大型业务任务仍应按需求引入 worker。跨平台发布、签名及真实更新升级的验证边界保持不变。