| name | build-portable |
| description | 打包 Axon Electron 便携版。执行 build-portable.ps1 脚本，生成免安装的便携版 zip，并可上传到 GitHub Release。Use this skill whenever the user mentions 打包、便携版、portable、Electron 打包、桌面版、build portable，even if they just say "打个包" or "出个桌面版"。 |
| disable-model-invocation | true |
| argument-hint | ["版本号，可选"] |
Electron 便携版打包
架构
Axon.exe(Electron) → spawn → node.exe(内嵌) → dist/web-cli.js → Express server → BrowserWindow.loadURL()
关键文件
build-portable.ps1 — 打包脚本electron/main.cjs — Electron 主进程electron/package.json — Electron 包配置
打包流程
Step 1: 前置检查
确认以下条件满足：
node_modules/electron/dist 存在dist/web-cli.js 存在（如不存在，先运行 npm run build）- 前端构建产物在
src/web/server/public/ 下存在
Step 2: 执行打包脚本
.\build-portable.ps1
脚本自动完成：
- 检查前置条件
- 创建
release/axon-portable/ 目录
- 复制 Electron runtime
- 复制 dist/、node_modules/、electron/ 等项目文件
- 内嵌 Node.js 运行时
- 生成启动入口 Axon.exe
- 打包成 zip
Step 3: 验证
- 检查输出文件大小是否合理（~300-400MB）
- 确认
release/axon-portable/Axon.exe 存在
Step 4: 上传到 GitHub Release（可选）
如果用户指定了版本号或要上传：
gh release upload v$ARGUMENTS release/axon-portable.zip --clobber
常见问题
- Windows Defender 拦截：打包过程中 Defender 可能报告威胁，需要在安全中心排除
F:\axon
- 内存不足：不要用 electron-builder，用手动复制方式避免内存溢出
- HTTPS/HTTP 自适应：main.cjs 同时尝试 HTTPS 和 HTTP，打包后默认 HTTP（
.axon-certs 不在 resources/app/ 下）
