新闻详情

新闻详情

首页 / 资讯中心 / 详情

爪爪 PawWork live-page action 完全实操手册:3 个核心 op 驱动真实网页

发布时间:2026/9/29 8:03:57来源:尧图网络
爪爪 PawWork live-page action 完全实操手册:3 个核心 op 驱动真实网页
爪爪 PawWork live-page action 完全实操手册3 个核心 op 驱动真实网页【免费下载链接】BrowserKittenPaw Work - selection-first web agent for Chrome: select on the live page, describe the outcome, take away an editable office file. BYOK, sandboxed, no server.项目地址: https://gitcode.com/gh_mirrors/pa/BrowserKitten爪爪 PawWork 是一款开源 Chrome 扩展用 live-page action 工具直接驱动真实网页先snapshot给页面控件拍快照再用fill_form批量填表、click精准点按让 AI 代理在你已登录的浏览器上替你操作BYOK、沙箱化、无服务器。一、live-page action 是什么先拍快照再动控件 普通网页自动化脚本靠 CSS 选择器硬编码页面一改就崩。爪爪 PawWork 的action工具换了一条路基于快照的引用ref机制。ref控件引用形如f0.a12——f0是 frame 编号a12是该 frame 内的控件序号对模型是不透明 ID不需要你写选择器。rev快照世代形如t7标记这份快照的代。页面每次变动后引用就会过期。回路固定snapshot拿快照 → 用同一代ref rev执行fill_form/click等变更 → 每次变更的返回里都会带一份新快照新rev 新controls继续下一轮操作。快照采集时每个 frame 最多收80 个可交互控件可见优先、隐藏排后覆盖input、select、textarea、button、a[href]、contenteditable等密码框的值会被打码为***避免泄露到模型上下文。实现见 content_script.js。二、三步加载爪爪从 clone 到第一次 action 拿到源码无package.json、无构建步骤git clone https://gitcode.com/gh_mirrors/pa/BrowserKitten加载扩展打开chrome://extensions→ 开启右上角开发者模式→加载已解压的扩展程序→ 选择仓库根目录manifest.json 就在根上要求 Chrome 135。填入 API Key打开侧栏粘贴一个 OpenAI 兼容接口的 KeyBYOK只存在本地chrome.storage.local然后在任意http(s)页面上直接发任务。两个顺手的小快捷键定义在 manifest.json快捷键作用AltShiftS开启/关闭伸爪页面点选把选区作为上下文交给代理AltShiftC区域截图 → 剪贴板 对话附件改过源码后在扩展卡片点重新加载即可。三、op 详解snapshot / fill_form / click 怎么用 模型可用的 op 共 8 个snapshot/fill_form/click/fill/select/press/scroll/wait完整 schema 见 tools.js。你最常用的是前三个1. snapshot给页面拍张清单照不带参数调用action opsnapshot返回当前 tab 所有 frame 的合并控件清单。清单里每个控件带 roletextbox / button / combobox…、无障碍名label、aria-label 或 placeholder、当前值以及ref。使用原则先 snapshot再用这份快照的 ref rev 去变更不要凭空猜 CSS 选择器。2. fill_form一次填好整张表单 ✍️fill_form的fields支持两种写法[{ ref: f0.a12, value: … }]—— 精确引用[{ name: 搜索框, value: … }]—— 用无障碍名回退命中两个控件会返回AMBIGUOUS多字段表单按frameId自动拆包分发到对应 frame一次调用填完所有输入框。之后需要提交时再显式click提交按钮——代理默认不会替你提交表单除非你明确要求。3. click精准点一下 ️click带上最近快照的ref和rev即可。配套动作还有fill/select单字段填值 / 下拉选择press按键Enter、Tab、Escape、方向键、Space…不指定目标时打给主 frame 的当前焦点元素scroll滚动页面wait等待某段text出现上限 5000ms或纯睡一小段时间默认 300ms作用域与限制30 秒读完action只作用于本轮消息打开的那个 tab显式tabId不会偷偷切到 Chrome 焦点标签缺 tabId 会报NEED_EXPLICIT_TAB。tab 租约同一个 tab 正被另一个会话的 execution 占用时返回TAB_LEASED防止两个会话同时改一个页面。限制页chrome://、扩展页、Web Store 等会返回NEED_PAGE。chrome://extensions重新加载扩展后快照世代rev会重置需要重新snapshot。四、常见错误码速查出错了先看这里 ️错误码含义怎么办STALE_REFrev对不上或控件已卸载重新snapshot用新refrevAMBIGUOUSname命中多个控件改用ref精确引用NO_TARGET无名无 ref / 零命中 / wait 超时核对快照清单里的名称FILE_INPUT遇到文件上传控件脚本填不了需手动上传NEED_PAGE限制页 / 无 host换到普通http(s)页面NEED_EXPLICIT_TAB本轮消息没带 tabId先打开目标页再发任务TAB_LEASEDtab 被另一会话占用等另一个会话结束BAD_INPUT缺op/fields/value等补齐参数重试完整契约参数表 错误码写在 agent/AGENTS.md跨 frame 扇出与租约的宿主侧逻辑见 src/AGENTS.md。五、相关文件速览 内容路径action工具 schema 与执行入口src/agent/vnext/sessionWorkspace/tools.js快照采集与 80 控件上限src/content_script.js消息总线与跨 frame 运输src/background.js产品架构与进程分层AGENTS.md安装与测试说明README.md一句话总结snapshot 看、fill_form 填、click 点三步回路配合rev世代防过期就能让爪爪 PawWork 在你真实登录态的网页上稳定完成表单填写与点击任务——无需服务器、数据不出本机。【免费下载链接】BrowserKittenPaw Work - selection-first web agent for Chrome: select on the live page, describe the outcome, take away an editable office file. BYOK, sandboxed, no server.项目地址: https://gitcode.com/gh_mirrors/pa/BrowserKitten创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

Codex 实战:简历项目怎么讲清楚——从单元测试到 CI/CD 的微服务叙事 2026/9/29 9:55:28

Codex 实战:简历项目怎么讲清楚——从单元测试到 CI/CD 的微服务叙事

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
小米 Q2 研发 92 亿、MiMo-V2.5 登顶 OpenRouter:手机厂大模型的端云协同怎么配 TaoToken 2026/9/29 9:55:28

小米 Q2 研发 92 亿、MiMo-V2.5 登顶 OpenRouter:手机厂大模型的端云协同怎么配 TaoToken

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
TaoToken 配置实战:用 settings.json 骨架复现李蓓地产交易决策的“不看“逻辑 2026/9/29 9:55:28

TaoToken 配置实战:用 settings.json 骨架复现李蓓地产交易决策的“不看“逻辑

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
GitHub Copilot CLI 实战:/fleet、Autopilot、Hooks 和 /delegate 怎么配合用(TaoToken 统一 Key 接入版) 2026/9/29 9:55:27

GitHub Copilot CLI 实战:/fleet、Autopilot、Hooks 和 /delegate 怎么配合用(TaoToken 统一 Key 接入版)

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
步进电机驱动器接线本质:信号链路精准匹配指南 2026/9/29 9:55:12

步进电机驱动器接线本质:信号链路精准匹配指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
OpenCV入门:图像读取、显示与写入的完整实践指南 2026/9/29 9:55:03

OpenCV入门:图像读取、显示与写入的完整实践指南

1. 准备工作:先把OpenCV环境搞定说实话,OpenCV入门最大的门槛往往不是代码本身,而是环境安装。我见过太多初学者卡在import cv2这一步,明明按照教程装完了,一运行就报ModuleNotFoundError,心态直接崩掉。这…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉