electron-build-run

name	electron-build-run
description	自动化构建与运行 Electron 桌面项目（含 electron-vite + 子包）。当用户要求构建、运行、启动、打包 Electron/electron-vite 项目，或出现 electron-vite 命令找不到、依赖缺失等问题时调用。

Electron Build & Run

本 skill 用于规范化地构建与运行基于 electron-vite 的桌面项目（如 DeepSeek-GUI），并涵盖子包（如 kun/）的依赖与构建处理。

何时调用

• 用户说"构建这个项目""运行这个项目""启动应用""打包 Electron"等
• 提示 electron-vite 不是内部或外部命令、Cannot find module、node_modules 不存在
• 需要在 Windows / macOS / Linux 上分发 Electron 安装包

标准流程

1. 环境与项目检查

• 确认仓库根目录存在 package.json，并查看 scripts 中的：
  • dev：开发启动
  • build：生产构建
  • dist / dist:win / dist:mac / dist:linux：打包
  • build:kun 或类似子包构建脚本
• 检查根目录与子包目录（如 kun/）是否存在 node_modules

2. 安装依赖

• 若根目录缺少 node_modules，先执行：

  npm install
  

• postinstall 脚本通常会自动初始化子包，无需手动处理

3. 构建项目

npm run build

• 会先执行 build:kun（子包 tsc 构建）
• 再使用 electron-vite build 输出到 out/{main,preload,renderer}

4. 运行项目

• 开发模式（带热重载）：

  npm run dev
  

• 预览构建产物：

  npm run preview
  

5. 打包分发

• Windows：npm run dist:win
• macOS：npm run dist:mac
• Linux：npm run dist:linux

常见问题排查

现象	原因	处理
electron-vite 不是内部或外部命令	根目录依赖未安装	执行 npm install
tsc 报子包错误	子包未构建或类型不匹配	进入子包执行 npm run build
Electron failed to install	网络问题	设置 ELECTRON_MIRROR 国内镜像后重试
EPERM / 资源占用	进程未关闭	关闭旧 Electron 进程再重试
端口 5173 占用	dev server 未释放	关闭旧 npm run dev 进程

使用约定

• 长时间运行命令（如 npm run dev）使用非阻塞执行
• 构建命令使用阻塞执行并检查 exit code
• 优先复用空闲终端，减少终端数量
• 不主动执行 git 提交或推送操作