Playrunner

借助 AI 构建。用证据交付。

Playrunner 将你的 Playwright 测试转化为可复用的工作流，
让你的团队、CI 和编码 Agent 都能运行。

从“代码写完了”到“这是通过的证据”。
运行真实的浏览器检查。跟踪执行过程。查看报告、追踪记录或视频。

试用 Playrunner Cloud →   ·   在本地运行   ·   连接你的 Agent   ·   阅读文档

一分钟了解 Playrunner

产品概览 · 61 秒	工作流与证据 · 51 秒
介绍可复用工作流、Agent 连接和分片的解说视频。	一个全新的本地工作流：两项检查通过，并展示报告和截图证据。

视频于 2026 年 10 月 19 日使用 OBS 录制，并由 AI 配音。概览视频展示 产品示例；工作流视频演示了一次真实的本地运行，包括已保存的配置、 通过的报告和截图证据。视频说明和文字稿 →

Agent 写好了。现在来检查。

看起来能用的界面是个不错的开始。可检查结果的可重复测试，才能让你的团队据此继续推进。

Playrunner 为 AI 辅助开发者和测试团队提供共享空间，用于运行 Playwright、复用环境和浏览器登录状态，以及排查故障。 保留现有测试。为它们配置工作流，让你在下次变更后可以再次运行。

面向氛围编程者及其钟爱的 Agent

将兼容的 MCP 客户端连接到 Playrunner Cloud，然后提出请求：

运行一次我的结账冒烟工作流。等待它完成，告诉我哪些测试通过或失败，并附上报告链接。

Agent 可以在同一段对话中发现项目、创建工作流、启动运行，并检查返回的证据。你保存的工作流会继续供团队成员和 CI 使用。

Codex · Claude · Cursor · Gemini CLI · Antigravity · Grok

连接步骤和功能因客户端而异。请使用支持远程 Streamable HTTP 和 OAuth 的客户端，或使用具备 Shell 操作能力的 Agent 提供的 CLI。 选择连接方式 → 阅读 MCP 指南 →

将测试套件变为可重复执行的检查

1. 添加测试。 使用现有的 Playwright 仓库，或从内联脚本开始。
2. 为它安排位置。 选择环境、可选的 Authentication Profile，以及工作流的运行位置。
3. 按你的方式运行。 使用可视化编辑器、你的 Agent、CLI 或定时计划。
4. 查看证据。 检查测试结果、日志、报告和运行生成的工件。作业已启动不代表测试已通过。

Your agent / CI / schedule
           ↓
      Environment → Playwright → Pass or fail → Your next action
                         ↓
              Report · traces · screenshots · video

你的测试、环境、运行器和后续步骤。一个清晰可见的工作流。

减少测试基础设施，获取更有用的反馈

四个分片。一份合并报告。失败的测试清晰可见。

让 CI 使用相同的工作流

启动已保存的工作流、持续获取进度，并在工作流失败、取消或超时时返回失败退出码：

export PLAYRUNNER_URL='https://playrunner.cloud'
export PLAYRUNNER_API_KEY='<your-api-token>'

npx playrunner WORKFLOW_ID

更喜欢将工作流作为代码管理？将定义与应用程序放在一起：

npx playrunner workflow create --file playrunner-workflow.json

CLI 运行指南 → · 工作流定义 →

npm install --global playrunner@latest
playrunner login
playrunner auth connect

快速入门

前置条件

• Docker Desktop
• Node.js 20+
• npm

启动完整本地堆栈

git clone https://github.com/playrunner/playrunner.git
cd playrunner
./install-local.sh
./start-local.sh

首次运行时，Playrunner 会打开设置应用。按照打印出的 URL 确认 PostgreSQL 并创建第一个管理员账户。使用默认端口时：

• Playrunner：http://127.0.0.1:3100
• 设置：http://127.0.0.1:3100/setup
• 文档：http://127.0.0.1:3104/playrunner/

除非你想在首次运行前更改端口，否则无需使用 .env.local 文件。如果该文件不存在，./start-local.sh 会根据示例文件创建它。完整操作指南请参阅入门指南。

./start-local.sh --setup

cd docs
npm run start -- --port 3104

探索

npm exec --prefix apps/frontend -- playwright install chromium

npm run test:e2e:mock

npm run test:e2e:mock -- --grep @github
npm run test:e2e -- --grep @github

npm run test:e2e:live
npm run test:e2e:live -- --grep @github

帮助完善 Playrunner

在一个对你很重要的工作流中试用它。告诉我们哪些地方好用、哪些地方失败了，以及怎样才能让它成为你日常工作中的实用工具。

加入 Discord · 报告问题 · 为项目点星

许可证

Playrunner 根据 Playrunner 可持续使用许可证以源代码可用的方式发布，版权 © 2026 Concept AI PTY LTD。