Foreword

In the DSH plugin ecosystem, browser debugging capabilities can be extended through plugins. Describing browser UI issues solely with text often lacks specific element context. dsh-annotate allows users to directly select elements within Chrome or Chromium, sending selectors, DOM facts, computed-style highlights, accessibility data, comments, and optional viewport screenshots to the Agent.

What is This

dsh-annotate is a DeepSeek Harness plugin maintained by BrambleXu, positioned as:

Browser element annotation bridge for DeepSeek Harness

It sends browser element annotation results to the Agent via a local loopback WebSocket bridge.

Verified information:

  • License: MIT
  • Node.js: ^22.19 or >=24
  • 0.1 Goals: One local Chrome/Chromium browser, one active tab, visible viewport screenshots

Core Features

Below are the verified capabilities.

  • Directly select elements in Chrome or Chromium via /annotate.
  • Capture selectors, DOM facts, computed-style highlights, accessibility data, comments, and optional viewport screenshots.
  • Send structured annotations to the Agent via a local loopback WebSocket bridge.
  • Browser connection restrictions: loopback host, extension origin, optional extension ID.

Specific rules for connection restrictions:

  • The server rejects non-loopback hosts.
  • The server rejects browser connections with an origin not matching chrome-extension://.
  • When allowedExtensionId is empty, any locally installed Chrome extension is accepted.
  • For stricter isolation, a precise extension ID should be configured.

Installation and Enabling

The local installation command provided in the documentation is:

dsh plugin --profile demo add ./dsh-annotate

This is an example of a local path from the documentation; the remote installation command has not been confirmed.

Before installation, the plugin source code and MIT license should be checked. dsh-annotate runs with the current dsh process privileges, so it is not recommended to install modified versions from unverified sources directly.

Typical Usage

Annotation commands can be issued from the DSH side:

/annotate
/annotate http://localhost:3000

Then operate on the page:

  1. Click an element.
  2. Input a comment for that element.
  3. If needed, repeat selection for other elements.
  4. After submitting, all captured facts and the visible tab screenshot will be sent to the Agent.
  5. Press Escape to cancel the current annotation.

Use Cases and Boundaries

This is suitable for debugging, inspection, or development scenarios that require passing local browser element context to the DeepSeek Harness Agent, especially for tasks like element location, style observation, and accessibility information compilation.

Please note the following boundaries:

  • Version 0.1 targets local Chrome/Chromium browsers, one active tab, and visible viewport screenshots.
  • Remote browsers, full-page capture, edit recording, and inline draggable note cards are explicitly deferred.
  • When allowedExtensionId is empty, any locally installed Chrome extension is accepted; it is recommended to configure a precise ID as needed.
  • The plugin runs with the current dsh process privileges; verify the source code and license before use.

Links

GitHub repository:

https://github.com/BrambleXu/dsh-annotate

Directory page clue (unconfirmed):

https://www.skillhub.cn/plugins/BrambleXu/dsh-annotate