Back to directory

deepseek-harness-skin

Maintenance: Active

heigeai/deepseek-harness-skin

Skin system for DeepSeek Harness — 21 built-in skins plus custom themes generated from a single image, with contrast and readability checks.

View on GitHub
$ git clone https://github.com/HeiGeAi/deepseek-harness-skin.git

52

stars

4

forks

TypeScript

Language

MIT

License

2026-08-13

Created

2026-09-23

Last push

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

  1. 01

    $ git clone https://github.com/HeiGeAi/deepseek-harness-skin.git

  2. 02

    cd deepseek-harness-skin

  3. 03

    bash scripts/install.sh /path/to/deepseek-harness

  4. 04

    cd /path/to/deepseek-harness && pnpm install && pnpm run build && pnpm dsh web

  5. 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

DSH integrationNative runtime

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.
2026-08-132026-08-30v1.0.0

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).

08Data and sources

  • Author-claimedgithub.com238d114d1e5b…

    Reskin the DeepSeek Harness web UI. 21 built-in skins plus one-image custom themes, with contrast-preserving color deriv…

  • Author-claimedgithub.com238d114d1e5b…

    装进 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.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.