# dsh-theme-whalegirl

DeepSeek-鲸鱼娘主题，面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）Web UI——移植自 DreamSkin 皮肤包 [`ver_cb557ececaa5de3f3dbe`](https://dreamskin.cc/themes/ver_cb557ececaa5de3f3dbe)。

[English](README.md) | 中文

![预览](assets/previews/preview.png)

## 功能

- **完整令牌重映射** —— 在 DSH 原生主题系统注册一套亮色主题（`deepseek-whalegirl`），携带完整的 `--dsw-*` 令牌字典（174 个）：表面、文字、边框、按钮、代码块、滚动条、状态色的每一档都由 DreamSkin 调色板推导。
- **默认轻磨砂** —— 鲸鱼娘插画作为固定背景衬在界面之后；自 0.2.0 起大幅降低磨砂感：主框背景模糊从 18px 降到 4px，各表面不透明度大幅提高，只保留一丝壁纸的透光。
- **玻璃与壁纸可调** —— 主框模糊、表面/气泡透明度、壁纸遮罩、壁纸显示与模糊、输入框聚焦光晕均可在设置页的插件卡片中实时调节（保存在浏览器本地），并附带三套预设：清爽玻璃 / DreamSkin 原味 / 纯净实底。
- **DreamSkin safe-css 意图移植** —— 圆角侧边栏、咖啡色输入框聚焦光晕（可关）、沙金色选中文本、紫调柔和阴影。
- **原生集成** —— 插件挂载时通过 `theme.setTheme()` 固定主题；内置「外观」设置重置偏好为*跟随系统*时会自动恢复。你在「外观」里显式选择亮/暗色则优先，直到在市场主题页把插件关开一次后恢复。

取自源皮肤的调色板锚点：

| 角色 | 源值 | 用途 |
| --- | --- | --- |
| 文字 text | `#352970` | 主标签、墨色阶梯 |
| 高亮 highlight | `#455b78` | 品牌与主按钮 |
| 强调 accent | `#7a4e29` | 输入框聚焦光圈 |
| 次强调 accentAlt | `#ceb683` | 导航选中描边、选区 |
| 次色 secondary | `#85c1cc` | 蓝/信息色阶梯 |
| 面板 panel / panelAlt | `#abb4cf` / `#c3cee4` | 长春花蓝侧边栏玻璃 |
| 背景 background | `#bd9999` | 玫瑰纸色调、气泡 |

## 安装

从 [dsh-market](https://github.com/dsh-market/dsh-market) 插件的主题 Tab 搜索 "whalegirl"，或在终端：

```sh
# GitHub Release 预构建包（免构建）
dsh plugin --profile web add -w https://github.com/ZHOUcourier/dsh-theme-whalegirl/releases/latest/download/dsh-theme-whalegirl.tgz
```

其他来源：

```sh
# git 仓库
dsh plugin --profile web add -w github:ZHOUcourier/dsh-theme-whalegirl

# npm
dsh plugin --profile web add -w dsh-theme-whalegirl

# 本地目录
dsh plugin --profile web add -w link:/path/to/dsh-theme-whalegirl
```

重启 profile 生效：

```sh
dsh --profile web
```

插件挂载后主题立即应用。想切走：在 设置 → 通用 → 外观 选择偏好即可（插件会让位）；想切回：在市场主题页把插件关闭再开启。

## 自定义

打开 **设置 → 插件配置页**，找到 **「鲸鱼娘 · 玻璃与壁纸」** 卡片。所有改动即时生效，仅保存在当前浏览器的 localStorage（`dsh-whalegirl.prefs.v1`），不写入 profile。

| 控制项 | 范围 | 默认 | 说明 |
| --- | --- | --- | --- |
| 预设 | — | 清爽玻璃 | 一键切换 清爽玻璃 / DreamSkin 原味 / 纯净实底 |
| 主框背景模糊 | 0–24px | 4px | 应用主框毛玻璃的模糊半径（旧版硬编码 18px） |
| 表面透明度 | 0–100% | 45% | 0 = 表面全不透明，100 = 原版半透设计 |
| 用户气泡透明度 | 0–100% | 60% | 玫瑰色用户气泡的透出程度 |
| 壁纸遮罩浓度 | 0–100% | 55% | 壁纸上纸色薄纱的强度 |
| 显示环境壁纸 | 开/关 | 开 | 关闭后回到纯净纸色背景 |
| 壁纸模糊 | 0–16px | 0px | 柔化插画细节 |
| 输入框咖啡色聚焦光晕 | 开/关 | 开 | DreamSkin 原版输入框聚焦描边 |

**恢复默认** 按钮还原上表默认值。从 0.1.x 升级直接使用新默认值（更轻的磨砂），不做迁移。

卸载：

```sh
dsh plugin --profile web remove dsh-theme-whalegirl
```

## 兼容性

- 需要 DSH web 客户端 profile（`dsh.client.platform: "web"`，客户端入口经 `exports["./client"]` 暴露）。
- 仅提供亮色外观——忠实还原源皮肤的单套亮色调色板。
- 与其他插件共存；禁用时不触碰任何东西，只依赖受控的 body 属性 `data-dsh-whalegirl`。

## 开发

```sh
npm run build   # 将 src/client.js 包装为 lib/client.js 并内嵌 assets/background.jpg
npm test        # 冒烟测试：对 mock DOM 走一遍 register/guard/dispose
npm run check   # 校验 lib/ 与 src/ 一致（CI 用）
```

构建零依赖（纯 Node）。`lib/` 已提交入库，安装方无需执行任何构建。

## 致谢

- 主题插画与配色：[DeepSeek-鲸鱼娘](https://dreamskin.cc/themes/ver_cb557ececaa5de3f3dbe)（[DreamSkin](https://dreamskin.cc)）。
- 插件结构遵循官方 [`dsh.bundle`](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 清单约定。

## 许可

[MIT](LICENSE)。随包分发的插画来自上述 DreamSkin 皮肤包，原作品权利归其作者所有。