前言¶
在 DeepSeek Harness（DSH）的開發與使用中，Agent 經常需要調用瀏覽器執行任務。常規做法中，瀏覽器每次啓動都是全新的環境，無法複用之前的登錄態。這導致 Agent 每次都需要重新進行登錄流程，降低了效率。DSH 插件生態強調“一切皆插件”，下面介紹 dsh-uni-browser 插件，它爲 Agent 提供了持久化的瀏覽器配置文件方案。
插件介紹¶
dsh-uni-browser 是一個爲 DeepSeek Harness 提供持久化、可審計的 uni-browser 配置文件的插件。它由用戶 baixianger 維護，旨在解決 Agent 在瀏覽器操作中無法保留本地狀態的問題。通過該插件，Agent 可以使用獨立的、帶有特定登錄信息的瀏覽器配置文件進行後續操作。
核心功能¶
該插件主要包含以下能力：
- 命名配置文件：支持創建獨立的 Chromium 或 Camoufox 瀏覽器配置文件，支持 Unicode 名稱，便於區分不同的使用場景。
- 持久化登錄：能夠保留本地 Cookies、localStorage 和 IndexedDB 數據，實現登錄態的持久化。
- Agent 動作：通過提供的 API，Agent 可以執行導航、讀取無障礙快照、點擊、輸入文本和按鍵等操作。
- 託管運行時：插件可以按需啓動私有的本地守護進程來管理瀏覽器。
- 清晰的控制：提供“打開”、“停止”和“忘記”等操作。打開和停止僅控制瀏覽器進程，不刪除本地狀態；忘記操作則會確認後永久刪除本地數據。
安裝與啓用¶
在安裝之前，請確保當前運行環境在支持的系統範圍內（詳見下方注意事項）。安裝命令如下：
dsh plugin --profile web add dsh-uni-browser@latest
安裝完成後，可以通過以下命令訪問瀏覽器：
dsh web
典型用法¶
使用該插件通常需要經過以下步驟：
- 打開 Settings → Uni Browser，創建一個配置文件。
- 對於需要手動登錄的配置文件，保持 headless（無頭模式） 禁用。
- 選擇 Open，在可見的瀏覽器窗口中完成登錄操作。
- 指令 Agent 在後續的瀏覽器任務中使用該配置文件。
- 執行
dsh web以啓動瀏覽器服務。
運行時與環境¶
插件通過安裝匹配的 uni-browser daemon 來管理瀏覽器進程。npm 會根據當前系統自動安裝對應的運行時包，支持的系統包括 macOS ARM64/x64 和 Linux ARM64/x64。
- 瀏覽器引擎：運行時包默認複用系統已安裝的 Chrome 或 Chromium。如果需要使用 Camoufox，可以通過環境變量指定其可執行文件路徑。
- 環境變量：
UNI_BROWSER_CHROMIUM_BIN：選擇 Chromium/Chrome 的可執行文件。UNI_BROWSER_CAMOUFOX_BIN：選擇 Camoufox 的可執行文件。UNI_BROWSER_SOCKET或UNI_BROWSER_BIN：用於連接外部管理的守護進程。
注意事項¶
在使用過程中，需要注意以下幾點：
- Windows 不支持：當前捆綁的運行時矩陣不包含 Windows 系統。
- 引擎安裝：運行時包本身不安裝瀏覽器引擎，需要依賴系統環境或手動指定。
- 版本獨立：插件和運行時版本獨立演進，新發布的上游運行時不會強制更新已安裝的插件。
- 安全與數據：密碼和 Cookies 不會作爲配置或工具參數直接傳遞，而是保存在配置文件的本地存儲中。
- 守護進程管理：卸載插件會停止由該插件啓動的守護進程；如果使用外部管理的守護進程，卸載不會影響它。
總結¶
dsh-uni-browser 通過提供命名配置文件和持久化存儲，簡化了 DSH Agent 在瀏覽器環境下的操作流程。它將複雜的瀏覽器上下文管理封裝爲可控的工具，適合需要在 DSH 中處理登錄態和本地數據交互的場景。
