dsh-lego-plugin
dsh-lego-plugin banner
Lego-style visualization of dynamic Cordis plugins in the DeepSeek Harness
(DSH) Web GUI.
This plugin replaces the native "Cordis Plugin" panel at the bottom-left
sidebar with a Lego-brick view of the plugins the current session is running
(dyn/*). Every plugin is a brick rendered with pure CSS — no external
libraries, no WebGL — and each brick keeps the full lifecycle controls of the
native panel: run, stop, remove, approve, decline. Hot plug/unplug is the
point of the plugin, not just a pretty list.
Trademark notice. This project is not affiliated with, endorsed by, or
connected to the LEGO Group. "LEGO" is a trademark of the LEGO Group. The
brick-style appearance is a visual metaphor only.
Scope. This plugin manages dynamic Cordis plugins (dyn/*, the ones
created through cordis_define). Static Loader plugins from cordis.yml
are not listed — hot plug/unplug exists only for dynamic plugins.
Features
- Replaces the native Cordis Plugin panel — same entry position and label
("Cordis Plugin"), same data and lifecycle verbs, Lego-brick presentation.
- Hot plug/unplug — click a brick: Run / Stop / Remove for running or
stopped plugins, Approve / Approve (future versions) / Decline while a
run is awaiting approval. State refreshes live as plugins start and stop.
- Lego bricks — plastic-look 3D bricks with glossy studs (highlight +
drop shadow); running plugins render solid with a green status dot, stopped
ones greyed out, awaiting-approval ones outlined in red.
- 4 themes — Classic red, Ocean blue, Forest green, Amber (switchable in
the panel header).
- Search — filter bricks by plugin id.
- Running count — the sidebar entry shows how many plugins are running.
- i18n — follows the GUI locale (中文 / English).
- Light/dark — colors come from
--dsw-alias-* theme tokens.
Style reference
The brick and stud styling follows the classic pure-CSS Lego block recipe:
The stud/brick visuals are original code in this repository, informed by those
references; no code is copied verbatim.
Screenshot
Cordis Plugin panel rendered as Lego bricks
Install
Requires a DeepSeek Harness installation with the Web GUI.
dsh plugin --profile web add dsh-lego-plugin
--profile is required and names your run configuration. Use web if you
start the GUI with dsh web (the most common case), headless for the CLI,
or any other name — a missing profile is created automatically.
Or install directly from GitHub:
dsh plugin --profile web add github:XIAOke8698/dsh-lego-plugin
Git installs build from source automatically; pnpm may ask you to allow the
package's build script, then re-run the add command.
Usage
Click Cordis Plugin at the bottom-left of the sidebar. The panel opens with
one Lego brick per dynamic plugin. Click a brick to see its actions:
| Brick state | Available actions |
|---|
| Running (solid + green dot) | Stop, Remove |
| Stopped (greyed out) | Run, Remove |
| Awaiting approval (red outline) | Approve, Approve (future versions), Decline |
Uninstalling
Remove the bundle from your profile to restore the native Cordis Plugin panel:
dsh plugin --profile web remove dsh-lego-plugin
Removal is clean and complete:
- The browser half unloads, which restores the native Cordis Plugin panel —
nothing about this plugin persists in the page after it stops.
- The stylesheet this plugin injected is removed on unload; no global styles
are left behind.
- The
cordis.patch.yml layer is removed from the profile, so the package is
no longer mounted at the next dsh web start.
You can also stop just the visual replacement without uninstalling: because
the panel is a dynamic plugin itself, stop it from the Cordis panel
(dyn/… brick → Stop) or with cordis_stop, and the native panel returns
immediately.
Development
src/
index.js host half (Loader entry)
client/index.js browser half — the whole feature
scripts/
build-client.mjs zero-dependency build (Node only)
node scripts/build-client.mjs
node --check lib/client.js
License
MIT
