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
方式二：从发布包安装
- 解压发布包到一个固定位置，例如
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 张；点缩略图切换，点缩略图上的 × 删除
图片放满 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。
No comments yet. Be the first to write one.