前言¶
DeepSeek Harness（DSH）采用插件化架构，允许开发者扩展功能。dsh-winterskin（雪岭皮肤）是一个“趣味换装”类插件，由用户 hgp005 维护。它的核心价值在于把任意一张照片变成整个 GUI 的底色，并将面板、边框、品牌色一并调成配套的玻璃质感主题。
核心功能¶
照片底图与可读性¶
插件会将照片铺满窗口（background-size: cover），且滚动时照片保持不动（background-attachment: fixed）。为了保障正文可读性，照片之上会叠一层随明暗主题切换的冷色罩和径向暗角。
面板玻璃化¶
插件会覆写 13 个 --dsw-* 别名 token（包括背景、浮层、边框、品牌色、文字、三态色），并为浅色与深色各提供一套值，实现玻璃质感面板。
控件与调节¶
插件提供两处控件：右下角可拖动的胶囊（快捷开关 + 浮层控制台）与「设置 → 雪岭皮肤」完整设置页。用户可以通过 0–100% 的滑块连续调节浓淡，这同时影响照片色罩厚度与面板透明度。
配色与换图¶
插件提供松绿、暖阳、冷霜、墨色、夜蓝五套预设配色，并提供取色器覆盖强调色。换图无需重启，拖拽或选择图片后，浏览器会将其压缩（最长边 ≤ 2400×1500，WebP，回退 JPEG）并存入本地。
健壮性设计¶
插件仅在探测到图片可加载后才绘制，图片缺失时完全不介入界面。样式表、token 层、slot 注册等副作用均由插件 fiber 持有，停用或卸载即可完全回收。
安装¶
在命令行中执行以下命令：
dsh plugin --profile web add github:hgp005/dsh-winterskin
若没有 git 环境，也可以使用 tarball 安装：
dsh plugin --profile web add https://github.com/hgp005/dsh-winterskin/archive/refs/heads/main.tar.gz
让改动生效¶
安装或更新后必须执行两步操作：
- 重启 web profile：宿主在启动时将客户端 bundle 快照进内存，重启前一直使用旧字节。
- 强制刷新页面：使用
Ctrl + Shift + R强制刷新，普通刷新可能命中首页缓存。
使用说明¶
右下角胶囊¶
点击胶囊上的「雪岭皮肤」可穿上或脱下主题。点击百分比展开控制台，点击浮层外部或按 Esc 关闭。
设置页操作¶
在「设置」中找到「雪岭皮肤」选项，可调节总开关、浓淡滑块、配色、自定义强调色，或拖拽/选择图片。
图片处理¶
支持拖拽或选择图片，浏览器会自动压缩后存入本地。若图片过大导致存不下，控制台会提示。
注意事项¶
- 端口隔离：设置按浏览器来源隔离（协议 + 主机 + 端口），换端口会显示默认皮肤。
- 存储配额：localStorage 有大小限制，图片过大存不下时控制台会提示。
- 插件冲突：多个皮肤插件覆写同一批 token 时，后注册的层生效，建议同一时间只留一个皮肤插件。
- 许可证：代码以 MIT 许可发布。
总结¶
dsh-winterskin 提供了一种轻量级的方式来自定义 DeepSeek Harness 的视觉外观，通过简单的配置即可实现照片背景与玻璃化面板的统一。
- 插件目录：dsh-winterskin
- 源码仓库：GitHub
