启动一个新的浏览器实例（自动分配调试端口）。

接管一个已在运行的浏览器（需开启远程调试端口，默认 127.0.0.1:9222）。

接管后的浏览器在本服务关闭时不会被退出。

关闭并移除一个浏览器会话（browser_connect 接管的浏览器只断开连接不退出）。

列出所有浏览器会话及其标签页、上下文信息。

新建标签页。指定 context_id 时在对应多账号上下文中创建（cookies 隔离）。

列出浏览器会话中的所有标签页。

关闭标签页，省略 tab_id 时关闭最新标签页；others=True 时保留该标签页关闭其余。

获取标签页的当前地址、标题与加载状态。

在标签页中执行 JavaScript 并返回结果（可 JSON 序列化的部分）。

在标签页中打开网址，返回导航结果（url/status/ok）。

在标签页中执行浏览器后退。

在标签页中执行浏览器前进。

刷新标签页当前页面。

等待元素出现（页面加载、AJAX 渲染后返回）。

获取标签页当前网址、标题、加载状态与 User-Agent。

获取标签页当前页面的完整 HTML（不含 iframe 内部内容），超长时截断。

在标签页中定位一个元素，返回摘要与 element_id（供交互工具使用）。

在标签页中定位所有匹配元素，返回摘要列表（每个元素含 element_id）。

获取元素完整信息：文本、HTML、属性、值、链接、位置尺寸与状态。

点击元素。默认通过 Actions 派发真实鼠标事件（移动→按下→抬起）， 保证 hover/焦点/事件链真实触发，适合 UI 自动化测试。

响应在有新浮层时附带 overlays（弹窗/提示等，封顶 4 条），无则省略。

向输入框元素输入文本。

将鼠标悬停在元素上（触发下拉菜单、悬浮提示等）。

在下拉框（）元素中选择选项。

勾选或取消勾选复选框/单选框。

滚动元素（或让元素滚动到可视区域）。

列出标签页顶级 DOM 中的所有 iframe 及其可见状态（可见即激活态功能模块）。

返回的 frame_index / iframe_id 可作为其他工具 frame 参数的取值。

按顺序执行一串真实鼠标/键盘操作（CDP Input 事件级别，非 JS 模拟）。

典型用法：先 move_to 元素再 click；或 hold+move+release 拖拽； type 输入文本前先 move_to/click 输入框获得焦点。

按下并松开一个键盘按键（真实键盘事件），如 ENTER、ESC、TAB、BACKSPACE、DELETE、箭头键。

读取当前显示的 AntD message 全局提示与 notification 通知内容（用于操作结果断言）。

查询范围默认为主文档+自动穿透 iframe；portal 弹层归属触发它的功能模块文档， 建议传 frame='active' 或使用触发元素的所在文档。

展开 AntD 下拉选择框并列出当前可见的全部选项文本（先于 antd_select 使用）。

操作 AntD 下拉选择框（Select）：真实点击展开，在 portal 浮层中点击匹配选项。

操作 AntD 日期选择器（DatePicker）：真实点击输入框，在 portal 日历中点击目标日期。

点击当前可见 AntD 弹窗（Modal.confirm / Modal）中的按钮，如"确 定""取 消""确 定删除"。

自动寻找可见的 .ant-modal，在其 footer 或 confirm 区域真实点击匹配按钮。

绑定激活页面中的 VTable 并返回元数据：行列数、表头行数、冻结行列、 canvas 位置尺寸、实例类型。后续 VTable 工具沿用此绑定（table_index 可省略）。

列出 VTable 全部列：col 序号、业务字段 field、表头标题 title、单元格类型。 用于把业务列名映射为 col 序号。

批量读取 VTable 矩形区域的单元格值（行优先矩阵，最多 2000 格）。

在 VTable 全表（含表头）中按文本查找单元格，返回 {col,row,value} 列表。

读取单元格的值/类型/几何信息，并换算出页面视口绝对中心点坐标 （该坐标可直接用于 action_chain 的 move_to）。

把 VTable 滚动到指定单元格使其进入可视区域（支持虚拟滚动）。

点击 VTable 单元格：自动滚动到位 → 换算视口绝对坐标 → action_chain 真实鼠标移动并点击（非 JS 合成事件，触发完整 hover/focus/选区行为）。

点击单元格/表头内的交互图标（排序箭头、筛选漏斗、复选框、展开折叠等）。

图标通过 VTable scenegraph 发现，坐标为其视觉中心的视口绝对坐标， 以真实鼠标点击。

深度提取单元格的显示文本：scenegraph 场景图渲染文本优先（格式化器/ 自定义渲染后的"所见即所得"），依次回退溢出全文/显示值/原始值/业务记录 字段，并标注命中的来源。当 getCellValue 与页面显示不一致时以此为准。

读取 VTable 当前选区的单元格明细：col/row/field/title/value 及完整业务记录 originData。点击/框选单元格后用它做断言（数据源为官方 getSelectedCellInfos）。

拖拽 VTable 滚动条滑块实现滚动（真实鼠标：按下→拖动→释放）。

滑块几何由表格总量与滚动比例确定性计算（滚动条为 canvas 绘制）。 返回拖拽前后的 scrollTop/scrollLeft 供断言。

真实鼠标悬停在单元格上（自动滚动到位），读取悬停态颜色信息： 单元格背景色、文本颜色、是否可交互文本（link/cursor:pointer/下划线） 及同行邻格背景（用于检测行高亮）。

读取单元格状态：是否选中、复选/单选/开关状态值，以及 scenegraph 视觉签名 （fill/stroke 等，可在操作前后对比以断言高亮/颜色变化）。

对 VTable 画布中心派发真实鼠标滚轮事件（delta_y 正=向下滚，负=向上滚； delta_x 正=向右滚）。用于手动调整可视窗口。

用业务字段名 + 记录索引解析单元格地址（col/row）与当前值。 比 find_cell 更稳定：不依赖文本内容，直接走 VTable 内部映射 API。

通过 VTable editorManager 编辑单元格并落值（API 级编辑，要求该列配置了编辑器）。 如需真实键入流程：先 vtable_click_cell(double_click=True) 进入编辑态， 再用 action_chain 的 type 步骤输入，最后 press_key ENTER。

创建一个独立的浏览器上下文（BrowserContext），cookies 与主上下文完全隔离， 用于同一浏览器内登录多个账号。

关闭并销毁一个多账号上下文（其标签页与 cookies 一并清除）。

列出浏览器会话中的所有多账号上下文。

读取标签页当前域名相关的 cookies。

向标签页写入 cookies（复用登录态时使用）。每条 cookie 需含 name/value/domain。

清除标签页所属域的 cookies。

一次性列出当前功能页面的可交互控件（按钮/输入框/下拉/链接，封顶 40 项， 文本截断 24 字符）。用于首次进入页面时快速掌握可用操作，之后用 find_element + element_click 精确交互。