前言¶

在 DSH 中使用 Agent 操作瀏覽器時，通常不只要能調用工具，還要明確哪些操作允許、哪些操作必須本地確認、憑據放在哪裏。@puxora/dsh-browserpilot 是 BrowserPilot 的獨立 DSH 雙端插件：Host 端將 BrowserPilot MCP 工具提供給 Agent，Web 端提供專屬設置入口、權限策略和管理面板按鈕。

這是什麼¶

它是 @puxora/dsh-browserpilot，由 Puxora 維護，許可證爲 MIT。

它解決的是 DSH Agent 使用本機 Chrome 的接入問題：Host 端提供 MCP 工具，Web 端提供設置、權限策略和管理面板入口。

本插件不會把令牌、Cookie 或瀏覽器憑據保存到 DSH。

核心功能¶

• 本機 Chrome 控制：讓 DSH Agent 通過 BrowserPilot 使用本機 Chrome。
• 分級權限：對瀏覽器操作進行分級限制；DSH 本地策略只能進一步限制，不能放寬 BrowserPilot 全局策略。
• 本地最終確認：保留本地最終確認環節。
• 連接診斷：調用 browserpilot_status 查看連接狀態。
• 管理面板入口：從 DSH 設置打開本地管理面板。

安裝與啓用¶

1、準備 BrowserPilot 本地橋接¶

先註冊當前 Windows 用戶的 Chrome Native Messaging Host：

browserpilot install

命令輸出中會給出 chrome-extension 目錄，下一步需要在 Chrome 中加載該目錄。

在 Chrome 開發者模式下，加載 browserpilot install 輸出的 chrome-extension 目錄。

啓動並查看狀態：

browserpilot start
browserpilot status

2、安裝 DSH 插件¶

執行：

dsh plugin --profile web add @puxora/dsh-browserpilot@latest

如果使用本地開發安裝，命令中包含示例路徑 G:/github/dsh-browserpilot，需要替換爲本地倉庫路徑。

典型用法¶

1、打開設置 → BrowserPilot，確認啓用瀏覽器工具已開啓。

2、在 DSH 中調用 browserpilot_status。

3、狀態爲 connected 後，使用以 mcp__browserpilot__ 開頭的瀏覽器工具。

設置與權限¶

• 本插件不會把令牌、Cookie 或瀏覽器憑據保存到 DSH。
• DSH 本地策略只能進一步限制，不能放寬 BrowserPilot 全局策略。
• 敏感操作在 DSH 內禁止，包括上傳、下載、腳本、Cookie 與憑據相關操作。
• 插件每 3 秒同步一次全局值；daemon 不可用時，全局控件會變爲只讀。
• 連接握手默認超時爲 12 秒，單次工具調用默認超時爲 60 秒。

管理面板¶

設置頁中的管理面板按鈕會打開：

http://127.0.0.1:9876/

適用場景與注意¶

適合 DSH / 智能體開發者：需要在 DSH 中讓 Agent 操作本機 Chrome，同時保留本地確認和敏感操作限制。

注意：該插件以當前 DSH 進程權限運行。安裝前應檢查源碼與許可證。

源碼倉庫：https://github.com/Puxora/dsh-browserpilot。

許可證：MIT。

鏈接¶

GitHub：https://github.com/Puxora/dsh-browserpilot