dsh-annotate

Element annotation and review panel for the DeepSeek Harness web client. Open a local app you are already running, click the elements you want changed, write a note on each, and send the whole review to the conversation as one structured block.

This is the package README. For the architecture, the full workflow, the annotation payload, configuration and the documented limits, see the repository README.

Install

Give a coding agent this prompt:

Read https://github.com/alaliqing/dsh-annotate and install its latest published version into the local DeepSeek Harness web profile. Preserve existing configuration and do not stop the current Harness session. Verify the installation, then explain how to restart Harness and open Annotate.

Or install manually with Node.js 20+, the dsh CLI, and pnpm on PATH:

dsh plugin --profile web add dsh-annotate

For a new install, version 0.1.3 and later registers and enables its own bundle. Version 0.1.2 and earlier used this manual entry in $DSH_HOME/profiles/web/cordis.patch.yml (default ~/.dsh/profiles/web/cordis.patch.yml):

- insert:
    - name: dsh-annotate

When upgrading an existing 0.1.2 or earlier installation, remove and add the package so DSH registers its new bundle; updating the existing dependency alone may leave it out of the profile's bundle list:

dsh plugin --profile web remove dsh-annotate
dsh plugin --profile web add dsh-annotate

Remove only the old manual insertion from cordis.patch.yml and keep all other profile entries. If no patch entries remain, use [] rather than a comments-only file. Check for exactly one - id: dsh-annotate row with dsh --profile web --dump-config. Restart the web profile and refresh the browser, then click Annotate or press ⌘/Ctrl⇧B. If you use npx @deepseek-ai/dsh web, replace dsh above with npx @deepseek-ai/dsh. The package ships built files; no build step is needed.

What you get

• A sidebar tab (Annotate, ⌘/Ctrl⇧B) listing the local development servers that are actually running, with page titles, refreshed every five seconds.
• Each app opens on its own isolated loopback preview origin, at its original paths, so root-absolute assets, SPA routes and WebSocket upgrades just work.
• Click an element to write a note. Markers follow the element through window and nested scrolling, resizing and layout shifts, and hide when the element is clipped or gone.
• Send annotations sends the review alone; Add to composer merges it into your draft. A rejected send keeps the annotations, and your draft and attachments are never sent by accident.
• Structured payloads: original URL, viewport, selector and match count, semantic anchors, component chain, geometry, computed styles and visible text.
• English and Chinese, switchable in the toolbar.

Package contents

File	Role
lib/index.js	Host half: discovery, the loopback preview proxy, the host API
lib/client.js	Client half: the sidebar tab
lib/shim.js	Injected into previewed documents: URL and socket mapping, navigation reports
lib/overlay.js	Injected into previewed documents: picking, markers, comment cards
cordis.patch.yml	Bundle layer that activates the plugin automatically

Compatibility

Chromium is the validated browser. A restartable, local DeepSeek Harness web client is required.

A packed 0.1.3 checkout passed a native check with Harness Desktop 0.2.0-rc.2; this does not verify an npm-published 0.1.3 package. See the compatibility record for the environment and validation limits.

Local development only: proxy targets are restricted to loopback, so a remote harness or a public deployment is out of scope.

License

MIT.