在 DeepSeek Harness (DSH) 的開發與調試中,面對瀏覽器環境時的操作與狀態追蹤往往較爲繁瑣。本插件旨在提供一套完整的網頁調試與操作能力,包括獨立瀏覽器窗口、多標籤頁管理、可訪問性快照以及控制台和網絡數據採集。
插件定位¶
這是一個爲 DeepSeek Harness 提供客戶端網頁操作與調試能力的插件。它通過獨立的瀏覽器窗口或標籤頁,爲智能體提供多會話管理、元素操作、快照讀取及網絡數據採集等能力。該插件在社區目錄維護,通過 cordis.patch.yml 接入 profile。
核心功能¶
- 獨立瀏覽器窗口與多標籤頁:支持新開受控標籤、導航、歷史前進後退及標籤頁的激活、關閉、領取與移交。
- 元素操作與等待:提供點擊、填充、按鍵、滾動等操作,支持等待文本出現、元素消失、頁面穩定或指定時間。
- 調試與採集:支持可訪問性快照、截圖、控制台日誌採集及網絡請求捕獲。
- 高級能力:提供 ref 操作以恢復舊引用或獲取實時座標,支持人工接管模式,以及通過 CDP / Electron provider 執行高級命令。
安裝與啓用¶
插件通過 cordis.patch.yml 接入 profile。桌面端默認使用 Electron provider,外部 Chrome 使用 CDP provider(出廠配置默認關閉)。
安裝步驟如下:
-
桌面端首次使用:
從 GitHub Releases 下載dsh-webops-desktop-v<版本>-win-x64-portable.zip。解壓後運行啓動.cmd。 -
已有桌面便攜版:
下載dsh-webops-plugin-update-v<版本>.zip,覆蓋到便攜版根目錄並保留home,重啓即可。 -
已有自己的 dsh:
下載dsh-webops-plugin-v<版本>-win-x64-portable.zip,按 插件安裝說明 裝入 profile。
典型用法¶
- 新開與導航:使用
webpage_open或webpage_navigate新開受控標籤並進行導航或歷史前進後退。 - 讀取頁面信息:使用
webpage_snapshot讀取頁面大綱,或使用webpage_find檢索緩存。 - 元素操作:使用
webpage_click、fill、press或scroll操作元素,或使用webpage_locate獲取實時座標以恢復舊 ref。 - 等待與採集:使用
webpage_wait等待頁面穩定或特定條件,使用webpage_screenshot、console或network進行調試採集。 - CDP 執行:通過
webpage_execute執行允許列表內的一條 CDP 命令。
適用場景與注意¶
- 標籤獨佔:每個受控標籤同時最多由一個對話佔用。彈窗會繼承家族歸屬。
- 權限與接管:支持人工接管,接管期間 Agent 無法操作,交還後重新取得有效 ref。重啓不會恢復舊對話的權限。
- 安全提示:頁面內容按不可信數據處理,Runtime.evaluate 會執行頁面代碼,需謹慎使用。
- 適用範圍:適合需要精細控制瀏覽器行爲、進行網頁自動化測試或調試的智能體開發場景。
該插件通過提供標準化的工具集和雙 provider 架構,降低了 DeepSeek Harness 在瀏覽器環境中的操作門檻。更多細節與源碼請查看其 GitHub 倉庫。