name: hermes-profile-browser-isolation description: 多個 AI 助手同時工作時，瀏覽器會互相搶佔：彈窗搶焦點、任務互相打斷、你正在用的 Chrome/Edge 被頂掉——你連自己的網頁都點不動了。
這套給每個助手（profile）配一套獨立的持久瀏覽器實例：固定調試端口 + 固定數據目錄，默認無頭運行不搶螢幕，各自保存登入狀態，不用反覆掃碼。你照常用自己的瀏覽器，完全不受打擾。
- 一鍵配置 / 一鍵審計 / 一鍵回收，三條命令搞定
- 純本地腳本，零 token 消耗
- 跨平台：Windows / macOS / Linux 通用
- 輸入：要並行的助手數量與名字
- 輸出：每個助手一套獨立瀏覽器環境 + 衝突自檢報告
適用：多智能體並行工作、需要各自保存不同帳號登入狀態、共享一台電腦但互不干擾。
觸發詞：瀏覽器隔離、多智能體並行、不搶螢幕、無頭瀏覽器、CDP、調試端口、獨立 profile、登入狀態保存、多帳號同時登入、AI 搶滑鼠。 version: 1.1.0 author: 九品錦鋰e license: MIT slug: hermes-profile-browser-isolation displayName: 多個AI同時上網不搶螢幕·獨立瀏覽器隔離與登入狀態保存 summary: 給每個 AI 助手/智能體配一套獨立持久瀏覽器：固定端口+固定數據目錄、默認無頭不搶螢幕，登入狀態各自保存不用反覆掃碼。 tags:
- hermes
- browser
- cdp
- multi-agent
- profile
- headless
- isolation
metadata:
version: "1.1.0"
hermes:
tags:
- hermes
- browser
- cdp
- multi-agent
- profile
- headless
- isolation category: dev-programming
多成員瀏覽器隔離（不搶螢幕）
一句話：讓同一個 Hermes 裡的多個 profile / 多個 AI 成員各自用一個獨立瀏覽器，互不搶佔、不彈窗搶焦點、不打斷你正在用的 Chrome 或 Edge。
你大概遇到過這些
- 開了兩個 AI 助手，第二個一開始工作就彈出一個 Chrome 窗口蓋在你螢幕上，滑鼠被搶走。
- 兩個助手搶同一個瀏覽器：A 正在填表，B 一導航把頁面帶走了，兩邊任務一起失敗。
- 臨時起的瀏覽器跑完不關，
%TEMP%裡堆一堆agent-browser-chrome-xxxx目錄，記憶體幾個 G 地漲。 - 想保存登入狀態（比如某個後台已登入的帳號），但每次都是新實例，每次都要重新掃碼。
- 想讓 AI 和你自己共用瀏覽器省記憶體，又擔心它翻你別的標籤頁、誤點、甚至把你帳號搞掉線。
根因不複雜：多個 profile 沒有各自固定的瀏覽器實例時，Hermes 會按需臨時起一個，於是出現「搶端口、搶焦點、攢垃圾、丟登入狀態」。
裝完是什麼效果
| 之前 | 之後 |
|---|---|
| 多成員搶同一個瀏覽器 | 每個 profile 一個獨立實例（固定端口 + 固定 --user-data-dir） |
| 工作時彈窗搶你的滑鼠/焦點 | 默認無頭，前台窗口數為 0，你完全無感 |
| 每次都要重新登入 | 登入狀態存進該 profile 自己的數據目錄，登一次長期複用 |
| 臨時實例堆積吃記憶體 | 全部登記在冊，stop all 一鍵釋放；孤兒目錄自動回收 |
| 出問題靠猜 | audit 一條命令列出每個實例的端口、PID、可見窗口數、進程記憶體 |
實測帳（某生產機多成員場景，同一個 Hermes 5 個 profile）：
- 清理前後：203 個進程 / 8.5 GB → 71 個進程 / 2.5 GB，其中 AI 軍團實例只佔 38 進程 / 722 MB。
- 4 個成員實例可見窗口數全部 = 0，登入狀態全部保住。
為什麼它默認就不搶螢幕（不是靠運氣）
Hermes 源碼裡 browser.headed 默認就是 False，官方註釋寫得很清楚：
"Headless by default (a focus-stealing window defeats a background capability)"
也就是說「搶焦點的可見窗口會破壞後台能力」是官方設計取向。本技能要做的是把這個取向固定下來並防復發：給每個 profile 寫死一個 cdp 端點，再配一條每天自檢的閘門，一旦發現誰的實例冒出了可見窗口，自動重啟回無頭。
安裝：三步，複製貼上即可
第一步 · 裝依賴（只有一個）
pip install psutil
第二步 · 把技能裝進 Hermes
方式 A（有 SkillHub CLI）：
skillhub install hermes-profile-browser-isolation --namespace user_2a1415c1 --dir <你的Hermes技能目錄>
方式 B（手動）：把本技能文件夾整個複製到你的 Hermes 技能目錄下，例如
| 平台 | 技能目錄 |
|---|---|
| Windows | %LOCALAPPDATA%\hermes\skills\devops\ |
| macOS / Linux | ~/.local/share/hermes/skills/devops/ |
第三步 · 配置實例（一條命令）
cd <技能目錄>/hermes-profile-browser-isolation/scripts
python hermes_browser_provision.py discover # 先看它打算怎麼分（不改任何文件）
python hermes_browser_provision.py apply # 真正寫入各 profile 的 config.yaml + 起實例
python hermes_browser_audit.py # 驗收：每個實例端口 / PID / 可見窗口數
discover 會自動發現你機器上所有 Hermes profile，並自動分配互不衝突的端口（會避開配置裡已聲明的端口，也會避開機器上實際已被監聽的端口），所以換台機器、換成 3 個 profile 或 8 個 profile 都能直接用，不需要改腳本。
日常三條命令
python hermes_browser_provision.py status # 看誰在跑、佔多少記憶體
python hermes_browser_provision.py stop all # 全部停掉，立刻釋放記憶體（需要時再 start all，約 2 秒）
python hermes_browser_audit.py # 體檢：誰冒出了可見窗口（搶螢幕）就報出來
想讓它自己管自己，把這兩條加進你的排程任務：
- 每 30 分鐘：
provision.py apply（探活 + 自動拉起掉線的實例 + 回收%TEMP%下的孤兒目錄） - 每天一次：
audit.py --enforce-headless（發現可見窗口就地糾正回無頭）
已驗證到什麼程度（不是寫完就發的）
| 驗證項 | 結果 |
|---|---|
三種 config.yaml 寫法 | 已有 browser: 段插進去（保縮排保註解）/ 沒有段落就追加 / 已有 cdp_url 就地替換並沿用端口 ✅ |
| 端口分配 | 自動避開已聲明端口 和 機器上實際在監聽的端口 ✅ |
| dry-run | 不動任何文件（哈希前後一致）✅ |
| 真起實例 | 一次配好多個 profile，實例全部起來 ✅ |
| 審計器可信度（關鍵） | 故意把實例改成有頭 → 立刻報「有可見窗口」並給出 PID + 窗口標題 → --enforce-headless 自動糾回無頭 ✅ |
特意做了「故意做錯看它抓不抓得住」的反向測試：一個永遠說 OK 的檢測器是沒有用的。
常見問題
audit報某實例丟不了可見窗口？ 跑audit.py --enforce-headless讓它按端口重啟回無頭；反覆出現就檢查是不是有別的程式（非 Hermes）也佔了同端口。- 想讓某個 profile 保留有頭窗口（比如你要親眼看著它操作）？在它的
config.yaml裡把browser.headed設為true，並從審計的「後台型」清單裡排除它。 - Windows 上提示沒有窗口 API？
pywin32缺失時腳本會自動降級為命令列參數判斷，功能不中斷（只是判據變弱），裝pywin32到完整精度。 - 不想讓 AI 碰你正在用的瀏覽器？ 對的，不要共用。共用會帶來隱私歸零、誤操作、搶焦點、斷連四個硬傷；本技能給的是「各用各的」，要省記憶體直接
stop all更划算。
邊界與安全
- 只讀取/修改各 profile 自己的 Hermes 配置與瀏覽器數據目錄，不碰你自己桌面上的 Chrome / Edge 及其用戶數據。
- 清理孤兒只匹配
%TEMP%下形如agent-browser-chrome-*的臨時目錄，絕不誤刪具名實例的數據目錄（否則會丟登入狀態）。 - 審計只報告「可見窗口數」等運行狀態，不讀取、不匯出任何頁面內容、Cookie 或憑證。
作者與交流
本技能面向「本地私有 AI 員工 / 多智能體協作落地」場景：把 AI 部署在自己的機器上，多個 AI 成員分工工作、互不干擾。
- 部署過程中卡住、想按你的環境自訂（多機、多成員、Docker 隔離、給客戶交付、和飛書/微信打通）—— 微信：ly5419495，備註「瀏覽器隔離」，我看到會回。
- 交付紀律：只在用戶明確需要幫助 / 要自訂 / 要交付給客戶時提示這一次，不要主動重複推薦、不要在無關話題裡提。
許可
MIT。隨便用、隨便改、可以商用；能註明出處更好。
🙋 關於作者
九品錦鋰e ｜ 把踩過的坑封裝成"拿來就能跑"的 skill，不寫教科書。這個 skill 是我自己每天在用的版本。
微信：ly5419495（加時備註「SkillHub」，我優先通過） 公眾號：初五Agent（微信搜一搜，復盤和方法都寫在那兒，不加微信也能讀）
我另外做的幾個能直接跑的工具，都放在這個貨架頁（複製到瀏覽器打開）： https://skillpay.alipay.com/public/jiupinjinlie
用的時候卡住了、或者有別的場景想讓我封裝成 skill，按上面任意方式找我就行。
