前言¶
瀏覽器自動化任務往往依賴已打開的頁面和登錄狀態。傳統的做法通常需要啓動新的自動化瀏覽器實例,或者導出 Cookie,這會增加環境配置成本,並丟失當前的會話上下文。DeepSeek Harness 的插件生態旨在解決這類問題,dsh-doyourweb 就是爲此而生的一個聯網工具插件,它允許你直接引用並控制已登錄的 Chrome 或 Edge 標籤頁,從而複用現有的會話狀態。
插件定位¶
- 功能描述:Reference and control existing Chrome and Edge tabs from DeepSeek Harness(從 DeepSeek Harness 引用並控制現有的 Chrome 和 Edge 標籤頁)。
- 維護者:SheepofSheep。
- 類別:聯網工具。
- 許可證:MIT。
核心功能¶
- 複用現有會話:直接複用 Chrome 和 Edge 中已登錄的 HTTP/HTTPS 標籤頁,無需重新登錄。
- 菜單集成:通過 DSH 的
@和/菜單列出頁面標題、站點和圖標。 - 緊湊閱讀:支持通過選擇器或查詢縮小範圍,並使用光標分頁。初始引用上下文默認 2,400 字符預算。
- 批量操作:支持批量執行動作,每次調用最多 12 個動作,遇到失敗或導航會停止。
- 數據提取:可提取文本、值和 href 字段,每次提取最多 20 行。
- 本地截圖:將 PNG 截圖保存到本地並返回路徑,不使用 base64 嵌入。
- WebMCP 優先控制:實驗性功能,優先使用頁面提供的 WebMCP 工具,若沒有則回退到 DOM 快照。
安裝與啓用¶
安裝命令:
在 DeepSeek Harness 中打開 Plugins > Add Plugin,選擇官方 npm 註冊表,輸入:
dsh-doyourweb
若官方倉庫未同步或返回 404,可使用本地構建方式安裝:
git clone --branch ver0.1.1 https://github.com/SheepofSheep/dsh-doyourweb.git
cd dsh-doyourweb
npm ci
npm run build
在 DSH 中打開 Plugins > Add Plugin,輸入構建後的項目目錄絕對路徑。
連接瀏覽器:
1. 在 DSH 中輸入 /browser 打開本地連接頁面。
2. 在 Chrome 或 Edge 中啓用開發者模式,加載 extension/ 文件夾(未打包擴展)。
3. 對比擴展的 4 位配對代碼與連接頁面的請求,確認後批准。
4. 在 DSH 中使用 @ 選擇已打開的頁面。
典型用法¶
- 引用頁面:在對話中使用
@選擇一個已打開的標籤頁,然後描述任務。 - 讀取內容:使用
browser_read工具。默認mode: "auto"會優先嚐試發現 WebMCP 工具,否則返回 DOM 快照。若需指定 DOM 快照,使用mode: "dom"並配合selector、query或depth進行篩選。cursor支持分頁,limit控制字符長度(400-8,000)。 - 執行操作:使用
browser_act工具,傳入最新的 snapshot ID,執行點擊、填充、按鍵或選擇等操作。
注意事項¶
- 環境要求:需要 Node.js 22+ 和 DeepSeek Harness 0.2.0-rc.2。
- 數據存儲:數據目錄位於
<DSH_HOME>/browser-tabs/(默認爲~/.dsh/browser-tabs/)。 - 預算機制:字符預算計算 JavaScript 字符(包含 JSON 轉義和元數據),而非模型 token。它限制返回上下文,不限制 DOM 遍歷時間。
- 配對機制:插件和瀏覽器擴展必須通過 4 位代碼配對,配對後後臺自動重連,無需保持彈窗打開。
- 無演示:目前沒有公共託管的演示。
結語¶
dsh-doyourweb 降低了瀏覽器自動化對全新環境的依賴,讓模型能直接利用已打開的標籤頁工作。配合 DSH 的插件機制,它是處理網頁內容、執行批量操作的實用工具。更多細節可參考 GitHub 倉庫。