/moai e2e

用于创建并运行网页、移动、桌面应用 E2E (End-to-End) 测试的命令。它会自动检测项目类型，为各平台选择 CLI 优先的工具链，在最小化 token 用量的前提下执行。

信息

一句话总结: /moai e2e 是"用户旅程验证工具"。它把登录 → 支付 → 确认这样的真实用户流程，在浏览器·模拟器·桌面应用中从头到尾执行并验证。

信息

斜杠命令: 在 Claude Code 中输入 /moai:e2e 即可直接执行此命令。只输入 /moai 会显示所有可用子命令的列表。

单元测试验证的是单个函数，而 E2E 测试验证的是用户的完整旅程。/moai e2e 将这一过程自动化 — 它自行判别项目是网页、移动还是桌面应用，选出平台的默认工具链，然后编写并运行测试脚本。

整体流程如下。

flowchart TD
    Start["执行 /moai e2e"] --> Detect["平台自动检测
(扫描项目标记文件)"]
    Detect --> Select["工具链选择
(推荐默认值 + 用户确认)"]
    Select --> Journey["用户旅程映射
(分析路由与文档)"]
    Journey --> Script["编写测试脚本"]
    Script --> Run["CLI 优先执行
(输出写入文件，上下文只留摘要)"]
    Run --> Record["记录 (可选)
--record 时使用原生追踪"]
    Record --> Report["结果报告
(逐旅程状态 + 产物路径)"]

> /moai e2e

不带参数执行时，会先检测项目类型，然后给出推荐工具链和发现的用户旅程供选择，再继续进行。

# 指定工具链直接执行
> /moai e2e --tool playwright

# 只运行特定旅程
> /moai e2e --journey login

# 记录执行过程 (追踪/录制)
> /moai e2e --record

每个平台都有固定的默认工具链，且所有默认路径都能只靠 CLI 完成。

若所选工具链未安装，会先给出安装命令，经批准后安装 → 重新确认版本 → 再继续。

通过读取项目的标记文件来分类平台。检测由标记驱动，不偏袒任何语言或框架。

读取项目文档和路由定义 (routes.ts、urls.py、router.go、导航图等)，发现待测的用户旅程候选。登录、核心功能、错误处理等关键路径优先。

旅程: 用户登录
步骤:
1. 前往 /login (网页) | 启动应用至登录界面 (移动/桌面)
2. 输入邮箱
3. 输入密码
4. 提交
5. 验证重定向到 /dashboard
6. 验证欢迎消息显示

按所选工具链的约定，在 e2e/ 目录下编写测试脚本。

每个旅程步骤都对应一个可验证的结果 — 不会编写没有断言 (assertion) 的纯导航脚本。

运行测试，并以表格报告逐旅程的 PASS/FAIL 状态、耗时和产物路径。失败的旅程会附带失败点的日志摘录和截图路径。

加上 --autofix 标志后，当 Phase 3 执行发现 失败或可改进之处 时，编排器会将修复委托给 manager-develop 代理并重新运行 Phase 3，进入循环。若未加该标志或 Phase 3 已通过，则跳过此步骤。

flowchart TD
    Run["Phase 3 执行"] --> Fail{"失败/改进点?"}
    Fail -->|"否"| Green["Phase 5 报告"]
    Fail -->|"是 (--autofix)"| Approve["一次性批准"]
    Approve --> Group["问题分组
独立=并行 / 依赖=顺序"]
    Group --> Fix["manager-develop
autofix: localize→repair→validate"]
    Fix --> Run

• 一次性批准：首次委托前编排器获取一次批准，该批准覆盖整个循环，后续迭代不再询问。拒绝则回到标准的手动下一步流程。
• 问题分组：触及不同文件的独立问题并行 fan-out；触及同一模块的依赖问题顺序处理（避免并发写冲突）。
• 循环上限：最多 3 次迭代（与 ci-autofix-protocol.md 一致）。通过即报告；耗尽则将剩余失败和产物路径上报给用户。

/moai e2e 的核心设计原则是 CLI 优先 (CLI-first)。它不会把冗长输出堆进 AI 上下文，而是从最便宜的路径用起。

1. CLI + 有界尾部输出: 完整运行日志保存到 e2e/.runs/ 下的文件，上下文中只显示退出码 + 末尾几行。日志文件路径始终被引用。
2. 结构化报告器: 分析失败时，不重跑整个套件，而是从 JSON 报告器输出中只挑出失败的用例来读。
3. MCP 仅限条件使用: 只有性能追踪、Lighthouse 级审计等 CLI 无法完成的能力才使用 MCP 工具。任何默认路径都不把 MCP 作为硬依赖。

报告、追踪、截图、录制都保存在项目本地的 e2e/ 目录中，并以路径引用 — 内容不会内联进上下文。

使用 --record 标志时，通过所选工具链的原生记录功能记录运行。

当未检测到可测的 E2E 表面时 (例如没有网页/移动/桌面入口的纯库项目)，会连同已核对的标记依据一起报告 “未检测到 E2E 目标”，不创建任何 e2e/ 产物并正常退出。

检测到既非 Electron 也非 Tauri 的原生桌面应用 (纯 macOS 应用、WinUI、Qt/GTK 等) 时也走同一分支 — 操作系统级的原生桌面自动化尚未提供；会连同分类依据一起给出延期 (deferral) 说明并正常退出。

/moai e2e 的执行主体是 e2e-tester 智能体。所有面向用户的选择问题由 MoAI 编排器负责，e2e-tester 只接收选择结果并执行。

flowchart TD
    User["用户请求"] --> Orchestrator["MoAI 编排器"]
    Orchestrator --> Detect["e2e-tester
平台检测 + 工具链探测"]
    Detect --> Ask["编排器
工具链·旅程选择问题"]
    Ask --> Exec["e2e-tester
编写脚本 + CLI 执行 + 记录"]
    Exec --> Report["编排器
结果报告"]

• /moai fix - 一次性自动修复
• /moai loop - 迭代修复循环
• /moai - 完全自主自动化