爪爪 PawWork 浏览器智能体工具契约全览：9 大工具参数与错误码速查

爪爪 PawWork 浏览器智能体工具契约全览9 大工具参数与错误码速查【免费下载链接】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 的 selection-first 网页智能体扩展在真实登录页面上框选、用一句话描述目标就能带走一份可编辑的办公文件。它采用 BYOK自带密钥、本地沙箱运行、不经过任何服务器。本文以速查手册的形式带你一次性看懂 PawWork 浏览器智能体的 9 大核心工具参数与常用错误码——inspect、acquire、run、clarify、action、task、sheet、doc、web——新手也能快速上手。一、9 大工具总览一页看懂分工PawWork 的工具契约集中定义在 tools.js 与 officeTools.js 中。所有工具返回统一结构成功时ok: true失败时携带error、机器可读的code即错误码以及可选的hint修复提示。工具一句话职责典型场景inspect只读探查会话状态看选区、文件、表格采样、sys ABI 目录acquire把公网内容带入会话搜索、抓取、建图、爬虫、生成图片⚙️run沙箱“客用机”执行 JS/TS、注册表格/文档产物clarify暂停并向用户提问意图不清时提问、复杂任务出计划卡️action操作当前活动标签页填表、点击、滚动、等待task持久化任务状态计划、检查点、完成、定时sheet读写活动电子表格单元格写入、排序、拆列doc读写长文本文档段落、列表、插图web编辑站点 HTML 产物页面改版、动效蓝图二、逐个工具看参数1️⃣inspect只读探查器参数核心是view取值groups、group、item、artifacts、files、skill、workbook、range、html、sys十种配合offset/limit/maxChars分页读取。它不改变任何状态是每次动手前的“安全侦察”。2️⃣acquire公网内容接入器唯一必传参数是action枚举值为search、fetch、map、crawl、note、imagesearch/map需要query可加limit限制条数fetch/crawl需要url支持页面别名如页面1image需要prompt可选itemIds图生图、aspect_ratio、allowTextnote把text存为会话内笔记注意它是匿名抓取不带你的 Cookie需要登录态的内容请走runsys。3️⃣run沙箱客用机两种用法传code执行 JS/TS 程序沙箱内只有fs和sys两个接口文件根目录为/context只读、/artifacts持久、/scratch本轮临时或传op注册产物如sheet、doc、write_artifact、ingestPdf等。⏱️ 超时上限 120 秒代码正文超 24000 字符会被直接拒绝。4️⃣clarify暂停与提问三种形态单问questionoptions、多问questions[]1–4 个支持multiSelect、或计划卡plan { title, steps }。用户未批准计划前智能体不会执行任何变更。5️⃣action活动标签页操作器必传op枚举为snapshot、fill_form、click、fill、select、press、scroll、wait。关键规则先snapshot拿快照再用该代快照的ref如f0.a12rev如t7做变更每次变更后页面会返回新快照。wait的ms上限 5000。️6️⃣task持久任务管理器op取inspect、plan、checkpoint、wait、complete、schedule定义见 taskTool.js。其中wait/complete会持久化状态并立即让出执行权适合长任务跨轮接力。7️⃣sheet电子表格读写必传actread采样读取、write应用commands[]、snapshot导出 CSV 到/scratch。write支持的命令包括setRange、setFormula、applyGrid、insertRow/Col、deleteRow/Col、sort、numberFormat、reshapeSplit拆列、insertCellImage等。成功写入会返回 readback 回读请以回读值为准。8️⃣doc文档读写act为read或write。长文建议先由run写出 JSON 文件再通过path/from指向/scratch或/artifacts下的commands[]/blocks[]避免直接复述全文。9️⃣web站点 HTML 编辑器编辑会话内已注册的站点产物HTML 画布支持改版、动效蓝图等对真实登录页面的普通点击/填表请用action二者不要混用。三、错误码速查表 所有工具失败都会返回code字段下表是最常见的一批完整返回结构见 tools.js错误码常见出处含义与处理NEED_PAGEaction当前没有可用的活动页面切到普通http(s)页面重试CDP_BUSYrun(sys)目标标签页 DevTools 未关闭关闭后重试NEED_TABinspect/ 预览缺少对应活动标签页打开目标页重试TAB_LEASEDaction同一标签页被另一个会话占用请切换会话或标签页STALE_REFactionrev快照版本过期重新snapshot后操作AMBIGUOUSactionname匹配到多个控件改用ref精确指定BAD_INPUT全部工具参数缺失或非法按返回的hint修正NET_DENIEDacquire目标 URL 被网络守卫拦截策略见 netGuard.jsMISSING_QUERY/MISSING_URL/MISSING_PROMPTacquire分别缺少query/url/promptNOT_FOUND/AUTH_DENIEDinspect等资源不存在 / 不属于本会话鉴权见 auth.jsNO_CANVASsheet/doc会话还没有画布先用run opsheet注册工作簿NO_SUCH_SHEETsheet指定工作表不存在省略sheet作用于活动表SNAPSHOT_TOO_LARGEsheet快照范围过大缩小a1范围IMAGE_UNRESOLVEDsheet图片src无法解析为像素改用路径 /wi_id /图片NENOENT/FS_DENIEDrun/doc文件不存在 / 无该路径写权限见 officePathHydrate.jsNO_PIXELS/TOO_LARGE图片处理拿不到图像字节 / 图像超限见 itemPixels.jsUSE_CANVASrun写 HTML该 HTML 写入被策略拦截应走画布工具见 htmlWritePolicy.jsARTIFACT_CONFLICT产物更新版本冲突按expectedRevision提示刷新后重试NOT_PENDINGclarify当前没有等待回答的澄清TASK_UNAVAILABLE/TASK_YIELDEDtask任务宿主不可用 / 任务已让出本轮不能再跑工具SYS_FAILED/HTTP_ERRORrun(sys)宿主系统调用失败 / 页面 fetch 返回非 2xx见 browserSys.js 小技巧遇到失败先看hint字段——PawWork 的多数错误都自带一句“下一步怎么改”的中文友好提示。四、典型协作流程选区 → 表格选区在登录好的页面上框选内容PawWork 自动绑定为组/条目inspect viewgroups确认拿到的素材清单run opsheet注册工作簿或run code加工数据后注册sheet actwrite应用命令写数据按 readback 校对action回到真实页面做点击/提交先snapshot需要追问时用clarify暂停复杂任务用task持久化检查点。这套契约也解释了 PawWork 的三大卖点BYOK密钥只存本地chrome.storage.local、沙箱run在客用机中执行、无服务器流程见 README.md 与 AGENTS.md。五、延伸阅读 工具契约总入口tools.js办公画布工具sheet/doc/webofficeTools.js网络守卫策略netGuard.js任务调度与状态模型taskTool.js、tasks.js项目架构说明AGENTS.md、src/agent/AGENTS.md纯 Node 回归测试runtime-regression.test.mjs把这份速查表收藏起来下次 PawWork 返回一个陌生code时你只需两秒钟就能定位原因、按hint修复——这就是工具契约的价值。✅【免费下载链接】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），仅供参考