环境准备

需要的软件

软件	版本	用途
Node.js	22 LTS（20.19+ 也可以）	运行测试
pnpm	10 或 11	装依赖
adb（Android Platform Tools）	任意近期版本	只有跑 Android 才需要
Git	任意	拉代码

macOS 用 Homebrew 一键装：

brew install node pnpm android-platform-tools

Windows 建议用 nvm-windows 装 Node，npm i -g pnpm 装 pnpm，adb 从 Android 官网 下载后加到 PATH。

拉代码、装依赖

git clone <仓库地址> autotest
cd autotest
pnpm install

第一次安装会下载 Chromium，几十 MB 到一两百 MB，耐心等。装完会自动生成两份节点清单 midscene-node-spec.web.md 和 midscene-node-spec.android.md，写用例时查这两份文件，或直接看本站的节点参考。

pnpm 10+ 会拦构建脚本

如果看到 Ignored build scripts 的报错，说明 pnpm 拦截了 esbuild/sharp 的安装脚本。仓库里 pnpm-workspace.yaml 的 allowBuilds 已经放行了，正常不会遇到；遇到了先确认 pnpm 版本不低于 10，再 pnpm install 一次。

填模型 Key

复制一份环境变量模板：

cp .env.example .env

打开 .env，把 MIDSCENE_MODEL_API_KEY= 后面填上阿里云百炼的 API Key。其他几项已经配好，默认用 qwen3.7-plus 北京区。

MIDSCENE_MODEL_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
MIDSCENE_MODEL_API_KEY=sk-xxxxxxxx        # 填这里
MIDSCENE_MODEL_NAME=qwen3.7-plus
MIDSCENE_MODEL_FAMILY=qwen3

Key 找负责人要，不要提交到仓库，.env 已在 .gitignore 里。

验证模型连通：

pnpm verify

看到模型名和一次成功的调用就说明通了。

其他配置项

变量	默认	说明
HEADLESS	true	改成 false 可以看到浏览器窗口，调试时好用
ANDROID_DEVICE_ID	空	adb devices 里的序列号，留空取第一台

Android 设备连接见 Android 设备接入。