前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许开发者扩展功能。dsh-image-skin 是一个 Web 插件，旨在解决界面定制的问题。它允许用户设置背景图片，并自动根据图片的调色板适配 UI 的文本、背景、品牌和边框颜色。
插件简介¶
- 名称：
dsh-image-skin - 维护者：YouHui1
- 类别：趣味换装
- 许可证：MIT
- 定位：通过分析图片颜色自动生成主题令牌，改变 DSH Web 界面的外观。
核心能力¶
- 背景图片：支持上传图片，系统会自动将其缩放至 1600px JPEG 存储。
- 调色板适配：提取图片的平均色和主导色，并以此生成完整的主题令牌集（包括背景、主次标签、品牌色、边框等）。
- 对比度保证：基于 WCAG 相对亮度检查，确保生成的文字颜色与背景对比度达标（主次级 >= 4.5:1，三级文本 >= 3:1）。
- 不透明度控制：提供滑块控制主表面不透明度；对于分层表面（菜单、弹出框），不透明度保持在 >= 80%。
- 图片适配模式：支持覆盖、包含、拉伸三种模式。
- 遮罩：在背景图上添加一层色调遮罩，提高文字可读性。
- 自动亮/暗模式：可选“跟随图片”开关，根据图片亮度自动切换亮色或暗色主题。
- 持久化：图片和设置保存在浏览器的
localStorage中，刷新页面后自动恢复。 - 设置入口：在 DSH 设置中注册了一个“Skin”页面。
安装与启用¶
使用以下命令安装插件：
dsh plugin --profile web add link:<absolute path to this repo>
安装完成后，重启 DeepSeek Harness 并在浏览器中强制刷新页面（Ctrl/Cmd+Shift+R）以生效。
技术细节与限制¶
- 存储机制：图片以
data:image/jpeg格式存储在localStorage的dsh-image-skin.v1键下。 - 颜色限制：高饱和度图片会强烈着色表面；背景饱和度被限制在 45 以内。分层表面（菜单/弹出框）不透明度不低于 80%。
- 重载规则：客户端的更改需要强制刷新；主机端的更改需要重启 DSH。
生态链接¶
- GitHub 仓库：https://github.com/YouHui1/dsh-image-skin
- 社区目录：https://www.skillhub.cn/plugins/YouHui1/dsh-image-skin
