tabbit-devtools-wbversion:把 Tabbit 的 DevTools 端口接進 agent-browser

前言

自動化測試裏常見的一處死結:瀏覽器已經起來了,調試通道卻接不上去。agent-browser 走的是 CDP,Tabbit 自己起的瀏覽器也確實開了遠程調試,但兩邊的 wsEndpoint 對不上,腳本只能停在「瀏覽器已打開」這一步,後面的點擊、斷言全做不了。tabbit-devtools-wbversion 就是用來把這一層打通的。

下面介紹這個 Skill 的定位、它能做什麼,以及接入時需要注意什麼。

這是什麼

一句話定位:一個把 Tabbit 運行時的 DevTools 端口解析成 wsEndpoint、再交由 agent-browser 通過 --cdp 複用的適配 Skill。

基本信息如下。

項 值
Skill 名稱 tabbit-devtools-wbversion
座標 @user_060bc032/tabbit-devtools-wbversion
版本 1.0.0
來源 community
分類 ai-agent
發佈者 user_060bc032
是否需要 API Key 否(requires_api_key=false)
評分 100000
下載 1296
安裝 13

說明:項目頁抓取失敗,上表中的數據來自預抓取的官方地址元信息,截至成稿時的頁面數據可能已有變化。

核心功能

只做一件事,鏈路分三步:

  1. 讀取 Tabbit 實時生成的 DevToolsActivePort 文件。
  2. 從文件內容推導出瀏覽器的 wsEndpoint。
  3. 把後續瀏覽器操作統一路由到 agent-browser --cdp。

關鍵在於第 1 步:Chromium 系瀏覽器啓動時會在用戶數據目錄裏寫出一個 DevToolsActivePort 文件,裏面記錄了調試監聽的端口。直接讀這個文件,就不必去猜端口號、也不必讓兩套工具各自再起一份瀏覽器。第 2、3 步則是把讀出來的地址格式化成 agent-browser 能接受的 CDP 參數,之後的頁面操作全部走這一條通道。

這樣做的好處是複用同一個瀏覽器實例:Tabbit 負責頁面狀態,agent-browser 負責驅動,不用爲了拿調試權限再開一個窗口。

安裝與啓用

該 Skill 屬於通用 SKILL.md 格式,目錄結構上是一個包含 SKILL.md 的文件夾,SKILL.md 的 frontmatter 裏給出 name 和 description。

官方地址:

https://api.skillhub.cn/user_060bc032/tabbit-devtools-wbversion

SkillHub 頁面:

https://www.skillhub.cn/skills/user_060bc032/tabbit-devtools-wbversion

說明:本次嘗試抓取上述兩個地址均失敗,因此無法覈實頁面上給出的具體安裝命令、目錄路徑或宿主工具(Cursor / Codex CLI / Claude Code)的差異說明。請以官方地址頁面上的指引爲準,不要照抄第三方示例。

按通用 SKILL.md 的約定,啓用方式是把 Skill 目錄放進宿主工具能掃描到的 skills 路徑,然後在會話裏直接觸發。該 Skill 標記爲 requires_api_key=false,不需要額外申請密鑰。

典型用法

官方簡介裏給出的可復現鏈路如下。

第一步,確認 Tabbit 已經啓動,並且用戶數據目錄裏存在 DevToolsActivePort 文件:

ls -l <tabbit-user-data-dir>/DevToolsActivePort

第二步,讀取文件內容。文件第一行是監聽地址與端口,據此拼出 wsEndpoint。

第三步,把推導出的 wsEndpoint 交給 agent-browser:

agent-browser --cdp <wsEndpoint> <action>

完成前兩步後,agent-browser 的所有瀏覽器操作都走這條 CDP 通道,不需要再單獨啓動瀏覽器。

以上步驟的先後順序和參數佔位來自官方簡介描述,具體路徑需按你本機 Tabbit 的實際用戶數據目錄替換。

適用場景與注意

適合這類人:已經在用 Tabbit 起瀏覽器,同時希望用 agent-browser 做頁面驅動,並且能接受調試端口已被佔用的情況。

需要注意的幾點:

  • DevToolsActivePort 是運行時文件,只在瀏覽器啓動後存在。讀它之前先確認 Tabbit 已經起來,否則會拿到空值或不存在的路徑。
  • wsEndpoint 必須由實際讀到的端口拼出來,不要硬編碼端口號,重啓後端口可能變化。
  • Tabbit 與 agent-browser 必須指向同一個瀏覽器實例,否則會出現「Tabbit 看到的頁面」和「agent-browser 操作的頁面」不一致。
  • 該 Skill 來自 community 來源,安裝量較小(13 次),接入前建議先在一個非生產環境裏驗證一遍。
  • 頁面信息未能覈實,版本號、發佈者等元數據以官方地址爲準。

結尾

這個 Skill 的價值在於它只解決一個窄問題:從 DevToolsActivePort 推導 wsEndpoint,然後讓 agent-browser 走 --cdp。鏈路短、職責單一,不需要額外密鑰。如果你正好卡在「Tabbit 起來了但調試通道接不上」這一步,可以從官方地址先看一遍安裝說明。

官方地址:https://api.skillhub.cn/user_060bc032/tabbit-devtools-wbversion

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜