使用可访问性引用定位
交互快照为控件返回 @e1 一类引用。按角色与名称选择后使用返回值，不需要从截图凭空猜测 CSS 选择器。
agent-browser
agent-browser 通过终端向编码 Agent 提供 Chrome 或 Chromium 操作。精简快照为控件附带引用，让 Agent 找到按钮、操作当前页面，并在连续命令间检查状态变化。
检查一条界面路径
筛选数量检查能验证页面变化后快照与元素引用是否仍然可用，为后续多步任务建立具体基线。
带入 Floatboat 的请求
请求可预览和复制，不会从此处自动发送。
参考来源: agent-browser https://github.com/vercel-labs/agent-browser 先阅读原始说明并核对当前环境与依赖。需要安装或连接新工具时，先提出方案。 我的任务: 在我的本地测试 URL 使用 agent-browser，读取当前核心指引并获取快照，操作指定筛选器，将可见结果与预期数量对照，页面变化后重新取快照。 期望交付: 动作序列、快照、实际状态及可复现差异。证据不足时列出失败步骤与未解决问题。
关于 agent-browser
agent-browser 是 Vercel Labs 面向编码 Agent 的 CLI。由宿主选择动作，CLI 通过 CDP 执行浏览器操作。常见循环是打开页面、读取带 @eN 短引用的可访问性快照、操作当前引用，再观察变化；它本身不提供另一个独立规划任务的模型。
官方 agent-browser Skill 是发现入口，会要求宿主先执行 agent-browser skills get core，从已安装 CLI 读取详细指引，避免复制的文件描述了另一版本。专项指南还覆盖探索式 QA、Electron 应用等环境，普通网页任务不必加载全部专项内容。
项目另有 MCP、本地及托管浏览器接入。任务依赖账号状态时，应明确选择提供方与会话。Floatboat 在准备 CLI 和浏览器后，可采用 Cursor、Codex 对应的终端路径。Apache-2.0 管理 CLI 源码，托管提供方、模型处理和服务额度另行判断。
定位控件、延续状态与更新引用
快照描述当前文档，会话则在多次命令间延续浏览器状态。两者有效期不同：会话可以继续，但导航或页面更新后的元素引用需要重新取得，不能将短引用当成长期选择器。
由已安装 CLI 提供指引
核心指南及引用资料与本地版本匹配。按任务加载所需专项内容，例如探索式 QA 使用 dogfood，桌面应用使用 electron。
跨命令保留浏览器状态
页面可在观察与操作之间保持打开。账号状态由当前配置或提供方决定；会话仍在运行，不表示重绘前的元素引用依然有效。
在仓库工作旁使用 agent-browser
编码宿主需要分步操作网页并返回明确结果时，可使用该 CLI。新界面检查、账号报表、过期引用诊断与探索式 QA 需要不同交付物；扩大调查前先选择对应指引。
检查新建界面
提供开发地址、控件名称和动作后的预期状态，例如详情面板展开。使用快照引用操作后读取变化页面；判断涉及布局时补截图，存在可访问名称本身不能证明对齐或响应式表现正确。
读取已登录仪表盘
选择获准账号会话，指定日期范围和三个报表字段。按当前指引读取，并返回来源页、选定周期与缺失区域。会话过期时报告登录状态，不能把空页面当成数值为零的报表。
诊断过期引用
筛选刷新或导航后点击失败时，重新获取交互快照并定位控件。重试前比较新角色、名称与状态。交付失败发生的状态转换和修正顺序，而不是一串不断操作旧引用的重试命令。
整理探索式 QA 交接
针对测试应用的账号设置等限定区域，加载本地 dogfood 指南。调查不同路径，保留复现步骤、预期与实际行为，必要时补视觉证据。将可复现缺陷与未确认疑点分开，便于开发者判断修复优先级。
准备 CLI 与测试目标
命令和浏览器配置以已安装版本指引为准。以下流程假定宿主可执行命令，并已有无敏感测试页；复用登录态或云提供方属于另外的会话选择，需要单独配置。
CLI 与浏览器运行环境
官方 Skill 记录 npm i -g agent-browser，随后执行 agent-browser install。按平台准备系统依赖，或选择文档支持的提供方，不假定单个二进制包含全部浏览器环境。
版本匹配的核心指南
浏览器命令前先运行 agent-browser skills get core，按引用查看当前等待、会话、认证与输出选项；需要更多指南时用 skills list 查找。
可核对的界面预期
提供网址、目标准确名称、动作后状态，以及获准账号或测试数据。视觉判断还应约定视口并提供截图证据。
打开、快照、操作与重新观察
第一次只检查一个控件及一项预期结果。示例引用仅表示快照句柄格式，实际操作应使用当前页面返回值；已安装核心指南的语法不同时，以该版本为准。
加载指南并打开网址
读取 agent-browser skills get core，再用 agent-browser open <test-url> 打开指定地址。确认页面及账号属于任务目标；登录页或部署错误属于准备阶段发现，不能当成待测界面。
找到交互元素
运行 agent-browser snapshot -i，按可访问角色和名称找到指定按钮或字段，取得当前 @eN 引用。未出现时先判断加载或界面状态，不直接改选另一个控件。
执行一个动作并更新观察
按钮可用 agent-browser click 加当前引用执行，@e1 仅为示例。变化后重新读取快照，对照面板、文字或记录是否符合预期。页面没变化时先看动作错误与当前结构，再决定是否重试。
交付可复现结果
报告初始网址、控件、动作、预期与实际状态；视觉判断附截图。确实受阻或失败时如实交付。无需保留审阅状态后，可在浏览器任务结束时运行 agent-browser close。
相关软件项目
比较这些项目的用途、运行条件和源码许可。
agent-browser 常见问题
为什么 Skill 要求再从 CLI 读取指南？
仓库 Skill 有意只保留发现入口。agent-browser skills get core 返回与已安装工具匹配的流程，减少复制指令描述过期命令的问题。
引用是稳定选择器吗？
不是。引用属于观察时的文档状态。导航或 DOM 明显变化后重新获取并定位控件；浏览器会话仍打开，不表示旧元素映射仍有效。
快照不能验证什么？
可访问性文字能说明名称和控件存在，不能证明像素对齐、颜色或响应式布局。此类判断需要指定视口的截图，并说明每项结论对应的证据。
什么时候加载 dogfood 或 electron？
探索式 QA 与缺陷报告可用 dogfood，Electron 应用使用 electron。这些是 CLI 提供的专项流程，不是所有普通网页任务都要加载的内容。
同一次检查要同时使用 MCP 与 CLI 吗？
应选择接口并明确会话身份。项目提供两者，但随意切换可能导致在一个浏览器观察、另一个浏览器操作。宿主能调用 CLI 时，终端流程本身即可承接检查。
此路径会为 Floatboat 增加另一个模型吗？
不会。由编码宿主推理并调用浏览器工具。安装运行环境后使用对应外部 Agent 配置，云提供方与模型数据处理仍有各自设置和费用。