SuperAPI AI 工具集

rocm-doctor

部署与运维

查看项目

更新于 10-15 19:56

技能介绍

用途:针对“ROCm / PyTorch / llama.cpp 在我的 AMD GPU 上不工作”的报错,识别已知配置错误并修复(需用户同意)或给出下一步。该技能本身不探测、不推理,由 rocm CLI 负责探测、封闭故障目录与修复,技能只驱动并转述结果。

主要能力:先做范围判断,仅处理 AMD GPU;NVIDIA/Intel/Apple GPU 直接说明超出范围并停止,不提供任何排查建议。WSL2 属于支持范围,正常执行流程。支持原生 Linux、Windows(HIP SDK)、WSL2。

使用方式:先确认 rocm CLI 存在,运行 rocm --version;缺失时经用户同意安装。Linux x86_64 用 curl -fsSL https://raw.githubusercontent.com/ROCm/rocm-cli/main/install.sh | sh,Windows PowerShell 用 irm https://raw.githubusercontent.com/ROCm/rocm-cli/main/install.ps1 | iex。随后运行 rocm diagnose --symptom "<粘贴确切错误>" --json,读取 has_match、matched[]、out_of_scope、route_when_no_match。has_match 为 true 才可提议修复;score 75 以上为高置信,50–74 需再确认证据。修复命令:rocm fix <fix-id>、--dry-run、--yes。仅四个自动修复由 CLI 执行,其余 22 个为仅打印方案。

适用场景与限制:适用于基于系统 ROCm/HIP 构建的 PyTorch、llama.cpp。自带运行时的应用(Lemonade、Ollama、LM Studio)需转到对应问题跟踪器。无匹配时路由到 ROCm 核心仓库。不得自行编造修复,不得在未获明确同意时执行变更修复,不要手动设置 HSA_OVERRIDE_GFX_VERSION 等环境变量。