
如何向 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/MathModelAgentMathModelAgent 是一款专为数学建模设计的开源 Agent一条命令即可自动完成赛题分析、模型构建、代码实现与论文撰写直接产出可提交的竞赛论文。如果你跑出了满意的结果欢迎通过 PR 将优秀案例贡献到 MathModelAgent-Example 社区案例库。本文用 5 个步骤带你走完「本地运行 → 产出案例 → 整理目录 → 提交 PR」的完整贡献流程全程不超过半小时。为什么要提交数学建模案例对社区贡献者来说提交案例是参与 MathModelAgent 项目门槛最低、价值最高的方式零代码门槛你不需要修改任何 Agent 源码只需要「跑一道题、整理产物、发起 PR」。帮助模型调优项目团队正在不同模型、不同 Harness 上做大规模黑盒测试你的真实案例就是最直接的评测素材。案例将进入官方示例库优秀案例会被收录为 WebUI 中可直接一键运行的「样例解析」供所有用户参考。官方对贡献方向的说明可以见 README.md「如果你有跑出来好的案例可以提交 PR 在 MathModelAgent-Example 仓库下」。案例目录结构速览每个案例本质上就是「一个竞赛题目 它的附件数据」。以仓库内置的三个案例为例案例目录题目来源数据文件2023华数杯C题/华数杯 2023 C 题题目 PDF 附件.xlsx2024高教杯C题/高教杯 2024 C 题题目 PDF 3 个附件2025五一杯C题/五一杯 2025 C 题题目 docx csv 附件关键约定只有两条参考 backend/app/example/ 下的现有结构必须有questions.txt纯文本的题目描述。后端 modeling_router.py 中的/example接口会直接读取该文件作为建模输入文件名不可更改。附件数据随意命名同目录下的其他文件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/各阶段报告。建议保留「运行环境信息」模型名称与参数、HarnessClaude 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 RequestFork 案例仓库在你的代码托管平台上 forkMathModelAgent-Example。新建分支命名建议case-2025wuyibei-C之类「案例来源 时间」格式。提交案例目录按第三步整理好的结构放入仓库根目录commit 信息写清楚「赛事 模型 亮点」例如add 2025五一杯C题: XGBoost 睡眠质量预测一次通过率 90%。PR 描述建议包含题目链接、所用模型与 Harness、运行结果摘要准确率/关键结论、产物截图。等待合并维护者会检查目录规范与数据完整性通常会在社区群README 中的 QQ 群 / Discord同步进展。案例验收标准与常见问题一份「优秀案例」长什么样目录规范questions.txt命名正确、附件齐全能被/example接口直接加载结果可信数值结论可复现代码与图表对应有差异价值覆盖新赛事、新题型优化/预测/分类/机理或展示新模型的运行表现常见问题问题解答必须提交完整论文吗不需要案例库核心是「题目 数据」论文可作为附加产物一并附上可以提交自己编的题吗可以只要数据公开、目录规范自拟题请在 PR 中说明代码有 Bug 能提交吗能。黑盒测试欢迎记录真实表现在 PR 中注明失败点即可同样有价值更多技术细节可参考官方 使用教程 与 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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考