Foreword¶

DSH Web GUI already provides theme capabilities, but if third-party developers want to add their own color schemes, image backgrounds, or light/dark bases, they usually also need an installable, verifiable plugin layer that does not modify the core. dsh-skins is the client plugin repository that does this: registering skins into DSH’s theme system and providing an immediate switch entry in the settings page.

Below, based on verified information, I introduce what it is, what it can do, and how to install and verify it.

What is it¶

dsh-skins is a client plugin repository for skinning the DeepSeek Harness (DSH) Web GUI.

The names and source fields appearing in the verified information are as follows:

• Repository name: dsh-external/dsh-skins
• package.json package name: @dsh-external/dsh-web-skins
• GitHub URL: https://github.com/Moeblack/dsh-skins
• Copyright author in the information: mattheliu

These fields are not entirely consistent, and the information also states that the repository is currently a private repository requiring read access to the dsh-external organization; on the other hand, the scraping page can be accessed from Moeblack/dsh-skins. The public status cannot be confirmed solely based on this information. Please verify the actual source, access permissions, and source code before use.

Core Capabilities¶

Register skins via the official ThemeService¶

According to the information, this plugin does not directly modify the DSH core frontend, but registers third-party themes via the official ThemeService and uses --dsw-* alias tokens for overrides. The information summarizes this approach as “zero core modifications.”

After installation, users can see the “Skin” selector in the General section of the settings page; clicking the skin switches it immediately, with the preference written to dsh.theme.

Listed Locally Built and Verified Skins¶

The information lists four locally built and verified skins:

The information also lists neon-bamboo, ink-wash, and harbor-night as candidates or not yet started, and they are not part of the released skins.

Image Backgrounds and Self-contained Resources¶

Supports dark/light base skins. Image skins will overlay AI-generated image backgrounds.

The information explains that background images are inlined into the bundle as data URLs and do not rely on external hosting. That is to say, skin resources are delivered with the plugin rather than requiring users to configure external image addresses.

Local Build and Verification Scripts¶

The repository provides local build and verification scripts, including:

pnpm typecheck
pnpm build
pnpm test
pnpm verify
pnpm i18n
pnpm preview

pnpm verify is used to run typecheck, build, test, smoke tests on the artifacts, and the i18n bilingual consistency gate all at once. The information states that this gate requires consistent documentation structure between the Chinese and English README/docs and that updates must be done in pairs.

Installation and Activation¶

First, confirm that you can access the corresponding repository. The information states that public distribution is not allowed before it is officially released; if repository permissions are still within the dsh-external organization, you need to first obtain the corresponding read permissions.

The installation and startup commands are as follows:

omdsh market install dsh-web-skins --profile web --enable
omdsh activate --profile web
omdsh launch --profile web --

The information states that the market install entry resolves the id to @dsh-external/dsh-web-skins and an immutable Git spec:

git+https://github.com/dsh-external/dsh-skins.git#78349585a85ab94fd3ad22bfcfa9816058da2d93

The information also explains that each commit serves as an immutable identity, therefore changing the skin version is reflected by changing the ref. OMDSH disables the install script by default. The commands above are listed as per the information.

Typical Usage¶

Switching Skins After Installation¶

After installation, enter the DSH Web GUI:

1. Open Settings
2. Go to General Settings
3. Select the target skin in the Skin section
4. Click to switch the skin immediately

The switched preference is written to dsh.theme.

Adding a New Skin¶

The path for adding a new skin given by the information is:

1. Add a SkinDefinition in packages/dsh-web-skins/src/client/skins.ts
2. Add Chinese and English copy for skins.name.<id> in locales.ts
3. If an image background is needed, ensure the background image is inlined as a data URL into the bundle
4. Run pnpm verify to perform typecheck, build, test, smoke tests on the artifacts, and the i18n bilingual consistency gate
5. Register the new skin information in README/docs

After the above steps, you can view the effects on the local preview page:

pnpm preview

The information states that local installation or preview depends on the fulltest-wt snapshot next to the repository or a Private DSH snapshot; the information does not explain how to obtain the public snapshot.

Applicable Scenarios and Notes¶

Suitable for the following scenarios:

• You need to add third-party skins to the DSH Web GUI, rather than modifying the core source code
• You need dark/light base skins, or need to overlay image backgrounds
• You need to keep skin definitions, settings page entries, and local verification scripts in the same plugin repository
• You need to perform structural consistency checks on the Chinese and English README/docs

Notes before use:

• The plugin runs with the permissions of the current dsh process. You should check the source code, license, repository source, and executable logic before installation.
• package.json declares the license as MIT; the information also states that the copyright belongs to mattheliu, and the repository only contains original plugin code and DSH official logo assets, not the rest of the official repository source code.
• The information states that the repository is currently private, and public distribution is not allowed before official release. Due to the inconsistency between the scraping URL and the repository name/package name, the public status cannot be confirmed solely based on the information.
• The candidate skins neon-bamboo, ink-wash, and harbor-night are not in the released list, do not use them as released skins.
• The DSH philosophy is “Everything is a plugin”; the community directory is an independent site with no official affiliation to DeepSeek / Hanfang, and should not be interpreted as an official app store.

Conclusion¶

The value of dsh-skins lies in making the skinning requirement of the DSH Web GUI a client plugin that is installable and verifiable: skins are registered via the official ThemeService, can be switched directly from the settings page, and local scripts can also run typecheck, build, test, verify, and preview.

The GitHub address provided by the verified information is:

https://github.com/Moeblack/dsh-skins

The directory page URL was not provided in the verified information, so it is not listed in this article.