在 DSH（DeepSeek Harness）的开发与调试流程中，Web 界面的视觉呈现往往是定制化需求的起点。虽然 DSH 提供了基础的插件架构，但默认的背景样式较为单一。dsh-whale-background 插件旨在解决这一问题，为 DSH Web GUI 提供深海鲸鱼娘主题壁纸，并支持应用半透明磨砂效果，允许开发者自定义背景图片、透明度及铺放方式。
插件定位¶
这是一个针对 DSH Web GUI 的背景扩展插件，属于「趣味换装」类别。由开发者 tuogusa 维护，采用 MIT 许可证。它通过注入 CSS 样式和模板，改变应用表面的视觉呈现，不涉及核心逻辑修改。
核心功能¶
- 内置鲸鱼壁纸：插件包含默认的深海鲸鱼娘壁纸，该图片在构建时被内联为 Base64，因此无需加载外部资源即可直接使用。
- 设置页自定义背景：进入 DSH Web 的设置页即可操作。
- 本地图片：选择本地文件，插件会自动将其转换为 data URL。
- 远程图片：粘贴图片 URL，插件会进行预加载检查，若加载失败会明确提示。远程图片加载时会自动添加
no-referrer策略，以降低防盗链影响。
- 恢复与清除：支持一键清除自定义图片设置，恢复至内置的鲸鱼壁纸。
- 表面透明度：提供 0-100% 的滑块，实时调节应用表面的透明度，实现磨砂玻璃效果。
- 铺放方式：支持背景图片的铺放逻辑选择。
contain：完整显示图片，两侧留白。cover：铺满全屏，裁切多余部分。
- 持久化存储：所有配置（背景图、透明度、铺放方式）保存在浏览器的
localStorage中，刷新页面或重启 DSH 后设置依然存在。
安装与配置¶
安装插件¶
插件仅兼容 Profile web（DSH Web GUI）。安装时请使用以下命令：
dsh plugin --profile web add github:tuogusa/dsh-whale-background
安装完成后，重启 DSH 并按 Ctrl+Shift+R 刷新浏览器（若未连接 HMR）。
更新插件¶
如需更新到最新版本，可以使用 CLI 命令：
dsh plugin --profile web update dsh-whale-background
自定义壁纸（开发者操作）¶
如果你希望替换默认的鲸鱼壁纸，可以直接替换源码中的图片文件。
- 将新的壁纸图片（支持 JPG/PNG/WebP/GIF）覆盖到
assets/wallpaper.jpg。 - 执行构建脚本重新生成客户端代码：
node build.js
这会重新生成 lib/client.js，将新壁纸内联进去。若已连接 HMR，更新会自动生效；否则需刷新浏览器。
使用说明¶
安装并重启后，进入 DSH Web 界面：
- 点击右上角设置按钮。
- 找到「背景」选项卡。
- 在此页面进行以下操作：
- 更换背景：点击「选择文件」上传本地图片，或粘贴 URL。
- 调节透明度：拖动滑块调整磨砂效果强度。
- 调整铺放：选择
contain或cover模式。 - 恢复默认：点击「恢复默认」按钮清除所有自定义设置。
注意事项¶
- 兼容性：仅适用于 DSH Web GUI，不兼容其他 Profile。
- 网络策略：远程图片加载使用了
no-referrer策略，这是为了减少因 Referer 签名导致的防盗链拦截。 - 刷新机制：如果在未连接 HMR 的情况下修改了插件源码或配置，建议使用
Ctrl+Shift+R强制刷新浏览器以确保样式生效。
该插件为开发者提供了一个轻量级的 UI 定制方案，通过简单的配置即可改变 DSH Web 的视觉风格。更多细节与源码，可参考插件目录或 GitHub 仓库。
