doctor

name doctor description 环境检查与安装向导。检查数学建模工作流所需的全部依赖是否已安装，对缺失项提供安装命令，并在用户确认后执行安装。手动触发。 allowed-tools Bash(*), Read, Write Doctor — 环境检查与安装向导 本 skill 检查完整数学建模工作流所需的所有工具是否已就绪，并帮助用户安装缺失项。 本 skill 只在用户显式触发时运行，不自动执行。 检查项清单 核心工具 工具 用途 检测命令 typst 论文编译（5writing、6verity，Typst 引擎） command -v typst xelatex 论文编译（5writing、6verity，LaTeX 引擎，中文模板必需） command -v xelatex python3 数值计算与图表（3coding-visual） command -v python3 drawio / draw.io DrawIO 流程图导出 PDF（4drawio） command -v drawio || command -v draw.io pdftoppm PDF 转 PNG 视觉检查（6verity） command -v pdftoppm mutool PDF 转 PNG 备用（6verity） command -v mutool magick PDF 转 PNG 备用（6verity） command -v magick Python 包 包 用途 numpy 数值计算 scipy 科学计算、优化求解 pandas 数据处理 matplotlib 图表生成 scikit-learn 机器学习建模 openpyxl 读写 Excel 数据附件 工作流程 Step 1：检测当前平台 case " $(uname -s) " in Darwin) echo "PLATFORM=mac" ;; Linux) echo "PLATFORM=linux" ;; MINGW*|MSYS*|CYGWIN*) echo "PLATFORM=windows" ;; *) echo "PLATFORM=unknown" ;; esac Windows 下优先使用 winget，备用 scoop 或 choco。Linux 下优先使用 apt（Debian/Ubuntu），备用 dnf（Fedora/RHEL）或 pacman（Arch）。 检测包管理器： # Linux 发行版检测 if [ -f /etc/os-release ]; then . /etc/os-release echo "DISTRO= $ID " fi # Windows 包管理器检测（在 Git Bash / PowerShell 中） command -v winget >/dev/null 2>&1 && echo "PKG=winget" command -v scoop >/dev/null 2>&1 && echo "PKG=scoop" command -v choco >/dev/null 2>&1 && echo "PKG=choco" Step 2：检查所有工具 check_cmd () { if command -v " $1 " >/dev/null 2>&1; then echo "OK $1 ( $(command -v " $1 " ) )" else echo "MISS $1 " fi } check_cmd typst check_cmd xelatex check_cmd python3 || check_cmd python # Windows 上可能是 python command -v drawio >/dev/null 2>&1 || command -v draw.io >/dev/null 2>&1 \ && echo "OK drawio" || echo "MISS drawio" check_cmd pdftoppm check_cmd mutool check_cmd magick python3 - << 'PYEOF' import importlib pkgs = [ "numpy" , "scipy" , "pandas" , "matplotlib" , "sklearn" , "openpyxl" ] for p in pkgs: try: importlib.import_module(p) import importlib.metadata as meta try: ver = meta.version(p if p != "sklearn" else "scikit-learn" ) except Exception: ver = "?" print (f "OK {p} ({ver})" ) except ImportError: print (f "MISS {p}" ) PYEOF Step 3：输出检查报告 将结果整理展示： 状态 工具/包 说明 ---- -------- ---- ✓ typst 0.13.0 论文编译 ✗ drawio DrawIO 导出 PDF（可选） ✓ python3 3.11.x 数值计算 ✗ scipy 科学计算（可选） ... 必须项： typst 或 xelatex（至少一个论文编译器）、python3、numpy、pandas、matplotlib 可选项： drawio、pdftoppm/mutool/magick 三选一、scipy、scikit-learn、openpyxl Step 4：提供安装命令（按平台） 仅对缺失项输出对应平台的命令。 typst 平台 命令 macOS brew install typst Linux (apt) snap install typst 或从 GitHub Releases 下载二进制 Linux (arch) pacman -S typst Windows (winget) winget install Typst.Typst Windows (scoop) scoop install typst 通用 cargo install --locked typst-cli （需要 Rust） xelatex（TeX 发行版） xelatex 包含在主流 TeX 发行版中（TeX Live / MiKTeX / MacTeX）。安装发行版即可获得 xelatex。 平台 命令 macOS brew install --cask mactex 或 brew install texlive Linux (apt) sudo apt install texlive-full Linux (dnf) sudo dnf install texlive-scheme-full Linux (arch) sudo pacman -S texlive Windows (winget) winget install MiKTeX.MiKTeX 或 winget install TeXLive Windows (scoop) scoop install latex （需先添加 extras bucket） 注意： texlive-full 体积较大（约 5GB），如需精简可只装 texlive-xetex + texlive-lang-chinese （中文支持）。 Python 3 平台 命令 macOS brew install python Linux (apt) sudo apt install python3 python3-pip Linux (dnf) sudo dnf install python3 python3-pip Windows winget install Python.Python.3 或从 python.org 下载安装包 Python 包（批量安装缺失项） pip3 install <缺失的包> # Windows: pip install <缺失的包> # 例如: pip3 install scipy scikit-learn openpyxl drawio 平台 命令 macOS brew install --cask drawio Linux 从 https://github.com/jgraph/drawio-desktop/releases 下载 AppImage 或 deb Windows winget install JGraph.Draw 或从上述页面下载安装包 pdftoppm（来自 poppler） 平台 命令 macOS brew install poppler Linux (apt) sudo apt install poppler-utils Linux (dnf) sudo dnf install poppler-utils Windows winget install oschwartz10612.poppler 或 scoop install poppler mutool（来自 mupdf） 平台 命令 macOS brew install mupdf Linux (apt) sudo apt install mupdf-tools Windows scoop install mupdf 或从 mupdf.com 下载 ImageMagick 平台 命令 macOS brew install imagemagick Linux (apt) sudo apt install imagemagick Linux (dnf) sudo dnf install imagemagick Windows winget install ImageMagick.ImageMagick 或 choco install imagemagick Step 5：询问用户是否安装 列出所有缺失的 必须项 后，询问用户： 以上必须项缺失，是否现在安装？(y/N) 若用户确认，按检测到的平台依次执行安装命令，每步完成后打印结果。 若用户拒绝或只有可选项缺失，打印可手动执行的命令列表并退出。 安装完成后重新运行 Step 2，确认已生效。 Step 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 工具，视觉检查将跳过 注意事项 执行安装前必须获得用户明确确认，不得静默安装。 Windows 下建议在 PowerShell（管理员）或 Git Bash 中运行，部分命令需要管理员权限。 Linux 的 sudo 命令会请求密码，执行前告知用户。 drawio 和 PDF 转 PNG 工具缺失不影响核心工作流，仅影响导出质量。 如平台检测为 unknown，打印所有平台命令供用户手动选择。