一个本地优先、可审计、可复现的大学生数学建模完整社区工作流。
它不再停留在建目录和生成占位模板，而是覆盖赛题接入、数据审计、模型选择、代码求解、实验验证、图表、论文 PDF、轻量原创性检查、结果复现、交付包和技术冻结。配合仓库内的 Codex Skill，可以从一份赛题和数据持续推进到完整研究交付。
当前版本：
0.2.0-beta。社区版拥有完整功能链，增强版的差异主要是年度赛事规则覆盖、建模推理深度、自动返修、红队强度、逐页视觉精修和一口气完成能力，而不是把核心阶段从社区版删除。
- 社区 Agent Skill：告诉 Codex 如何连续完成整条建模链；
- 工作流引擎：任务隔离、题面解析、数据审计、模型登记、实验与复现门禁；
- 完整交付模块：论文 PDF、图表与页面轻审计、原创性与身份扫描、打包和冻结；
- 完整合成案例求解代码：真实计算三问结果、滚动预测、整数调度、六张图和稳健性分析；
- 合成案例可见结果：无需安装即可查看实际数值、模型比较和交付清单；
- 端到端演示：一次运行生成完整任务、论文、结果、图表、审计报告和交付包。
- 独立的
tasks/CASE_ID/研究目录； - 原始输入清单、逐问需求矩阵和数据字典；
- 基线与候选模型登记、实验协议和稳健性证据；
- 可运行模型代码、机器可读结果与复现报告；
- 数据图、结果图和敏感性图；
- 可编辑 Markdown 论文源文件与 PDF；
- 本地原创性、身份、占位符、页面流和图像分辨率轻量审计；
- 包含论文、代码、结果、图表和证据的 ZIP；
- 文件哈希、交付清单和冻结记录。
社区版不保证获奖、参赛资格、查重率或任何特定结果。真实比赛必须先建立并核验当年赛事适配器，并遵守 AI、联网、协作、引用和披露要求。
需要 Python 3.11 或更高版本：
git clone https://github.com/LUCASXGAMER/MathModeling-Workflow.git
cd MathModeling-Workflow
python3 -m venv .venv
.venv/bin/pip install -e '.[dev]'
.venv/bin/python scripts/full_demo.py完成后打开：
.workflow/community-demo/tasks/synthetic-complete/
├── code/solve.py
├── results/expected/result.json
├── figures/ # 6 张真实计算图
├── paper/paper.md # 可编辑中文论文源文件
├── paper/build/paper-electronic.pdf
├── compliance/qa-report.json
├── submission/community-research-package.zip
└── reports/final-package/community-freeze.json
演示使用原创合成数据，不含真实赛题、获奖论文或第三方素材。CI 使用 scripts/smoke_demo.py 在临时目录中执行同一条完整链路。
先依据主办方当年规则建立适配器。rules/competition-profile-template.yml 是待核验模板，不能直接声称符合真实赛事。
.venv/bin/mathmodel init my-case \
--competition your-competition \
--problem /绝对路径/赛题.pdf \
--data /绝对路径/附件目录 \
--rules 2026 \
--target-tier 全国一等奖 \
--collaboration-mode single
.venv/bin/mathmodel ingest my-case
.venv/bin/mathmodel audit-data my-case
.venv/bin/mathmodel plan my-case随后在 Codex 中调用：
$mathmodeling-workflow
Skill 会继续完成题意分析、模型比较、代码实现、实验与稳健性、论文和图表、复现、PDF 审计、打包与冻结。底层完整命令为：
.venv/bin/mathmodel verify-results my-case
.venv/bin/mathmodel build-paper my-case
.venv/bin/mathmodel audit my-case
.venv/bin/mathmodel package my-case
.venv/bin/mathmodel freeze my-case
.venv/bin/mathmodel status my-case具体研究主线见 docs/WORKFLOW.md，规则适配见 docs/RULE_ADAPTER.md，版本边界见 COMMUNITY_VS_PRO.md。
社区版不是空壳，但它的完整审计属于轻量级：使用通用规则适配器、Markdown PDF 渲染、本地文本扫描和单轮页面结构检查。增强版会进一步提供已维护的赛事年度适配、更深的模型候选比较、严格证据绑定、多轮红队、逐页视觉理解与自动修复，以及更强的一口气完成能力。
无论使用哪个版本，问题特异的模型、数值和结论都必须来自本次数据与真实运行，不能由模板虚构。
.venv/bin/pytest -q
.venv/bin/ruff check src tests scripts examples/synthetic/solution
.venv/bin/python scripts/audit_distribution.py .
.venv/bin/python scripts/smoke_demo.py发行审计必须返回 distribution_clean=true。安全问题请按 SECURITY.md 私下报告，不要在公开 Issue 中发布密钥、未公开赛题或个人数据。
仓库不包含优秀论文、获奖论文、样本论文、历史任务、官方规则原文或比赛附件。所有合成案例、代码和文档均为项目原创内容。社区代码采用 GNU AGPL v3 或更高版本；名称与视觉标识不随软件许可自动授权。