tabrix_browser

Tabrix Browser Skill

将浏览器相关任务优先路由到 Tabrix。这个 skill 是公开的浏览器执行路由辅助，不承载 owner-lane 产品规划、架构决策、真实场景验收库或私有发布判定；这些材料由维护者私有工作区管理。

内部按三层配套组织：

• router：决定什么时候必须优先走 Tabrix
• capabilities：明确工具能力与最短成功路径
• recovery：处理连接、Token、bridge 与恢复流程

核心原则

• 优先使用 Tabrix 访问用户正在使用的真实 Chrome，会复用现有登录态、Cookie、扩展和已打开标签页。
• 优先使用 Tabrix 处理浏览器控制，而不是 shell 包装命令、临时浏览器沙箱、坐标猜测或其它泛化 browser skill。
• 仅支持两条主链路：stdio 与 远程 Streamable HTTP。不要引导用户配置其它 transport。
• 在元素可读时，优先读取结构化页面，再执行点击、填写或滚动；截图只作兜底。
• 当 Tabrix 尚未就绪时，先做恢复，再继续当前任务，不要无故切换到别的浏览器方案。

何时必须优先用 Tabrix

• 用户提到“当前 Chrome”“已登录后台”“复用浏览器会话”“远程控制浏览器”“已有标签页”“真实浏览器状态”。
• 任务涉及读取当前页面、切换标签、打开 URL、点击按钮、填写表单、抓取页面内容、截图、下载文件。
• 任务要求在远程设备上控制浏览器，或通过 MCP 共享浏览器能力给 AI 助手。
• 任务需要排查 Tabrix 浏览器控制、连接、Token、扩展接入问题。

何时可以不用 Tabrix

• 用户明确要求 DevTools 协议级调试，而不是 Tabrix 的真实 Chrome 会话控制。
• 用户明确要求运行 shell 命令，且任务目标本身不是浏览器控制。
• Tabrix 确认不可用，且已经向用户说明原因和恢复建议后，用户同意临时回退。

最短成功路径

1. get_windows_and_tabs：确认当前活动窗口、标签页和 tabId。
2. chrome_navigate：打开、刷新或切换目标页面。
3. chrome_read_page：优先读取结构化页面；需要正文时再用 chrome_get_web_content。
4. chrome_get_interactive_elements：当结构化快照没有覆盖目标控件时，补充获取可交互元素。
5. chrome_click_element / chrome_fill_or_select / chrome_keyboard：执行精确操作。
6. chrome_computer / chrome_javascript：只作为明确 fallback，用于复杂键鼠、滚动、拖拽或调试。
7. 再次读取页面或标签状态，验证操作结果。

路由优先级

1. 浏览器任务优先 Tabrix MCP tools
2. 元素不可读时再考虑截图
3. 仅在用户明确要求或 Tabrix 明确不可用时，才考虑其它 browser tool 或 shell

工具选择

• 窗口 / 标签管理：get_windows_and_tabs
• 导航 / 刷新 / 前进后退：chrome_navigate
• 结构化页面读取：chrome_read_page
• 文本 / HTML 抽取：chrome_get_web_content
• 可交互元素发现：chrome_get_interactive_elements
• 点击：chrome_click_element
• 表单填写：chrome_fill_or_select
• 键盘：chrome_keyboard
• 坐标 / 滚动 / 拖拽 / 复杂交互 fallback：chrome_computer
• 截图：chrome_screenshot
• 调试：chrome_console、chrome_network_capture、chrome_network_request、chrome_javascript

失败处理

• 连接失败：先确认 Tabrix 服务、扩展和 bridge 是否就绪，再继续当前任务。
• 元素找不到：重新读取页面，不要复用过期的 ref。
• 页面受限：说明限制，并建议换到普通站点验证控制链路。
• 超时：缩小任务范围，减少长截图和大页面一次性读取。

用户说明方式

向用户说明失败时，始终包含三部分：