前言¶
DSH 的理念是「一切皆插件」。对已经使用 dsh Web UI 的开发者来说，外观定制最好以插件形式提供：可安装、可卸载，并尽量减少对宿主界面的长期影响。
下面介绍 dsh-skin-blue-whale。它是为 dsh Web UI 打造的蓝鲸跃海主题插件，提供官网同款蓝白渐变背景、官方蓝鲸 logo 动画、主页/会话双场景自适应，以及整套蓝鲸配色界面令牌。DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-skin-blue-whale 是一个 dsh Web UI 皮肤插件，维护者为 zenghuizhu69-hub，许可证为 MIT。
它解决的是 dsh Web UI 的主题化问题：在界面中叠加一层蓝鲸跃海视觉，同时保留主页空会话和对话/思考中两种场景下的可用性。
核心功能¶
下面介绍该插件已核实的主要能力：
- 浅色模式复刻 DeepSeek 官网 Hero 区蓝白渐变，深色模式自动适配为夜海幽光版。
- 使用 DeepSeek 官方鲸鱼 logo 路径绘制鲸鱼，并包含水花飞溅、涟漪扩散、气泡上升效果。
- 主页空会话场景下，鲸鱼以输入框为海平面跃出，并在输入框顶边显示发光水线。
- 对话或思考中场景下，鲸鱼变为整页居中的底层水印，约 10% 透明度，不占据左侧边栏。
- 将按钮、焦点环、选区、聊天气泡、侧栏、滚动条统一覆盖为 DeepSeek 蓝鲸蓝令牌。
- 尊重系统
prefers-reduced-motion偏好，用户偏好减少动效时关闭动画。 - 卸载插件时，令牌层、DOM、样式、监听器自动还原，无残留。
安装与启用¶
前置要求为：
Node 20+
pnpm
dsh 0.1.0-rc.6+
请将仓库克隆到不含空格的路径。当前 dsh CLI 在路径含空格时，转发给 pnpm 的绝对路径不会加引号，会导致安装失败。
下面执行安装命令：
git clone https://github.com/zenghuizhu69-hub/dsh-skin-blue-whale.git
cd dsh-skin-blue-whale
dsh plugin --profile web add .
经过上面的步骤，dsh plugin 会将本包以 link: 方式挂进 profile。因此克隆目录请勿移动；如果移动了目录，需要重新执行：
dsh plugin --profile web add .
安装后重启 Web 服务即可生效：
dsh web
典型用法¶
安装并重启 dsh web 后，插件会在 Web UI 中生效。
如果修改插件源码，需要再次重启 dsh web 才会加载新版本：
dsh web
卸载时使用下面命令：
dsh plugin --profile web remove dsh-skin-blue-whale
卸载后重启 Web 服务，可还原基础样式：
dsh web
适用场景与注意¶
适合希望给 dsh Web UI 增加蓝鲸跃海主题，并保留可卸载、可还原能力的用户。安装前请检查插件源码与 MIT 许可证；插件以当前 dsh 进程权限运行，应将其视为普通第三方插件包使用。
使用时注意以下几点：
- 克隆目录请勿移动。
- 请将仓库克隆到不含空格的路径。
- 移动目录后，需要重新执行
dsh plugin --profile web add .。 - 修改插件源码后，需要重启
dsh web。 - 卸载后需要重启 Web 服务以还原基础样式。
链接¶
- GitHub：https://github.com/zenghuizhu69-hub/dsh-skin-blue-whale
- 社区目录页：本资料未确认具体 URL，以 DSH 插件社区目录实际发布为准。
