An npm package with 9 built-in DSH Web GUI theme skins and skin center cards, supporting online preview and one-click switching without restart.
ⓘ This plugin is a sub-package of the CAPTAIN1275/dsh-ui-web monorepo — stars and activity count the whole repository.
- Language
- TypeScript
- License
- Apache-2.0
- Branch
- main
Install
$ dsh plugin --profile web add @captain1275/dsh-skinsRun the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial
Install via your agent
Install the DeepSeek Harness plugin CAPTAIN1275/dsh-ui-web/packages/dsh-skins for me: review the repository at https://github.com/CAPTAIN1275/dsh-ui-web first, then run the install command and verify the plugin loads successfully.
Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.
At a Glance
A unified skin bundle for DSH Web GUI: After installation, a "Skin Center" card appears in "Plugin Config → Web UI Plugins", listing 9 built-in theme skins (THS, Windows XP, Blue Fantasy, Dragon Heir, Minecraft, Miku, Trading Terminal, Whale Song, Aurora), supporting online try-on and one-click switching.
Core Features
- Insert a Skin Center card in "Plugin Config → Web UI Plugins", listing all official default and installed skin names, taglines, and accent colors, with the currently active skin marked as Active
- Try on any skin online (non-persistent): instantly preview effects, light/dark theme toggle, exit to fully restore the current skin state
- One-click apply skin: host
/api/skin-center/applyuses in-processdsh-skin useESM port, writes to~/.dsh/cordis.patch.ymlmanaged section, configuration listener hot-reloads within seconds without restart - Skins are mutually exclusive: only one skin can be active at a time, enforced by the
dsh-skin managedsection in the patch file - One npm package bundles all 9 skin assets (each skin is a set of
skin.json+lib/client.js+lib/index.js+cordis.patch.yml), no separate npm package name needed for each skin - Try-on uses on-demand loading: skin bundle (~700KB base64 art resources) is loaded via same-origin script route only when clicking "Try on", not embedded in cold start
Technical Implementation
- Language: TypeScript (skin center host/client) + Node.js (aggregator build script as ESM
.mjs) - Key Dependencies:
@deepseek-ai/dsh-host-webserver(host routing service),@deepseek-ai/dsh-settings(background occlusion config schema),@deepseek-ai/dsh-client-runtime/@deepseek-ai/dsh-client-ui-theme/@deepseek-ai/dsh-client-locale(client runtime/theme/i18n),schemastery(schema validation),react ^18.2.0(skin center card UI) - Architecture Pattern: Cordis plugin host + client dual half; host half mounts native HTTP route
/api/skin-center/*inctx.effect, injected viadsh-client-runtime; theusecommand for skin switching writes patch file + manages profile node_modules symlinks via in-processsrc/skin-switch.ts(1:1 ESM port ofdsh-skinCLI), no external CLI binary needed - Entry Files: Aggregator entry
packages/dsh-skins/build.mjs(syncs assets from sourcepackages/skins/<id>topackages/dsh-skins/skins/<id>); skin center host entrypackages/skins/skin-center/src/index.ts; skin center client entrypackages/skins/skin-center/src/client/index.ts
Use Cases
Ordinary users who want to change the style of DSH Web chat interface without fiddling with command lines: install one package to get 9 themes, from THS stock trading style, Windows XP Luna nostalgia, Minecraft block world to the popular Miku and Whale Song, all available for try-on / one-click switching in the Skin Center card.
Developers who like custom skins can also use it: the aggregator package fully bundles each skin's skin.json + lib/client.js, add your own skin following the packages/skins/aurora template, run pnpm --filter @captain1275/dsh-skins build and it will appear in the Skin Center.
Prerequisites & Compatibility
| Dependency | Minimum Version | Notes |
|---|---|---|
| DSH | 0.1.0-rc.6+ | @deepseek-ai/dsh-host-webserver, @deepseek-ai/dsh-client-runtime, etc. in skin center devDependencies are all ^0.1.0-rc.6 (packages/skins/skin-center/package.json:38-46) |
| Node | Not declared | Neither root nor package.json declares engines field |
| Platform | Web / macOS / Windows / Linux | Bundle declares dsh.client.platform: "web" (packages/skins/skin-center/package.json:23); host half automatically falls back to directory junction on Windows, no developer mode required (packages/skins/skin-center/src/skin-switch.ts:433,487-502) |
| Native modules | None | Only uses Node built-in fs/os/path, no third-party native modules; falls back to directory junction on Windows symlink failure |
Installation
dsh plugin --profile web add github:CAPTAIN1275/dsh-ui-web/packages/dsh-skins
Configuration
| Config | Type | Description | Default |
|---|---|---|---|
backgroundOpacity | Number (0-100, step 5) | Main interface background occlusion opacity; higher values darken the background image; only visible effect for skins with built-in backgrounds (e.g., blue-fantasy / whale-song) (packages/skins/skin-center/src/index.ts:34-47) | 0 |
FAQ
Q: What will I see in the DSH Web interface after installing this package?
A: A "Skin Center" card appears in "Settings → Plugin Config → Web UI Plugins", listing "Official Default" plus all installed built-in skins (THS ths, Windows XP luna, Blue Fantasy blue-fantasy, Dragon Heir dragon-heir, Minecraft minecraft, Miku miku, Trading Terminal trading, Whale Song whale-song, Aurora aurora), with the currently active skin marked as Active.
Q: Do I need to restart the dsh web service to switch skins?
A: No. After clicking "Apply / Restore Default", the skin center writes changes to the dsh-skin managed section of ~/.dsh/cordis.patch.yml via in-process dsh-skin use, the host configuration listener hot-reloads within seconds, and refreshing the browser shows the new skin.
Q: Can I enable two skins at the same time?
A: No. The skin center enforces only one active skin through the dsh-skin managed section in the patch file; other skins are written as disabled: true.
Q: Will "Try on" modify my current settings?
A: No. Try-on only temporarily mounts that skin's visuals on the current page (actually uses module loader, not eval), and on exit restores the current skin's body attributes, background inline styles, chrome child nodes, xp footer taskbar, etc., according to the recipe, without writing any files.
Q: After installation, the skin list is empty or missing some skins. What should I do?
A: Check if packages/dsh-skins/skins/<id> contains skin.json, lib/client.js, lib/index.js, and cordis.patch.yml simultaneously; missing any will be skipped by build.mjs; normal npm install will automatically complete the build.
Q: Getting "Permission denied" errors when switching on Windows?
A: The switching logic automatically falls back to directory junction (junction) when symlink fails, no developer mode required; if it still fails, run dsh as administrator, or manually place the skin package in profile's node_modules.
Q: How do I add my own skin?
A: Place skin.json (containing id, name, tagline, bodyAttr, wiring.id, package fields) + built lib/client.js / lib/index.js / cordis.patch.yml under packages/skins/<your-id>/, then run pnpm --filter @captain1275/dsh-skins build to repackage; reinstall the aggregator package to see it in the Skin Center.
Q: How do I remove a skin and switch back to official default?
A: The Skin Center card has an "Official Default" entry; click to apply with one click; to completely uninstall the plugin, use dsh plugin --profile web remove @captain1275/dsh-skins.
Difficulty Level
Beginner — After installation, the Skin Center card is directly visible in Web plugin config without any additional configuration; only need to look at build.mjs and skin.json fields when adding or adjusting skins.
Known Issues & Limitations
- Skin Center only reads the
wiring.bundleWiredstatic field from eachskin.json, not implementing runtime detection based on actual profile loading situation (TODO noted atpackages/skins/skin-center/src/skin-switch.ts:245-248) - Creating profile symlinks on Windows may fail (no developer mode / insufficient permissions), automatic fallback to directory junction (junction) required to complete switching (
packages/skins/skin-center/src/skin-switch.ts:433,487-502) - Bundle targets DSH Web GUI only (
dsh.client.platform: "web"), browser half will not load in CLI mode (headless profile) - Skins only modify browser DOM (CSS, title bar, status bar, background image, etc.), do not affect any model requests
基于 zhu1090093659/dsh-web-ui(Apache-2.0)开发的 DeepSeek Harness(DSH)Web UI 插件套件。全套 22 个包已发布到 npm(
@captain1275/*)。
DSH Web UI 全家桶为 DeepSeek Harness 的 Web 界面提供一系列插件与皮肤:极光毛玻璃皮肤、任务看板、 SSH 运维、右侧文件/变更面板、Git 图谱、移动端远程控制、DeepSeek 娘看板娘(养成系)、实时令牌统计, 以及皮肤中心。所有插件既可独立安装,也可通过聚合包一次装齐。
极光 Aurora 皮肤效果(沉浸光感 / 深色 / 浅色)



特性
极光(Aurora)皮肤(支持动态背景)
- 毛玻璃输入框:高斯模糊(backdrop-filter 30px)+ 半透明玻璃底 + 细边框 + 内高光
- 自定义背景:URL / 本地图片 / 动图(GIF/WebP)/ 视频(mp4/webm) / 透明度 / 模糊调节,
深浅两套极光渐变;视频背景支持静音开关、本地文件持久化(存
~/.dsh/skin-aurora-media/,刷新不丢) - 仿Claude Code推理等级滑块:点击模型菜单的「推理等级」弹出 Effort 滑块面板——无极拖动、松手吸附、 WebGL 火焰跟随、OFF/MAX 刻度、Low/Medium/High/Ultracode 状态

- 用户消息气泡毛玻璃:与输入框统一的玻璃质感
DeepSeek 看板娘(养成系)
- 图片资源(社区同人资源,codex-pet-DeepSeek-girl)
- 养成系统:亲密度 4 级成长(幼鲸 / 伙伴 / 挚友 / 深海羁绊)、升级庆祝气泡、进度条、 Token 零食经济、使用时长成长(每 30 分钟 +1)
- 待机随机气泡:空闲时随机说话(live2d 风格文案)
- 摸头 / 喂食 / 改名 / 拖动,召唤按钮(live2d 同款贴边滑出)
Skill 人格设定
- 设置「人格设定」:开关启用/禁用常驻人格,编辑技能名、描述与人格正文
- 一键生效:保存后写入用户级技能
~/.dsh/skills/catgirl-rp/SKILL.md,DSH 技能系统实时加载, 所有新对话自动以该人格回应(含语气、动作表达、互动规则) - 内置猫娘人格:默认提供「小咪」猫娘人格(常驻生效、好感度系统、模式切换指令),可自由改写
- 可临时退出:对话中说「退出角色扮演模式」即切回普通助手,说「进入角色扮演模式」恢复

用量看板
- 彩色统计卡:累计 token、调用次数、缓存命中、估算费用(按 DeepSeek 官方定价)
- 近 14 天趋势:每日 token 消耗柱状图
- 模型分布:各 provider/model 用量环形图 + 图例
- 会话排行:Top 20 会话(标题 / 模型 / 调用数 / token / 费用)
- 自动记录:对话时自动采集 token 用量(会话快照替换语义,不双计),存
~/.dsh/usage.json - 侧边栏入口:彩色柱状按钮打开全屏看板
功能插件
| 插件 | 功能 |
|---|---|
| dsh-task-board | 侧边栏任务看板:多列 kanban、真实执行(驱动 agent 会话)、定时执行(cron) |
| dsh-ssh | SSH 运维:主机管理、远程执行、SFTP 传输、隧道、集群并发、Web 终端 |
| dsh-aionui-panel | 右侧「预览 / 文件 / 变更」面板:文件树、多格式预览、git 操作、文件拖拽 |
| dsh-git-graph | 会话头部 git 分支选择器 + 提交图 |
| dsh-live-stats | 实时 token 估算与生成速度 |
| dsh-full-stats | 完整统计行:覆盖官方统计(不省略)+ 运行状态指示 + 自定义状态文本(含替换官方 Deep diving...) |
| dsh-usage-dashboard | 用量看板:彩色统计卡 / 近 14 天趋势 / 模型分布 / 会话排行 / 费用估算 |
| dsh-web-ui-settings | 设置页「Web UI 插件」配置组 + 「人格设定」+「关于」版权页 |
| dsh-web-ui-all | 聚合包:一键安装全部插件 |
皮肤中心
10 套皮肤(ths / xp / blue-fantasy / dragon-heir / minecraft / miku / trading / whale-song / aurora / skin-center),支持皮肤启用互斥管理与一键切换。
其余皮肤(ths / xp / blue-fantasy / dragon-heir / minecraft / miku / trading / whale-song) 为上游 dsh-web-ui 自带皮肤。
安装
方式一:npm(推荐,已发布)
# 在 DSH profile 目录(~/.dsh/profiles/web)安装聚合包
npm install @captain1275/[email protected]
然后在 profile 的 package.json 里把 @captain1275/dsh-web-ui-all 加入
dsh.profile.bundles:
{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@captain1275/dsh-client-ui-skin-aurora",
"@captain1275/dsh-full-stats",
"@captain1275/dsh-web-ui-all"
]
}
}
}
重启 DSH 即生效。
方式二:从源码(开发)
git clone <your-repo-url> dsh-web-ui
cd dsh-web-ui
pnpm install
pnpm -r build
# 把本地包链接进 profile(junction)
node scripts/link-profile.mjs
开发
- 构建:
pnpm -r build(或pnpm --filter <package> build) - 新增皮肤:参考
packages/skins/aurora(skin.json+src/client+cordis.patch.yml), 然后用node scripts/skin-center-bundles重新生成注册表 - 聚合包 patch:编辑
packages/dsh-web-ui-all/aggregate.yml后node scripts/aggregate.mjs - 皮肤资产同步:
node packages/dsh-skins/build.mjs
目录结构
packages/
├─ dsh-task-board / dsh-ssh / dsh-aionui-panel / dsh-git-graph
├─ dsh-pet / dsh-live-stats / dsh-full-stats
├─ dsh-web-ui-settings / dsh-web-ui-all / dsh-skins
└─ skins/ # 皮肤源码(aurora、miku、ths 等)
scripts/ # 构建 / 注册表 / 链接工具
shared/ # 共享构建预设(tsdown.client.ts)
版权与许可
- 主体代码:zhu1090093659/dsh-web-ui,Apache-2.0
- 增强优化:@captain1275
- DeepSeek 娘精灵图:xpy12367/codex-pet-DeepSeek-girl, 社区同人资源,版权归原作者
- 人形图标:Font Awesome 6.7.2,CC BY 4.0
- 样式参考:live2d-widget(GPL-3.0,仅参考视觉风格,未搬用代码)
- 商标:DeepSeek 及其相关标识均为 DeepSeek 官方资产;本插件为社区开发者独立维护的非官方同人项目, 不代表 DeepSeek 官方立场。
Read the usage guide →
Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.
Listing badge
[](https://deepseek-plugin.org/plugins/CAPTAIN1275/dsh-ui-web/packages/dsh-skins)Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.