鲸鱼娘皮肤 zhenhua520/dsh-whalegirl

dsh-whalegirl · 鲸鱼娘

DeepSeek Harness（DSH）Web GUI 的鲸鱼娘皮肤，接入 skin-manager 的皮肤协议。

视觉源自 DreamSkin 的鲸鱼娘皮肤包，由 ZHOUcourier/dsh-theme-whalegirl 首次移植到 DSH。本仓库将其重制为可被皮肤管理器发现、切换、调参的独立皮肤包，并补齐了深色外观。

预览

特性

- 完整的 174 个 --dsw- 令牌重映射 —— 表面、文字、边框、按钮、代码块、滚动条、状态色全部由统一调色板推导，不是零散打补丁。
- 浅色 / 深色 / 跟随系统三态 —— 两套调色板通过 theme.overrideTokens() 成对提交（{ light, dark }），由 presenter 按当前外观自行选取，不会改写你的外观偏好。
- 壁纸只铺在对话列 —— 鲸鱼娘作为对话区的 background-image，侧栏、插件页、设置页保持自身的实底，不会出现「壁纸跑到别处」。
- 7 项实时参数 —— 在「设置 → 皮肤管理」里拖动即时生效，无需刷新。
- 可被皮肤管理器管理 —— 提供 skin.json 与 customization 协议 v2，与「深海女仆工坊」「虎鲸链路」等皮肤互斥切换，启动时由管理器兜底。

安装

需要已安装皮肤管理器 @smalltailqwq/dsh-client-ui-skin-deep-whale-manager：

dsh plugin --profile web add '@smalltailqwq/dsh-client-ui-skin-deep-whale-manager'
dsh plugin --profile web add 'dsh-whalegirl'

从 GitHub Release 的预构建包安装：

dsh plugin --profile web add -w https://github.com/zhenhua520/dsh-whalegirl/releases/latest/download/dsh-whalegirl.tgz

从本地目录 / 压缩包安装：

dsh plugin --profile web add -w /path/to/dsh-whalegirl
dsh plugin --profile web add -w /path/to/dsh-whalegirl-1.0.19.tgz

安装后重启一次 DSH：

dsh web

然后在 设置 → 皮肤管理 里选择「鲸鱼娘」。

卸载：

dsh plugin --profile web remove dsh-whalegirl

可调参数

设置 → 皮肤管理 → 鲸鱼娘。全部实时生效，按 skinId 保存在浏览器 localStorage。

| 参数 | 范围 | 默认 | 说明 |
| 主框背景模糊 | 0–24px | 4px | 应用主框毛玻璃的半径；0 = 完全关闭 |
| 表面透明度 | 0–100% | 45% | 0 = 面板全不透明，100 = 原版半透设计 |
| 用户气泡透明度 | 0–100% | 70% | 用户消息气泡的透出程度 |
| 壁纸遮罩浓度 | 0–100% | 58% | 盖在插画上的纸色薄纱强度 |
| 显示环境壁纸 | 开/关 | 开 | 关闭后回到纯净纸面 |
| 壁纸模糊 | 0–16px | 0px | 插画本身的锐度（不影响文字） |
| 输入框聚焦光晕 | 开/关 | 开 | DreamSkin 原版的咖啡色聚焦描边 |

壁纸模糊控制的是插画锐度，壁纸遮罩控制的是插画显不显眼。想让鲸鱼娘更清楚就降前者，想让文字更稳就升后者。

外观三态

皮肤不改写你的外观偏好：

| 你在「设置 → 通用 → 外观」里选 | 结果 |
| 浅色 | 鲸鱼娘浅色版（纸面 + 长春花蓝） |
| 深色 | 鲸鱼娘深色版（深蓝紫 + 浅字） |
| 跟随系统 | 随系统明暗实时切换 |

实现上通过 theme.overrideTokens() 一次提交两种模式的值，因此 preference 始终是你选的那个，不会被插件覆盖。

兼容性

- 需要 DSH >=0.2.0-rc.2 <0.3.0-0
- 需要 @deepseek-ai/cordis ^4.0.1、react >=18
- 仅 Web 客户端（dsh.client.platform: "web"）
- 与 skin-manager 生态的其它皮肤互斥切换；未安装管理器时也能单独工作（退回注册一个亮色主题）

署名与许可

代码与美术分开授权。

代码 —— MIT

package.json、skin.json、cordis.patch.yml、lib/index.js、lib/client.js 以 MIT 授权，见 LICENSE。可商用。

美术素材 —— CC BY-NC-SA 4.0

assets/background.jpg、assets/previews/.png 以 署名-非商业性使用-相同方式共享 4.0 国际（CC BY-NC-SA 4.0） 授权，见 LICENSE-ARTWORK。禁止商业使用。
修改后必须以相同许可分发，并保留完整署名链。

署名链

鲸鱼娘角色与全部图片素材均为衍生作品，按创作顺序致谢：

1. 一创 上善（Pixiv · Bilibili：上善无形）—— 角色形象原作者
2. 二创 ZipZipPipe（Pixiv）—— 加入 DeepSeek 元素的二次设计
3. 三创 Small-tailqwq —— dsh-deep-whale 皮肤家族的再设计
4. 移植 ZHOUcourier —— 首次移植到 DSH（dsh-theme-whalegirl），本包继承它的调色板锚点、壁纸与 CSS 生成逻辑

本包新增：接入 skin-manager（协议 v2 / skin.json / 实时参数）、深色调色板、外观三态映射、壁纸收敛到对话列，以及行内代码、改动卡片、滑杆、反色徽标的对比度修正。

完整说明见 NOTICE。

开发

语法检查
node --check lib/client.js

打包（无需构建步骤，lib/ 已随包提交）
tar czf dsh-whalegirl.tgz package.json skin.json cordis.patch.yml lib assets README.md README.en.md LICENSE

结构：

package.json dsh.bundle + dsh.client + peerDependencies
skin.json 皮肤管理器发现所需的元数据 cordis.patch.yml bundle 自身的 insert 行 lib/index.js host 半（空 apply，纯视觉插件） lib/client.js 浏览器半：调色板、CSS、协议、参数 assets/background.jpg 壁纸（同时以 base64 内嵌进 client bundle）