在 GitHub Actions 中运行
Midscene 提供了 midscene-action，用于在 GitHub Actions 中运行 Midscene Test。
- 自动将测试结果汇总到工作流的 Summary。
- 将 HTML 报告和测试数据保存为 Artifacts，供下载查看。
- 按需将报告发布到 Cloudflare Workers，通过链接在线预览。
尚未创建测试项目时，请先阅读创建和使用测试项目。
示例
接入工作流
运行 Action 前，先安装测试依赖、准备浏览器或设备，并配置模型。然后在工作流中添加：
working-directory：测试项目相对于仓库根目录的路径。项目位于仓库根目录时填.。command：在测试项目目录中执行的命令，默认是npx midscene-test。可以替换为项目已有的测试命令，如pnpm test。
完整工作流示例
下面以 tests/midscene 下的测试项目为例。接入前，请确认测试项目可以在本地正常执行。
1. 配置模型
在 GitHub 仓库的 Settings → Secrets and variables → Actions 中添加：
使用与本地相同的模型配置，具体值见支持的模型与配置。
2. 添加工作流文件
创建 .github/workflows/midscene.yml：
根据项目实际情况调整 working-directory 和 command。完整参数说明见 midscene-action 文档。
3. 发布报告到 Cloudflare Workers（可选）
设置 publish-pages: true，将报告发布到 Cloudflare Workers。每次运行都会生成独立的预览链接，并显示在工作流的 Summary 中。
创建 API Token
根据 Worker 的配置方式选择 Token 权限：
| Worker 配置 | 准备工作 | API Token 权限 |
|---|---|---|
| ⭐ 使用已有 Worker（推荐） |
 | 选择 Specified Workers，选中目标 Worker，勾选 Individual Workers → Editor。 |
| 由 Action 创建 Worker | 将 cloudflare-worker-name 设为所需的 Worker 名称。 | 选择 Entire Account，勾选 Workers → Admin，可管理该账号下的所有 Worker。 |
保存确认弹窗中的 API Token 和 Account ID。Token 仅显示一次。
启用发布
在 Settings → Secrets and variables → Actions 中添加：
- 仓库 Secret：
CLOUDFLARE_API_TOKEN。 - 仓库变量：
CLOUDFLARE_ACCOUNT_ID。
将前面运行测试的 Action 步骤改为：
如需使用已有 Worker，将 cloudflare-worker-name 设为其名称。默认值为 midscene-reports。
4. 查看测试报告
测试运行结束后，可以在工作流的 Summary 中查看测试结果和报告入口。
读取 Action 输出
为 Action 步骤设置 id: midscene 后，可以通过 ${{ steps.midscene.outputs.<name> }} 读取输出：