为 DSH Web 提供 7 套精选皮肤、自定义背景壁纸与奶龙桌面宠物,所有偏好保存到本地浏览器。
- 语言
- JavaScript
- License
- MIT
- 分支
- main
安装
$ dsh plugin --profile web add dsh-skin在终端中运行以上命令,通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh?看这篇新手教程
对话式安装
帮我安装 DeepSeek Harness 插件 KinGao294/dsh-skin:先查看仓库 https://github.com/KinGao294/dsh-skin 确认安全性,然后执行安装命令并验证插件加载成功。
把这段指令粘贴给 DSH Web GUI 里的助手,由它代你完成安装与验证。
一句话定位
为 DeepSeek Harness 的 Web 界面提供「换肤」能力:内置 7 套精选配色、可上传本地图片或视频作为半透明背景,再附带一只会跟着对话状态换表情的奶龙桌面宠物。所有偏好都保存在当前浏览器,刷新后自动还原。
核心能力
- 提供 7 套预设配色(深海蓝、石墨灰、森林绿、落日紫、午夜黑、纸感暖、樱花粉),覆盖浅色与深色两种模式
- 允许上传本地图片(自动压缩到约 1.8MB 以下)或粘贴 http(s)/data 视频地址作为半透明背景,支持遮罩浓度、模糊强度、铺满/完整/拉伸/平铺四种显示方式
- 提供一只可拖动、可调大小(64–180px)的奶龙桌宠,含 8 种表情;自动跟随会话状态切换(思考→干活→完成→睡觉),也可点击或打开 🎨 表情包手动指定
- 在「设置 → 通用」新增 3 行配置:皮肤 / 壁纸 / 桌宠,与官方主题并列
- 选择持久化到本地浏览器(localStorage),刷新和重启浏览器后自动还原
技术实现
- 语言: JavaScript(浏览器端 CJS 风格,无构建步骤)
- 关键依赖:
@deepseek-ai/dsh-client-runtime(inject/theme/locale/slots)、@deepseek-ai/dsh-client-ui-theme(主题注册与 token 覆盖层)、@deepseek-ai/dsh-client-locale(中英文案)、react(行内渲染设置行 UI) - 架构模式: 双面插件,Host 半(
lib/index.js)仅做 cordis patch 注册(插入id: skin加载项),业务全部在 Client 半(lib/client.js);通过 cordisctx.theme.register()注册皮肤、ctx.theme.overrideTokens()注入半透明遮罩 token、ctx.slots.inject("settings.general.item", ...)挂载设置行 - 入口文件:
lib/index.js(Host)/lib/client.js(Client, 2091 行)
适用场景
DSH 用户希望把默认界面换成自己喜欢的色调、添加一张个性化背景图,或在工作台放一只陪伴型小宠物。常见于长时间使用 Web 客户端、需要定制视觉体验、又不想深入修改源码的场景。设置项均在「设置 → 通用」面板内,鼠标点选即可使用,无需命令行。
前置依赖与兼容性
| 依赖 | 最低版本 | 说明 |
|---|---|---|
| DeepSeek Harness | >=0.1.0-rc.6 | 由 peerDependencies 中各 @deepseek-ai/dsh-client-* 包声明 |
@deepseek-ai/cordis | ^4.0.1 | 插件运行时框架 |
react | ^18.2.0 | 设置行渲染依赖 |
| Node.js | 未声明 | 插件运行在浏览器侧,源码未读取 engines |
| 平台 | 跨平台 | manifest platform: web,跟随 DSH Web 客户端 |
| 原生模块 | 无 | 纯前端实现,不依赖 node-pty、node:sqlite 等原生模块 |
安装方式
dsh plugin --profile web add dsh-skin
安装完成后需重启 dsh web,新插入的 patch layer 才能被加载。
配置项
本插件在「设置 → 通用」面板暴露 3 行可视化配置,不需要写代码或编辑配置文件。
| 配置 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| 皮肤 / Skins | 选择 | 7 套预设配色(深海蓝 / 石墨灰 / 森林绿 / 落日紫 / 午夜黑 / 纸感暖 / 樱花粉),或「默认」跟随系统外观 | 默认(跟随系统) |
| 背景图片 / Wallpaper | 图片 + 网址 + 滑块 + 移除 | 选择本地图片(自动压缩到约 1.8MB)或粘贴 http(s)/data 视频地址;可调节界面遮罩浓度、模糊强度、显示方式(铺满 / 完整显示 / 拉伸 / 平铺) | 未设置 |
| 奶龙桌宠 / Pet | 开关 + 滑块 + 按钮 | 开关显示桌宠;滑块调整大小(64–180px);按钮重置拖动位置 | 关闭,大小 120px |
常见问题
Q: 安装后界面没有变化怎么办?
A: 插件是以 cordis patch 形式新增 loader entry,正在运行的 web 进程并不会自动加载。运行 dsh web 重启即可看到「设置 → 通用」面板下新增的皮肤、背景图片、奶龙桌宠三行。
Q: 皮肤、壁纸、宠物这些选择保存在哪里?
A: 全部存在当前浏览器域名的 localStorage 里(键名 dsh-skin:skin、dsh-skin:wallpaper 等)。这是因为 DSH 的 Host settings 接口只对官方 namespace 开放,第三方偏好落到 wire 上会返回 settings-not-exposed,所以选择本插件只跟随当前浏览器,不跨设备同步。
Q: 填入的 blob: 链接为什么无效?
A: blob: 是浏览器为当前会话临时分配的 URL,刷新页面后即失效。插件会主动拒绝 blob: 并提示用 http(s) 或 data 地址、本地图片。
Q: 能导入自己的配色吗?
A: 当前版本没有提供可视化自定义皮肤入口。7 套配色以对象字面量写在 lib/client.js 内,要新增需要修改源码、重新打包再安装。
Q: 桌宠的表情和会话状态怎么对应?
A: 桌宠通过 ctx.get("sessions").list() 每 500ms 轮询一次会话,把状态映射到表情:思考中→thinking、运行中→working、完成后→done(带星星)、空闲超过 45 秒→sleeping。点宠物或打开 🎨 表情包可手动指定一个表情,4 秒后回到自动模式。
Q: 能用在桌面端或手机 App 里吗?
A: 插件 manifest 声明 platform: web,只跟随 DSH 的 Web 客户端加载;DSH 桌面应用、原生移动端不消费此插件。
Q: 怎么卸载?
A: 在 ~/.dsh/profiles/web 内运行 dsh plugin --profile web remove dsh-skin,然后重启 dsh web。localStorage 中的偏好键不会被自动删除,下次重新安装会继续生效;如需彻底清理,可在浏览器开发者工具里删除 dsh-skin:* 键。
上手难度
入门 — 不需要修改任何源码或配置文件,在「设置 → 通用」面板用鼠标点选即可完成所有操作;安装完成后只需重启一次 Web 服务。
已知问题与限制
- 图片被压缩到 data URL 后存进 localStorage,超过约 1.8MB 会被丢弃并提示「图片太大,存不下」(来源
lib/client.js:50, 728-730) - blob: 地址会在刷新后失效,已保存的 blob 壁纸下次启动会被自动清除并提示「壁纸地址已失效,已清除」(来源
lib/client.js:483, 449) - localStorage 配额打满时保存会失败,提示「存盘失败(空间不够或浏览器限制了)」(来源
lib/client.js:414-421) - 第三方 settings namespace 未被 Host 开放,皮肤/壁纸/宠物状态不能跨设备或跨浏览器同步(来源
lib/index.js:6-12、README.md:104-109) - 安装或更新插件后必须手动重启
dsh web,正在运行的实例不会自动加载新 bundle(来源README.md:125-130) - 桌宠每 500ms 轮询一次会话状态以切换表情(来源
lib/client.js:1314)
Skin switcher + custom wallpaper + 奶龙桌宠(desktop pet with sticker pack) for DeepSeek Harness — a "change the skin" feature in the spirit of Codex themes. It registers a curated catalog of palettes into DSH's built-in theme runtime and adds three rows to Settings → General (below the built-in Appearance row):
- 皮肤 / Skins — pick one of 7 curated palettes (or 默认 / Default to follow the built-in appearance).
- 背景图片 / Wallpaper — local image, or paste an image/video URL; opacity, blur, and fit (cover / contain / stretch / tile).
- 奶龙桌宠 / Pet — a floating, draggable yellow-dragon desktop pet with an 8-mood sticker pack (表情包). It follows the agent's running state (idle → thinking → working → done → sleeping), blinks while idle, falls asleep when idle too long, can be dragged anywhere (position remembered), and shows a 🎨 sticker panel where you can pick any mood manually. Toggle it, resize it, or reset its position from the settings row.
Both choices persist across reloads (localStorage). A saved third-party skin is re-applied once on boot (DSH only persists system/light/dark itself).
How it works
DSH's theme system is token-based: the web shell ships --dsw-* design tokens,
and ThemeRuntime lets third-party plugins register themes that override the
alias layer (--dsw-alias-*) per color scheme. This package is a regular
dual-face plugin:
- Host half (
lib/index.js) — adsh.bundlepatch layer that inserts one loader entry (skin); a no-opapply, exactly like the shipped ui-* packages. - Browser half (
lib/client.js) — adsh.clientbundle (served at/plugins/dsh-skin/client.js) that:- registers 7 curated skins via
ctx.theme.register(...); - restores the saved skin id and applies it with
ctx.theme.setTheme(...); - renders the wallpaper as a fixed backdrop layer (
z-index: -1) and stacks a token override (ctx.theme.overrideTokens) that makes the main canvas (--dsw-alias-bg-base) and sidebar (--dsw-specific-sidebar-fill) translucent, so the image shows through while inner surfaces (cards, inputs, bubbles) stay opaque and readable; - keeps the slot stores in sync with
theme/change(and re-shades the wallpaper when the active skin or light/dark scheme changes); - mounts both rows into
settings.general.item; - mounts the desktop pet (a fixed, draggable element with inline-SVG
stickers) and watches the agent's running state through
ctx.get("sessions").list()to switch moods.
- registers 7 curated skins via
Each skin sets its colorScheme (light/dark), which drives
body[data-ds-dark-theme], plus alias-token overrides applied as inline custom
properties on <body> by ui-layout's ThemePresenter.
Skins
| id | scheme | vibe |
|---|---|---|
skin-ocean | dark | DeepSeek-blue deep sea |
skin-graphite | dark | neutral monochrome |
skin-forest | dark | green calm |
skin-sunset | dark | warm purple |
skin-midnight | dark | pure black OLED |
skin-paper | light | warm paper |
skin-sakura | light | pink accents |
Ids are namespaced (skin-*) so they do not collide with official @deepseek-ai/dsh-client-ui-console themes (sakura, graphite). Saved unprefixed ids are migrated on read.
Picking 默认 / Default reverts to the built-in appearance (follow system) and clears the stored skin.
Wallpaper
In Settings → General → 背景图片 / Wallpaper:- 选择图片 / Choose image — pick a local image (≤ 2MB, stored as a data URL, kept in this browser only). Local video files are not uploaded; paste a URL instead.
- 网址 / URL — paste http(s) / data image or video (mp4/webm/ogv/mov). blob is rejected (dies on reload). No extra media server.
- 显示方式 / Fit — cover / contain / stretch / tile.
- 界面遮罩 / UI wash and 模糊 / Blur sliders (rAF-coalesced; no crash). Higher wash = more solid UI.
- 移除 / Remove clears it.
The wallpaper lives on a z-index: -1 fixed layer, so it is only visible
through the translucent main canvas and sidebar; message surfaces keep their
solid backgrounds for readability. It also follows your active skin's tint
(switching skins re-shades the translucent surfaces).
奶龙桌宠 / Pet
In Settings → General → 奶龙桌宠 / Pet you can show/hide the pet, resize it (64–180 px) and reset its position. Behavior:
- Status moods — the dragon follows the agent:
thinkingwhen a turn starts,workingwhile it runs,done(with sparkles) when it finishes, then back toidle. Left idle too long it falls asleep (sleeping, Zzz). - Sticker pack (表情包) — hover the pet and open 🎨: 8 moods to pick (idle / happy / thinking / working / done / sad / surprised / sleeping). Clicking the pet also cycles to a random sticker for a few seconds.
- Draggable — drag it anywhere; the position is remembered
(
dsh-skin:pet-pos). Reset it from the settings row. - Zero assets — every sticker is inline SVG (original hand-drawn art in a
Nai-Long style, not the licensed character), so the bundle stays dependency-
free and crisp at any size.
preview.htmlin the repo shows the full pack.
Persistence
Choices are stored in localStorage (dsh-skin:skin, dsh-skin:wallpaper,
dsh-skin:wallpaper-opacity, dsh-skin:wallpaper-blur, dsh-skin:wallpaper-fit,
dsh-skin:pet-enabled, dsh-skin:pet-size, dsh-skin:pet-pos).
DSH's Host settings wire only exposes an allowlisted set of namespaces to
browser clients (WEB_SETTINGS_NAMESPACES in dsh-host-apiproxy), so a
third-party namespace would answer settings-not-exposed; the product itself
keeps remote browser preferences process-local, and localStorage matches that
boundary for a visual preference while surviving reloads on the same origin.
Install
From anywhere, add the package to the web profile:
dsh plugin --profile web add -w /path/to/dsh-skin
The
-wflag is required: every profile ships apnpm-workspace.yaml, so pnpm 9 treats the profile directory as a workspace root and refuses a bareaddwithERR_PNPM_ADDING_TO_ROOT.
This runs pnpm in ~/.dsh/profiles/web, installs the package, and appends it
to dsh.profile.bundles (its patch layer inserts the skin loader entry).
The running web server must be restarted to pick up the new bundle layer:
# stop the running instance, then:
dsh web
Open Settings → General to use the skins, wallpaper and pet.
Publishing (npm)
DSH (rc.6) has no separate plugin marketplace — the plugin distribution
channel is the npm registry. A package that declares dsh.bundle (host patch
layer) and dsh.client (browser bundle) is exactly what dsh plugin --profile <name> add <package> installs, so publishing this package to npm is
what "上架" means today:
- Pick a unique name (scoped names are safer, e.g.
@yourscope/dsh-skin) and fill inauthor,repository,keywords, and a CHANGELOG. - Make sure
filesshipslib/index.js,lib/client.js,lib/types,cordis.patch.yml(already configured). - Publish to the official npm registry (this machine's default registry is
a mirror — publishing to a mirror does not reach npmjs):
npm publish --registry https://registry.npmjs.org - Users install with:
then restartdsh plugin --profile web add -w @yourscope/dsh-skindsh web.
Known platform boundaries to document for users: browser-side preferences are
stored in localStorage (third-party settings namespaces are not exposed over
the wire yet), and the client bundle may only require module-table entities
(platform seeds + registered client bundles).
Development
The client bundle is written directly in the __ModuleLoader__ bundle format
(the same shape tsdown emits for the shipped ui-* packages), so no build step
is required. lib/client.js may require only module-table entities: platform
seed words (react, react/jsx-runtime, …) and registered client bundles
(@deepseek-ai/dsh-client-runtime/client, @deepseek-ai/dsh-client-ui-theme/client,
…). After editing, restart the web server (bundle content is re-hashed and
served with a new rev; loader entries are rescanned at boot).
查看使用指南 →
该插件的安装步骤、关键要点、FAQ 与兼容性说明(基于已收录字段派生)。
收录徽章
[](https://deepseek-plugin.org/plugins/KinGao294/dsh-skin)把这段 markdown 粘贴到你的 GitHub README,链接回本插件详情页。徽章只声明已被本站收录,不代表安全认证。