前言¶
DSH Web 界面的默认外观比较固定。如果只希望更换背景，或者在几张本地图片、图片地址和内置预设之间切换，可以看一下 dsh-wx-skin。它是一个面向 DSH Web GUI 的皮肤插件，提供侧栏「皮肤」面板，支持本地图片 / URL 作为全屏背景，并包含预设、暗化、模糊、关闭皮肤与跨刷新持久化能力。
这是什么¶
dsh-wx-skin 由 wangxilhy23 维护，许可证为 MIT。它的定位是 DSH Web GUI 皮肤插件，属于外部 client 插件，采用 dsh-web-ui 风格。它不改 DSH 仓库，也不影响主界面与其它插件，主要在浏览器端提供背景替换与显示参数调节。
核心功能¶
侧栏入口¶
安装后，侧栏会出现「皮肤」入口。点击该入口会弹出设置面板。资料描述该面板为浮层，不遮挡聊天内容。
背景选择¶
支持通过浏览器原生文件对话框选择本地图片。已核实支持的位图格式为：
- PNG
- JPEG
- WebP
- GIF
- BMP
SVG 等矢量格式不支持。
资料说明本地图片不限文件大小，超尺寸会自动缩放。
也支持粘贴 http(s):// 图片地址直接应用。
预设皮肤¶
内置预设包括：
- 墨蓝
- 石板
- 暖沙
- 落日渐变
- 深海渐变
- 极光渐变
效果调节¶
可调节项包括：
- 暗化：0–80%
- 模糊：0–24px
- 透出：0–100%，默认 72%
面板还提供启用开关与恢复默认操作。
持久化与主题¶
设置会持久化到 localStorage，并镜像到宿主副本：
~/.dsh/dsh-wx-skin.settings.json
资料说明刷新、重启、桌面端换端口后会自动恢复。
插件也支持明暗主题自动适配。
安装与启用¶
前置条件¶
需要先满足以下条件：
- 已安装
deepseek-harness - 已初始化
web profile package.json中声明Node >=22.19.0和packageManager pnpm@11.7.0
安装命令¶
已核实资料给出的安装命令是：
pnpm dsh plugin --profile web add dsh-wx-skin@0.1.2
该命令使用固定版本 0.1.2。
重启与刷新¶
安装后重启 dsh web，然后刷新：
http://127.0.0.1:3080
侧栏出现「皮肤」入口即可使用。
验证是否挂载¶
可执行：
pnpm dsh --profile web --dump-config
输出中应看到：
"# == dsh-wx-skin"
典型用法¶
1、点击侧栏「皮肤」。
2、选择背景：选择本地图片、粘贴 http(s):// 图片 URL，或选择预设。
3、调节「暗化」「模糊」「透出」。
4、打开「启用皮肤」；需要还原时执行「恢复默认」。
如果只想先预览效果，可以打开自包含演示源：
assets/demo.html
资料说明该文件可直接用浏览器打开预览。
卸载¶
已核实的卸载命令是：
pnpm dsh plugin --profile web remove dsh-wx-skin
重启 dsh web 后，侧栏入口消失，皮肤设置一并清除。
适用场景与注意¶
适合使用 DSH Web 界面、希望替换背景并保留聊天主界面可读性的开发者。
使用前建议：
- 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。 - 仅接受位图 PNG / JPEG / WebP / GIF / BMP；SVG 等矢量格式不支持。
- 侧栏入口依赖 DSH shell 的 DOM 结构；若 DSH 版本变更导致入口未出现，资料说明只会记录日志，不影响 GUI。
- 皮肤依赖应用根
#root为挂载根，通过z-index: 0与#root抬升方案渲染背景。 - 本地图片以 data URL 存于
localStorage，并镜像到~/.dsh/dsh-wx-skin.settings.json。
链接¶
GitHub：
https://github.com/wangxilhy23/dsh-wx-skin
资料中提到的目录页：
https://www.skillhub.cn/plugins/wangxilhy23/dsh-wx-skin
该目录页链接来自插件线索，未单独抓取核实；这里仅作为资料中出现的地址列出。
