前言¶
在 DSH 的“一切皆插件”路线里，界面外观也可以做成可替换的客户端插件。如果你长期使用 http://127.0.0.1:3080 的 DSH Web 界面，又希望按本地图片或视频调整背景，而不直接修改 DSH 源码，dsh-client-ui-skins 就是这类场景下的一个可选方案。
它把内置皮肤、自定义图片/视频皮肤、背景遮罩和输入框不透明度集中到 DSH 设置里，完成安装后刷新页面即可使用。
这是什么¶
当前仓库为 caoyiwei850/dsh-client-ui-skins，定位是 DSH Web 界面换肤插件。
已核实的边界如下：
- 面向 DSH Web 界面。
- 提供 4 套内置皮肤和自定义图片/视频皮肤。
- 纯 client 插件，不改 DSH 源码。
- 卸载后恢复原生外观。
- 许可证为 MIT。
- 需要 DSH web profile，路径为
~/.dsh/profiles/web。 - 依赖
pnpm。
核心功能¶
下面介绍已核实的几类能力。
内置皮肤¶
提供 4 套内置皮肤：
- 深海蓝
- 樱粉
- 薄荷
- 琥珀
这 4 套皮肤在深色和浅色外观下都适配。
自定义图片壁纸¶
支持任意 PNG、JPG、WebP 图片。
导入后，界面配色会自动取自主图，用于背景、强调色和交互高亮。
视频动态壁纸¶
支持 MP4、WebM 视频循环播放。
视频皮肤使用首帧取色生成配色。
背景遮罩滑块¶
用于独立调节壁纸明暗。
当背景图较复杂、文字对比不足时，可以通过遮罩降低背景干扰。
输入框不透明度滑块¶
用于独立调节输入框背景。
目标是保证在自定义背景上打字时，输入区仍然清晰。
正文加强开关¶
用于给助手正文加一层轻磨砂底。
当背景图高光区较强时，可以开启这个开关，减少阅读干扰。
安装与启用¶
一键安装¶
先运行安装脚本：
bash install-dsh-skins.sh
完成后刷新页面：
http://127.0.0.1:3080
然后进入左下角：
设置 → 通用设置 → 皮肤
手动安装¶
如果你需要手动操作，先在 DSH web profile 下安装本地插件包：
cd ~/.dsh/profiles/web && pnpm add -w ./dsh-client-ui-skins-0.1.13.tgz
接着编辑注册文件：
~/.dsh/profiles/web/cordis.patch.yml
追加以下插件项：
- insert:
- id: ui-skins
name: 'dsh-client-ui-skins'
最后重启 DSH Web 进程：
launchctl kickstart -k gui/$(id -u)/com.deepseek.dsh.web
卸载¶
运行卸载脚本：
bash uninstall-dsh-skins.sh
典型用法¶
下面是一组可复现的使用步骤。
1、刷新 DSH Web 界面：
http://127.0.0.1:3080
2、进入设置入口：
设置 → 通用设置 → 皮肤
3、选择内置皮肤。
可以直接点击内置皮肤卡片切换，例如深海蓝、樱粉、薄荷、琥珀。
4、选择自定义皮肤。
点击：
自定义（选图/视频）
然后从本机选择图片或视频。
5、调整自定义皮肤参数。
自定义皮肤激活后，会出现以下控件：
- 背景遮罩滑块
- 输入框不透明度滑块
- 正文加强开关
这些参数可以实时预览，插件也会记住偏好。
适用场景与注意¶
适合谁¶
这个插件更适合以下使用方式：
- 长期在 DSH Web 界面里工作，希望调整视觉背景。
- 想使用本机图片或视频作为背景，但不想改 DSH 源码。
- 希望保留 DSH 原生功能，只在客户端外观层做扩展。
- 需要卸载后恢复原生外观。
使用前注意¶
- 插件是纯 client 插件，不改 DSH 源码。
- 卸载后恢复原生外观。
- 自定义图片/视频只在本机流转：图片存
localStorage，视频存IndexedDB，不会上传到任何服务器。 - 需要 DSH web profile：
~/.dsh/profiles/web
- 依赖
pnpm。 - 插件以当前 DSH 进程权限运行。安装前建议检查仓库源码、安装脚本与许可证；当前资料给出的许可证为 MIT。
- 已抓取资料中存在版本号不一致：README 与安装包示例使用
0.1.13，package.json示例显示0.1.14。本文手动安装命令沿用已核实用法中的0.1.13安装包名，实际安装前请以仓库内实际文件为准。
链接¶
- GitHub：
https://github.com/caoyiwei850/dsh-client-ui-skins
- 社区目录页：
https://www.skillhub.cn/plugins/caoyiwei850/dsh-client-ui-skins
如果你只是想给 DSH Web 界面换一套背景，并保持“不动源码、可卸载”的边界，这个插件的路径比较直接：先执行安装脚本，再进入设置里选择皮肤；需要个性化时，再导入本机图片或视频，并调好遮罩与输入框不透明度。
