Midscene.js 配置指南4 步跑通 AI 驱动的 E2E 自动化【免费下载链接】midsceneGUI Agent for E2E Testing项目地址: https://gitcode.com/GitHub_Trending/mid/midsceneMidscene.js 是 AI 驱动的 GUI 自动化测试框架用自然语言描述步骤按截图定位元素覆盖 Web、Android、iOS 与桌面端。本文只解决一件事——从装好 CLI 到跑通第一条脚本、配好生产参数。 前置检查装之前先过这 5 关检查项通过标准验证命令Node.js20.19 / 22.12 / 24node -vnpm 可达能访问 npm 仓库npm ping多模态模型有 API Key 与服务地址—adb做 Androidadb --version有输出adb --version设备授权做 Android列表显示设备adb devices -lNode 版本不达标时Rspack 工具链会直接抛Unsupported Node.js version。先把 Node 升上去再装 CLI。 最短运行链路4 步出第一份报告1. 装 CLInpm i -g midscene/cli全局安装后midscene命令在任意目录可用。2. 配模型环境变量export MIDSCENE_MODEL_BASE_URLhttps://替换为你的模型服务地址/v1 export MIDSCENE_MODEL_API_KEY你的API Key export MIDSCENE_MODEL_NAME替换为你的模型名称 export MIDSCENE_MODEL_FAMILY替换为你的模型系列也可以在运行目录下建.env文件CLI 会通过 dotenv 自动加载。变量放在工具运行目录和 YAML 文件位置无关环境变量加载逻辑 里还藏着两个调试开关。3. 写第一个脚本bing-search.yamlpage: url: https://www.bing.com tasks: - name: 搜索天气 flow: - ai: 搜索 今日天气 - sleep: 3000 - aiAssert: 结果显示天气信息结构固定为「目标配置 tasks 数组」flow 里的每一步都是一句自然语言不用写选择器。4. 执行midscene ./bing-search.yaml跑完后输出目录里会生成 JSON 总结默认index.json、每个脚本的独立结果和一份可回放的 HTML 报告。需要从零研究代码时仓库可克隆到本地git clone https://gitcode.com/GitHub_Trending/mid/midscene。 核心能力拆解三个配置点自然语言指令与 YAML 脚本YAML 是 Midscene.js 的最小执行单元。aiaiAct简写执行交互、aiQuery提取结构化数据、aiAssert校验界面状态三类能力各占一行。动态值可用${variable-name}引用环境变量批量执行用通配符midscene ./scripts/**/*.yaml。字段完整定义见 YAML 脚本文档。桥接模式复用真实浏览器会话测登录态、内部后台时脚本应直接驱动现有桌面浏览器。在page下加一行bridgeMode即可复用 Cookies、插件与登录态该模式与 CDP 互斥不可同开。缓存策略降低重复调用开销同一 prompt 重复执行时Midscene.js 优先复用已缓存的规划与 XPath。规划缓存失效会自动回退到 AI 重新规划查询类步骤永不缓存。配置方式agent: cache: id: search-cache strategy: read-write缓存文件落在./midscene_run/cache下规则细节见 缓存文档。⚖️ 开发期 vs 生产期两组参数别混用配置项开发期生产期并发--concurrent1盯单条执行4按机器资源上调重试--retry0失败立即暴露2吸收偶发抖动浏览器形态--headed或--keep-window默认无头缓存策略read-write边跑边沉淀read-only只读防污染日志详略--dotenv-debug排查变量关闭减少噪音报告本地 HTML 回放--summary index.json收集状态参数也可写入 YAML 配置文件后用--config引用命令行参数优先级更高。完整参数列表见 YAML 脚本运行器文档。 高频故障速查5 个坑的解法症状可能原因修复动作启动报Unsupported Node.js versionNode 低于 20.19/22.12/24升级 Node 后重装 CLI设备unauthorized或列表为空USB 调试未授权、未开「USB 调试安全设置」手机确认授权开发者选项里两项都打开模型调用 401/404Base URL、Key、模型名任一不匹配核对 4 个MIDSCENE_MODEL_*变量加--dotenv-debug看实际生效值输入后文本被清空默认 ESC 收起键盘部分输入框监听 ESC设备配置keyboardDismissStrategy: back-first动态内容下aiAssert偶发失败断言跑在渲染完成前前插aiWaitFor步骤并给足timeoutADB 路径异常、远程 ADB 服务器等专项配置见 Android 平台文档。✅ 落地清单验证node -v落在 20.19/22.12/24 区间用--headed跑通第一条 YAML 脚本并回放 HTML 报告确认输出目录同时存在 JSON 总结与逐脚本结果文件为回归脚本配置read-only缓存并固定 cache id生产批次加上--retry 2 --summary index.json现在打开终端执行npm i -g midscene/cli按「最短运行链路」四步走一遍今晚之前把第一份报告跑出来。【免费下载链接】midsceneGUI Agent for E2E Testing项目地址: https://gitcode.com/GitHub_Trending/mid/midscene创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考