DeepSeek Harness Plugin

EnzoX/dsh-dee-mate

Stars ★ 1 Downloads (30d) 325 Category UI Enhancements Added 2026-11-16 npm dsh-dee-mate

A functional betta desktop companion for the DeepSeek Harness Web UI: it follows several concurrent sessions at once, can switch a session to full access for the moment and restore the default permission automatically once the work is done, and adds a panel to send a line, stop a turn, or approve inline — size and colour are adjustable.

Install

# from npm (prebuilt)

dsh plugin --profile web add dsh-dee-mate

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:EnzoX/dsh-dee-mate

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

A dreamy pink companion for the DeepSeek Harness Web UI: it shows and manages several running conversations at once, turns "who is busy and who is waiting for you" into a state you can read at a glance, and hands the decisions that need you right to your fingertips.

中文版:README.md

Features

Status & notifications

  • Many conversations, one panel: shows and manages several running conversations at once — who is working, who is waiting, and what just happened in each, all in one place.
  • State at a glance: swims faster while thinking, sways slower while waiting, hops when a turn completes, sinks and greys out on errors.
  • Updates become bubbles: cross-session updates carry the session name; click one to jump there without interrupting the current conversation.
  • A chime when you're needed: sounds only when a decision is pending, and can be muted on its own; browsers require one click or keypress before audio is allowed.

Approvals & actions

  • Decide right here: approve or reject in the panel (Allow once / Reject) without switching back to the session; approvals from other sessions work too.
  • Approval bubbles: with the panel closed, approvals appear as a clickable bubble next to the fish; can be turned off.
  • Allow all this turn: a temporary, on-demand elevation — one click switches to full access so you aren't asked again for the rest of the turn; the previous permission is restored automatically when the turn completes (survives a page refresh).
  • Message from the panel: send a sentence to the current session without leaving the UI, or stop a running task.

Look & adjustments

  • Docks at the bottom-right: draggable with a persisted position; arrow keys nudge it when focused.
  • Hide anytime: collapses into a 24px bubble in the corner; click it or press H to bring Dee back. While hidden it doesn't subscribe to event streams — genuinely quiet.
  • Resizable: 50%–135%, 100% by default; a slider plus − / + for 5% steps, and the choice is remembered.
  • Switchable palette: Dream Pink (the original artwork) or Deep Ocean Blue; shape and animations stay identical.
  • Follows the theme: UI copy and colors follow DSH (English/Chinese, light/dark); icons are original SVG.

Install

DeeMate ships as a standalone Cordis bundle package, dsh-dee-mate, installed with DSH's own CLI.

Prerequisite: the dsh command

The Desktop app ships it at <install dir>\resources\runtime\cli\bin\dsh.cmd, but not on PATH. Add the bin directory to PATH to call plain dsh, or use the full path (replace <install dir>, e.g. C:\Program Files\DeepSeek Harness):

& "<install dir>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add dsh-dee-mate

Install with dsh plugin

dsh plugin forwards its arguments to pnpm inside that profile, then automatically adds newly installed dependencies that declare dsh.bundle to the profile's bundles list — no manual config edit.

# Desktop app: fully quit DSH first (desktop is a reserved profile), reopen afterwards
dsh plugin --profile desktop add dsh-dee-mate        # the name form needs the npm release

# A Web UI started with `dsh web`
dsh plugin --profile web add dsh-dee-mate

# Local tarball / source directory: pass a path instead of the package name
dsh plugin --profile desktop add <path>\dsh-dee-mate-1.0.0.tgz
dsh plugin --profile desktop add <path>\dsh-dee-mate
  • --profile must match the profile that boots the UI: desktop for the Desktop app, web for dsh web, or your own profile name. The wrong profile installs the plugin somewhere the UI never loads.
  • desktop accepts only the dsh shipped with the Desktop app. An npm-installed dsh refuses it with profile "desktop" is managed exclusively by the Electron application.
  • Omitting --profile fails with required option '--profile <name>' not specified — that is DSH's contract, not a plugin problem.
  • A source directory installs as a link: rebuild with node build.mjs and refresh the page; no reinstall needed.

Refresh the Web UI after installing and Dee appears; if the Desktop app shows nothing, quit it completely and reopen. No install scripts, no runtime dependencies.

Quick start

Action Effect
Click the fish / Enter / Space Open the panel
Drag the fish Move it (position is remembered)
H Hide / bring back
M Mute / unmute the decision chime
B Toggle approval bubbles
Gear button Adjust size, switch palette

Full details (shortcuts, approval semantics, privacy, troubleshooting, uninstall) are in USAGE.md (currently in Chinese).

License

The source code is open-sourced under the MIT license, © 2026 EnzoX.

The character and brand are not covered by MIT: the "Dee" character, artwork, icons (icon.svg, assets/*, src/ui/icons.js, src/pet-whale.js, and the design rendered by src/pet-art.js), visual identity, and the look and feel of the product are © 2026 EnzoX, all rights reserved. They may not be copied, modified, redrawn, or used commercially without permission; the names "DeeMate" and "幻海 Dee" are not licensed as trademarks. For commercial, derivative-work, or brand licensing, contact the author (GitHub @EnzoX). See LICENSE for the full terms.

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.