前言¶
DeepSeek Harness（DSH）是面向智能体开发者的可视化编排工具。默认界面通常较为朴素，开发者希望在不改变 DSH 核心逻辑的前提下，通过皮肤定制界面样式。现有方案要么零散打补丁，要么不支持多主题切换。鲸鱼娘皮肤通过统一调色板与皮肤管理器协议，将视觉改造模块化。
是什么¶
鲸鱼娘是 DSH Web GUI 的主题皮肤，由维护者 zhenhua520 接入 skin-manager 生态。它基于 DreamSkin 的鲸鱼娘皮肤包，由 ZHOUcourier 首次移植到 DSH，本仓库将其重制为可被皮肤管理器发现、切换、调参的独立皮肤包，并补齐了深色外观。
插件提供完整的令牌重映射、浅色/深色/跟随系统三态、对话区壁纸收敛、以及 7 项实时可调参数。
核心功能¶
统一调色板¶
174 个 --dsw-* 令牌全部由统一调色板推导，包括表面、文字、边框、按钮、代码块、滚动条、状态色等。不是零散打补丁，而是从调色板生成的视觉一致性。
三态外观¶
通过 theme.overrideTokens() 一次提交 { light, dark } 两套调色板，由 presenter 按当前外观自行选取。皮肤不改写你的外观偏好，你在「设置 → 通用 → 外观」里选浅色、深色或跟随系统，皮肤会自动对应。
对话区壁纸¶
壁纸只铺在对话列，作为 background-image。侧栏、插件页、设置页保持自身的实底，不会出现壁纸跑到别处的情况。
皮肤管理器接入¶
提供 skin.json 与 customization 协议 v2，可与「深海女仆工坊」「虎鲸链路」等皮肤互斥切换。启动时由管理器兜底。需要在「设置 → 皮肤管理」里选择「鲸鱼娘」。
7 项实时参数¶
在「设置 → 皮肤管理」里拖动即时生效，无需刷新。按 skinId 保存在浏览器 localStorage。
| 参数 | 范围 | 默认 | 说明 |
|---|---|---|---|
| 主框背景模糊 | 0–24px | 4px | 应用主框毛玻璃的半径；0 = 完全关闭 |
| 表面透明度 | 0–100% | 45% | 0 = 面板全不透明，100 = 原版半透设计 |
| 用户气泡透明度 | 0–100% | 70% | 用户消息气泡的透出程度 |
| 壁纸遮罩浓度 | 0–100% | 58% | 盖在插画上的纸色薄纱强度 |
| 显示环境壁纸 | 开/关 | 开 | 关闭后回到纯净纸面 |
| 壁纸模糊 | 0–16px | 0px | 插画本身的锐度（不影响文字） |
| 输入框聚焦光晕 | 开/关 | 开 | DreamSkin 原版的咖啡色聚焦描边 |
壁纸模糊控制插画锐度，壁纸遮罩控制插画显不显眼。想让鲸鱼娘更清楚就降前者，想让文字更稳就升后者。
安装与启用¶
需要先安装皮肤管理器 @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
适用场景与注意¶
适合需要自定义 DSH 界面风格、希望界面与对话内容视觉分离的开发者。皮肤以当前 dsh 进程权限运行，安装前应检查源码与许可证。
代码以 MIT 授权，可商用；美术素材以 CC BY-NC-SA 4.0 授权，禁止商业使用。修改后必须以相同许可分发，并保留完整署名链。
署名链¶
鲸鱼娘角色与全部图片素材均为衍生作品，按创作顺序致谢：
- 一创 上善（Pixiv · Bilibili：上善无形）—— 角色形象原作者
- 二创 ZipZipPipe（Pixiv）—— 加入 DeepSeek 元素的二次设计
- 三创 Small-tailqwq ——
dsh-deep-whale皮肤家族的再设计 - 移植 ZHOUcourier —— 首次移植到 DSH，本包继承其调色板锚点、壁纸与 CSS 生成逻辑
本包新增：skin-manager 接入（协议 v2 / skin.json / 实时参数）、深色调色板、外观三态映射、壁纸收敛到对话列、以及行内代码/改动卡片/滑杆/反色徽标的对比度修正。
短结尾¶
鲸鱼娘皮肤通过统一调色板与皮肤管理器协议，将视觉改造模块化，支持浅色、深色、跟随系统三态，并提供 7 项实时可调参数。更多细节与源码见：https://github.com/zhenhua520/dsh-whalegirl
