企业官网建设流程全解析

如何向 MathModelAgent-Example 提交优秀案例：社区贡献与 PR 流程完全指南

【免费下载链接】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

MathModelAgent 是一款专为数学建模设计的开源 Agent，一条命令即可自动完成赛题分析、模型构建、代码实现与论文撰写，直接产出可提交的竞赛论文。如果你跑出了满意的结果，欢迎通过 PR 将优秀案例贡献到 MathModelAgent-Example 社区案例库。本文用 5 个步骤带你走完「本地运行 → 产出案例 → 整理目录 → 提交 PR」的完整贡献流程，全程不超过半小时。

为什么要提交数学建模案例？

对社区贡献者来说，提交案例是参与 MathModelAgent 项目门槛最低、价值最高的方式：

• 零代码门槛：你不需要修改任何 Agent 源码，只需要「跑一道题、整理产物、发起 PR」。
• 帮助模型调优：项目团队正在不同模型、不同 Harness 上做大规模黑盒测试，你的真实案例就是最直接的评测素材。
• 案例将进入官方示例库：优秀案例会被收录为 WebUI 中可直接一键运行的「样例解析」，供所有用户参考。

官方对贡献方向的说明可以见 README.md：「如果你有跑出来好的案例可以提交 PR 在 MathModelAgent-Example 仓库下」。

案例目录结构速览

每个案例本质上就是「一个竞赛题目 + 它的附件数据」。以仓库内置的三个案例为例：

关键约定只有两条（参考 backend/app/example/ 下的现有结构）：

1. 必须有questions.txt：纯文本的题目描述。后端 modeling_router.py 中的/example接口会直接读取该文件作为建模输入，文件名不可更改。
2. 附件数据随意命名：同目录下的其他文件（xlsx、csv、pdf 等）会被整体复制到任务工作目录，供代码阶段读取。

你可以打开 2023华数杯C题的 questions.txt 感受格式：题面全文 + 补充说明 + 子问题列表，保持原始题面排版即可。

第一步：本地跑通 MathModelAgent

贡献的前提是你先要跑出一个好结果。三种部署方式任选其一（详见 使用教程）：

• Docker 部署（推荐，最简单）：装好 Docker 后执行docker-compose up，访问http://localhost:5173即可使用 WebUI。
• 本地部署：需 Python、Node.js、Redis 环境，Windows 用户可直接双击win_start.bat启动。
• 桌面版：免环境配置，装好填一个模型 API Key 即可开始建模。

启动后在 WebUI「侧边栏 → 头像 → API Key」中配置你的模型密钥。若想自定义提示词模板，可编辑 backend/app/config/md_template.toml。

如果你使用 Skills 模式（项目当前的主要迭代方向），安装后一条命令启动全流程：

claude: /1start-mathmodel 完成这个数学建模任务

工作流会按 5 个阶段自动串联：赛题分析 → 编程与图表 → 流程图绘制 → 论文撰写 → 验证验收，每个阶段的职责与产物定义在 skills/1start-mathmodel/SKILL.md 中。

第二步：收集运行结果

运行结束后，关注两类产物：

• WebUI / 本地部署：结果保存在backend/project/work_dir/xxx/目录下，其中notebook.ipynb是全部建模代码，res.md是 Markdown 格式的结果汇总。
• Skills 模式：产物按标准骨架组织——code/代码、results/结果记录、figures/图表、paper/论文（Typst 或 LaTeX）、reports/各阶段报告。

建议保留「运行环境信息」：模型名称与参数、Harness（Claude Code / Codex 等）、总耗时、一次通过还是经过人工修正。这些元信息会让你的案例对社区评测更有参考价值。

第三步：整理成符合规范的案例目录

在你的本地环境（不要修改克隆来的仓库本身，建议另建贡献目录）中，按下面的结构整理案例：

2025某某杯X题/ ├── questions.txt # 必改名！纯文本完整题面 ├── 附件1.xlsx # 题目原始数据（按原题命名） └── 附件2.csv

整理清单：

• ✅ 将题目 PDF/docx 转写成纯文本questions.txt，保留全部子问题与补充说明
• ✅ 数据文件只保留题目附件，去除个人笔记与临时文件
• ✅ 目录命名规范：年份 + 赛事 + 题号，如2024高教杯C题
• ⚠️ 数据文件不要包含个人隐私或竞赛保密信息，题面与附件需公开发表、可分享

第四步：提交 PR 的完整流程

clone 项目到本地：

git clone https://gitcode.com/GitHub_Trending/ma/MathModelAgent

然后向MathModelAgent-Example社区案例仓库发起 Pull Request：

1. Fork 案例仓库：在你的代码托管平台上 forkMathModelAgent-Example。
2. 新建分支：命名建议case-2025wuyibei-C之类「案例来源 + 时间」格式。
3. 提交案例目录：按第三步整理好的结构放入仓库根目录，commit 信息写清楚「赛事 + 模型 + 亮点」，例如add 2025五一杯C题: XGBoost 睡眠质量预测，一次通过率 90%。
4. PR 描述建议包含：题目链接、所用模型与 Harness、运行结果摘要（准确率/关键结论）、产物截图。
5. 等待合并：维护者会检查目录规范与数据完整性，通常会在社区群（README 中的 QQ 群 / Discord）同步进展。

案例验收标准与常见问题

一份「优秀案例」长什么样？

• 目录规范：questions.txt命名正确、附件齐全，能被/example接口直接加载
• 结果可信：数值结论可复现，代码与图表对应
• 有差异价值：覆盖新赛事、新题型（优化/预测/分类/机理），或展示新模型的运行表现

常见问题

更多技术细节可参考官方 使用教程 与 skills 目录 下各阶段的 SKILL.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