悬浮主题挂件 zhanghzdev/dsh-theme-button

dsh-theme-button

给 DeepSeek Harness 桌面版加一个悬浮主题挂件：切换官方外观，以及设置一层自定义背景。

挂件浮在界面之上，可以拖到任何位置并记住位置。所有界面自带半透明毛玻璃效果。

效果展示

| 自定义背景：关闭 | 自定义背景：纯色 |

| 自绘取色器 | 自定义背景：图片 |

面板、挂件、取色板都是半透明毛玻璃，只在自定义背景开启时生效。

功能

| 功能 | 说明 |
| 悬浮挂件 | 默认在右下角，可拖动；位置自动记住；轻点开关面板，拖动时自动收起面板 |
| 官方外观 | 浅色 / 深色 / 跟随系统，写回 DSH 官方外观设置，不是插件自己的一套 |
| 自定义背景 | 纯色（6 个预设 + 自绘取色器）或图片（最多 6 张），二选一 |
| 背景参数 | 不透明度、模糊、亮度、饱和度，图片与纯色各有独立的不透明度 |
| 适配方式 | 填充 / 适应 / 平铺 / 拉伸 |
| 毛玻璃 | 挂件、面板、取色板三者一致；关闭自定义背景即恢复 DSH 原生外观 |

环境要求

- DeepSeek Harness 桌面版（Windows）
- 无需额外依赖

安装

先取得插件文件，再让 DSH 加载它。

方式一：本地链接安装（推荐）

把插件文件夹放到一个固定的位置（装好后不要再移动），然后执行：

dsh plugin --profile desktop add link:C:\dsh-plugins\dsh-theme-button

方式二：从发布包安装

1. 解压发布包到一个固定位置，例如 C:\dsh-plugins\dsh-theme-button
2. 在该目录下运行：

.\install.ps1

或者手工执行上面那条 dsh plugin ... add link: 命令。

完成后必须重启

请完全退出并重新启动 DSH。 插件的宿主部分只在启动时加载，仅刷新页面不够。

验证安装成功

重启后应该看到右下角出现一个调色板图标按钮。也可以访问：

- http://127.0.0.1:<DSH 端口>/dsh-theme-button/version —— 应返回一个版本号

使用方法

挂件

| 操作 | 效果 |
| 轻点 | 打开 / 关闭设置面板 |
| 按住拖动 | 移动挂件位置，鼠标变为抓手，面板自动收起；松手后位置自动保存 |
| 位置 | 重开 DSH 后保持上次位置；不会超出屏幕，也不会进入窗口按钮那一行 |

官方外观

面板第一段是「外观」，三选一：浅色 / 深色 / 跟随系统。选择会同步到 DSH 官方外观设置，与官方设置页双向一致。

自定义背景

面板第二段是「自定义背景」，总开关默认关闭。

打开总开关后，选择背景来源：

- 纯色：点色板里的预设，或点最右边的方块打开取色器自定义
- 图片：点「添加图片」选图，最多 6 张；点缩略图切换，点缩略图上的 × 删除

图片放满 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，方便我归档）
- GitHub Issues：提交 Issue —— 推荐用这个，问题公开留存，别人能直接看到

我不承诺一定会修，但会尽量看一眼。如果问题只影响你的个别情况，也欢迎自行修改—— MIT 许可，随便改、随便发。

已知限制

- 只支持 Windows 桌面版 DSH（边框预留区的处理依赖 Windows 窗口变量）
- 取色器与面板都绘制在自己的浮层里，不会与 DSH 原生菜单抢占最上层：DSH 自己的菜单和对话框会盖住它们
- 图片上限 6 张，且受浏览器存储容量限制

项目文件

| 文件 | 作用 |
| 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 许可，任何人都可以自己改、自己发。

如果你觉得它好用，欢迎请我喝杯水。感谢你的支持！

感谢支持

许可

MIT，见 LICENSE。