目标

• 了解Midscenejs的环境搭建过程

• 了解Midscenejs的模型配置

• 了解Midscene的yaml使用

1、简介​

官网地址：https://midscenejs.com/zh/​

2、安装Nodejs

NodeJS 要求最低版本是 v18，最好是 v20

2.1安装

C:\Users\Duan\AppData\Roaming\nvm 这个是隐藏路径，不建议使用，更换路径不要有中文，不要有空格。​

如果电脑上没有安装 nodejs，就不会有下图中的提示。

安装完成后，环境变量会自动加上

​1.2.2. 环境变量

在 CMD 验证安装情况，nvm -v​

1.2.3. 设置 nvm 国内镜像

只支持 Windows 系统

1. nvm node_mirror https://npmmirror.com/mirrors/node/​

2. nvm npm_mirror https://npmmirror.com/mirrors/npm/

AI构建项目

1.2.4. 离线安装 nodejs

当有时候无法线上下载时，如下图，就可以采用离线安装折方式

去官网下载指定的版本，https://nodejs.org/zh-cn/download

1.2.5. nvm 常用命令

以下所有命令要使用管理员权限打开 cmd

• nvm list available：列出所有远程服务器的版本，下面截图是 windows 上的运行结果

• nvm install v18：下载 v18中的最新版本，也可以指定详细版本号，nvm install 20.18.1​

• nvm list：查看下载的版本

• nvm use v18：如果有多个版本，可以通过use命令来指定使用的版本。使用 use 命令时 cmd 必须是通过管理员权限打开的，否则报错如下

参考链接：https://blog.csdn.net/weixin_45682449/article/details/120948835

• nvm uninstall 版本号：删除指定的版本

1.2.6. 全局下载配置

这里推荐在 nvm 安装目录下，创建两个目录node_cache和node_global。

配置命令，下面命令中红色部分不要照抄，换成自己你的路径

• npm config set prefix "C:\Users\Duan\AppData\Roaming\nvm\node_global"​
• npm config set cache "C:\Users\Duan\AppData\Roaming\nvm\node_cache"​

配置好后，就算切换了 nodejs 版本，也不会影响

验证配置是否成功，npm i -g nodemon。全局一下载nodemon来演示

配置环境变量，添加%NVM_HOME%\node_global​

然后确定保存后，重启 cmd。输入nodemon -v​

1.2.7. 国内下载源配置

nodejs 默认是从国外地址下载内容，速度很慢，所以需要配置国内下载源

• npm config set registry https://mirrors.cloud.tencent.com/npm/ ​
• npm config list：查看设置内容

3、Midscene 安装

执行下面的命令，二选一即可，一般用第一个，下载比较慢，最好有vpn，如果失败了就多次重试

1. # 全局安装，可以直接在cmd中使用​

2. npm i -g @midscene/cli​

3. # 项目中安装，只能在项目目录下使用​

4. npm i @midscene/cli --save-dev

执行成功日志如下

3.1 卸载

npm uninstall -g @midscene/cli

4、模型配置

官网教程：https://midscenejs.com/zh/choose-a-model

1. 1 # openrouter.ai​

2. 2 OPENAI_BASE_URL="https://openrouter.ai/api/v1"​

3. 3 OPENAI_API_KEY="......"​

4. 4 MIDSCENE_MODEL_NAME="qwen/qwen2.5-vl-72b-instruct"​

5. 5 MIDSCENE_USE_QWEN_VL=1​

6. 6 ​

7. 7 # 或使用阿里云的 OpenAI 兼容接入点​

8. 8 OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"​

9. 9 OPENAI_API_KEY="......"​

10. 10 MIDSCENE_MODEL_NAME="qwen-vl-max-latest"​

11. 11 MIDSCENE_USE_QWEN_VL=1

5、运行示例

在一个目录中，创建如下两个文件

5.1 .env

模型配置文件

1. 1 # 或使用阿里云的 OpenAI 兼容接入点​

2. 2 OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"​

3. 3 OPENAI_API_KEY="你的key"​

4. 4 MIDSCENE_MODEL_NAME="qwen-vl-max-latest"​

5. 5 MIDSCENE_USE_QWEN_VL=1

5.2 OPENAI_API_KEY 申请

申请地址：https://bailian.console.aliyun.com/?spm=5176.29597918.J_SEsSjsNv72yRuRFS2VknO.2.71d87b0835ITPT&tab=model#/api-key

将复制的 Key 粘贴到.env文件中

5.3 创建示例 yaml

1. 1 web:​

2. 2 url: https://www.bing.com​

3. 3 ​

4. 4 tasks:​

5. 5 - name: 搜索天气​

6. 6 flow:​

7. 7 - ai: 搜索 "今日天气"​

8. 8 - sleep: 3000​

9. 9 - aiAssert: 结果显示天气信息

5.4 运行脚本

midscene ./bing-search.yaml

注意图片中命令执行时所在的目录。

5.5 查看报告

6、常见问题

6.1 使用的大模型与申请的 key 不匹配

6.2 不明原因问题

6.3 yaml 中只能使用空格缩进

最后作为一位过来人也是希望大家少走一些弯路，在这里我给大家分享一些软件测试的学习资料，这些资料希望能给你前进的路上带来帮助。

​视频文档获取方式：
这份文档和视频资料，对于想从事【软件测试】的朋友来说应该是最全面最完整的备战仓库，这个仓库也陪伴我走过了最艰难的路程，希望也能帮助到你！以上均可以分享，点下方小卡片即可自行领取。