MathModelAgent doctor命令完全指南：一键检查数学建模工作流的全部依赖-创锋一号

MathModelAgent doctor命令完全指南：一键检查数学建模工作流的全部依赖

【免费下载链接】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 是一款专为数学建模设计的 AI Agent，可自动完成赛题分析、建模、编码、绘图，并生成一份可以直接提交的论文。它的/doctor命令正是为这条流水线量身打造的环境检查工具：一条命令即可扫描数学建模工作流所需的全部依赖，逐项标注状态，并给出分平台的安装建议，让你在开跑之前确认环境就绪。🩺

为什么开跑前要先跑一次 doctor

MathModelAgent 的核心是一条 6 阶段自动化流水线，每个阶段依赖的工具各不相同：

阶段	Skill	关键依赖
1️⃣ 启动与规划	1start-mathmodel	无硬性依赖
2️⃣ 赛题分析与建模	2analysis-modeling	无硬性依赖
3️⃣ 编程与数据图表	3coding-visual	`python3`+`numpy`/`pandas`/`matplotlib`
4️⃣ 流程图与技术路线图	4drawio	`drawio`（可选）
5️⃣ 论文撰写与排版	5writing	`typst`或`xelatex`（二选一必须）
6️⃣ 验证与验收	6verity	PDF 转 PNG 工具（可选）

如果缺了某个依赖，流程跑到一半就会"command not found"、图表空白或论文编译失败，排查起来很折腾。/doctor命令把这些分散的环境问题一次性检查清楚：它检测当前系统（macOS / Linux / Windows）和包管理器，扫描核心命令行工具与 Python 包，输出一份带 ✓ / ✗ 标记的检查报告，再针对缺失项给出对应平台的安装命令——而且只在用户显式触发时才运行，绝不会静默安装。

doctor 的检查流程：平台检测、工具扫描与报告解读

doctorskill 的完整逻辑定义在 skills/doctor/SKILL.md 中，共 6 步：

Step 1 · 平台检测通过uname -s判断操作系统：macOS 走 Homebrew，Linux 优先 apt（Debian/Ubuntu）、备选 dnf / pacman，Windows 优先 winget、备选 scoop / choco。

Step 2 · 全量扫描逐项执行检测命令，分两大类共 13 个检查项：

类别	检查项	用途
核心工具	`typst`	论文编译（Typst 引擎）
核心工具	`xelatex`	论文编译（LaTeX 引擎，中文模板必需）
核心工具	`python3`	数值计算与图表生成
核心工具	`drawio`/`draw.io`	DrawIO 流程图导出 PDF
核心工具	`pdftoppm`/`mutool`/`magick`	PDF 转 PNG 视觉检查（三选一）
Python 包	`numpy`/`scipy`/`pandas`	数值、科学计算、数据处理
Python 包	`matplotlib`/`sklearn`/`openpyxl`	图表生成、机器学习、Excel 读写

Step 3 · 输出检查报告所有结果整理成一张状态表，并区分：

必须项：typst或xelatex（至少一个论文编译器）、python3、numpy、pandas、matplotlib
可选项：drawio、PDF 转 PNG 工具三选一、scipy、scikit-learn、openpyxl

Step 4~6 · 安装建议 → 确认安装 → 就绪摘要仅对缺失项输出对应平台的命令，询问"是否现在安装？(y/N)"，你确认后才会执行；安装完成后自动重扫一遍确认生效，最后输出各阶段工作流的就绪状态摘要。

如何触发 doctor 命令：三秒开始一键检查

doctor属于工具类 Skill（与typst-author并列），见 skills/skills.sh.json 中的技能索引。触发方式非常简单：

# Claude Code 中 claude claude> /doctor

在 Codex 等 Harness 中，输入对应的 skill 触发词即可（如$doctor）。

缺失依赖怎么办：分平台安装命令速查

doctor会自动给出建议，这里整理成速查表方便对照。

typst（论文编译）

平台	安装命令
macOS	`brew install typst`
Linux (apt)	`snap install typst`
Linux (arch)	`pacman -S typst`
Windows (winget)	`winget install Typst.Typst`
Windows (scoop)	`scoop install typst`
通用	`cargo install --locked typst-cli`（需 Rust 环境）

xelatex（TeX 发行版）

平台	安装命令
macOS	`brew install --cask mactex`或`brew install texlive`
Linux (apt)	`sudo apt install texlive-full`
Windows (winget)	`winget install MiKTeX.MiKTeX`或`winget install TeXLive`

⚠️texlive-full体积较大（约 5GB）。网络或磁盘紧张时，只装texlive-xetex+texlive-lang-chinese即可满足中文排版需求。

Python 与常用包

# Linux sudo apt install python3 python3-pip pip3 install scipy scikit-learn openpyxl # 按 doctor 报告中的缺失项安装 # Windows winget install Python.Python.3

drawio 与 PDF 转 PNG 工具：macOS 可用brew install --cask drawio、brew install poppler/mupdf/imagemagick；Linux 用sudo apt install poppler-utils、sudo apt install mupdf-tools、sudo apt install imagemagick；Windows 可用winget install JGraph.Draw或scoop install poppler。

如何读懂最终的就绪摘要

安装完成后，doctor会输出类似这样的总结，一眼看清 6 个阶段的可用状态：

Doctor 检查完成（macOS） 必须项：5/5 ✓ 可选项：2/4（drawio、scipy 缺失） 工作流就绪状态： 1start-mathmodel ✓ 2analysis-modeling ✓ 3coding-visual ✓（scipy 缺失，部分功能受限） 4drawio ⚠ drawio 未安装，PDF 导出将跳过 5writing ✓（typst ✓，xelatex ✓） 6verity ⚠ 无 PDF 转 PNG 工具，视觉检查将跳过

只要必须项全部打勾，就可以放心运行/1start-mathmodel启动完整建模流程了。

常见问题 FAQ

Q1：可选项缺失会影响工作流吗？不影响核心流程。缺drawio只会跳过流程图 PDF 导出，缺 PDF 转 PNG 工具时6verity阶段的视觉检查会自动跳过，摘要中会用 ⚠ 明确标注。

Q2：Typst 和 LaTeX 两套引擎怎么选？两套引擎均覆盖全部模板（14 套中文 + 3 套英文，模板见 skills/5writing/templates/）。Typst 编译快、配置简单，推荐新手优先选它；熟悉 LaTeX 的话xelatex同样可用（需编译两遍解决交叉引用）。

Q3：Windows 下执行安装报权限错误？建议在 PowerShell（管理员）或 Git Bash 中运行。doctor在执行安装前会明确告知：Linux 的sudo命令需要输入密码，不会未经确认就执行任何安装。

Q4：doctor 会偷偷装东西吗？不会。skill 明确规定"执行安装前必须获得用户明确确认，不得静默安装"，拒绝安装时只会打印可手动执行的命令列表。

Q5：桌面版用户需要跑 doctor 吗？不需要。桌面版已内置 Claude Code 与全套 SKILLS，开箱即用；/doctor主要服务于自行部署 SKILLS 的开发者。

企业官网建设流程全解析