用途：在任意兼容的 Ubuntu 22.04 x86_64 主机上安装、升级或排查摩尔线程 MUSA 相关组件（MUSA Toolkit、libmusa、muDNN、MCCL、torch、torch_musa、mtgpu 驱动、MTT S5000）。
主要能力：把内核驱动与用户态 SDK 分开处理；将 Toolkit、libmusa、muDNN、MCCL、torch、torch_musa 视为一组兼容集合；建议采用带版本号的用户态前缀布局，便于切换 SDK；提供了先只读检查、选择兼容矩阵、下载与校验、环境变量配置、Python 包安装和分层验证的完整流程。
必要用法：首先进行只读检查，例如 lsb_release -a、uname -a、lspci -nn、mthreads-gmi、lsmod | awk '$1 == "mtgpu" {print}'、dkms status。确认兼容集合后再安装。环境变量示例：export MUSA_HOME="$MUSA_ROOT/$MUSA_VERSION"、export PATH="$MUSA_HOME/bin${PATH:+:$PATH}"、export LD_LIBRARY_PATH="$MUSA_DRIVER_LIB_DIR:$MUSA_HOME/lib${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}"。验证阶梯从 musaInfo、mcc --version、ldd 检查，到单卡 torch 计算，再到 MCCL 多进程与长时间训练。
限制：不得在 GPU 任务运行时升级或重载内核驱动；musaInfo 成功不代表 torch_musa 可用；torch 与 torch_musa 版本必须精确匹配；Python wheel 标签需与解释器一致；不要把未修改的 CUDA 依赖（nvidia-*、NCCL、bitsandbytes 等）装入 MUSA 环境。官方安装包或仓库版本与价格信息暂未提供。