用途:machine-check 用于检查这台电脑是否已准备好运行本地 Drupal 站点。建议在搭建本地站点之前运行一次,并在用户安装某些东西之后再运行一次,以确认环境是否就绪。
主要能力:检查操作系统类型(macos、wsl2、linux 或 unsupported);检查容器运行时是否在运行,并识别其提供方(如 orbstack、linux-docker、colima、docker-desktop 或 unknown),以及检测方式(ddev-dockercheck、docker-info 或 none);检查 DDEV、Node.js、npm 是否安装及各自版本。综合结果由 ready 字段表示:容器运行时正常运行、DDEV 已安装、Node.js 和 npm 均已安装时,ready 为 true。
使用方式:在该技能文件夹中运行 bash scripts/check-machine.sh。脚本会打印一个 JSON 对象,只要检查运行过就以退出码 0 退出,无论检查结果如何。运行 bash scripts/check-machine.sh --summary 可改为输出简短的纯文本摘要。建议把摘要展示给用户,而 JSON 由使用者自行读取。
结果解读:JSON 中 os 表示操作系统;ready 表示是否就绪;checks.container 含 running、provider、via 三个键,分别表示运行时是否响应、DDEV 检测到的平台名或推断的提供方(两者都未安装时为 none)、检查方式;checks.ddev、checks.node、checks.npm 各含 installed(布尔值)和 version(未安装时为空)。next_steps 是对象数组,每项含 piece(os、container、ddev、node 或 npm)、step(要运行的命令或要打开的网址)和 person_runs(为 true 时需请用户执行该步骤,之后重新运行检查)。ready 为 true 时可进入下一阶段。
适用场景:搭建本地 Drupal 站点前的环境预检,以及在用户安装依赖后复检环境状态。
限制:资料未提供该工具的收费、价格、平台支持范围之外的细节或效果保证;其检查范围限于操作系统、容器运行时、DDEV、Node.js 和 npm,其他环境因素暂未提供。