前言¶

在 DSH 中，agent 能力通常通過插件擴展。dsh-cloakbrowser 面向需要本地瀏覽器會話的 agent 工作流：它把本地安裝的 CloakBrowser 接入 DeepSeek Harness，讓 agent 可以啓動會話、管理標籤頁、導航頁面、執行點擊與輸入、獲取快照或截圖，並在顯式調用時進行視覺理解。

它不是 CloakBrowser 官方插件。CloakBrowser 由 CloakHQ 開發和維護；該倉庫只包含 DSH 集成，不包含或再分發 CloakBrowser 瀏覽器二進制。DSH 插件生態中的社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。

這是什麼¶

• 插件名：dsh-cloakbrowser
• 維護者：SJF-ECNU
• GitHub 倉庫：https://github.com/SJF-ECNU/dsh-cloakbrowser
• 許可證：Python wrapper 採用 MIT 許可證；CloakBrowser 瀏覽器二進制使用自己的 Binary License
• 定位：DeepSeek Harness 插件，讓 agent 使用本地安裝的 CloakBrowser
• 運行要求：Node.js 22.19 或更高版本、Python 3.11 或更高版本、Git

核心功能¶

下面按 agent 常用操作分組列出工具名。

會話：

• browser_start：啓動瀏覽器會話
• browser_close：關閉瀏覽器會話

標籤頁：

• browser_open_tab
• browser_list_tabs
• browser_activate_tab
• browser_close_tab

頁面導航與交互：

• browser_navigate
• browser_click
• browser_click_point
• browser_type
• browser_evaluate

快照、截圖與視覺理解：

• browser_snapshot
• browser_screenshot
• browser_understand

Cookies：

• browser_get_cookies
• browser_set_cookies

啓動參數：

• profile_dir：使用 CloakBrowser 原生持久化上下文
• cdp_port：將會話暴露到 127.0.0.1 的 CDP 端口
• virtual_display：在 Linux 下傳入 width 和 height，以啓動 headed browser
• humanize 與 human_config：用於控制動作；可用 humanize: true，並搭配 human_preset: "careful" 或 human_config

安裝與啓用¶

先確認本地已有 CloakBrowser，並滿足上面的運行要求。接下來添加插件：

dsh plugin --profile web add github:SJF-ECNU/dsh-cloakbrowser

經過上面的步驟，可以驗證插件配置：

dsh --profile web --dump-config | grep -A3 'dsh-cloakbrowser'

如果是本地 checkout 安裝，更新時使用：

dsh plugin --profile web update dsh-cloakbrowser

移除插件時使用：

dsh plugin --profile web remove dsh-cloakbrowser

典型用法¶

啓動會話¶

1. 調用 browser_start 創建瀏覽器會話。
2. 需要持久化上下文時，傳 profile_dir，使用 CloakBrowser 原生持久化上下文。
3. 需要本機 CDP 客戶端接入時，傳 cdp_port，將會話暴露到 127.0.0.1 的 CDP 端口。
4. 在 Linux 下需要 headed browser 時，給 virtual_display 傳 width 和 height。
5. 需要擬人化動作時，設置 humanize: true，並按需使用 human_preset: "careful" 或 human_config。

操作頁面¶

1. 使用 browser_open_tab、browser_list_tabs、browser_activate_tab、browser_close_tab 管理標籤頁。
2. 使用 browser_navigate、browser_click、browser_click_point、browser_type、browser_evaluate 進行頁面導航和交互。
3. 使用 browser_get_cookies、browser_set_cookies 讀寫 cookies。
4. 使用 browser_snapshot、browser_screenshot 獲取快照或截圖。

視覺理解¶

在 DSH web UI 中進入：

Settings → Plugins → Plugin configuration → Visual understanding model

配置項包括：

• Base URL
• 模型
• API style
• API key

API key 是 write-only，保存後不再顯示。

browser_understand 僅在顯式調用時使用。它會將所選標籤當前視口截圖發送到用戶配置的端點，用於視覺理解。它不解決 CAPTCHA 或人類驗證挑戰，只報告需要用戶操作。

適用場景與注意¶

適合以下情況：

• 本地已安裝 CloakBrowser，並希望 DSH agent 直接操作本地瀏覽器。
• 需要標籤頁管理、頁面導航、點擊、輸入、cookies、快照、截圖，以及可選的視覺理解。
• 在 Linux 環境中需要藉助虛擬顯示啓動 headed browser。

使用前需要注意：

• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼與許可證。
• 瀏覽器工具可訪問目標網站的認證狀態、cookies，以及傳入 CloakBrowser 的本地 profile。
• CDP 支持只暴露由該插件啓動的會話；連接任意現有 CDP 端點未實現。
• 虛擬顯示需要 Linux 和預裝的 Xvfb；它不是自動依賴安裝器或遠程桌面服務。
• browser_understand 會向用戶配置的端點發送截圖，且只在顯式調用時發生；不要在不期望該截圖外發的頁面上隨意調用。

結尾¶

dsh-cloakbrowser 的價值在於把本地 CloakBrowser 會話轉成一組 DSH 工具：agent 可以啓動會話、操作標籤頁、執行頁面交互、讀取 cookies，並在需要時調用視覺理解。使用時先確認本地 CloakBrowser 已安裝，再完成插件添加、配置和必要驗證。

GitHub 倉庫：https://github.com/SJF-ECNU/dsh-cloakbrowser

插件目錄頁地址未在已覈實資料中給出。