npm run *
- codex://threads/01a139a4-1acb-7442-8f34-ea7085e9b0b8 根据当前 package.json，主要命令如下：
| 命令 | 作用 | 什么时候用 |
|---|---|---|
npm run dev |
增量构建开发所需代码，启动 Electron 和 Vite；渲染界面支持热更新 | 日常开发 |
npm run build |
清理并完整重建 .build/，编译 TypeScript、复制资源并生成编辑器包 |
需要完整构建产物时 |
npm run build:dev |
增量构建到 .build/，不启动应用 |
只想更新构建产物时 |
npm start |
启动 Electron，复用上次成功的完整构建；缺少产物时自动构建 | 运行已构建的版本 |
npm run typecheck |
检查各 TypeScript 项目类型，不生成文件 | 快速检查类型错误 |
npm run lint |
检查文件长度并运行 ESLint | 检查代码规范 |
npm test |
依次运行单元测试、Electron 冒烟测试和开发模式测试 | 验证应用行为 |
npm run validate |
依次运行类型检查、lint、构建回归、全部测试及目录打包 | 提交前完整验证 |
npm run pack |
完整构建后，将当前平台应用打包到 dist/ 目录 |
检查可分发应用 |
npm run dist:win / dist:mac |
完整构建后生成对应平台安装包 | 发布打包 |
npm run sync-server |
构建并启动托管同步服务 | 开发或运行同步服务 |
最容易混淆的是 dev 和 start：dev 面向修改代码时使用；start 会复用已有构建，因此源码改动后不一定会反映在应用里。开发模式下，主进程或 preload 代码改动后需要重新运行 npm run dev。
