MIT-licensed, build-time skin pack for DeepSeek Harness: 21 built-in themes plus one-image custom themes, contrast-preserving color derivation, and a one-click revert to the native UI.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-09-01
License
MIT
01What can it help you accomplish?
Reskin the DeepSeek Harness (dsh) web UI with one of 21 built-in themes or a one-image custom theme
A themed DeepSeek Harness web interface (sidebar / input / session list restyled) selectable from Settings → 通用设置 → 皮肤, with contrast-preserving color derivation and instant revert to the native UI
DeepSeek Harness users who want a personalized web UI without losing native controls or functionality
Generate a full color scheme for the DeepSeek Harness UI from a single image
A custom skin derived from one PNG/JPG/WebP — local decode, 4-color extraction, auto contrast mask, WebP re-encode stored at ~/.dsh/skins/
Users who want a bespoke DSH theme from their own picture without uploading it off the machine
02How to install into DeepSeek Harness
Prerequisites
- A checked-out deepseek-harness source tree at version `0.1.0-rc.5`
- Node.js 22.19 or newer
- pnpm
- Not installable via `npx @deepseek-ai/dsh` from npm — the skin builds together with the frontend
Installation steps
- 01
$ git clone https://github.com/HeiGeAi/deepseek-harness-skin.git
- 02
cd deepseek-harness-skin
- 03
bash scripts/install.sh /path/to/deepseek-harness
- 04
cd /path/to/deepseek-harness && pnpm install && pnpm run build && pnpm dsh web
- 05
Open http://127.0.0.1:3080 → Settings → 通用设置 → 皮肤, then click a skin to apply
Verify the integration
- 浏览器打开 `http://127.0.0.1:3080`,左下角**设置 → 通用设置 → 皮肤**,点一下就换。
Rollback
- bash scripts/uninstall.sh /path/to/deepseek-harness
03DSH integration and capability boundaries
Build-time skin injection into the DeepSeek Harness web UI (patches ui-theme + host, rebuild required)
Built-in skin library (21 themes)
built-in theme JSON files under src/styles/skins/themes/→21 styled DeepSeek Harness UIs (light/dark, flat/glass/neon chrome)
One-image custom theme
one PNG / JPG / WebP image→a custom skin with 4 extracted colors, auto contrast mask, WebP re-encode stored at ~/.dsh/skins/
the uploaded image is processed locally; only a compressed WebP is stored under ~/.dsh/skins/Contrast-preserving color derivation
4 seed colors (accent / secondary / surface / text)→full 73-step color ramp preserving native contrast relationships (computed in OKLab, sRGB-clamped)
Build-time readability check
skin JSON files→build fails if any of 21 skins × 8 contrast contracts is unmet
04Who is it for? When not to use it?
Good for
- DeepSeek Harness users who want a personalized web UI without losing native controls or functionality
- Users who want a bespoke DSH theme from their own picture without uploading it off the machine
Not for
- This is a source-level change: install.sh overwrites packages/client/ui-theme and applies an 8-file host patch, then a full `pnpm run build` is required. It is not a runtime injection and hijacks no process.
- Baseline is `0.1.0-rc.5`. DSH is still in developer preview; if upstream changes the UI structure the patch may fail to apply — the script reports it explicitly rather than installing halfway.
05Compatibility, maintenance and safety notes
- This is a source-level change: install.sh overwrites packages/client/ui-theme and applies an 8-file host patch, then a full `pnpm run build` is required. It is not a runtime injection and hijacks no process.
- Baseline is `0.1.0-rc.5`. DSH is still in developer preview; if upstream changes the UI structure the patch may fail to apply — the script reports it explicitly rather than installing halfway.
- The upload route only accepts the WebP magic number; requests over 4MB are dropped outright rather than cached in memory.
- This project is not affiliated with DeepSeek officially.
MIT · latest release v1.0.0 (2026-08-13); skin system v1.0.0 targets DSH 0.1.0-rc.5; last push 2026-08-30
06Frequently asked questions
How do I install DeepSeek Harness Skin?
Clone the repo, then run `bash scripts/install.sh /path/to/deepseek-harness` against a deepseek-harness source checkout at `0.1.0-rc.5`. The script backs up the files it overwrites to `~/.dsh-skin-backups/`, injects the theme, and applies an 8-file host patch. Rebuild with `pnpm install && pnpm run build && pnpm dsh web`, then open http://127.0.0.1:3080.
Can I create my own skin from a picture?
Yes. The skin picker's first entry is 自定义(选图): pick a PNG/JPG/WebP and the rest is automatic — local decode, 4-color extraction, auto contrast mask, re-encoded to WebP and stored under `~/.dsh/skins/`. The original image never leaves your machine.
Does it change how DeepSeek Harness works?
No. It only restyles the UI — sidebar, input box, and session list stay native DSH controls and functionality is untouched. All CSS is scoped under `body[data-dsh-skin]` / `body[data-skin-chrome]`, so switching back to 默认 removes the attributes and the interface returns to native instantly with no residue.
Which DeepSeek Harness version do I need?
A deepseek-harness source checkout at `0.1.0-rc.5` (Node.js 22.19+, pnpm). It cannot be installed via `npx @deepseek-ai/dsh` because the skin builds together with the frontend. DSH is still in developer preview, so if upstream changes the UI structure the patch may fail — the script reports it explicitly rather than half-installing.
How do I uninstall or revert to the native UI?
Run `bash scripts/uninstall.sh /path/to/deepseek-harness`. You can also switch back any time from Settings → 通用设置 → 皮肤 by selecting 默认; custom-skin images in `~/.dsh/skins/` are left untouched by the uninstaller (delete them yourself if wanted).
07Related DSH workflows
dsh-beauty-skins
by xierw
Beauty-themed skins for DeepSeek Harness — one-click apply with palettes extracted from wallpaper, including dynamic backgrounds.
dsh-qq2006
by laplaceyoung
A switchable QQ2006 skin for the DeepSeek Harness Web UI with a coral-blue theme and retro assets.
dsh-beyond-glass
by leoethanz
A three-column glass UI for deepseek-harness, delivered as installable packages instead of a fork.
dsh-skin-market
by keman-ai
Skin marketplace for DeepSeek Harness — search and install community skins from dsh.a2hmarket.ai right in the settings page
08Data and sources
Reskin the DeepSeek Harness web UI. 21 built-in skins plus one-image custom themes, with contrast-preserving color deriv…
装进 DSH 源码,换肤就是设置面板里的一次点击,随时切回原生界面。
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-01. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.
