前言¶
下面介紹一個用於 DeepSeek Harness（DSH）的瀏覽器自動化插件：dsh-browseruse。
它解決的問題是讓 DSH 中的模型能夠完成網頁操作：打開頁面、讀取頁面、點擊、輸入、滾動、切換標籤頁，並在多步任務中根據頁面狀態決定下一步。與直接操作日常瀏覽器不同，它通過 playwright-core 驅動一個專用 Google Chrome 實例，使用獨立資料目錄和 cookie 持久化，目標是完成瀏覽器任務的同時不影響日常使用的 Chrome。
這是什麼¶
dsh-browseruse 是 DSH 插件，許可證爲 MIT，純 JavaScript 實現，無構建步驟。
它需要本機已安裝 Google Chrome，並通過 CDP 連接已安裝的 Chrome，不下載瀏覽器二進制。倉庫地址爲：
https://github.com/yzd6552-commits/dsh-browseruse#readme
已覈實事實中，倉庫 owner 爲 yzd6552-commits；資料中的 contributors 寫爲 DeepSeek Harness Agent (deepseek-v4-pro)，但未直接標明其維護者身份。
安裝與啓用¶
前置條件¶
安裝前需要滿足以下條件：
1、本機裝有 Google Chrome。
2、harness 內嵌 Node.js 版本滿足 Node >= 20。
本插件與 playwright-core 均要求 Node >= 20。插件運行在 harness 內嵌 Node 上；如果內嵌 Node 低於 20，資料建議先升級 DSH，不要強行安裝。
安裝命令¶
已覈實的安裝命令爲：
dsh plugin --profile web add github:yzd6552/dsh-browseruse
需要注意的是，已覈實資料中的安裝命令使用 github:yzd6552/dsh-browseruse，而 GitHub 倉庫地址爲 yzd6552-commits/dsh-browseruse；兩者 owner 不一致，當前無法確認實際有效安裝地址。安裝前應覈對該命令是否仍然有效。
安裝前檢查¶
已有反饋稱約 2026-08-08 前後，有用戶因運行時版本衝突導致瀏覽器工具返回空結果、會話崩潰，最後重裝 harness。該問題當前是否仍然存在尚無定論。
資料建議：安裝前先備份 ~/.dsh 和 DSH 部署目錄，並檢查 harness 內嵌 Node.js 版本。
如果出現問題，可先懷疑運行時版本衝突：覈對 Node 版本，並使用安裝前備份回滾，比現場硬修更快。
驗證狀態：本插件在 DSH 0.1.0-rc.6 + 內嵌 Node v24.19.0 下開發並實測通過，13 個工具掛載與調用正常。
核心功能¶
細粒度瀏覽器工具¶
插件提供一組 browser_* 工具，覆蓋常見網頁操作：
browser_open
browser_snapshot
browser_click
browser_type
browser_scroll
browser_navigate
browser_tabs
browser_fill_form
browser_download
browser_status
browser_close
其中：
browser_open：打開頁面，自動彈出專用 Chrome 窗口。browser_snapshot：讀取頁面文本 + 元素序號 + 截圖。browser_click：按序號或文字點擊。browser_type：輸入文字。browser_scroll：滾動頁面。browser_navigate：後退、前進、刷新。browser_tabs：標籤頁列表、切換、關閉、新建。browser_fill_form：按字段批量填表。browser_download：觸發並保存下載到~/Downloads。browser_status：查看運行狀態、標籤頁、配置目錄、待執行排程。browser_close：關閉專用 Chrome，登錄態保留。
自主任務¶
browser_task 支持自然語言目標。插件內部循環執行“看頁面 → 調用當前模型決策 → 操作”，默認上限 30 步。
後臺運行時，可用 job_output 跟蹤任務輸出。
定時任務¶
browser_schedule 支持按以下方式到點自動開跑：
HH:MM- ISO 時間
- 秒數
定時任務在本會話內有效；DSH 重啓後需重新排程。
危險操作確認¶
支付、下單、刪除、註銷等敏感動作，在動手前會彈窗徵求用戶同意。
驗證碼人工接管¶
檢測到驗證碼時，插件會暫停並截圖詢問。用戶可以在專用 Chrome 窗口親自處理後繼續。
截圖回傳¶
每步操作截圖會進入對話，前提是模型支持圖片輸入。
登錄態持久¶
插件使用獨立 profile，默認路徑爲：
$DSH_HOME/.browseruse/chrome-profile
如果沒有設置 DSH_HOME，則爲：
~/.dsh/.browseruse/chrome-profile
登錄一次長期記住，密碼不落盤。
典型用法¶
以下示例來自已覈實資料。
先打開頁面：
browser_open "https://www.baidu.com"
這一步會自動彈出專用 Chrome 窗口。
再讀取頁面快照：
browser_snapshot
這一步會返回頁面文本、元素序號和截圖。
輸入搜索詞：
browser_type {"text": "蘋果發佈會"}
也可以直接用一句話觸發自主任務：
browser_task "搜索蘋果發佈會並總結前三條結果"
如果需要定時執行：
browser_schedule {"goal": "搶購...", "at": "20:00:00"}
適用場景與注意¶
適合在 DSH 會話內完成以下任務：
- 打開網頁並讀取頁面內容。
- 按元素序號點擊、輸入、滾動。
- 填寫表單並觸發下載。
- 用
browser_task完成多步網頁操作。 - 用
browser_schedule在本會話內定時開跑。 - 保留登錄態，減少重複登錄。
需要注意：
1、插件運行在 DSH 主進程，以當前 dsh 進程權限運行。
2、它只消費宿主服務：tools / llm / userQuestions / attachments / jobs，不發佈服務。
3、安裝前應檢查源碼與許可證。
4、危險操作確認與驗證碼暫停依賴會話的 ask_user_question 通道。
5、在子代理上下文中無法詢問用戶時，會採取保守策略，阻止危險操作。
6、默認下載目錄爲：
~/Downloads
結尾¶
dsh-browseruse 把瀏覽器操作接入 DSH 插件體系：細粒度工具、自主任務、定時任務、登錄態保留、危險操作確認和驗證碼人工接管，都圍繞同一個專用 Google Chrome 實例展開。
安裝前仍應重點檢查 harness 內嵌 Node.js 版本，並保留 ~/.dsh 與 DSH 部署目錄的備份。
GitHub 地址：
https://github.com/yzd6552-commits/dsh-browseruse#readme
