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