前言¶
自動化測試裏常見的一處死結:瀏覽器已經起來了,調試通道卻接不上去。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 |
說明:項目頁抓取失敗,上表中的數據來自預抓取的官方地址元信息,截至成稿時的頁面數據可能已有變化。
核心功能¶
只做一件事,鏈路分三步:
- 讀取 Tabbit 實時生成的 DevToolsActivePort 文件。
- 從文件內容推導出瀏覽器的 wsEndpoint。
- 把後續瀏覽器操作統一路由到
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