ChatGPTClaudeGrok / X / CursorGemini

dsh-annotator: Let DeepSeek Harness See the Page Elements in Front of You

zhongqixiao/dsh-annotator

Tools & CapabilitiesVerified
Listed on 2026-11-11
Page last updated 2026-11-15

A DSH plugin that lets you pick, annotate, comment on and screenshot elements of a real Chrome/Edge page, then hands the locators to the agent for visual front-end edits.

dsh-annotator is a DSH plugin that packages element picks, comments and screenshots from a real Chrome, Edge or ego lite page into locator details an agent can read. It addresses the difficulty of an agent that cannot see your current page and must rely on written descriptions of where a button sits and how it looks. Core abilities include hover highlighting and click-to-pick, a unique CSS selector with coordinates and size, per-element comments, reference chips with screenshot attachments, long-lived browser reuse and batch undo.

How to Install

install
npmdsh plugin --profile <your-profile> add dsh-annotator

Replace --profile with the profile name you actually run (see ls ~/.dsh/profiles/): usually web in the browser UI, desktop or desktop-NNN in the desktop app.

Category
Tools & Capabilities
Platform
DSH Plugin
Author
zhongqixiao
Distribution
Plugin

dsh-annotator Key Features

Pick elements in real browsersComment annotations and screenshotsQuote chips into the input boxLong-lived browser reuseOne-click clear and undo
Listed on dsh-plugin.org

dsh-annotator Repo Summary

What Does It Do?

Annotator is a DSH plugin for DeepSeek Harness that lets you pick, annotate, comment on and screenshot elements of a real Chrome, Edge or ego lite page, then hands the element locators plus your comments and screenshots to the agent. It solves the problem of the agent not being able to see the page in front of you, so you no longer have to describe a button in words. Maintained by ZhongqiXiao and written in JavaScript, it was last updated on 2026-11-11 and belongs to the dsh-plugin ecosystem.

Core Features

  • Element picking: hover highlighting and click-to-pick with an overlay that does not pollute page styles, returning a unique CSS selector, page URL, coordinates, size and text excerpt.
  • Comment annotation: every picked element can carry a comment that travels to the agent together with its locator, so you can state what should change.
  • Reference chips: clicking Insert places an annotation chip and the element screenshot into the DSH GUI input box, expanded into full locator details on submit, with a plain-text fallback when the chip pipeline is unavailable.
  • Long-lived browser reuse: the first launch opens the chosen browser and later launches reconnect to the same instance, keeping login state and leaving the window open on disconnect; ego lite is taken over if already running.
  • Screenshots and undo: element screenshots are stored locally and attached as real images, Clear wipes all annotations at once, and Undo on the notice bar restores the whole batch.

How to Use This Plugin?

After enabling it in DSH, open the Element Annotation panel in the right sidebar, type an address (a bare domain is completed automatically, and a phrase with spaces is treated as a search query), choose a browser and click Start. Turn on picking mode, hover to highlight and click to pick, write a comment, then click Insert on the card or Insert All at the bottom; the input box then shows the reference chip and screenshot attachment. Inserted annotations leave the list, so the next round starts clean; submit the conversation and the agent receives the full locator details to edit the frontend code against the page you actually see. A small floating layer is injected into each page, so no browser extension is needed: Alt A toggles picking mode and Esc cancels the current pick.

How to Troubleshoot This Plugin?

All three browsers are listed in the panel, and any that is not installed is marked as unavailable and disabled, so install the corresponding browser as described in the official instructions. If no reference chip appears in the input box, the chip pipeline is unavailable and the plugin falls back to plain-text insertion, which still delivers the locator details to the agent. If the Element Annotation panel does not appear in the right sidebar after setup, restart DSH as described in the official instructions and check again.

This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: zhongqixiao/dsh-annotator. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.

Install, update, and uninstall this plugin in the Plugin Market of DeepSeek Harness's DSH Plugin Hub
ChatGPTClaudeGrok / X / CursorGemini

DSH Plugin FAQ