工具参考总览

共 57 个内置工具，按类别与 severity 分组：

类别	说明	数量
探查	页面读取 · safe	14
操作	页面写入 · caution	8
危险	提交 / 发 cookie 请求 / runJS · dangerous	6
元 / 视觉	跨 tab / bookmark / history / 视觉	29

Severity 说明

🟢 safe：自动执行，无需审批
🟡 caution：默认自动（依权限模式）；read 模式下要审
🔴 dangerous：默认每次要审；trust 模式下按白名单放行；yolo 模式全自动（危险）

速查表

工具	Severity	类别	摘要
`askUser`	🟢 safe	meta	[ASK] 向用户主动征询（不是执行操作）。任务有多个候选 / 二次确认 / 缺关键信息时调用。返回
`attachTab`	🟡 caution	meta	[META] 请求把已打开的 tab 纳入会话 attachedTabs；未预批准时会向用户索取审批。
`click`	🟡 caution	action	[ACT] 点击选择器命中的元素。required=false 时找不到不报错。会经过审阅（caution）。
`clickByUid`	🟡 caution	action	[ACT·UID] 用 takeSnapshot 返回的 uid 点击元素。比 selector 版稳定。
`closeTab`	🟢 safe	meta	[META] 真正关闭一个 tab。只能关 attachedTabs 里的 tab（防止误关用户其它窗口）。
`consoleMessages`	🔴 dangerous	meta	[OBSERVE] 读取本页 console 日志与未捕获错误。返回里带 backend 字段：main-world 档
`createPageIndex`	🔴 dangerous	meta	[PAGE-INDEX][FIRST·READ] 在内容脚本本地构建/刷新页面索引，返回小型页面地图、blockId、k
`detachTab`	🟢 safe	meta	[META] 从会话 attachedTabs 移除 tab；不关闭该 tab。
`downloadImage`	🟡 caution	meta	[ACT] 把一个 URL 下载到本地（Chrome Downloads）。返回 {downloadId, filena
`downloadSpreadsheet`	🔴 dangerous	meta	[ACT] 生成并下载真正的 .xlsx Excel 文件（Chrome Downloads）。适合把采集/抽取结果导出
`drag`	🔴 dangerous	meta	[ACT] 把一个元素拖到另一个元素上。同时发 pointer 序列和 HTML5 DragEvent（共用一个 Dat
`drop`	🔴 dangerous	meta	[ACT] 模拟从浏览器外部把文件或数据拖放到页面元素上。带 files 时等同上传（dangerous）。
`extractFormState`	🟢 safe	inspect	[FAST·USE BEFORE FILL] 把 <form> 内所有可填字段读成 {name: value} 对象（r
`extractImages`	🟢 safe	inspect	[FAST] 在 root 范围内提取所有 <img> 的 src/data-src/srcset；includeBg=
`extractPageFields`	🔴 dangerous	meta	[PAGE-INDEX][FIELD-FIRST] 通用字段候选提取：输入字段名数组，返回 value candidat
`extractText`	🟢 safe	inspect	[FAST·TARGETED] 提取选择器命中元素的文本。single=true 返回字符串，否则返回数组。
`fillByUid`	🟡 caution	action	[ACT·UID] 用 takeSnapshot 返回的 uid 填值（input/textarea/contented
`fillForm`	🟡 caution	action	[BATCH·ACT] 一次性填多个字段。每项写 selector + value 或 uid + value。返回 {
`fillInput`	🟡 caution	action	[ACT] 往 input/textarea/contenteditable 填值；触发 input/change 事件
`findElements`	🔴 dangerous	meta	[READ] 按文本或正则在可交互元素里找目标，返回 uid / role / name / bounds。不需要先 c
`focus`	🟢 safe	inspect	[ACT] 把焦点给某元素（触发 focus / focusin）。
`getPageInfo`	🟢 safe	inspect	[FAST·READ] 读当前页基本信息：URL / title / hostname / 语言 / OpenGraph
`getValue`	🟢 safe	inspect	[FAST] 读 input/select/textarea/contenteditable 的当前值。
`handleDialog`	🔴 dangerous	meta	[OBSERVE] 设定 alert / confirm / prompt 的应答策略，并返回已记录的弹窗。
`highlightElement`	🟢 safe	meta	[VISUAL] 给页面某元素加红色虚线框（默认 3s 自动消失），让用户看清你说的是哪个。仅视觉，不改 DOM。
`highlightText`	🟢 safe	meta	[VISUAL] 在页面文本里高亮某段文字（黄色背景，3s 后还原）。仅找到第一次出现的位置。
`hover`	🟢 safe	inspect	[ACT] 把鼠标悬停在元素上（触发 mouseenter / mouseover / mousemove）。
`httpRequest`	🟡 caution	danger	[ACT] 通过后台代理发请求。withCredentials=true 时带 cookie（dangerous，要审阅
`listTabs`	🟡 caution	meta	[META] 列出所有窗口的可访问 tab；返回 [{tabId, windowId, url, title, atta
`navigate`	🟢 safe	inspect	[ACT] 页面导航：后退 / 前进 / 重载 / 跳转。优先用本工具而不是 runJS('location.h
`navigateBack`	🔴 dangerous	meta	[FLOW] 后退一页。已在历史起点时返回 { ok:false, reason }，不抛错。
`navigateForward`	🔴 dangerous	meta	[FLOW] 前进一页。已在历史末尾时返回 { ok:false, reason }，不抛错。
`networkRequestDetail`	🔴 dangerous	meta	[OBSERVE] 读取单条请求的 headers 与 body。dangerous：响应头里可能有 Autho
`networkRequests`	🔴 dangerous	meta	[OBSERVE] 列出本页发出的网络请求摘要（method / url / status / 耗时）。默认隐藏 Per
`openTab`	🟡 caution	meta	[META] 打开新 tab，成功后自动加入会话 attachedTabs（source=ai-open）。返回 {ta
`pressKey`	🟡 caution	action	[ACT] 模拟键盘事件（keydown + 可打印字符 keypress + keyup）。
`querySelector`	🟢 safe	inspect	[FAST] 返回首个匹配元素的浅层摘要 (tag/id/classes/text/attrs)。仅探查用。
`querySelectorAll`	🟢 safe	inspect	[FAST] 返回所有匹配元素的浅层摘要数组。
`readPageBlock`	🔴 dangerous	meta	[PAGE-INDEX] 按 blockId 读取局部内容；长内容按 offset/maxChars 分页，返回 has
`readStorage`	🔴 dangerous	danger	[DANGER] 读 localStorage 或 sessionStorage 指定 key。需要审阅。
`recorderConfig`	🔴 dangerous	meta	[OBSERVE] 开关页面事件录制。bodies:true 打开请求/响应 body 捕获（默认关，有内存代价）；di
`resize`	🔴 dangerous	meta	[FLOW] 把视口调整到指定尺寸。main-world 档量取 outerWidth-innerWidth 反推浏览器
`runJS`	🟡 caution	danger	[LAST RESORT·DANGER] 在 MAIN world 注入并执行 async 函数体（receives `
`screenshot`	🟢 safe	meta	[VISION] 截当前 tab 可见区域为 PNG（自动作为 image block 注入下轮）。用于视觉调试、看图回
`scroll`	🟢 safe	inspect	[FLOW] 滚动页面。to 可为 'bottom' / 'top' / number。max 是滚动次数；untilS
`searchBookmarks`	🟢 safe	meta	[META] 搜索浏览器书签（chrome.bookmarks.search）。返回 [
`searchHistory`	🟢 safe	meta	[META] 搜索浏览器历史。daysBack 默认 7。返回 [{url, title, lastVisitTime,
`searchPageIndex`	🔴 dangerous	meta	[PAGE-INDEX] 在本地页面索引中搜索关键词/字段，返回小证据片段、blockId、complete/avail
`selectOption`	🟡 caution	action	[ACT] <select> 元素按 value 或 label 选项。同时给两者时优先 value。
`setCheckbox`	🟡 caution	action	[ACT] 设置 checkbox 勾选状态；派发 change 事件。
`snapshotDOM`	🟢 safe	inspect	[FIRST·LEGACY] 返回页面 DOM 简化树（tag/id/classes/直接文本/children）。
`submitForm`	🔴 dangerous	danger	[CONFIRM·DANGER] 提交 <form>。会触发服务端动作（下单、留言等），用户必须审阅。
`switchToTab`	🟢 safe	meta	[META] 把 Chrome 前台切到目标 tab。tabId 必须已在 attachedTabs 或当前 tab。
`takeSnapshot`	🟢 safe	inspect	[FIRST·UID] 抓取页面 accessibility snapshot：返回 [{uid, role, name
`uploadFile`	🔴 dangerous	danger	[CONFIRM·DANGER] 把后端代理拉到的文件填到 <input type=file>。某些站点会拒绝合成 Fi
`waitFor`	🟢 safe	inspect	[FLOW] 等待固定 ms，或等待选择器出现（带 timeoutMs 兜底）。
`writeStorage`	🔴 dangerous	danger	[DANGER] 写 localStorage 或 sessionStorage。改站点状态，需要审阅。

工具参考总览 ​

Severity 说明 ​

速查表 ​

工具参考总览

Severity 说明

速查表