chrome-browser-validation git:20261028.107afe6A

Immutable. This exact content never changes and is served at /api/v1/blob/fe48e3669a9cffa9.

---
name: chrome-browser-validation
description: 使用官方 @Chrome 插件连接用户现有 Chrome，进行网页调试、交互测试和视觉验收。跨项目适用于开发完成后的浏览器验证及现有网页问题复现；代码静态检查和单元测试不受此浏览器选择约束。
---

# Chrome 浏览器验收

这是用户的全局浏览器验收偏好。默认自动应用；仅当用户明确要求其他方式时，按其当前要求覆盖。

## 连接现有 Chrome

- 使用官方 [@Chrome 插件](plugin://browser@openai-bundled?browserFamily=chrome)，复用用户现有 Chrome 会话、登录状态及目标服务。
- 通过当前提供的浏览器运行时发现 Chrome 扩展连接，阅读它返回的操作文档。若工具为 `cua_repl`，按其首次调用规则初始化，再获取浏览器与标签页清单。确认连接类型为 Chrome 扩展，而非内置浏览器或自行启动的会话。
- 按目标 URL、标题和用户指定标签页选择页面；优先复用已有相关标签页。需要新页面时，通过同一 Chrome 扩展连接创建，并遵循运行时的会话命名要求。不改动无关标签页。
- 不启动独立 Playwright、无头 Chrome、独立调试端口、Docker 浏览器夹具，不用 AppleScript、原生桌面控制或其他浏览器替代验收。插件运行时提供的 Playwright 风格定位器可以使用；它不等于自行启动 Playwright 浏览器。
- 插件未连接、目标 Chrome 配置不可用或连接被拒绝时，报告具体障碍，请用户完成连接后继续；不要静默降级到其他验收环境。可继续不依赖浏览器的代码检查。
- 不读取、导出或搬用 Cookie、登录 Token 或浏览器用户数据目录。需要登录时由用户手动操作。

## 在真实页面验收

1. 根据本次改动确定关键显示、交互和异常场景，打开或刷新实际目标页面；本地网页优先复用现有 HTTP 开发服务。
2. 依据最新页面状态操作真实控件；每组操作后重新读取状态。只能使用当前运行时文档中支持的接口，不猜测工具能力。
3. 通过页面状态和截图验证结果，不能仅凭点击成功、数据存在、编译通过或测试通过宣称视觉验收完成。地图、Canvas、WebGL 等内容必须检查实际画面。
4. 使用插件支持的页面、控制台或网络诊断检查相关错误；若这些能力不可用，说明未检查项，不另开独立浏览器绕过。
5. 提供关键结果截图和简短结论，明确区分已验证、失败及未验证项目。浏览器连接受阻时，不复用旧截图充当本次验收证据。

本技能不额外授权提交、付款、发送消息或其他具有外部影响的操作；按用户本次任务授权范围执行。