dsh-theme-button
DeepSeek Harness 的浮动主题小组件：切换官方外观，并使用四个参数和四种适配模式设置自定义背景（图片或纯色）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:zhanghzdev/dsh-theme-button#a6ccf4ffd08f477f00e3b1d1cc82fbc087578157Theme Button 以 dsh-theme-button 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →给 DeepSeek Harness 桌面版加一个悬浮主题挂件：切换官方外观，以及设置一层自定义背景。
挂件浮在界面之上，可以拖到任何位置并记住位置。所有界面自带半透明毛玻璃效果。
| 功能 | 说明 |
|---|---|
| 悬浮挂件 | 默认在右下角，可拖动；位置自动记住；轻点开关面板，拖动时自动收起面板 |
| 官方外观 | 浅色 / 深色 / 跟随系统，写回 DSH 官方外观设置，不是插件自己的一套 |
| 自定义背景 | 纯色（6 个预设 + 自绘取色器）或图片（最多 6 张），二选一 |
| 背景参数 | 不透明度、模糊、亮度、饱和度，图片与纯色各有独立的不透明度 |
| 适配方式 | 填充 / 适应 / 平铺 / 拉伸 |
| 毛玻璃 | 挂件、面板、取色板三者一致；关闭自定义背景即恢复 DSH 原生外观 |
先取得插件文件，再让 DSH 加载它。
把插件文件夹放到一个固定的位置（装好后不要再移动），然后执行：
dsh plugin --profile desktop add link:C:\dsh-plugins\dsh-theme-button
C:\dsh-plugins\dsh-theme-button.\install.ps1
或者手工执行上面那条 dsh plugin ... add link: 命令。
请完全退出并重新启动 DSH。 插件的宿主部分只在启动时加载，仅刷新页面不够。
重启后应该看到右下角出现一个调色板图标按钮。也可以访问：
http://127.0.0.1:<DSH 端口>/dsh-theme-button/version —— 应返回一个版本号| 操作 | 效果 |
|---|---|
| 轻点 | 打开 / 关闭设置面板 |
| 按住拖动 | 移动挂件位置，鼠标变为抓手，面板自动收起；松手后位置自动保存 |
| 位置 | 重开 DSH 后保持上次位置；不会超出屏幕，也不会进入窗口按钮那一行 |
面板第一段是「外观」，三选一：浅色 / 深色 / 跟随系统。选择会同步到 DSH 官方外观设置，与官方设置页双向一致。
面板第二段是「自定义背景」，总开关默认关闭。
打开总开关后，选择背景来源：
图片放满 6 张后，「添加图片」会自动变灰禁用；删掉一张即恢复。
| 操作 | 效果 |
|---|---|
| 上方方形区域 | 拖动手柄调整饱和度与明度 |
| 中间彩色条 | 拖动手柄调整色相，圆环中显示当前选中的颜色 |
| 底部输入框 | 手动输入颜色值，回车或点击别处即生效 |
| ▴ ▾ 按钮 | 在 HEX / RGB / HSL 三种格式之间切换 |
输入时三种格式都认：即使当前显示的是 HEX，直接输入 rgb(255, 0, 0) 也会按 RGB 解析。
| 参数 | 范围 | 说明 |
|---|---|---|
| 不透明度（图片） | 0–10 | 图片的显示强度，0 等于关闭整个效果 |
| 不透明度（纯色） | 0–10 | 纯色独立的一份，与图片那份互不影响 |
| 模糊 | 0–24px | 背景的模糊程度，默认 0 |
| 亮度 | 0–10 | 5 为 100%，即不做调整 |
| 饱和度 | 0–10 | 5 为 100%，即不做调整 |
| 方式 | 效果 |
|---|---|
| 填充 | 铺满整个区域，超出部分裁掉（默认） |
| 适应 | 完整显示整张图，可能留边 |
| 平铺 | 按原尺寸重复平铺 |
| 拉伸 | 拉伸到铺满，会变形 |
| 项目 | 默认值 |
|---|---|
| 挂件位置 | 右下角 |
| 外观 | 跟随系统 |
| 自定义背景 | 关闭 |
| 背景来源 | 未选择 |
| 取色器颜色 | #8FB3A5 |
| 图片 | 无 |
| 适配方式 | 填充 |
| 不透明度 | 5 / 10 |
| 模糊 | 0px |
| 亮度 / 饱和度 | 5 / 10（100%） |
设置保存在本机浏览器存储中，重开 DSH 后全部沿用（面板的开 / 关状态除外）。
dsh plugin --profile desktop remove dsh-theme-button
然后重启 DSH。如果还要清掉本机保存的设置，见「常见问题」最后一条。
挂件没有出现
确认已经完全重启 DSH，而不是只刷新页面。再访问 /dsh-theme-button/version 看是否返回版本号。
背景效果看不见
先确认「自定义背景」总开关是打开的，且不透明度不为 0。
侧边栏 / 某个区域没有效果
少数情况下背景层需要界面自身发生变化才会重新计算。切换一下图片或颜色，或打开一个新会话即可恢复。
改了插件文件没有生效
lib/client.js（界面部分）会自动重载，但同一版本 10 秒内最多重载 3 次，超过请手动刷新页面。lib/index.js（宿主部分）必须重启 DSH。
想恢复出厂设置
打开开发者工具，执行下面这行后刷新页面：
localStorage.removeItem('dsh-theme-button.state.v2')
这个项目不保证持续更新，所以反馈的意义不是"让我去改"，而是把问题记录下来： 让后来遇到同样情况的人能在这里搜到答案，也让将来想接手的人知道有哪些坑。
所以无论你只是想说一句"这里好像不对"，还是发现了具体的 Bug，都欢迎告诉我：
| 请提供 | 在哪看 |
|---|---|
| 你做了什么操作 | 越具体越好 |
| 期望的结果 / 实际的结果 | 分别是什么 |
| 插件版本 | package.json 里的 version，或访问 /dsh-theme-button/version |
| DSH 版本 | DSH 的「关于」页 |
| 截图 | 最有效，能省很多来回 |
联系方式
zhanghz1130@outlook.com（标题里带上 dsh-theme-button，方便我归档）我不承诺一定会修，但会尽量看一眼。如果问题只影响你的个别情况，也欢迎自行修改—— MIT 许可，随便改、随便发。
| 文件 | 作用 |
|---|---|
package.json | 插件清单 |
cordis.patch.yml | 让 DSH 在启动时加载本插件 |
lib/index.js | 宿主部分：注册路由、注入页面脚本、读写外观偏好 |
lib/client.js | 界面部分：挂件、面板、取色器、背景效果 |
install.ps1 | 安装辅助脚本 |
LICENSE | 许可协议 |
_dev/ 是开发资料（历史备份与补丁脚本），不参与分发，可以删除。
# 打包：只收集该分发的文件，输出到 dist/
.\pack.ps1
改完 lib/client.js 后页面会自动重载（它每 2.5 秒检查一次版本号）；改完 lib/index.js
需要重启 DSH。
代码里有较多注释，说明了每一处设计的取舍；遇到疑问也欢迎直接反馈。
这个插件是用 AI 辅助完成的。我本人不是程序员，没有独立写出这些代码的技术能力， 但我投入了大量时间去提需求、试效果、找问题、反复验证，也承担了 AI 开发工具的费用。
项目状态：功能已完整可用。我不承诺持续更新——它现在够用，我就不一定继续折腾了。 代码是 MIT 许可，任何人都可以自己改、自己发。
如果你觉得它好用，欢迎请我喝杯水。金额随意，每笔 2 元、凑够 20 个人我就不亏了。
微信扫码即可打赏，金额随意。感谢你的支持！
微信赞赏码感谢每一位打赏者的支持（按时间顺序）：
MIT，见 LICENSE。