故障排查

构建错误

• TypeScript 报错：运行 npm run build 并查看首个错误；修正导入/拼写
• 原生模块不匹配：运行 npm run postinstall 重建原生依赖

打包问题

• 缺少 RPM：安装 rpm（rpmbuild），或仅构建 Linux DEB
• 在 Linux 上构建 Windows NSIS：安装 wine64 与 mono-complete，或在 Windows 上构建

应用相关

• ICO/ICNS 生成：安装 png2icons 或 ImageMagick（magick/convert）作为兜底
• ZIP 打包：确保 Linux/macOS 有 zip 或 7z；Windows 使用 PowerShell Compress-Archive

验证

• 检查 release/<platform>/SHA256SUMS.txt
• 在目标系统上运行安装包，验证启动与基本流程