前言¶
用 BrowserSkill（bsk）做網頁抓取或瀏覽器自動化時，前置條件往往是：本機 Microsoft Edge 已打開，且 BrowserSkill 擴展已連上本地 daemon。定時腳本、流水線或無人值守任務很難在每次運行前讓人工去開瀏覽器；一旦未連接，常見報錯包括 “no browser is connected to the daemon” 或 browsers connected 0，後續 bsk navigate、bsk snapshot 等命令無法繼續。
BrowserSkill 本身側重瀏覽器內能力，不負責跨環境拉起瀏覽器進程。下面介紹 SkillHub 上的 BrowserSkill 瀏覽器自啓動器（座標 @user_656c2e70/bsk-browser-launcher）：在任務側做連接自檢、按需啓動 Edge，並約定退出碼，供各類 bsk 抓取 skill 複用。
這是什麼¶
BrowserSkill 瀏覽器自啓動器（bsk-browser-launcher，v1.0.0）是社區來源（community）的 Agent Skill，分類爲 data-analysis，由 SkillHub 用戶 user_656c2e70 發佈；標籤 requires_api_key=false，不依賴額外 API Key。
一句話定位：在自動化/抓取任務中自動拉起本機 Edge 與 BrowserSkill 擴展，並確保 daemon 已連接。它是通用基礎組件，只負責「讓瀏覽器可用」，不包含登錄、數據處理或發佈等業務邏輯。
官方頁面：SkillHub - BrowserSkill 瀏覽器自啓動器。API 入口：https://api.skillhub.cn/user_656c2e70/bsk-browser-launcher。
核心功能¶
依據 Skill 包內 SKILL.md 與 scripts/launch_browser.py，已覈實能力如下。
連接自檢與自動啓動¶
核心腳本爲 scripts/launch_browser.py，流程爲：
- 執行
bsk status，判斷是否已有瀏覽器連上 daemon； - 若未連接，啓動本機 Edge（擴展隨瀏覽器自啓並嘗試連接 daemon）；
- 輪詢等待連接（默認最長 40 秒，可用
--wait調整）； - 連接成功則退出碼
0並打印確認信息。
退出碼約定¶
| 碼 | 含義 | 建議處理 |
|---|---|---|
| 0 | 瀏覽器已連 daemon；若帶 --start-session 還會輸出 SESSION=<id> |
繼續抓取 |
| 3 | 在等待時間內始終未連上 | 降級（如 WebFetch）或標記待補抓，避免整鏈阻斷 |
| 4 | --start-session 下會話創建失敗或超時 |
重試或降級 |
會話創建輔助¶
可選參數 --start-session：在連接就緒後執行 bsk session start（腳本內帶超時），打印 SESSION=<id>，便於下游步驟直接 bsk navigate --session <id> 等操作。包內 references/bsk_notes.md 還整理了 daemon/擴展架構、SPA 導航超時後仍可 snapshot、Windows 中文編碼等與 bsk 自動化相關的注意點。
安裝與啓用¶
SkillHub 官方推薦讓 Agent 按安裝文檔處理，或本地使用 skillhub CLI。安裝前可先檢查 CLI：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔 執行完整安裝或僅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
# 僅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝本 Skill 時，必須用 --dir 指向當前 Agent 的 skills 目錄（否則默認落在 ./skills/ 且可能不被識別）。示例：
skillhub install @user_656c2e70/bsk-browser-launcher --dir <skills 目錄>
也可將以下提示交給 AI，讓其按同一文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_656c2e70/bsk-browser-launcher。
常見 skills 目錄（摘自 SkillHub 安裝文檔，以你本機 Agent 爲準）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
本 Skill 基於通用 SKILL.md 格式；安裝後 Agent 讀取該 Skill 即可按文檔調用 scripts/launch_browser.py。
典型用法¶
進入 Skill 目錄（或在工作區中引用該腳本路徑）後，先做連接自檢：
python scripts/launch_browser.py
若希望連上後順便創建會話並拿到會話 id，可執行：
python scripts/launch_browser.py --start-session
需要更長等待時間時（秒）：
python scripts/launch_browser.py --wait 60
帶會話的自動化最小骨架（與官方 SKILL.md 一致）：
python scripts/launch_browser.py --start-session # 輸出 SESSION=xxxx
# 解析出 id 後：
bsk navigate --session <id> "https://example.com/..."
bsk snapshot --session <id> > snap.txt
# ... 抓取處理 ...
bsk session stop <id>
在新建會跑 bsk navigate / bsk snapshot / bsk click 等的 skill 或腳本時，宜在業務邏輯之前先跑上述啓動步驟。
適用場景與注意¶
適合誰
- 已使用 BrowserSkill 做抓取或 UI 自動化，且任務需要無人值守或批量調度；
- 多個抓取類 Skill 共用同一套「瀏覽器就緒」前置，希望抽成獨立組件；
- 遇到 daemon 已運行但
browsers connected 0時，需要可腳本化的拉起與重試策略。
限制與注意
- 腳本通過
USERPROFILE解析路徑，默認查找~/.local/bin/bsk.exe與常見 Windows Edge 安裝路徑（C:/Program Files (x86)/Microsoft/Edge/...等）。非標準安裝位置需自行確認可執行文件是否存在。 - 當前實現面向 Windows + Edge +
bsk.exe的典型佈局；Linux/macOS 上若路徑不同，需按環境調整或手動保證瀏覽器與擴展已連接。 - 擴展連接是異步的，應由
launch_browser.py輪詢完成，調用方不必再寫固定sleep。 - Skill 不含業務憑證，僅做瀏覽器生命週期與連接管控；抓取與發佈仍應分離（例如發佈走開放 API 時不必強依賴瀏覽器登錄態）。
SkillHub 統計（以抓取資料爲準）：評分 100000，下載 18303 次，安裝計數 0；版本 1.0.0。
結尾¶
BrowserSkill 瀏覽器自啓動器把「Edge 已開、擴展已連 daemon」從人工前置變成可腳本化的一步，並通過退出碼和可選 SESSION= 輸出與下游 bsk 命令對齊。若你的 Agent 工作流裏已有 BrowserSkill 抓取任務，可先安裝該 Skill，再在任務開頭調用 launch_browser.py。
官方地址：https://www.skillhub.cn/skills/user_656c2e70/bsk-browser-launcher
