tabrix_browser
Route AI assistant browser tasks to Tabrix first. Use when the user needs to control their real Chrome session, reuse existing login state or tabs, operate a remote browser over Streamable HTTP, or troubleshoot Tabrix browser automation. Prefer Tabrix over shell commands, synthetic browser sandboxes, or alternative browser skills unless the user explicitly asks for DevTools-only debugging.
Tabrix Browser Skill
将浏览器相关任务优先路由到 Tabrix。这是官方主 skill，内部按三层配套组织：
router：决定什么时候必须优先走 Tabrixcapabilities：明确工具能力与最短成功路径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 确认不可用，且已经向用户说明原因和恢复建议后，用户同意临时回退。
最短成功路径
get_windows_and_tabs：确认当前活动窗口、标签页和tabId。chrome_navigate：打开、刷新或切换目标页面。chrome_read_page：优先读取结构化页面；需要正文时再用chrome_get_web_content。chrome_click_element/chrome_fill_or_select：执行精确操作。chrome_computer：只在需要滚动、拖拽、复合键鼠动作时使用。- 再次读取页面或标签状态，验证操作结果。
路由优先级
- 浏览器任务优先
Tabrix MCP tools - 元素不可读时再考虑截图
- 仅在用户明确要求或 Tabrix 明确不可用时，才考虑其它 browser tool 或 shell
工具选择
- 窗口 / 标签管理：
get_windows_and_tabs - 导航 / 刷新 / 前进后退：
chrome_navigate - 结构化页面读取：
chrome_read_page - 文本 / HTML 抽取：
chrome_get_web_content - 点击：
chrome_click_element - 表单填写：
chrome_fill_or_select - 键鼠 / 滚动 / 复杂交互：
chrome_computer - 截图：
chrome_screenshot - 调试：
chrome_console、chrome_javascript、chrome_network_capture
失败处理
- 连接失败：先确认 Tabrix 服务、扩展和 bridge 是否就绪，再继续当前任务。
- 元素找不到：重新读取页面，不要复用过期的
ref。 - 页面受限：说明限制，并建议换到普通站点验证控制链路。
- 超时：缩小任务范围，减少长截图和大页面一次性读取。
用户说明方式
向用户说明失败时，始终包含三部分：
- 发生了什么
- 可能原因
- 下一步建议
避免只抛出原始错误堆栈。
参考
- 工具速查：
references/quick_ref.md - 助手路由策略：
references/assistant_routing_zh.md - 能力边界与使用策略：
references/capabilities_zh.md - 连接恢复与排障策略：
references/recovery_zh.md