Expect

让 AI 代理在真实浏览器中测试你的代码。

一条命令即可扫描未暂存的更改或分支差异，生成测试计划，并在真实浏览器中运行。

查看演示 →

安装

npx -y expect-cli@latest init

使用方式

Usage: expect-cli [options] [command]

Options:
  -m, --message <instruction>   用自然语言描述要测试的内容
  -f, --flow <slug>             通过 slug 重用已保存的测试流程
  -y, --yes                     跳过计划审核，立即运行
  -a, --agent <provider>        指定使用的 AI 代理提供商（claude 或 codex）
  -t, --target <target>         测试目标：unstaged（未暂存）、branch（分支）或 changes（更改）(默认: changes)
  --verbose                     启用详细日志
  -v, --version                 打印版本号
  -h, --help                    显示帮助信息

Commands:
  init                          全局安装 expect 并配置技能

Examples:
  $ expect-cli                                          打开交互式终端用户界面（TUI）
  $ expect-cli -m "test the login flow" -y              立即生成计划并运行
  $ expect-cli --target branch                          测试所有分支更改
  $ expect-cli --target unstaged                        测试未暂存的更改

设置 `NO_TELEMETRY=1` 可禁用分析事件收集。

工作原理

 ┌─────────────┐     ┌──────────────┐     ┌──────────────┐     ┌─────────┐
 │ Scan changes│────▶│ Generate plan│────▶│ Run in browser│────▶│ Report  │
 │ (git diff)  │     │ (AI agent)   │     │ (Playwright)  │     │ (pass/fail)│
 └─────────────┘     └──────────────┘     └──────────────┘     └─────────┘

Expect 会读取你的未暂存更改或分支差异，将其发送给 AI 代理（Claude Code 或 Codex CLI），生成逐步测试计划来验证更改。你可以在交互式 TUI 中审核并批准该计划，然后代理会在真实浏览器中执行每个步骤 - 使用你的真实登录会话，无需手动设置认证。每个会话都会被录制，你可以回放整个过程。

使用 -y 参数可跳过计划审核，在 CI 中无头模式运行。成功时退出码为 0，失败时为 1。

资源与贡献

想试用？查看 我们的演示。

发现 Bug？前往我们的 问题跟踪器 我们会尽力帮助。我们也欢迎提交 Pull Request！

我们要求所有贡献者遵守 行为准则 的条款。

→ 在 GitHub 开始贡献

许可证

FSL-1.1-MIT © Million Software, Inc.

Expect 快速上手指南

环境准备

• 系统要求：Node.js 16+
• 前置依赖：npm 或 cnpm（推荐使用 npm config set registry https://registry.npmmirror.com 切换为国内镜像源加速安装）

安装步骤

1. 执行初始化命令自动安装：

npx -y expect-cli@latest init

基本使用

最简测试流程

1. 交互式模式（自动检测变更并生成测试计划）：

expect-cli

2. 直接运行测试（跳过确认环节）：

expect-cli -m "测试登录流程" -y

3. 分支变更测试（测试当前分支所有变更）：

expect-cli --target branch

4. 未提交变更测试（测试工作区未提交的修改）：

expect-cli --target unstaged

⚠️ 注意：首次使用需在交互式 TUI 中确认测试计划，CI 环境可通过 -y 参数跳过确认环节。所有测试会自动录制浏览器操作视频供回放分析。