Small-tailqwq/dsh-deep-whale · 上手攻略

  • 仓库：Small-tailqwq/dsh-deep-whale
  • 链接：https://github.com/Small-tailqwq/dsh-deep-whale
  • 分类：工具 · DeepSeek Harness 主题皮肤
  • 作者：Tom
  • 更新：2026-08-26

这是什么

DSH Deep Whale 是 DeepSeek Harness（DSH）Web GUI 的鲸鱼娘系列主题皮肤仓库，由两个独立皮肤包（maid-atelier / orca-link）和一个皮肤管理器组成，采用 CC BY-NC-SA 4.0 许可证开源发布。适合 DeepSeek Harness 用户个性化定制界面。

注意：这是主题皮肤，不是功能插件，不影响 DSH 的任何 AI 能力。

解决什么问题

  • DeepSeek Harness 默认界面太素，想要二次元风格皮肤
  • 想在 AI 工作台看到精心设计的鲸鱼娘角色界面
  • 需要统一管理多套皮肤、避免叠加冲突

快速安装

前置要求

  • DeepSeek Harness 已安装并正常运行
  • pnpm ≥ 9（⚠️ 必需，pnpm 8 不支持 #path: 语法，会把路径当 commit 引用报错）
  • 网络可访问 GitHub（或者提前 clone 仓库）

一行命令安装（三包全装）

Linux / macOS / WSL：

dsh plugin --profile web add 'github:Small-tailqwq/dsh-deep-whale#path:/skin-manager' \
  && dsh plugin --profile web add 'github:Small-tailqwq/dsh-deep-whale#path:/maid-atelier' \
  && dsh plugin --profile web add 'github:Small-tailqwq/dsh-deep-whale#path:/orca-link'

PowerShell（注意 # 是注释符，spec 必须包在引号里，命令之间用 ; 而非 &&）：

dsh plugin --profile web add 'github:Small-tailqwq/dsh-deep-whale#path:/skin-manager'; dsh plugin --profile web add 'github:Small-tailqwq/dsh-deep-whale#path:/maid-atelier'; dsh plugin --profile web add 'github:Small-tailqwq/dsh-deep-whale#path:/orca-link'

最小安装（只装一套皮肤）

如果只需要一套皮肤，删掉不需要的包名即可（但 skin-manager 建议保留）：

# 只安装 maid-atelier
dsh plugin --profile web add 'github:Small-tailqwq/dsh-deep-whale#path:/skin-manager'
dsh plugin --profile web add 'github:Small-tailqwq/dsh-deep-whale#path:/maid-atelier'

安装后必须重启一次 DSH

首次安装新增插件包后，需要重启一次 DSH。重启时 skin-manager 会自动检测「两套皮肤同时启用」的情况并原子回退到官方默认（防止界面叠加混乱），这是正常行为。

皮肤切换

方式 A：图形界面（推荐）

DSH → 设置 → 皮肤管理 → 点击目标皮肤「切换」→ 热重载生效

此方式会自动把互斥行写入两个 patch 层，无需手动配置。

方式 B：手动写配置文件

将以下内容追加到两个 patch 文件（两层都要写，缺一不可）：

# ~/.dsh/profiles/web/cordis.patch.yml
# ~/.dsh/cordis.patch.yml

# 示例：只启用 maid-atelier
- id: ui-skin-maid-atelier
  disabled: false
- id: ui-skin-orca-link
  disabled: true
- id: ui-skin-deep-whale-manager
  disabled: false

⚠️ patch 文件中若只有注释加 []，需要用上面列表整体替换 []，否则 YAML 解析失败。

两套皮肤简介

皮肤 包名 风格 许可证
maid-atelier（深海女仆工坊） @dsh-external/dsh-client-ui-skin-maid-atelier 双女仆背景、深海蓝蕾丝界面、Q版侧栏 CC BY-NC-SA 4.0
orca-link（虎鲸链路） @dsh-external/dsh-client-ui-skin-orca-link 珍珠白机械舱、虎鲸娘角色、电蓝链路信号 CC BY-NC-SA 4.0

皮肤管理器 skin-manager 本身是 MIT 许可证。

角色形象：上善（原作）· ZipZipPipe（二创 DeepSeek 元素加入）

更新皮肤

# Linux / macOS / WSL
dsh plugin --profile web update @dsh-external/dsh-client-ui-skin-deep-whale-manager \
  @dsh-external/dsh-client-ui-skin-maid-atelier \
  @dsh-external/dsh-client-ui-skin-orca-link

# PowerShell
dsh plugin --profile web update '@dsh-external/dsh-client-ui-skin-deep-whale-manager' \
  '@dsh-external/dsh-client-ui-skin-maid-atelier' \
  '@dsh-external/dsh-client-ui-skin-orca-link'

update 会重新拉取仓库最新提交，更新后皮肤配置热重载，无需重启 DSH（除非是新增/删除插件包）。

验证安装成功

# 检查依赖是否注册
dsh plugin --profile web list
# 应看到三个 @dsh-external/dsh-client-ui-skin-* 依赖

# 检查配置状态
dsh --profile web --dump-config
# manager 行 disabled: false；两套皮肤互斥：恰一套 false

浏览器控制台验证（两种 DSH 版本均可用）：

document.documentElement.outerHTML.match(/\/plugins\/@dsh-external\/[^"'\s]+/g) ?? []
// 结果必须包含 manager 与当前启用皮肤的包名

坑与注意

⚠️ 常见报错与处理：

报错 原因 处理
ERR_PNPM_FETCH_404 GitHub spec 拼写错误、网络不可用、或用了裸目录名 用完整 #path: 语法；本地开发用绝对路径
无法解析 ref pnpm < 9 升级 pnpm 到 ≥ 9
皮肤叠加混乱（设置按钮消失、侧栏异常） 两套皮肤同时启用 打开「设置 → 皮肤管理」切换到单一皮肤，或运行 stage-mutual-exclusion.mjs 恢复
皮肤完全不生效 patch 层配置错误或 YAML 解析失败 检查两个 patch 文件格式

其他注意事项：

  1. skin-manager 是皮肤管理器，不是皮肤本身——它常驻启用，提供皮肤发现和切换面板
  2. 皮肤定制配置（如「不那么二次元模式」时段）保存在当前浏览器，不是服务器端
  3. Windows 路径中的反斜杠 / 正斜杠 pnpm 会自动规范化，无需手动转换
  4. CC BY-NC-SA 4.0 意味着不可商用，如果需要集成到商业产品需联系作者获得授权
  5. 二创角色形象版权归上善和 ZipZipPipe 所有，反馈问题请在 GitHub issue 而非联系作者

本地开发安装（可选）

不需要 clone 也能用，但如果要参与皮肤开发或 GitHub 网络不可用：

# 1. 浅克隆（跳过历史）
git clone --depth 1 https://github.com/Small-tailqwq/dsh-deep-whale

# 2. 在皮肤仓库目录内执行（相对路径 ./maid-atelier）
dsh plugin --profile web add ./skin-manager
dsh plugin --profile web add ./maid-atelier
dsh plugin --profile web add ./orca-link

⚠️ 不要写裸目录名 dsh plugin --profile web add maid-atelier，pnpm 会当作 npm 包名去 registry 拉取而 404。

一句话推荐结论

DSH Deep Whale 为 DeepSeek Harness 用户提供了两套精美的鲸鱼娘主题皮肤，安装简单、热切换方便，是美化 AI 工作台的低成本方案——二次元爱好者推荐maid-atelier，科技感爱好者推荐orca-link。