SuperAPI AI 工具集

browser-automation

测试与质量

查看项目

更新于 10-15 21:10

技能介绍

用途:在本地开发期间,把 OpenCode 浏览器工具接入 OpenWork Electron 应用,通过 Electron 的 Chrome DevTools Protocol(CDP)端点驱动应用 UI,从 composer 发送任务/会话并在界面确认响应。该技能仅用于探索和调试;如需判定结果,应编写或运行 evals/specs 测试(write-a-spec、run-tests),不要手工驱动 CDP。

主要能力:列出浏览器目标、读取页面状态、填写 Lexical composer、点击 Run task 按钮、确认会话响应。

本地开发设置:pnpm dev 默认启用 Electron CDP,端口由 OPENWORK_ELECTRON_REMOTE_DEBUG_PORT 控制,默认 9823;OpenCode 浏览器工具的默认浏览器 URL 为 http://127.0.0.1:9823,应用 UI 通常加载于 http://localhost:5173/。更换端口:OPENWORK_ELECTRON_REMOTE_DEBUG_PORT=9830 pnpm dev;禁用 CDP:OPENWORK_ELECTRON_REMOTE_DEBUG_PORT=0 pnpm dev。后台启动:nohup pnpm dev > /tmp/openwork-dev.log 2>&1 &,随后用 lsof -nP -iTCP:9823 -sTCP:LISTEN 等待端口就绪。

浏览器工具流程:用 browser_list 并指定 browser_url: "http://127.0.0.1:9823" 列出目标,选择 OpenWork 目标 ID,用 browser_eval 或 browser_snapshot 读取状态,定位 [contenteditable="true"][data-lexical-editor="true"] 填写 composer,点击 Run task,再通过 document.body.innerText 或当前 URL 确认会话响应。

限制与注意:Electron CDP 仅用于开发测试工具;用户浏览器任务应使用 OpenWork 内置 Browser 目标。成功本地附加应能在 http://127.0.0.1:9823 看到 OpenWork 目标。已知可用的冒烟提示为 Say hello from the Electron browser test.,预期响应为 Hello from the Electron browser test。