dsh-whalegirl · 鲸鱼娘

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

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

English | 中文

特性

• 完整的 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）