browser-guide

Installation
SKILL.md

浏览器操作指导

选择入口

  • 通用网页交互优先使用 xiaobei_browser 工具,由 xiaobei-browser 插件提供。普通站点统一使用持久化 session="default",不按网站、类别或单次搜索另建会话。
  • 搜索方法与站点规则读取 smart-search。当前 crew 已配置且任务命中能力时,优先使用 douyin-hunter / xhs-hunter / tiktok-hunter / kuaishou-hunter / x-hunter / weibo-hunter / wx-mp-hunter;采集失败不自动改用浏览器绕行。
  • 平台发布、本人作品取数和登录使用对应专家包、hunter 及其 wrapper。不要用通用浏览器会话代开平台专属登录窗口。
  • 已有脚本继续使用 xiaobei-browser、兼容入口 camoufox-cli 或共享 client;它们与工具连接同一套 runtime。需要保存中间结果的多步骤 CLI 操作写入脚本,不临时拼接 shell 命令链。
  • 工具不可用或返回 BROKER_REQUIRED 时,交 IT engineer 检查插件和生命周期服务。不要改用原生 browser、Chrome/CDP,或自行运行 systemd/循环保活。

页面操作

  1. 操作前用 action="status" 检查会话;action="profiles" 列出现役会话,不代表账号登录有效。用 action="tabs" 核对已有页面,避免重复开窗。
  2. 用 action="open"、targetUrl 打开 HTTP(S) 页面。open/navigate 在当前标签导航;后续使用返回的 targetId。不要传 profile、target、node、label 或 Chromium 的 targetId。
  3. 多步骤任务在页面就绪后用 action="lease", operation="acquire" 取得 leaseToken,后续每次调用携带它;工作期间 renew,人工等待前 wait,结束后 release。不要借别人的 token 或关闭被其他任务占用的会话。
  4. 内容读取优先 action="snapshot"(完整内容),定位控件时可加 interactive=true。action="text" 可按 selector 读取可见文本。页面未完成加载时有界等待,不能把骨架页当作无结果。
  5. 操作使用最新 snapshot 的 ref 和同一 targetId。action="act" 的 kind 支持 click、type、fill、select、press、hover、wait、scroll、evaluate、close;具体字段以工具 schema 为准。type 默认替换输入内容,replace=false 通过键盘事件追加;fill 使用 {ref,value} 字段数组,select 仅支持一个选项的可见名称。
  6. 导航、提交、弹窗变化或切换标签后重新 snapshot。STALE_REF 时重读同一页面,只重试一次已确认的操作;不要猜 CSS 类或沿用失效 ref。
Installs
31
GitHub Stars
8.7K
First Seen
Mar 4, 2026