DSH Suite — the DeepSeek Harness power-user workbench

中文 | English

A complete toolkit that turns DeepSeek Harness (dsh) from a CLI tool into a visual workstation: a cyberpunk desktop launcher + 8 production-grade plugins + 6 engineering skills + 1 in-dsh skill. Zero core rewrites — every capability is delivered through official plugin extension points, so the upstream core stays independently upgradable at all times.

SillyTavern-grade Control Deck	Skin manager + community skin market

✦ What is this

DeepSeek Harness is DeepSeek's official agent framework — powerful, but natively CLI-only with a plain web UI. DSH Suite adds on top of it:

• A desktop launcher (UX inspired by 秋叶 aaaki's ComfyUI packs): double-click an EXE for one-click start/stop, plugin market, skill market, skin market, token analytics, session browser, and one-click updates — all graphical;
• The Control Deck: SillyTavern-grade multi-entry leveled prompt injection, regex scripts, World Info lorebooks, and sampling overrides, edited in a GUI and hot-reloaded within 1.5 s;
• A cost stack: live multi-provider balances, automatic model price sync, cache-hit rates, and a CC-style usage heatmap;
• Safety & speed: destructive-command blocking, hover model prices, HTTP quick-workspace creation, and frontend skin injection.

Everything ships as plugins / skills / a standalone launcher — git status in the core repo stays clean forever.

✦ Quick start

Prerequisites: Windows 10/11, Git, Node.js ≥ 18, Edge or Chrome.

git clone https://github.com/WZZNNE/DSH-CyberWorkStation.git
cd DSH-CyberWorkStation
setup.cmd

setup.cmd automatically: uses the bundled core/ source tree (dsh 0.1.0-rc.8; falls back to cloning upstream when absent) → installs deps and builds (build:lib + build:web) → registers all suite plugins → opens the launcher.

Daily use afterwards: double-click launcher/DSH启动器.exe. Manual mode: node launcher/server.mjs then visit http://127.0.0.1:3090.

Remember to configure an API key (OPENROUTER_API_KEY / DEEPSEEK_API_KEY env vars, or ~/.dsh/settings.yaml). Core checked out elsewhere? Point DSH_REPO at it; override the launcher port with DSH_LAUNCHER_PORT.

✦ How it differs from stock dsh (feature matrix)

✦ Control Deck tutorial

"Control Deck" page in the launcher sidebar. Every save hot-reloads within 1.5 s — no dsh restart. Semantics match SillyTavern, so ST veterans feel at home instantly.

1. Prompt injection (multi-entry, leveled)

Each entry has:

• Name / text: what gets injected;
• order: lower numbers sort earlier — multiple entries stack by order;
• position: system (into the system prompt) or user-prefix (prepended to the user message);
• interval: 1 = every step; N>1 = once every N steps (periodic reminders);
• enabled: toggle per entry without deleting it.

2. Regex scripts (ST runRegexScript semantics)

Rewrites user input / world-info content, with SillyTavern-compatible fields:

• findRegex (flags supported) and replaceString with {{match}} (whole match) and $1…$9 capture groups;
• trimStrings: substrings stripped from the match before it fills {{match}};
• placement: scope — user_input or world_info.

3. World Info (full ST field set)

Scans recent conversation and injects lore when keys match:

• keys: primary keywords, /regex/flags supported; secondaryKeys + selectiveLogic: andAny / andAll / notAny / notAll;
• constant 🔵: always injected, no key needed; probability: percentage gate after a match;
• order / position; caseSensitive / matchWholeWords (whole-word by default, auto-skipped for CJK text);
• Recursion: one entry's content can trigger another (excludeRecursion / preventRecursion / delayUntilRecursion + global maxRecursionSteps);
• inclusion group + groupWeight: mutually exclusive within a group, weighted pick;
• sticky / cooldown / delay measured in message counts;
• Global settings: scanDepth (how many recent messages to scan) and budgetChars (injection budget).

4. Sampling overrides (with a master switch)

When "enable sampling override" is unchecked, the plugin touches no request parameters at all — nothing can be passed by accident. When checked, you can override temperature, maxTokens, and stop sequences (up to 4). Reasoning effort is deliberately not in the Control Deck: the native model picker already owns it, and two controllers would fight.

5. Tool switches

List tool names to deny them at the tools/pre-execute stage (e.g. disable web_search).

✦ Launcher page tour

The 🌐 icon at the bottom-left switches zh/en; the default skin supports light / dark / follow-system.

✦ The skin system

• Launcher skins (launcher/skins/launcher/): cyberpunk-2077 (Cyberpunk 2077 × Edgerunners, Jimeng-AI-generated art) and default (three-state theme).
• dsh frontend skins (launcher/skins/frontend/): injected into the dsh web UI via the dsh-skin-loader plugin. Pick "(none)" to restore stock looks.
• Community skin market: search npm skin packages and install with one click (results are double-filtered for the dsh ecosystem + skin semantics, so unrelated packages never slip in). The launcher converts each package in place into a single local CSS file (manifest-v2 asset dirs, legacy client.js plugin format, plain CSS packages, and aggregator shells via one-level recursion are all supported); background art is inlined as data URIs and layered exactly like the original skin-center runtime — painted on the body above its background color, beneath the translucent panels, with light/dark variants following the dsh theme attribute. Converted skins are then switched/deleted like your own — skins never end up in the plugin system. Converted files are git-ignored (copyright stays with the original authors).

✦ Plugin roster

✦ Engineering skills (six-pack)

Copy the folders under skills/ into ~/.claude/skills/ and Claude Code masters the dsh codebase: dsh-architecture (Cordis model) · dsh-plugin-dev (plugin contract) · dsh-frontend-dev (client slots) · dsh-env-ops (environment ops) · dsh-playbook (tuning playbook) · dsh-testing (test layering).

✦ Why zero core rewrites work

dsh is built on the Cordis plugin framework; the suite only uses these official extension points:

• ctx.systemPrompt.section() — sectioned system-prompt injection;
• agent/pre-step — rewrite messages entering the model (regex / world info / prefixes);
• agent/request — merge request parameters (sampling overrides);
• tools/pre-execute — allow/deny tool calls (safety blocking / tool switches);
• ctx.webServer.register() — mount HTTP endpoints (quick workspace / skin serving);
• the client __ModuleLoader__ slot — frontend injection (skins / price hints).

The launcher is a fully separate process that talks to the core only via CLI and HTTP.

✦ FAQ

Q: A task failed with MISSING_CREDENTIAL: deepseek-official — is that a bug? No. dsh sessions pin the model chosen at creation time. If a session was created on the official DeepSeek model while you only configured an OpenRouter key, that session keeps using the official channel and reports the missing credential. Fix: start a new session (default model shows on the dashboard), switch models inside the session, or add DEEPSEEK_API_KEY.

Q: Where did my market-installed skin go? The "dsh frontend skins" section of the Skins page — never the plugin list (v1 briefly installed them as plugins; that's fixed, with conversion).

Q: UI changes not showing? Browser cache — hard-refresh with Ctrl+F5.

Q: Do Control Deck edits need a restart? No — saves hot-reload within 1.5 s.

✦ License & credits

Original suite code is MIT (see LICENSE). Forked plugins keep their upstream MIT licenses: dsh-cost-meter (Han-1413141), dsh-usage-stats (Tastelessor). Control Deck semantics align with SillyTavern (behavior reference only, no code included). Community skin content belongs to its authors (Maid Atelier is CC BY-NC-SA 4.0, non-commercial). Launcher artwork generated with Jimeng AI by the suite author. Launcher UX pays homage to 秋叶 aaaki's ComfyUI pack launcher.