veddata

Execute actions on the page: input, scroll, click, or select. Two modes: 1. Single step: ved_act("scroll", "bottom") ved_act("input", "python教程", target="搜索") ved_act("click", target="下一页") ved_act("select", "最多播放", target="综合排序") ved_act("click", target="css=a[href*='/download/']") ← target 也接受选择器 ved_act("click", target="//a[contains(@href,'/download/')]") 2. Chain: ved_act(actions=[ {"action": "input", "value": "python教程", "target": "搜索"}, {"action": "scroll", "value": "bottom"}, {"action": "click", "target": "最多播放"}, ]) Each step reports new API method + path inline so AI sees them immediately. 未命中时给出最接近的可见文本；点击失败时给出错误原文（不再一律说成 not found）。

列出已捕获的所有数据。包括网络请求、DOM 内嵌数据、JS 变量等。每条记录标注触发时机，不贴类型标签。

工具链：一次把多个工具按顺序交给服务端连续执行。 解决 MCP 回合制的两个硬伤： 1. **别错过** —— 动作与等待/取样在服务端紧挨着跑，中间不经过模型， 瞬时事件（请求/日志/中间态/弹窗）不会被回合间隔吞掉。 2. **给因果** —— 每个动作步骤自动算差分，报告里直接写"+3 requests: …"， AI 不用再靠"点前点后各取一次"去猜哪个请求是哪个动作触发的。 步骤（三种写法）： {"tool": "ved_act", "args": {"action": "click", "target": "下一页"}} {"wait": {"network": "**/joblist**", "timeout": 8}} wait 支持：ms / network（等指定请求出现）/ network_idle（网络静默）/ element(+state=visible|hidden) {"repeat": {"times": 5, "steps": [ ... ]}} # 只允许一层，翻页用 典型链路（翻页抓接口：现在 12+ 回合 → 2 回合）： ved_chain(steps=[ {"tool": "ved_open"}, {"tool": "ved_goto", "args": {"url": "https://…"}}, {"tool": "ved_watch", "args": {"observations": [{"type": "request", "pattern": "**/api/**"}]}}, {"tool": "ved_act", "args": {"action": "click", "target": "下一页"}}, {"wait": {"network_idle": 800, "timeout": 10}}, {"tool": "ved_watch", "args": {"collect": True, "timeout": 10}}, ]) 行为约定： - 撞上登录/验证/风控 → 停在该步；用户处理完用 ved_chain(resume="<id>:<步号>") 续跑，**不重放**前面动作 - 状态被工具之外改动（页面自跳 / 用户开标签页）→ 停，并说明原因 - 每步都过和单独调用时同一套门禁（链不是后门） - 只允许既有工具里的动作/读取类；ved_close 与 ved_chain 自身禁用 - 上限：30 步 / repeat 20 次 / 单步 30s / 整链 300s - 报告每步一行 + 因果差分，细节留服务端（用 ved_apis / ved_inspect / ved_watch(collect) 取）

Close the browser and clear all captured data. Closes the Playwright context and resets all state.

操作页面控制台：执行 JS / 查看 log/warn/error 消息。 code 非空 → 在页面执行 JS，返回执行结果。 code 为空 → 返回控制台历史消息（log/warn/error，来自官方内置缓冲）。 tail → 只看最近 N 条；filter → 按文本过滤。

Search all data sources for keyword, returning field paths and values.

View cookies for the current page.

通过路径定位一个 DOM 节点。 路径要**从根节点开始**（第一段必须匹配 ``html``）—— 例如 ``html > body.win > div#app > div.feed-card``（可直接从 ved_dom_tree 的输出里抄）。 段格式：``tag[.class][#id][:nth-child(n)]``，``>`` 分隔。

在内存 DOM 树中搜索文本。 不调浏览器，直接在保存的树结构里查找。返回匹配的节点路径和上下文。

输出当前页面的 DOM 目录树（内存快照，含容器/字段/交互标记）。 首次调用或页面导航后会自动重新扫描；此后从内存读取，不再调浏览器。

导出捕获到的 API 数据源（一个或多个）。

一次导出当前 tab 捕获到的所有 API 数据源。

获取页面全文，辅助定位数据关键词。当需要从页面文本中选取关键词来反查数据时使用。 First call scrolls to bottom and writes a JSON cache file. Subsequent calls with start_index read from cache (no re-scroll).

导航到目标页面，自动发现所有数据来源。返回 DOM 结构、网络请求、内嵌数据清单。 Starts network monitoring BEFORE navigating (event-driven attach happens at tab registration, which precedes goto). Use new_tab=True to open in a new tab while keeping the current page.

Show full request and response details for one or more APIs.

列出页面所有 JS 脚本的 URL、大小和行数。 用于定位目标脚本后传给 ved_script_source。内联的 ``data:`` 脚本**只给摘要** —— 页面里常有几百 KB 的 wasm/base64，整段吐出来会一次性烧掉大量上下文。

启动数据发现会话。打开浏览器以开始捕获页面数据源。浏览网页是前置步骤，不是终点。 Launches a Playwright Chromium session (persistent context) and clears old state. Does NOT navigate — use ved_goto() for that.

快速探测指定 URL 的数据源。打开页面 → 自动捕获 API → 返回字段文档。

Send a test HTTP request — replay from captured API or fully custom. Three modes: 1. Replay: index=3, params='{"page":2}' — 用 API #3 的 URL/method/headers 作底， params/headers 在其上**覆盖或删除**。 2. Manual: url="...", method="POST", body="..." — fully custom。 3. Raw: index=3, raw=true, headers='{"cookie":"sessionid=..."}' — 原样发出： 不继承捕获记录的头/参数/body，不注入 cookie 与 XSRF，只发你给的东西。 覆盖语义：``params`` / ``headers`` 里 **值为 null 表示删掉该键**，其余为设置/覆盖。 非 raw 模式下 cookie 默认由浏览器实时同步；你显式给的 ``cookie`` 头优先于它。 返回里会回显**实际发出的请求**（方法、最终 URL、请求头及每个头的来源、参数）， 以及被删除 / 未发送的键 —— 用它可以判断"哪些东西是必需的"。

Comprehensive page data source scanner. MODE "all" — full page scan (default): 1. Network APIs — requests captured by the event listener 2. DOM Structure — snapshot tree with repeated-container marks 3. Embedded JSON — script-tag / window-global data records MODE "dom" — keyword-targeted DOM scan: Searches the in-memory DOM tree for the keyword.

截图当前页面。

局部查看：查看某个脚本源码，支持搜索高亮和上下文。 url: 脚本 URL（从 ved_list_scripts 或 ved_search_scripts 获取）。 query: 搜索字符串，匹配行会高亮（>>> 前缀）——压缩成一行的 bundle 用这个，别翻页。 context_lines: 匹配行前后显示几行上下文。 start_line / line_count: 按行翻页（大文件分段读；单行超过 2000 字符会被截断）。 读到任意窗口即视为"已读该脚本"：之后才允许在它上面打 JS 观测点（ved_watch 的先读后打）。

在已捕获的所有数据中搜索关键词。包括网络请求、DOM 内嵌 JSON、页面渲染文本和 JS 全局变量。 Supports comma-separated keywords for OR search.

全局搜索：在所有已加载的 JS 源码中搜索字符串。 结果按文件分组，显示每个文件的匹配行数（有上限，见 limit / per_file）。 支持正则（query 以 / 开头和结尾时）。 **零命中时会自动反查**：把 query 按路径片段拆开再搜一遍脚本，并列出已捕获请求里 含这些片段的接口 —— 接口 URL 常是拼接出来的，整串在源码里搜不到。

状态体检：现在有哪些标签页、各自在哪个页面、有没有撞上人机门。 用户说"登录好了 / 验证过了"之后**先调这个** —— 不要重新导航（会再次触发风控）。 它同时是一次"重新建档"：调过之后依赖活状态的工具才放行。

Close browser tab(s) by CDP short ID and prune their API records. 两种写法等价：``tab="C724404D,5FD84E84"``（逗号分隔）或 ``tabs=["C724404D","5FD84E84"]``。 都不给 = 关闭当前标签。**最后一个标签不会被关掉** —— 全关会让会话没有可用页面 （要结束会话请用 ved_close）。

Switch the active tab by CDP short ID (from ved_tabs output). After switching, ved_goto() targets the new tab.

List all open browser tabs with their URLs — 这是"重新建档"的入口。 页面自己跳走、用户开关标签页之后，依赖活状态的工具会被拒绝； 先调这个（或 ved_status）确认现状，再继续。

全局搜索一个值出现在哪些地方。 搜索范围: JS 源码 → 网络请求 → DOM 内嵌 → 渲染文本 → JS 变量 → WS。 每条匹配标注位置和上下文，支持直接设观测点。

批量观测：注册请求/JS 观测点 → 触发操作 → 一次性取回快照。 四种用法（都不传 = 列出当前观测点）： 1. 注册：``ved_watch(observations=[{...}, {...}])`` —— 一次可打多个点 2. 列表：``ved_watch()`` —— 看 id / 类型 / 目标 / 命中数 / 状态 3. 收集：``ved_watch(collect=True)`` —— 等所有点命中（或超时）后返回报告 4. 删除：``ved_watch(remove="w1,w3")``，``remove="all"`` 清空 observation 项： {"type": "request", "pattern": "/api/*"} — 请求（glob 或 /regex/） {"type": "js", "url": "...app.js", "line": 147, "variables": ["userid", "secret"]} — JS 断点（line 是 **1-based**） 可选字段：{"id": "login", "max": 1} id —— 自定义 id（缺省自动分配 w1/w2…，单调递增、跨批次不重复） max —— 该点最多记几次命中，默认 1；**达到后自动移除该点**（0 = 不限，仍受全局上限） 原理：JS 观测点用的是 CDP ``Debugger.setBreakpointByUrl`` —— 和人工断点同一个接口， 区别只在命中后自动读值并 resume，不打断页面。但也因此：断点打在热点行会反复中断， 所以默认只取第一次（要连续观察就调大 max）。 **先读后打**：JS 观测点要求先读过该脚本（``ved_script_source(url=...)``）。没读过会被 拒绝并提示去读；读完之后脚本变了（页面重载/内容不同）也要重读 —— 否则等于拿旧认知 在错误的行上设断点。请求观测点不涉及代码，没有这个要求。