DeepSeek Harness Desktop Pro

An Electron desktop shell and a Cordis plugin for DeepSeek Harness (dsh). The plugin adds desktop notifications for pending interactions, an opt-in screen_capture model tool, a multi-agent tiling canvas, a desk-pet companion window, and a desktop settings section. The shell boots the dsh host in-process and embeds its web UI in a native window with tray controls.

English | 中文

What it does

Capability	Side	Notes
Interaction notifications	client	Subscribes to the sessions store; fires a browser desktop notification when a session waits on an approval, question, or plan review. Click opens that session.
screen_capture model tool	host	Captures the primary display and commits the screenshot into the conversation as an image attachment. Disabled by default — see Consent.
Multi-agent tiling canvas	client	A conversation.view tab rendering a live, read-only grid of sessions and sub-agents from the sessions store.
Desk pet	client	A floating companion window (cat / robot / whale) driven by a state engine that derives pet state (idle / thinking / working / alert / success) from live sessions. Ships a custom navigation icon in the dsh nav bar.
Desktop settings	client	A settings section for pet preferences: enable/disable, character (built-in robot / whale / cat or a custom PNG), and size.
Native shell	app	Electron 35 app that boots the dsh host in-process, embeds the local Web UI in a frameless window, pins in-app directory browsing, and provides tray controls with a recent-sessions menu and update checks.

How it plugs in

• The package declares a dsh.bundle manifest (object form: { "patch": "./cordis.patch.yml" }) — this is what dsh recognizes as an installable plugin. dsh.client declares the web platform and the @deepseek-ai/* runtime packages it injects.
• Host side registers the screen_capture model tool only.
• Client side reads the sessions store and the question/requested interaction stream (via the PendingWait.answer channel) — it never registers a second ctx.userQuestions provider, so it works against the published runtime with no slot conflicts.
• The client bundle is a single file wrapped in the window.__ModuleLoader__.load({ id, factory }) handshake (see build.mjs).

Install

The plugin ships as @mixian/dsh-desktop-plugin with a dual-face Cordis bundle (dsh.bundle + dsh.client). Mount it with either mechanism:

# via a profile (recommended)
dsh plugin --profile web add @mixian/dsh-desktop-plugin

# from a source checkout
dsh plugin --profile web add ./packages/dsh-desktop-plugin

# or as a one-off overlay (no install)
dsh web --patch ./packages/dsh-desktop-plugin/cordis.patch.yml

Consent

screen_capture exposes the operator's whole display. It is not registered unless screenCapture: true is set explicitly in the profile patch:

# ~/.dsh/profiles/web/cordis.patch.yml
- id: dsh-desktop-plugin
  config:
    screenCapture: true   # opt in: registers the screen_capture tool

The captured image is always surfaced back into the conversation for transparency — it is never silently injected.

Run the desktop app

pnpm install
pnpm dev            # Electron dev
pnpm electron:package # Windows production bundle

Requires Node.js ≥ 22 and pnpm 11 (corepack enable).

Model Experience

• The plugin adds no tokens when idle: the notification watcher, canvas, desk pet, and settings are client-side and read the sessions store; they never enter the model context.
• screen_capture adds one model-facing tool with a short description; its output is an image block in a durable tool/result event, subject to the same attachment limits as any image in the session. It requires a model that accepts image input.

Known Limitations

• Screen capture is host-only and captures the primary display; multi-monitor and region capture are not supported.
• The multi-agent canvas is a read-only monitor; it does not create or attach sessions.
• Notifications fire as native OS notifications in the desktop shell and fall back to the browser desktop-notification API in the web runtime. The Alt+Space global quick panel is planned, not shipped.
• Time travel, session rewind, and live fork are not implemented.

Development

pnpm install
pnpm check          # lint + typecheck + tests + Electron build + plugin build + bundle verification
pnpm dev:plugin     # plugin dev loop

Project layout

packages/dsh-desktop-plugin/   # dual-face Cordis plugin (dsh.bundle + dsh.client)
packages/dsh-desktop-electron/ # Electron desktop application
stubs/                         # local type-stubs for unpublished @deepseek-ai/* transitive deps
docs/                          # ARCHITECTURE_ANALYSIS + PUBLISHING_GUIDE (verified 2026-08)

Documentation & community

• Architecture analysis — dsh internals research and verified constraints
• Publishing guide — packaging rules, registry submission, npm pitfalls
• Contributing · Security policy · Changelog

The repo carries the dsh-plugin, deepseek-harness, and cordis-plugin topics for ecosystem discovery.

License

MIT