Agent Skill 核验档案

浏览器自动化 · Browser Automation · Hive

hive.browser-automation 是 Hive 框架的默认 Skill（版本 2.2），在任何 hive-browser CLI 命令前必须加载。它指导通过终端以 hive-browser <command> ... --json（经 terminal_exec）驱动用户正在运行的真实 Chrome（通过 GCU Beeline 扩展与 CDP），涵盖浏览器生命周期规则（桥接附加到用户已运行的 Chrome，绝不杀掉或启动浏览器进程）、截图+视口分数坐标工作流、富文本编辑器点击先于输入的规则以及 CSP 注意事项。

适用任务

在 shadow DOM 重度站点（如 Reddit）上用截图估计视口分数坐标，点击搜索输入框并通过 focused_element 验证聚焦后再输入文本
多 Chrome 账户环境下通过 hive-browser status --json 查看 connected_profiles，使用 --browser-profile 指定正确的 profile 并核对命令回显的实际 profile
导航到 SPA 页面后等待水合完成（sleep 2-3 秒），再用 wait --wait-for-selector 或 page snapshot 检查目标元素
在富文本编辑器（Draft.js、Lexical、contenteditable）中先点击编辑区再输入，并通过 evaluate 检查发送按钮 aria-disabled 是否翻转为 false
用 hive-browser page shadow-query 的 >>> 穿透语法获取元素 rect 分数坐标，直接用于后续 --coordinate 交互

输入

用户正在运行的 Chrome（含已登录会话），经 Beeline 扩展与 CDP 连接
--browser-profile 指定的已连接 profile 标签（多账户时）
目标 URL、选择器（含 >>> 穿透语法）、视口分数坐标（0..1）与要输入的文本

输出

所有命令的机器可读 JSON 结果（始终要求 --json），并回显实际使用的 profile
截图 JPEG 及 meta 中的 cssWidth/cssHeight，saved_to 路径
focused_element 描述：tag、id、role、contenteditable、分数 rect、inFrame 面包屑
page shadow-query 返回的视口分数 rect（rect.cx / rect.cy）
状态变更动作后自动附加的 accessibility snapshot（可用 --auto-snapshot-mode 调节）

限制与检查

不得通过 MCP 工具驱动浏览器，只能终端执行 hive-browser CLI
禁止自行启动 Chrome（任何 --remote-debugging-port、--user-data-dir、headless 标志）——被封锁
禁止 kill/pkill/killall Chrome、桥接或 gcu 进程，以及 Hive 桌面应用和 bridge_host
type 动作的 --selector 和 --wait-for-selector 不支持 >>> 穿透语法，仅 page shadow-query 支持
对使用 zoom 或 transform: scale() 的容器，避免用 evaluate + getBoundingClientRect 查坐标（返回 CSS 像素会出错）
快照可能过期、缺失或与可见布局不匹配（LinkedIn、X、虚拟滚动 SPA），需切换到截图定位
省略 --browser-profile 时会回退到第一个连接的 profile，多账户场景可能操作错误账户
每次执行 hive-browser 命令时是否都带了 --json，并检查结果 JSON 回显的 profile 是否与预期的 --browser-profile 一致

浏览器自动化 · Browser Automation · Hive

适用任务

输入

输出

限制与检查

AI 搜索

项目详情