README

🤖 MathModelAgent 📐

    


    专为数学建模设计的 Agent
    自动完成数学建模，生成一份完整的可以直接提交的论文。


简体中文 | English


    ⬇️ 下载最新桌面版（推荐）


    🎨 姊妹项目：sci-box —— 科研图表 & 流程图 SKILL 合集


---

 🖥️ 桌面版（推荐使用方式）

 不想折腾环境？直接下载桌面版，开箱即用。

 👉 前往 Releases 下载最新版本

桌面版已内置 Claude Code 与全套 MathModelAgent SKILLS，无需安装 Python / Node.js / Redis，也无需手动配置 SKILL，装好填一个模型 API Key 即可开始建模。

| 系统 | 下载文件 |
|------|----------|
| macOS（Apple 芯片 M 系列） | mathmodel--arm64.dmg |
| macOS（Intel 芯片） | mathmodel--x64.dmg |
| Windows 64 位 | mathmodel--x64.exe |

macOS 安装包已 Developer ID 签名并通过 Apple 公证。

 [!TIP]
 不确定自己的 Mac 是哪种芯片？点击左上角  → 关于本机，看「芯片」一栏：显示 Apple M 系列选 arm64，显示 Intel 选 x64。

 [!WARNING]
 Windows 安装包当前未签名，首次安装或运行时可能出现 Microsoft Defender SmartScreen 提示，请选择「更多信息」→「仍要运行」，并务必从官方 Releases 页面 下载。

安装后应用会自动检查更新（macOS 支持自动更新，Windows 待代码签名证书配置完成后启用）。

如果你是开发者，想自行部署或参与贡献，请继续阅读下方的 SKILLS 与 使用教程。

---

 🌟 愿景：

3 天的比赛时间变为 1 小时
自动完整一份可以获奖级别的建模论文


    
    


 ✨ 功能特性

- 🔍 自动分析问题，数学建模，编写代码，纠正错误，撰写论文
- 💻 Code Interpreter
    - local Interpreter: 基于 jupyter , 代码保存为 notebook 方便再编辑
    - 云端 code interpreter: E2B 和 daytona
- 📝 生成一份编排好格式的论文
- 🤝 multi-agents: 建模手，代码手，论文手等
- 🔄 multi-llms: 每个 agent 设置不同的、合适的模型
- 🤖 支持所有模型: litellm
- 💰 成本低：workflow agentless，不依赖 agent 框架
- 🧩 自定义模板：prompt inject 为每个 subtask 单独设置需求
- 🌐 Web Search: Agent 自主搜索互联网获取真实数据（Tavily API）
- 📚 RAG 知识库: 从本地知识库检索建模方法、代码模板、论文写作参考（ChromaDB + Rerank）
- 🤝 HIL 人机协作: 关键节点暂停等待用户审批，支持 6 种决策动作（confirm / edit / regenerate / ask / skip / abort）
- 🛡️ 四层容错: 有限重试 → Fallback Hand Off → Evaluator Shadow Mode → Feedback Rerun




---
---

我在平台中托管了一个在线版本，方便使用，欢迎体验：

https://mathmodel.top/home

 SKILLS

项目蒸馏成完全由 SKILLS 驱动
不再做 Harness 层

 Intro

MathModelAgent SKILL —— 直接在 Harness 中驱动的数学建模自动化方案.

💰 开源免费，接入任意模型
完全开源免费，可接入任何模型。

🧠 端到端自动化
从问题分析、建模、编码、绘图到论文排版和验收，一条 /1start-mathmodel 命令全自动完成，中间阶段自动串联，无需人工干预。

📄 17 套 Typst 论文模板
内置中英文主流赛事模板（国赛、华数杯、华为杯、MCM/ICM 等），自动匹配赛事类型，生成排版精良、可直接提交的 PDF 论文。

📐 内置建模知识库
包含完整的建模规范、模型选择决策树（AHP、TOPSIS、ARIMA、GA 等）、常见易错模式和 MCM/ICM 评分标准，每个阶段自动参考，降低模型幻觉。

✅ 9 步自动验收
文本泄漏检测 → 数值一致性校验 → Typst 编译 → PDF 可视化检查，确保论文零低级错误。

🔧 可组合、可扩展
每个阶段是独立 Skill，可单独调用（如只跑分析、只写论文）；模板和知识库可自由扩展；支持 Typst 生态排版。

 Skills 一览

工作流 Skills 按 1–6 阶段串联，也可以按需单独调用。

| Skill | 用途 | 主要交付 |
|-------|------|----------|
| 1start-mathmodel | 启动完整数学建模流程，安排各阶段任务 | 建模计划与任务清单 |
| 2analysis-modeling | 分析赛题与数据，设计模型和求解策略 | 建模报告、假设、公式与约束 |
| 3coding-visual | 编写并运行求解代码，生成数据图表 | 可复现代码、结果报告与图表 PDF |
| 4drawio | 绘制技术路线、求解流程与模型结构图 | 可编辑的 DrawIO 图与 PDF |
| 5writing | 选择比赛模板，组织和排版论文 | Typst / LaTeX 论文源码与 PDF |
| 6verity | 核对数值、引用、图表、编译与提交要求 | 验收报告与待修复问题 |
| mathmodel-to-ei | 将完整数模论文改写为英文会议论文 | IEEE LaTeX 源码、PDF 与改稿说明 |
| doctor | 检查工作流依赖，指导补齐环境 | 环境检查结果与安装指引 |
| typst-author | 编写、修改和排查 Typst 文档 | Typst 源码与排版修复 |
| mathmodel-figure-templates | 使用内置科研绘图模板，按需调整样式 | 绘图脚本与 PNG / PDF / SVG |
| _references | 提供各阶段共用的建模、写作与图表规范 | 共享参考知识库，由其他 Skills 按需读取 |

 数模论文转 EI 会议论文

已有完整的数学建模竞赛论文，可以使用 mathmodel-to-ei 提炼研究主线、重组章节、改写英文正文并整理图表。内置 IEEE conference LaTeX 模板，交付论文源码、编译成功的 PDF 和改稿说明；目标会议有指定模板时优先使用指定模板。

text
使用 $mathmodel