前言¶

在 DeepSeek Harness（DSH）裏做瀏覽器相關任務時，如果 AI 只能在後臺操控瀏覽器，操作過程不容易直接覈對。dsh-browser-control 提供一條更直觀的路徑：讓 AI 操控一個真實、可見的 Chrome 瀏覽器，並在對話 GUI 裏實時看到每一步操作。

下面介紹這個插件的定位、核心能力、安裝方式和典型用法。

這是什麼¶

dsh-browser-control 是 kyo615 維護的 DeepSeek Harness 插件，許可證爲 MIT，版權歸 kyo615 所有。

它的一句話定位是：讓 DeepSeek Harness 裏的 AI 操控一個真實、可見的 Chrome 瀏覽器，並在對話 GUI 裏實時看到每一步操作。

插件基於 microsoft/playwright-mcp，通過 MCP stdio 連接。它只調用 DSH / Cordis 的公開插件 API，不包含、不修改它們的源碼。

核心能力¶

真實有頭 Chrome¶

插件使用真實有頭 Chrome，不是無頭瀏覽器。AI 執行鼠標移動、輸入、點擊等操作時，桌面上可以直接看到瀏覽器裏的實際動作。

面向 AI 的 browser_* 工具¶

插件會把約 80 個 browser_* 工具註冊給 AI，例如：

• browser_navigate
• browser_click
• browser_type
• browser_snapshot
• browser_press_key
• browser_mouse_click_xy
• browser_tabs
• browser_evaluate

這些工具用於完成網頁導航、點擊、輸入、按鍵、標籤頁管理和腳本執行等任務。

GUI 內嵌即時畫面¶

每次 AI 動作後，插件會截圖到 live.png，並通過宿主 HTTP 路由 /dsh-browser/shot.png 刷新到對話面板。

面板截圖上的數字方框，對應 AI 可點擊的元素編號。這樣可以在對話 GUI 裏同時看到瀏覽器畫面和 AI 正在操作的元素位置。

面板可操作¶

對話面板支持以下操作：

• 網址欄跳轉
• 刷新畫面
• 重啓瀏覽器
• 關閉瀏覽器

零硬編碼路徑¶

插件聲明爲零硬編碼路徑，所有路徑自動探測或可配置。使用時不需要手工拼本機絕對路徑。

安裝與啓用¶

先確認運行環境：

• DeepSeek Harness，或兼容其動態 Cordis 插件機制的環境
• Node.js ≥ 18
• 系統已安裝 Google Chrome（或 Edge）

先執行安裝命令：

dsh plugin add https://github.com/kyo615/dsh-browser-control

安裝後，還需要在對應工作區執行依賴安裝：

npm install @playwright/mcp

如果使用動態插件方式，即通過 cordis_define / cordis_run 定義和運行，則它是進程級的：DSH 重啓後需要重新定義與運行。Client 部分需要授權。

典型用法¶

經過上面的步驟後，可以使用以下方式觸發瀏覽器操作。

1、直接對 AI 說：

• 打開某網站
• 搜索某某
• 幫我操作網頁

2、在面板的網址輸入框輸入網址，執行跳轉。

3、如果瀏覽器未運行，AI 可以調用 browser_status，並帶 start: true，自行拉起瀏覽器。

4、通過面板執行畫面刷新、重啓瀏覽器或關閉瀏覽器。

適用場景與注意¶

適合在 DSH 對話中執行網頁導航、搜索、點擊、輸入等操作，並希望看到真實瀏覽器畫面的場景。

使用前需要注意：

• 插件允許 AI 操控瀏覽器執行真實操作，需要自行負責網站條款、登錄態、自動化訪問限制等合規性。
• 使用前應檢查源碼和許可證，並確認當前 DSH 進程的權限範圍、可用資源和目標網站訪問限制。
• 第三方依賴包括 microsoft/playwright-mcp、Playwright 等，涉及 Apache-2.0 許可證，詳見倉庫中的 THIRD_PARTY_NOTICES。
• 動態插件方式在 DSH 重啓後需要重新定義與運行。

相關鏈接¶

GitHub 倉庫：

https://github.com/kyo615/dsh-browser-control