用途：在 macOS 上排查 nvm 相关故障，包括 zsh/bash 配置文件未加载、PATH 优先级冲突、权限错误，以及 Homebrew 安装的 Node 与 nvm 冲突等问题。当 macOS 环境中出现 nvm 命令找不到（nvm not found）或版本切换异常时可使用。
主要能力与工作流：
- 运行诊断检查，例如：echo "Shell: $SHELL"、echo "NVM_DIR: $NVM_DIR"、cat ~/.zshrc | grep -n nvm、echo $PATH | tr ':' '\n' | head -10。
- 检查 macOS zsh 配置文件加载顺序：~/.zshenv（始终读取）、~/.zprofile（登录 shell）、~/.zshrc（交互式 shell）。
- 修复最常见问题，即在 ~/.zshrc 中缺少 nvm 加载语句，需加入： export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" [ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion"
- 验证修复：source ~/.zshrc、command -v nvm（应输出 nvm）、nvm --version、node -v。
适用场景：macOS 上使用 zsh 或 bash 时 nvm 无法加载、PATH 中 nvm 路径优先级不正确、出现权限报错，或 Homebrew 安装的 Node 与 nvm 管理的版本冲突。
限制与说明：常规验证属于 nvm-verify 技能；Linux/WSL 问题应使用 nvm-troubleshooting-linux。资料中还列出了示例文件映射：examples/troubleshooting-macos.md、examples/macos-troubleshooting.md、examples/problems.md、examples/compatibility-issues.md。其他细节如支持版本范围、具体平台限制暂未提供。