Relay DSH Workbench Plugin
Now supports DSH 0.1.2-rc.1 while retaining 0.1.2-alpha.3 compatibility. Plugin 0.2.2 is verified on both releases. Install it from npm · Compatibility evidence.
Release channels: latest → 0.2.2; next → 0.2.1-rc.1.
npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-workbench@0.2.2
npx @deepseek-ai/dsh@0.1.2-rc.1 web
English | 中文
npm package: relay-dsh-plugin-workbench
· All Relay DSH plugins
Live npm-installed Relay plugins in official DSH
Real npm-installed demo on official DSH: live conversations, a Workbench file
view, and an executed terminal command. Watch the H.264
MP4.
relay-dsh-plugin-workbench adds a reusable Workbench shell to the official
DeepSeek Harness (DSH) Web
UI. It gives other plugins a safe place to register right-side panels and bottom
panels without modifying DSH core code.
This package does not add a visible feature by itself. Install it directly only
when you are developing or testing another Workbench view plugin. Normal users
usually install Workbench together with a feature plugin such as Files or
Terminal.
Workbench hosting the Relay Files side panel in DSH Web
The screenshot was captured from official DSH 0.1.1-rc.2 with Workbench and
Files installed. Workbench alone keeps the default DSH layout until a feature
plugin registers a view.
Do I Need This Plugin?
Install Workbench directly when you want to:
- test the shared side/bottom panel shell by itself;
- develop another DSH plugin that contributes a Workbench view;
- make sure a DSH Profile already has the common Workbench layout before adding
local feature plugins.
Install it manually when using GitHub development builds of
relay-dsh-plugin-files or relay-dsh-plugin-terminal. DSH's pnpm profile
blocks GitHub packages as transitive dependencies, so development installs list
Workbench and the feature plugin in the same command.
Quick Start With Official DSH
The current development build has been validated with:
- DeepSeek Harness
0.1.1-rc.2, commit
b150a551
- Node.js 22.13 or newer
pnpm available on PATH
DSH is a developer preview and may introduce compatibility-breaking changes.
1. Install
Stop a running DSH Web process before changing Profile plugins.
GitHub development build
Use this when you want the latest development build:
pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-workbench#main
For a reproducible install, replace #main with a tag or full commit SHA.
npm release
Install the published package with:
pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-workbench@latest
2. Start or restart DSH Web
pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 web
If you already have a dsh command installed, dsh web is equivalent. Restart
DSH Web after installing, updating, or removing plugins.
3. Confirm behavior
Workbench alone keeps the normal DSH conversation layout. It only becomes visible
when another plugin registers a side or bottom view. For an end-user visible test,
install the Files or Terminal plugin instead.
What It Provides
- A generic right-side panel region
- A generic bottom panel region
- The public
ctx.workbench registry for view plugins
- Public contracts at
relay-dsh-plugin-workbench/contracts
- Idempotent activation, so multiple feature plugins can safely bring Workbench
into the same DSH Profile
Feature plugins should use ctx.workbench, keyed DSH slots, and the public
contracts entry. They should not import Workbench source files.
Plugin Boundary and Relay
This repository is maintained as part of
Relay, an open-source project for
long-running agent work, external-event delivery, reusable DSH workbench views,
and multiple conversation backends.
Workbench is intentionally small. It owns only the common panel shell; Files,
Terminal, Codex, Claude, and Events remain separate optional plugins.
Update, Inspect, or Remove
Stop DSH Web before changing plugins, then restart it afterward.
dsh plugin --profile web why relay-dsh-plugin-workbench
dsh plugin --profile web update relay-dsh-plugin-workbench
dsh plugin --profile web remove relay-dsh-plugin-workbench
For GitHub installs, pnpm records the package source inside the DSH Profile.
Run dsh plugin --profile web why relay-dsh-plugin-workbench to inspect it.
Troubleshooting
Nothing changed after installing Workbench
That is expected when Workbench is installed by itself. It is a host shell for
other plugins. Install Files or Terminal to see a new panel.
DSH fails to start after a plugin change
Restart DSH Web and inspect the plugin source:
dsh plugin --profile web why relay-dsh-plugin-workbench
If the package came from GitHub main, try pinning a known commit SHA.
Installation says pnpm is missing
Install pnpm using the official guide: https://pnpm.io/installation.
Development
git clone https://github.com/yangbobo2021/relay-dsh-plugin-workbench.git
cd relay-dsh-plugin-workbench
npm install
DSH_ROOT=/path/to/deepseek-harness npm run verify
npm pack
npm run verify runs type checking, tests, and the production build against an
official DSH checkout.
Feedback
Report bugs and feature requests in this repository's issue tracker:
https://github.com/yangbobo2021/relay-dsh-plugin-workbench/issues
