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

发布时间:2026/11/22 14:42:38

爪爪 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),仅供参考
延伸阅读

更多相关文章

2026/11/21 23:48:17

软硬协同,同星EOL下线测试方案重塑产线终检新体验

EOL(End of Line)测试是汽车零部件生产制造过程中,产品完成所有装配工艺后的最后一道关键质检环节。在严苛的生产节拍下,测试系统需模拟真实车载环境,对ECU进行全方位的电气、通讯及逻辑功能验证,保障每一台…

2026/11/22 14:39:20

电工证实操考试心里没底怕挂科?昆山市初级电工证怎么报名全攻略

电工证实操考试心里没底怕挂科?昆山市初级电工证怎么报名全攻略 实操考试心里没底怕挂科?这几乎是每个准备考昆山市初级电工证的学员心里最真实的写照。尤其是刚入行的南阳房建工程从业者,一边要应对繁重的工地任务,一边还要挤时间备考,压力不小。但别慌…

2026/11/22 14:39:20

工地太忙根本没时间复习考试?中间电工证正反转考试在哪考全攻略

工地太忙根本没时间复习考试?中间电工证正反转考试在哪考全攻略 工地太忙根本没时间复习考试?中间电工证正反转考试在哪考成了很多一线电工的燃眉之急。特别是像南阳这样的工程大市,应届毕业生一毕业就上工地,没时间准备考试、没时间复习内容,导致很多电…

2026/11/22 14:39:20

国家电网特种工网上查询全攻略:报名怕被坑?这里给你讲明白

国家电网特种工网上查询全攻略:报名怕被坑?这里给你讲明白 你是不是也遇到过这种情况,听说干特种作业能挣钱,想报个国家电网特种工证,结果网上一搜,各种培训机构、中介信息满天飞,不知道去哪报名才靠谱? 不知道去哪报名怕被中介坑…

2026/11/22 14:34:12

保定维修电工证值不值得考?实操考试心里没底怕挂科怎么办

保定维修电工证值不值得考?实操考试心里没底怕挂科怎么办 实操考试心里没底怕挂科,这是很多想考保定维修电工证的小伙伴最真实的焦虑。尤其是像我这样的信阳浉河区转岗从业者,从零基础开始,面对各种考试流程和操作要求,真的不知道从哪儿下手。不过,别担…

2026/11/22 0:09:40

高压电工证还能年审吗良心建议来了,学历不高也能考!

高压电工证还能年审吗良心建议来了,学历不高也能考! 你是不是也担心,自己学历不高,根本报不上高压电工证?其实不然,现在政策已经非常明确, 高压电工证还能年审 ,而且只要符合条件, 学历不是门槛 , 良心建议…

2026/11/22 0:09:40

吴江的电工证免费培训怎么报名?官方报名入口全解析

吴江的电工证免费培训怎么报名?官方报名入口全解析 你急需特种作业证才能上岗找工作,但不知道从哪里下手?别急,现在就给你讲明白【吴江的电工证免费培训】到底怎么操作,以及怎么通过 官方报名入口…

2026/11/22 0:09:40

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱 不知道去哪报名怕被中介坑?这几乎是每个需要办理或复审电工证的人的真实经历。尤其在肃州区,信息不透明、流程复杂、中介收费高又不靠谱,让很多电工从业者感到头疼。作为一个在应急管理和特种作…

2026/11/22 0:09:40

高压电工证还能年审吗良心建议来了,学历不高也能考!

高压电工证还能年审吗良心建议来了,学历不高也能考! 你是不是也担心,自己学历不高,根本报不上高压电工证?其实不然,现在政策已经非常明确, 高压电工证还能年审 ,而且只要符合条件, 学历不是门槛 , 良心建议…

2026/11/22 0:09:40

吴江的电工证免费培训怎么报名?官方报名入口全解析

吴江的电工证免费培训怎么报名?官方报名入口全解析 你急需特种作业证才能上岗找工作,但不知道从哪里下手?别急,现在就给你讲明白【吴江的电工证免费培训】到底怎么操作,以及怎么通过 官方报名入口…

2026/11/22 0:09:40

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱 不知道去哪报名怕被中介坑?这几乎是每个需要办理或复审电工证的人的真实经历。尤其在肃州区,信息不透明、流程复杂、中介收费高又不靠谱,让很多电工从业者感到头疼。作为一个在应急管理和特种作…

2026/11/22 9:39:14

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/22 5:39:03

SSM电子书店源码全解析:结构、原理、部署与排错实战

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

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑