前言¶
DSH 插件生态强调「一切皆插件」。对本地运行 DeepSeek Harness Web GUI 的人来说，换皮肤常会碰到两个问题：一是只想改外观，不想碰源码；二是手工改过 dist 后，升级或回滚都不方便。dataizu/dsh-whale-aqua-theme 把这个主题做成 DSH 插件包，同时保留传统 dist 补丁安装方式。它主要提供三样东西：macOS 风格皮肤、水中鲸鱼动态背景、点阵鲸鱼发送按钮。
这是什么¶
dataizu/dsh-whale-aqua-theme 是一个用于 DeepSeek Harness Web GUI 的外观主题包。它不改服务逻辑，不改源码，重点在 Web 前端样式和动画。仓库提供 MIT License 的样式与脚本，同时说明 DeepSeek 鲸鱼图形为 DeepSeek 官方资产，版权归 DeepSeek 所有；该仓库仅用于个人主题美化，请勿商用。
核心功能¶
- 水中鲸鱼背景：为 Web 界面提供动态水底效果。
- 点阵鲸鱼发送按钮：发送按钮使用点阵鲸鱼图形，运行时可带动画。
- 苹果风皮肤：提供 macOS 风格界面样式。
- 低开销动画：性能参数为
DPR 1.25、24fps，失焦或隐藏时自动暂停，按钮动画按需绘制。 - DSH 插件包安装：可作为插件包随 profile 安装、停用、卸载。
- 插件生命周期管理：插件方式下，停止插件即可完全回收副作用。
- 传统
dist补丁安装：也可把样式文件复制到 Web 前端目录，并拼接到index.html。
安装与启用¶
插件方式安装¶
插件方式安装不改动任何 dist 文件，DSH 升级不受影响。执行下面命令，从 GitHub 仓库地址安装该插件包：
dsh plugin --profile web add https://github.com/dataizu/dsh-whale-aqua-theme
安装完成后重启 DSH 生效。
停用¶
停用插件时，删除 profile 配置中该主题对应的 insert 行。对应标识为：
id: dsh-whale-aqua
配置文件为 cordis.patch.yml。如果你当前环境中有可用的插件市场入口，也可以按市场中的卸载或移除操作处理；本文不把市场入口作为确定前提。
AI 辅助部署¶
如果不想手工修改文件，可以把仓库 README 中的 AI 部署提示词原样复制给 AI，让它自动完成定位、备份、复制和拼接。执行后仍需硬刷新页面查看效果，并检查皮肤是否生效。
传统 dist 补丁安装¶
如果不想引入插件系统，可以使用传统 dist 补丁方式。先找到目标机器自己的 DSH Web 前端目录，目录中应包含：
index.html
然后把主题样式文件复制到该 dist 目录：
apple-style.css
whale-icon.css
接下来打开该目录下的 index.html，做两处修改。第一处在 <head> 中加入样式引用：
<link rel="stylesheet" href="/whale-icon.css" />
<link rel="stylesheet" href="/apple-style.css" />
第二处把背景动画脚本插入到 </body> 之前。仓库中的脚本片段位于：
install/background-snippet.html
需要把其中的 <script>...</script> 块复制到目标 index.html。
完成后硬刷新页面：
Ctrl+Shift+R
注意：这里只能使用目标机器自己的 index.html，不要用仓库中的整页文件直接覆盖不同版本构建。
same-version 整页覆盖¶
仓库提供 same-version/index.html，它只适用于与开发版本相同的 DSH 构建。如果把它覆盖到不同版本的 DSH，会导致界面无法加载，因此默认不推荐。
版本兼容¶
这个主题分两部分，兼容性不同。
- 背景动画 + 发送按钮鲸鱼：README 标注为任意 DSH 版本可用，主要依赖稳定 DOM 特征。
apple-style.css：依赖编译后的 CSS 类名。不同 DSH 版本的类名哈希可能不同，皮肤可能部分或全部不生效。
如果皮肤未生效，按下面步骤处理：
1、在页面按 F12 打开检查器；
2、查看目标元素的实际类名；
3、替换 apple-style.css 中对应的哈希前缀，保持稳定的类名后缀不变。
适用场景与注意¶
- 适合本地运行 DSH Web GUI，并且只希望做界面美化的场景。
- 插件方式安装不改动任何
dist文件，DSH 升级不受影响；停止插件即完全回收副作用。 - DSH 插件以当前
dsh进程权限运行，安装前应检查源码、依赖和许可证。 - 样式与脚本为 MIT License；DeepSeek 鲸鱼图形版权归 DeepSeek 所有，本仓库仅用于个人主题美化，请勿商用。
链接¶
GitHub 仓库：
https://github.com/dataizu/dsh-whale-aqua-theme
插件目录页（来自插件线索，访问前请核对）：
https://www.skillhub.cn/plugins/dataizu/dsh-whale-aqua-theme
