Browser Testing

⚠️ 铁律（每次测试前必须确认，不得跳过）

1. 截图必须用 Playwright MCP，绝不用内置浏览器截图

内置浏览器 browser screenshot 只返回 AI 分析文本，MEDIA: 无法渲染，用户看不到图片。

截图唯一正确方式：playwright__browser_take_screenshot → 存文件 → MEDIA:<路径>

2. 使用内置浏览器前，先检查 ssrfPolicy 白名单

目标域名和登录域名（Auth0 等）必须在 ~/.openclaw/openclaw.json 的 allowedHostnames 中，否则导航报 blocked by policy。

配置改完必须执行完整重启序列：browser stop → gateway restart → 等 15 秒 → browser start

3. 字体/环境问题，先检查 browser-setup 是否跑过，不要手动折腾

中文乱码、浏览器启动超时等环境问题，优先运行 bash testagent-browser-setup/scripts/setup.sh，不要手动装字体或逐步排查。

测试 SOP

阶段一：收集启动信息

收到测试指令后，只询问登录前无法自行获取的信息：

1. 目标 URL（若用户未提供）
2. 测试账号和密码（登录用）
3. 测试目标描述（如「测试创建团队功能」）

不要在看到产品之前提任何关于产品细节的问题（字段格式、必填项、二级账号等），这些登录后自己看。

阶段二：探索产品，制定测试计划（需用户确认）

1. 按 [REFERENCE.md 工具选择](REFERENCE.md#工具选择) 选定主用工具
2. 若使用内置浏览器，导航前先确认 ~/.openclaw/openclaw.json 的 browser.ssrfPolicy.allowedHostnames 已包含目标域名和登录域名；若未包含，先添加并执行完整重启序列（见 [REFERENCE.md 踩坑](REFERENCE.md#踩坑)），再导航
3. 导航到目标 URL，自动登录
4. Viewport 检查（必做，自主判断）：用 Playwright MCP 截图，自行判断页面是否适合测试：

- 若内容拥挤、元素重叠、按钮被遮挡、侧边栏挤压主内容区 → 执行 playwright__browser_resize → width=1440, height=900，再截图确认

- 若页面显示正常 → 直接继续

- 不需要询问用户，自主决定是否调整

1. 浏览目标功能区域，了解实际页面结构和交互
2. 基于真实页面，输出 3-5 个测试点，等用户确认或修改后再开始执行

（登录并查看产品后）我计划测试以下场景，确认后开始：
1. 创建团队 — 填写名称和必要字段，验证创建成功
2. 表单校验 — 必填项为空时是否有提示
3. 团队内发送消息 — 消息是否正常显示
4. 边界输入 — 团队名称超长时的处理

只有在探索后发现确实需要额外信息时（如：测试场景需要第二个账号、需要特定测试数据），才在此阶段向用户追问。

阶段三：执行测试（全程自主，不打断用户）

• 逐一执行每个测试点
• 发现 bug 立刻截图，不要攒到最后（页面状态随时可能变化）
• 截图命名：/root/.openclaw/workspace/bug_<序号>_<简短描述>.png
• 同一操作失败 2-3 次后，立即切换工具或策略（见 [REFERENCE.md 踩坑](REFERENCE.md#踩坑)）

阶段四：输出测试报告

所有测试点完成后，聊天内输出完整报告（格式见 [REFERENCE.md 报告格式](REFERENCE.md#报告格式)）。

阶段五：确认录入 Coding（需用户确认）

报告输出后询问：

以上 N 个 Bug 是否录入 Coding？
可修改建议的优先级、assignee、工期后回复「录入」，或指定修改某条。

用户确认后，调用 coding-net skill 的 create_issue 批量录入：

• issue_type="DEFECT"
• priority：按优先级规则（见 [REFERENCE.md](REFERENCE.md#优先级规则)）
• due_date：今日日期 + 建议修复工期（天）
• assignee_id：按 AGENTS.md 分工规则查成员 ID（用 get_team_members_id_and_name 或 extract_members_from_issue_list）

录入完成后输出每条 bug 的 Coding issue 编号。

详细工具对比、截图流程、报告模板见 [REFERENCE.md](REFERENCE.md)