总览

electronup 本身只负责构建流程；下面这些包按需安装，用于创建项目或补充运行时能力。

构建相关

• create-electronup：创建 electronup 项目模板的命令行，支持 vanilla、vue、react、react-swc、solid。
• @quiteer/parser-config：按路径解析用户配置文件，electronup 用它读取 electronup.config.ts 等文件。

运行时相关

以下七个包在本仓库 packages/electron-* 下维护，与 electronup 配套使用，可按需单独安装：

• @quiteer/electron-ipc：主进程 IPC 预设通道，一次 init() 即可让渲染进程操作所属窗口、调用 node:path 能力。
• @quiteer/electron-preload：预加载脚本，导入即拿到路径，暴露 $ipc / $clipboard / $webFrame 三组已收敛的 API。
• @quiteer/electron-browser：窗口管理，统一注册、随处取窗、响应式操作。
• @quiteer/electron-menu：菜单管理，统一注册、随处取用、按路径定位菜单项、改动自动同步。
• @quiteer/electron-tray：系统托盘管理，统一注册、随处取用、图标状态切换、菜单与事件一把梭。
• @quiteer/electron-app：应用生命周期样板，单实例锁、deep link、macOS activate 重建主窗口、优雅退出。
• @quiteer/electron-shortcut：全局快捷键管理，按名注册、冲突检测、按窗口焦点启停、退出自动注销。

从旧版本升级 electron-preload / electron-ipc 请看升级指南。

这些运行时包不依赖 electronup 的命令行，也不影响构建产物目录；请根据自己的主进程入口按需引入。

在 electronup 项目里安装

electronup 把主进程打成 CJS（electron.cjs）。dependencies 里能被 require 的包留在外部，运行期 require；而 exports 只提供 import 条件的纯 ESM 包（除 electron-preload 外这些包都是）会被自动打进 electron.cjs，否则运行期会报 ERR_PACKAGE_PATH_NOT_EXPORTED。所以这些包放在 dependencies 或 devDependencies 都能用：

包	建议放在	原因
electron-ipc / browser / menu / tray / app / shortcut	devDependencies	无论放哪里都会打进 electron.cjs；放在 devDependencies 时安装包里不会再多带一份
electron-preload	dependencies	preloadPath / createPreload() 指向包里预构建的 index.cjs，运行期必须能找到这个文件，由 electron-builder 打进安装包

pnpm add -D @quiteer/electron-ipc @quiteer/electron-browser
pnpm add @quiteer/electron-preload

想让其他能 require 的运行时依赖也打进主进程，在 electronup.config.ts 的 packConfig.noExternal 里列出它们；反过来，packConfig.external 里列出的包始终不打包。使用 electron-preload 时不需要再在 electronup 的 preload 配置里构建它。