如何构建MathModelAgent桌面版？Electron打包macOS与Windows完整指南

如何构建MathModelAgent桌面版Electron打包macOS与Windows完整指南【免费下载链接】MathModelAgent专为数学建模设计的 Agent skills ,自动完成数学建模生成一份完整的可以直接提交的论文。 An Agent Designed for Mathematical Modeling ,Automatically complete mathmodel and generate a complete paper ready for submission.项目地址: https://gitcode.com/GitHub_Trending/ma/MathModelAgentMathModelAgent 桌面版是专为数学建模设计的一体化 AI Agent上传赛题后自动完成问题分析、建模、编码、绘图最后生成一篇排版精良、可直接提交的论文。本文带你完整走一遍 MathModelAgent 桌面版的构建路线先认识它的三服务架构再本地跑通 Web 版最后用 Electron electron-builder 分别打包出 macOS 的 .dmg 安装包和 Windows 的 .exe 安装包。为什么需要 MathModelAgent 桌面版在开源社区MathModelAgent 的常规部署需要手动准备 Python、Node.js、Redis 三套环境对新手并不友好。而官方桌面版把整套环境打包进一个安装包开箱即用无需安装 Python / Node.js / Redis装好后填一个模型 API Key 即可开始建模内置建模能力预装全套 SKILLS自动建模、代码纠错、论文撰写一条命令跑完全流程17 套论文模板覆盖国赛、华数杯、华为杯、MCM/ICM 等主流赛事。 最省事的做法直接从官方Releases页面下载对应系统的桌面版macOS 支持 arm64 / x64 双架构Windows 为 64 位 .exe安装后应用会自动检查更新。下面的构建指南适合两类读者想理解桌面版内部结构的学习者以及想自行打包分发的开发者。先搞懂技术架构打包之前必看MathModelAgent 是一个「前后端分离」项目桌面版本质上是用 Electron 把 Web 前端包进原生窗口再托管后端服务。三服务的职责如下服务技术栈端口说明前端Vue 3 Vite TailwindCSS5173聊天、论文预览、Notebook 渲染后端FastAPI Uvicorn8000Agent 工作流、代码解释器、论文生成缓存/消息Redis6379任务状态与会话管理关键配置文件后端模型配置backend/app/config/model_config.toml每个 Agent建模手、代码手、论文手可分别指定不同模型环境变量模板backend/.env.example提示词模板Prompt Injectbackend/app/config/md_template.toml。建模流程由 skills/ 目录下的分阶段 Skill 驱动1start-mathmodel启动 →2analysis-modeling分析建模 →3coding-visual编码绘图 →5writing撰写论文 →6verity九步验收可参考 skills/1start-mathmodel/SKILL.md。第一步本地跑通 Web 版打包的前提是能本地运行按顺序完成下面三步即可。克隆代码git clone https://gitcode.com/GitHub_Trending/ma/MathModelAgent安装依赖前端参考 frontend/package.jsoncd frontend npm install -g pnpm pnpm i后端使用 uv 管理参考 backend/pyproject.tomlcd backend pip install uv uv sync别忘了安装 Redis并把backend/.env.example复制为backend/.env.dev按 README.md 教程设置REDIS_URLredis://localhost:6379/0。一键启动三个服务Windows 用户直接双击根目录的 win_start.bat 即可同时拉起 Redis、后端、前端macOS / Linux 手动分别在三个终端执行redis-server、uvicorn app.main:app --host 0.0.0.0 --port 8000、pnpm run dev前端入口配置见 frontend/vite.config.ts。启动后访问 http://localhost:5173 在「侧边栏 → 头像 → API Key」填入模型密钥看到对话界面出现说明核心链路已通。也可以不用手写命令直接用 docker-compose.yml 一键容器化部署来验证环境。第二步用 Electron 包裹前端仓库本身不包含 Electron 工程官方桌面版在独立构建流水线中产出因此我们需要在frontend之外新建一个壳工程npm create electron-applatest mma-desktop # 选择 Vite TypeScript 模板核心思路只有三点代码量很小main.js 主进程创建 BrowserWindow 时指向本地后端http://localhost:5173生产环境则加载打包后的静态文件frontend/dist托管三服务在app.whenReady()中用child_process.spawn依次启动 Redis、uvicorn端口 8000、vite preview端口 4173app.quit时统一 kill 子进程——这样桌面版才是真正「零依赖」的WebSocket 转发MathModelAgent 的任务进度通过 WebSocket 推送Electron 需保持webPreferences: { contextIsolation: true }并放行 8000 端口的 ws 连接后端 WS 心跳参数可参考 backend/app/main.py。配置完成后npm run dev即可在桌面窗口中体验完整功能。macOS 桌面版打包electron-builder 与公证在electron-builder的build配置中声明 macOS 双架构mac: { target: [ { target: dmg, arch: [arm64] }, { target: dmg, arch: [x64] } ] }执行npm run dist:mac后产出与官方一致的两种安装包芯片安装包Apple M 系列mathmodel-version-arm64.dmgIntelmathmodel-version-x64.dmg 用户不确定自己 Mac 的芯片「关于本机」中显示 Apple M 系列选 arm64显示 Intel 选 x64。签名是 macOS 分发的关键一步在 Apple Developer 计划个人 99 美元/年申请Developer ID Application证书用CSC_LINK/CSC_KEY_PASSWORD环境变量让 electron-builder 自动签名配置notarize: true提供 Apple ID 与 App 专用密码完成公证避免用户双击提示「已损坏」更新渠道可接入 electron-updater配合发布页实现自动更新。Windows 桌面版打包NSIS 安装器Windows 侧配置更简单win: { target: [{ target: nsis, arch: [x64] }] }npm run dist:win将生成mathmodel-version-x64.exe安装器NSIS 会处理图标、快捷方式与卸载逻辑。两点提醒⚠️ 未签名的 .exe 首次运行会触发Microsoft Defender SmartScreen蓝色警告属正常现象选择「更多信息 → 仍要运行」即可。想要消除提示需购买 EV 代码签名证书打包机必须使用 Windows或在 CI 中提供 Windows Runnerelectron-builder 不支持在 Linux 上直接打 .exe由于主进程托管了 uvicorn注意把后端.venv与 win_start.bat 中的启动逻辑整合进spawn参数路径中避免中文。常见问题速查问题解决思路端口被占用8000 / 5173 被占时先lsof -i:8000排查Redis 连不上确认.env.dev中REDIS_URL与本地实例一致详见 backend/.env.example论文输出在哪结果保存在backend/project/work_dir/xxx/下的 notebook 与 res.md想换赛事模板编辑 skills/5writing/templates/ 下的 Typst 模板完整部署细节参考官方教程 docs/md/tutorial.md总结回顾一下整条构建路径理解三服务架构 → 本地跑通 Web 版 → Electron 主进程托管服务 → electron-builder 分别产出 macOS dmgarm64/x64 签名公证与 Windows exeNSIS。整个方案的核心收益在于用户无需任何环境准备装好填 Key 即可让 MathModelAgent 在本地自动完成数学建模并产出可提交论文。如果你在打包过程中遇到问题不妨先对照 README.md 的部署章节逐服务自检这是最快的排障路径。【免费下载链接】MathModelAgent专为数学建模设计的 Agent skills ,自动完成数学建模生成一份完整的可以直接提交的论文。 An Agent Designed for Mathematical Modeling ,Automatically complete mathmodel and generate a complete paper ready for submission.项目地址: https://gitcode.com/GitHub_Trending/ma/MathModelAgent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考