web-access 是一个联网操作技能,定位于统一承接智能体的各类网络访问需求。资料明确要求:所有联网操作必须通过此技能处理,包括搜索、网页抓取、登录后操作、动态页面交互等。触发场景覆盖用户要求搜索信息、查看网页内容、访问需要登录的网站、操作网页界面、抓取社交媒体内容(小红书、微博、推特等)、读取动态渲染页面,以及任何需要真实浏览器环境的网络任务。
首次安装方面,用户首次使用时先运行环境探测脚本 check-deps.sh,由 AI 根据输出处理缺失依赖,缺什么装什么;Chrome 缺失时提示用户手动下载,无法自动安装。安装完成后向用户说明:凡是联网需求直接提出即可,技能会自动选择最合适的方式——只需搜索结果时直接搜索;需要看完整页面时抓取页面内容、不启动浏览器;需要登录或动态页面时自动启动浏览器,登录一次后持久保存。Windows 用户需要 Git Bash 环境(安装 Git for Windows 即可)。
浏览哲学上,技能强调像人一样浏览而非像机器人一样执行程序,围绕三个核心判断展开:我需要什么(任务驱动,选最轻且能直达的方式)、够了吗(信息能完成任务即止,不过度采集)、遇到阻碍怎么办(在层内解决弹窗、登录墙、广告、加载失败等问题,不退回、不打扰用户,只有确认无法自行解决时才告知用户)。
信息获取通道选择上,技能按目标信息性质选择起点:只需搜索摘要或发现信息来源用 WebSearch;URL 已知的静态公开页面用 WebFetch(请求加 Accept: text/markdown, text/html 头,支持该协议的网站直接返回 Markdown,省约 80% token,失败时空内容、403、JS 渲染时升级到浏览器层);社交媒体与内容平台用浏览器 CDP 并跳过 WebFetch;需要动态内容、登录态、交互操作或自由导航探索时用浏览器 CDP,且不要求 URL 已知。技能规定降级禁止:进入更重通道后不得回头用轻量工具完成同一目标,浏览器层遇阻应在层内解决,唯一例外是浏览器操作中衍生的新子目标可重新选择通道。进入浏览器层后区分操作型与内容型任务:操作用 accessibility tree 感知界面,无法识别时才截图辅助;读内容用 accessibility tree 读文字结构,同时判断图片是否承载核心信息,是则提取图片 URL 定向读取。
浏览器 CDP 模式通过 ensure-browser.sh 启动,并依据输出判断浏览器状态是否可信;脚本自启的 Browser ready 可直接使用(任务结束后关闭),检测到残留进程的 already running 状态不可信,需验证后再用;ERROR 或无响应时先执行 close-browser.sh 再重新运行。技能严禁降级到其他浏览器工具,并说明 Playwright MCP 能力等效但 profile 路径不同,切换会丢失已有登录态。常用命令包括 open、snapshot -i、snapshot、click、fill、wait、scroll、screenshot、eval 等,可完成打开页面、读取可交互元素或完整无障碍树、点击、填表、触发懒加载和提取 DOM 信息。
图片与视频内容获取方面,判断内容在图片里时,用 eval 从 DOM 直接拿图片 URL 再定向打开截图读取,比全页截图更精准;需注意懒加载图片未进入视口时 naturalWidth 为 0,eval 前先滚动到底,并用 naturalWidth > 200 过滤图标和头像。视频方面,CDP headed 模式下浏览器真实渲染,截图可捕获当前帧,可通过 seek 到任意时间点截图进行离散采样分析,采帧粒度由任务需求自行判断。
登录判断的核心是目标内容是否拿到:先尝试获取目标内容并持续执行,结合领域知识与页面实际反馈判断;即使页面显示登录提示,只要目标内容已取得就不打扰用户;仅在确认无法获取且推断登录可解决时,才提示用户在已打开的 Chrome 窗口中登录,登录完成后无需重启浏览器,直接继续原任务。任务结束后,若浏览器为本次启动,必须用 close-browser.sh 关闭,勿直接 kill 以免留下崩溃窗口。
特殊任务规则包括:核实任务以一手来源为目标,搜索仅用于定位来源而非证明真伪,政策法规查发布机构官网、企业公告查官方新闻页、学术声明查原始论文或机构官网;找不到官网时可用权威媒体原创报道作为次级依据并向用户说明转述误差可能。对工具能力边界有疑问时,应先查官方文档,必要时查看源码,不猜测、不把不确定性转移给用户。References 索引提供 commands.md(需要不常用命令如 drag、storage、pdf 时加载)与 login-flow.md(需要了解登录流程细节时加载)。该技能暂未提供收费、价格、适用平台范围或效果数据等信息。