Introduction

In DSH, agent capabilities are typically extended through plugins. dsh-cloakbrowser targets agent workflows that require local browser sessions: it connects a locally installed CloakBrowser to DeepSeek Harness, allowing the agent to start sessions, manage tabs, navigate pages, execute clicks and input, obtain snapshots or screenshots, and perform visual understanding upon explicit invocation.

This is not an official CloakBrowser plugin. CloakBrowser is developed and maintained by CloakHQ; this repository only contains the DSH integration and does not include or redistribute the CloakBrowser browser binary. The community directory within the DSH plugin ecosystem is an independent site with no official affiliation to DeepSeek / Hypersphere.

What is this

  • Plugin Name: dsh-cloakbrowser
  • Maintainer: SJF-ECNU
  • GitHub Repository: https://github.com/SJF-ECNU/dsh-cloakbrowser
  • License: MIT License for the Python wrapper; the CloakBrowser browser binary uses its own Binary License
  • Positioning: DeepSeek Harness plugin to allow agents to use a locally installed CloakBrowser
  • Runtime Requirements: Node.js 22.19 or higher, Python 3.11 or higher, Git

Core Features

Below are the tool names grouped by common agent operations.

Sessions:

  • browser_start: Start a browser session
  • browser_close: Close a browser session

Tabs:

  • browser_open_tab
  • browser_list_tabs
  • browser_activate_tab
  • browser_close_tab

Page Navigation and Interaction:

  • browser_navigate
  • browser_click
  • browser_click_point
  • browser_type
  • browser_evaluate

Snapshots, Screenshots, and Visual Understanding:

  • browser_snapshot
  • browser_screenshot
  • browser_understand

Cookies:

  • browser_get_cookies
  • browser_set_cookies

Startup Arguments:

  • profile_dir: Use CloakBrowser’s native persistence context
  • cdp_port: Expose the session to a CDP port on 127.0.0.1
  • virtual_display: Pass width and height on Linux to start a headed browser
  • humanize and human_config: Used to control actions; you can use humanize: true along with human_preset: "careful" or human_config

Installation and Activation

First, ensure CloakBrowser is locally installed and meets the runtime requirements mentioned above. Next, add the plugin:

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

After the steps above, you can verify the plugin configuration:

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

If installed via a local checkout, use this to update:

dsh plugin --profile web update dsh-cloakbrowser

To remove the plugin, use:

dsh plugin --profile web remove dsh-cloakbrowser

Typical Usage

Starting a Session

  1. Call browser_start to create a browser session.
  2. When persistence context is needed, pass profile_dir to use CloakBrowser’s native persistence context.
  3. When you need to connect a local CDP client, pass cdp_port to expose the session to a CDP port on 127.0.0.1.
  4. When a headed browser is needed on Linux, pass width and height to virtual_display.
  5. When humanized actions are needed, set humanize: true, and use human_preset: "careful" or human_config as needed.

Operating on Pages

  1. Use browser_open_tab, browser_list_tabs, browser_activate_tab, and browser_close_tab to manage tabs.
  2. Use browser_navigate, browser_click, browser_click_point, browser_type, and browser_evaluate for page navigation and interaction.
  3. Use browser_get_cookies and browser_set_cookies to read and write cookies.
  4. Use browser_snapshot and browser_screenshot to obtain snapshots or screenshots.

Visual Understanding

In the DSH web UI, navigate to:

Settings → Plugins → Plugin configuration → Visual understanding model

The configuration items include:

  • Base URL
  • Model
  • API style
  • API key

The API key is write-only and will not be displayed after saving.

browser_understand is only used upon explicit invocation. It sends a screenshot of the currently selected tab’s viewport to the endpoint configured by the user for visual understanding. It does not solve CAPTCHA or human verification challenges; it only reports actions requiring user intervention.

Suitable Scenarios and Precautions

Suitable for the following scenarios:

  • CloakBrowser is locally installed, and you want DSH agents to directly manipulate the local browser.
  • Tab management, page navigation, clicking, input, cookies, snapshots, screenshots, and optional visual understanding are required.
  • A headed browser needs to be launched with a virtual display in a Linux environment.

Precautions before use:

  • The plugin runs with the permissions of the current dsh process; review the source code and license before installation.
  • Browser tools can access the authentication status and cookies of target websites, as well as the local profile passed to CloakBrowser.
  • CDP support only exposes sessions started by this plugin; connecting to arbitrary existing CDP endpoints is not implemented.
  • The virtual display requires Linux and a pre-installed Xvfb; it is not an automatic dependency installer or remote desktop service.
  • browser_understand sends screenshots to the endpoint configured by the user and only occurs upon explicit invocation; do not call it arbitrarily on pages where you do not expect screenshots to be sent externally.

Conclusion

The value of dsh-cloakbrowser lies in converting a local CloakBrowser session into a set of DSH tools: the agent can start sessions, operate on tabs, execute page interactions, read cookies, and invoke visual understanding when needed. Before use, confirm that CloakBrowser is locally installed, then complete the plugin addition, configuration, and necessary verification.

GitHub Repository: https://github.com/SJF-ECNU/dsh-cloakbrowser

The URL for the plugin directory page is not provided in the verified materials.