mcpField
T
tabbit-devtools

tabbit-devtools

github.com/tabbit-browserAgent 工作流46154 次安装24 周前更新
代码仓库

关于 tabbit-devtools

tabbit-devtools 是用于将 agent-browser 连接到 Chromium 浏览器 Tabbit 的 Agent 技能。它负责发现 Tabbit 的 DevTools WebSocket 端点，之后将浏览器操作交给标准 agent-browser 工作流。

主要功能

  1. 01查找 Tabbit 的 DevToolsActivePort 文件
  2. 02推导浏览器 WebSocket 端点
  3. 03提供端点发现与浏览器封装脚本
  4. 04将操作交给 agent-browser

适用场景

  1. 01将 agent-browser 连接到 Tabbit 会话
  2. 02获取结构化的 Tabbit 连接信息

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tabbit-browser/tabbit-devtools-skill --skill tabbit-devtools

安装后在 Claude Code 中输入/tabbit-devtools确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
discovery.md
setup.md
scripts/
discover_tabbit_cdp.py
read_current_tabbit_page.py
run_agent_browser_on_tabbit.py

详细介绍

Tabbit 开发工具

当请求明确涉及 Tabbit，或包含 用我的 tabbit 浏览器、在 Tabbit 里、Tabbit 当前页 或 Tabbit 当前标签 等表述时，优先使用此技能。

将 Tabbit 视为基于 Chromium 的浏览器。 此技能介绍如何将 agent-browser 连接到 Tabbit。 建立连接后，使用常规的 agent-browser 工作流进行浏览器自动化和检查。 不要在此技能中实现并行的浏览器自动化层、桥接守护进程或自定义 CDP 客户端。

agent-browser 快速参考

在发现 Tabbit 端点后，将 agent-browser 作为浏览器操作层。

此技能最相关的命令包括：

  • open <url>
  • snapshot -i
  • click @e3
  • fill @e5 <text>
  • press Enter

请勿在此处复述完整的 agent-browser 手册。处理 Tabbit 任务时，默认使用这些命令；如需了解更多命令，请优先参考官方 README。

快速路径

  1. 检测平台并搜索 DevToolsActivePort：
    • macOS：先查找 ~/Library/Application Support/Tabbit/DevToolsActivePort，再查找 ~/Library/Application Support/Tabbit Browser/DevToolsActivePort
    • Windows：先查找 %LOCALAPPDATA%\Tabbit Browser\User Data\DevToolsActivePort，再查找 %APPDATA%\Tabbit\User Data\DevToolsActivePort
  2. 使用文件中的两行内容：
    • 第 1 行：TCP 端口
    • 第 2 行：浏览器路径，例如 /devtools/browser/<id>
  3. 将完整的浏览器端点构造为 ws://127.0.0.1:<port><path>。
  4. 优先使用该 wsEndpoint，而不是 http://127.0.0.1:<port>。Tabbit 可能会开放浏览器 WebSocket，但 /json/version 和 /json/list 仍会返回 404。
  5. 实际执行浏览器操作时，优先使用 scripts/run_agent_browser_on_tabbit.py。它会将实时的 wsEndpoint 注入 agent-browser --cdp ...。
  6. 仅需结构化连接信息时，使用 scripts/discover_tabbit_cdp.py。
  7. 连接后，使用完整的常规 agent-browser 工作流执行页面操作。

工作流

  1. 对于 Tabbit 请求，先直接读取 DevToolsActivePort，或运行 scripts/discover_tabbit_cdp.py。
  2. 返回 Agent 实际需要的连接信息：activePortFile、port、browserPath、browserUrl 和 wsEndpoint。
  3. 除非用户明确只询问端点详情，否则优先立即使用 scripts/run_agent_browser_on_tabbit.py，使命令变为 agent-browser --cdp <wsEndpoint> ...。
  4. 移交后，按照常规的 agent-browser 工作流执行打开、快照、点击、填充及其他浏览器命令。
  5. 如果无法使用 agent-browser，请直言说明，并提供连接信息，不要自行编造 CDP 桥接方案。

指引

  • 此技能解决的是连接问题，而非一般的浏览器操作问题。
  • 先返回结构化连接数据，再补充简短说明。
  • 优先选择最轻量的发现路径：DevToolsActivePort 以及由此推导出的浏览器 WebSocket 端点。
  • 在 macOS 上先搜索 Tabbit 支持目录，再搜索 Tabbit Browser。在 Windows 上先搜索 %LOCALAPPDATA%\Tabbit Browser\User Data，再搜索 %APPDATA%\Tabbit\User Data。
  • 优先使用完整的 wsEndpoint，而非原始端口，因为 Tabbit 可能不会开放 HTTP 发现路由。
  • 通过 run_agent_browser_on_tabbit.py 启动 Tabbit 任务后，除非用户明确要求改用其他方式，否则后续任务都继续使用同一包装脚本路径。
  • 连接后，其他所有操作均使用标准的 agent-browser 模式。

限制

  • 不要假设存在专用的 tabbit-devtools MCP 服务。
  • 不要假设通用的 chrome-devtools 会话可以重新指向 Tabbit。
  • 不要将此技能变成 agent-browser 的替代品。
  • 不要为连接后的浏览器操作创建自定义守护进程、长期运行的 CDP 代理或一次性的 WebSocket 客户端。
  • 不要承诺 chrome-devtools MCP 会自动接管 Tabbit。
  • 如果无法在当前环境中启动 agent-browser，请停留在连接说明这一步，并解释限制。
  • 连接后，浏览器工作流由 agent-browser 负责，而不是由此技能负责。

资源

评论

支持 Markdown