xiaozhi-client: Command for Claude Code

上下文

• 了解如何使用 playwright-cli: !playwright-cli --help
• 当前 git 分支: !git branch --show-current
• 构建产物状态: !ls -la dist/cli/index.js 2>/dev/null || echo "未构建"
• Web 服务端口占用情况: !lsof -i :9999 2>/dev/null | head -5 || echo "端口 9999 未被占用"
• 可用测试用例: !ls -d tests/e2e/*/ 2>/dev/null | sed 's|tests/e2e/||;s|/||' || echo "无测试用例"

输入参数

用户参数: $ARGUMENTS

模式判断

根据 $ARGUMENTS 判断执行模式：

模式一：路径模式（$ARGUMENTS 是一个目录路径）

当 $ARGUMENTS 指向一个存在的目录路径时（支持相对路径和绝对路径），进入路径模式：

1. 识别目标：

   • 检查该目录下是否存在 test.md 文件
   • 如果存在 → 这是单个测试用例，只执行这一个
   • 如果不存在 → 扫描子目录，找出所有包含 test.md 的子目录作为待执行用例列表

2. 执行每个测试用例：

   对每个测试用例，按以下流程执行：

   a. 准备产物目录：

   • 创建 artifacts/ 子目录：mkdir -p <测试用例绝对路径>/artifacts/trace
   • 创建 steps/ 子目录：mkdir -p <测试用例绝对路径>/steps
   • 清空 steps/ 目录中已有的旧截图：rm -f <测试用例绝对路径>/steps/*.png
   • 初始化截图计数器为 1

   b. 读取 test.md，理解测试步骤

   c. 检查该用例目录下是否有 expected.png

   d. 确保浏览器已打开且在正确页面（如未打开则 playwright-cli open）

   e. 启动录制：

   • 开始视频录制：playwright-cli video-start <测试用例绝对路径>/artifacts/recording.webm
   • 开始 Trace 录制：playwright-cli tracing-start

   f. 按照 test.md 中的步骤逐步执行操作：

   • 遇到"截图"指令时：
     • 先添加视频章节标记：playwright-cli video-chapter "步骤<N>: <描述>" --description="<步骤原文>" --duration=1500
       • 描述从截图指令的括号中提取，如 截图（对话框打开状态） → 描述为 "对话框打开状态"；无括号则使用 "步骤N"
     • 截图保存到 steps/：playwright-cli screenshot --filename=<测试用例绝对路径>/steps/<两位数编号>.png
     • 如果存在 expected.png，使用视觉能力对比 expected.png 和实际截图，描述差异
     • 一致 → PASS，有明显差异 → FAIL 并说明差异
     • 截图计数器递增
   • 其他操作（导航、点击、填写等）直接执行，trace 自动记录所有操作

   g. 捕获日志（所有步骤执行完毕后）：

   • 捕获完整控制台日志：playwright-cli --raw console > <测试用例绝对路径>/artifacts/console.log 2>&1
   • 捕获控制台警告：playwright-cli --raw console warning > <测试用例绝对路径>/artifacts/console-warnings.log 2>&1
   • 捕获网络活动：playwright-cli --raw network > <测试用例绝对路径>/artifacts/network.log 2>&1

   h. 停止录制：

   • 停止 Trace：playwright-cli tracing-stop
     • 将 trace 文件从 .playwright-cli/traces/ 移动到用例的 artifacts/trace/ 目录：

       LATEST_TRACE=$(ls -t .playwright-cli/traces/*.trace 2>/dev/null | head -1)
       if [ -n "$LATEST_TRACE" ]; then
         TRACE_BASE=$(basename "$LATEST_TRACE" .trace)
         mv "$LATEST_TRACE" <测试用例绝对路径>/artifacts/trace/test.trace
         mv ".playwright-cli/traces/${TRACE_BASE}.network" <测试用例绝对路径>/artifacts/trace/test.network 2>/dev/null
         [ -d ".playwright-cli/traces/resources" ] && mv .playwright-cli/traces/resources <测试用例绝对路径>/artifacts/trace/resources 2>/dev/null
       fi
       

   • 停止视频录制：playwright-cli video-stop