🎨 dsh-wx-skin

DeepSeek Harness（DSH）Web GUI 皮肤插件 —— 侧栏「皮肤」面板，自选本地图片或图片 URL 作为全屏磨砂背景，支持预设、暗化、模糊与透出调节，明暗主题自动适配，跨刷新持久化。

上图为本插件实际效果演示(深蓝渐变壁纸透过半透明表面)。assets/demo.html 是自包含的演示源,可直接用浏览器打开预览。

---

✨ 功能特性

• 侧栏「皮肤」入口,点击弹出设置面板(浮层,不遮挡聊天内容)。
• 本地图片:浏览器原生文件对话框选择 PNG / JPEG / WebP / GIF / BMP,不限文件大小;按显示需要编码(≤4096px 保持原始分辨率,更大的自动缩放以保证浏览器可绘制、可持久化),选中后点「应用」生效。
• 图片 URL:粘贴 http(s):// 图片地址直接应用。
• 预设皮肤:墨蓝 / 石板 / 暖沙 / 落日渐变 / 深海渐变 / 极光渐变。
• 效果调节:
  • 暗化 0–80%(黑色遮罩,保证文字可读);
  • 模糊 0–24px(背景毛玻璃);
  • 透出 50–100%(表面不透明度,越低背景越明显,默认 72%)。
• 启用开关 + 恢复默认,一键关闭皮肤。
• 持久化:设置存于 localStorage['dsh-wx-skin.settings'],刷新、重启后自动恢复。
• 明暗主题适配:随 body[data-ds-dark-theme] 自动切换两套半透明配色。
• 完全独立:纯浏览器端 client 插件,不修改 DSH 仓库,不影响主界面与其它插件。

---

📦 安装

前置条件:已安装 deepseek-harness 并初始化 web profile。

方式一:从 npm 安装(推荐)

插件已发布到 npm,一条命令装齐(在 DSH 源码 checkout 目录执行):

pnpm dsh plugin --profile web add dsh-wx-skin@0.1.0
# 若 `dsh` 已加入 PATH,也可直接:
dsh plugin --profile web add dsh-wx-skin@0.1.0

方式二:使用发布包(tarball)

下载 dsh-wx-skin-0.1.0.tgz(或通过 GitHub Releases 获取):

pnpm dsh plugin --profile web add file:
# 例如:
pnpm dsh plugin --profile web add file:C:/Users/you/Downloads/dsh-wx-skin-0.1.0.tgz

方式三:克隆源码构建(开发者)

git clone 
cd dsh-wx-skin
npm install
npm run build

# 装进 web profile(从 DSH 源码 checkout 目录执行)
pnpm dsh plugin --profile web add link:

完成安装后

重启 dsh web,刷新 http://127.0.0.1:3080,侧栏出现「皮肤」入口即可使用。

验证是否挂载: