dshbase

Plugin directory / UI & Skins / dsh-deep-whale

dsh-deep-whale

Verified · install-tested on dsh Small-tailqwq

✓ Actively maintained 12 contributors Pure TypeScript

View on GitHub ↗ ← Back to plugin directory

2263Stars
68Forks
13Open issues
TypeScriptLanguage
2026-09-29Last push
Cross-platformPlatform

What it does

DSH Web whale-girl skin series

✅
Our take
Recommended — verified working and popular

DSH Web whale-girl skin series It installs cleanly and boots without issues in our testing. With 2263+ stars it's a community-endorsed, low-risk pick.

“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.

README

dsh-deep-whale · 鲸鱼娘皮肤系列

简体中文 · English · Tiếng Việt

给 DeepSeek Harness(DSH)Web 界面换上鲸鱼娘主题的皮肤合集,附带一个用来切换皮肤的管理面板。

效果预览

点击图片可查看完整尺寸。

皮肤 亮色模式 暗色模式
maid-atelier maid-atelier 亮色模式 maid-atelier 暗色模式
orca-link orca-link 亮色模式 orca-link 暗色模式

住户

皮肤 包名 说明 许可
maid-atelier @smalltailqwq/dsh-client-ui-skin-maid-atelier 深海女仆工坊:两位鲸鱼娘女仆、深海蓝蕾丝与 Q 版侧栏,把 DSH 布置成女仆工坊 MIT (code) / CC BY-NC-SA 4.0 (artwork)
orca-link @smalltailqwq/dsh-client-ui-skin-orca-link 虎鲸链路:酷酷的小黑鲸操作员,全直角界面加用直线重绘的图标;亮色机能,暗色治愈 MIT (code) / CC BY-NC-SA 4.0 (artwork)
skin-manager @smalltailqwq/dsh-client-ui-skin-deep-whale-manager 皮肤管理器:切换已安装的皮肤,调整各皮肤自带的选项,在「设置 → 皮肤管理」中打开 MIT

版权所有人

版权所有人 版权所有内容 对应皮肤 个人主页
上善 鲸鱼娘角色形象原作 maid-atelier / orca-link Pixiv · Bilibili(上善无形)
ZipZipPipe 加入 DeepSeek 元素的女仆鲸鱼娘二次设计 maid-atelier Pixiv · Bilibili(ZipZipPipe)

*反馈问题尽可能在 issue 中发起,而不是跑去联系上面两位老师。但是,看鲸鱼娘二创可以去关注一下,谢谢喵

安装

[!NOTE]
如果你用的是 dsh-web(装过 @linxin666/dsh-web-all),请直接在 dsh-web 自带的皮肤中心里安装 maid-atelier 和 orca-link,不要再运行下面的命令。两边的皮肤是分别适配的,装在同一个 profile 里会让界面显示错乱。

皮肤可以从 npm 或 GitHub 安装,两种来源装的是同一套皮肤,区别在于更新节奏:

npm(推荐) GitHub
拿到的版本 正式发布的版本,有固定版本号 main 分支上的最新代码
什么时候能用上修复 发版后约 24 小时(DSH 内置的 pnpm 默认只安装发布满一天的版本) 修复合并后马上就能装
网络 可以配置 npm 镜像源,国内一般更稳 需要能访问 GitHub

拿不准就选 npm。复制对应系统的命令运行即可,不需要 clone 仓库。

从 npm 安装

# Linux / macOS / WSL
dsh plugin --profile web add '@smalltailqwq/dsh-client-ui-skin-deep-whale-manager' && dsh plugin --profile web add '@smalltailqwq/dsh-client-ui-skin-maid-atelier' && dsh plugin --profile web add '@smalltailqwq/dsh-client-ui-skin-orca-link'
# PowerShell
dsh plugin --profile web add '@smalltailqwq/dsh-client-ui-skin-deep-whale-manager'; dsh plugin --profile web add '@smalltailqwq/dsh-client-ui-skin-maid-atelier'; dsh plugin --profile web add '@smalltailqwq/dsh-client-ui-skin-orca-link'

从 GitHub 安装

# 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
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'

两种来源用的是同一个包名,后装的会替换先装的。想从一种换到另一种,直接用另一组命令重新装一遍即可。

装好后重启一次 DSH,然后打开「设置 → 皮肤管理」,在想用的皮肤上点「切换」就好。之后换皮肤都是即时生效,不用再重启。

  • 只想要其中一套皮肤?把命令里另一套皮肤的那段 add 删掉即可。皮肤管理器建议保留,切换皮肤要靠它。

  • 两套都装了的话,首次重启后界面还是官方默认的样子,这是正常的:两套皮肤同时启用会互相打架,管理器会先把它们都关掉,等你来选。

  • 不想自己敲命令,可以把这句话发给任意 AI(或 DSH 本身),它会按 INSTALL.md 帮你装好:

    读取 https://github.com/Small-tailqwq/dsh-deep-whale/INSTALL.md 并按其中的指引安装本仓库皮肤
    

更新

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

这条命令对 npm 和 GitHub 两种来源都适用:npm 来源会更新到最新发布的版本,GitHub 来源会拉取 main 上的最新代码。更新后刷新页面即可,不需要重启 DSH。如果这个 profile 里只装了本仓库的皮肤,也可以直接运行 dsh plugin --profile web update 更新全部插件。

刚发布的 npm 新版要满 24 小时后才能通过 update 装上,在此之前 update 会停在上一个版本,也不会报错(这是 DSH 内置的 pnpm 为防范恶意包设的默认延迟)。想马上用上某个新版,可以在包名后面加上 @^版本号 重新安装,版本号可以在 Releases 查到:

dsh plugin --profile web add '@smalltailqwq/dsh-client-ui-skin-orca-link@^0.1.6'

版本号前的 ^ 不要省:省掉后会固定在这个版本,以后的 update 就不会再升级了。

遇到问题

升级 DSH 后皮肤不见了

每套皮肤只声明支持自己适配过的 DSH 版本(目前是 0.1.7 与 0.2 系列)。DSH 升级到更新的版本而皮肤还没跟上时,DSH 会自动停用皮肤、恢复官方界面,免得皮肤把输入框之类的控件挡住。

先按上面的命令更新皮肤。如果还没有新版,又想先用着旧皮肤,可以打开「设置 → 皮肤管理」:被停用的皮肤会显示「未声明支持当前的 DSH x.y.z,已被自动停用」,点「切换」并确认即可。这个放行只针对当前的皮肤版本和 DSH 版本,任意一方升级后会重新检查;用得不顺手随时切回「官方默认」。

用命令行放行
dsh plugin --profile web allow-version @smalltailqwq/dsh-client-ui-skin-orca-link@<皮肤版本> --dsh-version <DSH 版本> --accept-risk

界面乱了:设置按钮不见、侧栏宽度异常、装饰叠在一起

多半是两套皮肤同时在运行。打开「设置 → 皮肤管理」,点「官方默认」或任意一套皮肤,刷新页面即可恢复。如果连设置都打不开,展开下方的皮肤互斥原理,按其中的方法手动修复。

装了但页面没变化

先刷新浏览器;仍然没有的话,去「设置 → 皮肤管理」确认目标皮肤处于启用状态。

更多情况见下方的常见安装报错。

进阶说明

以下内容大多数用户用不到,按需展开。

从 0.1.3 之前的旧版本迁移

0.1.3 之前从 GitHub 安装的版本用的是 @dsh-external/* 这个旧包名。请先移除这三个旧包,再按安装重新装,否则 DSH 里会同时留着两份同样的插件:

dsh plugin --profile web remove '@dsh-external/dsh-client-ui-skin-orca-link'
dsh plugin --profile web remove '@dsh-external/dsh-client-ui-skin-maid-atelier'
dsh plugin --profile web remove '@dsh-external/dsh-client-ui-skin-deep-whale-manager'

装好后重启一次 DSH。你之前选的皮肤和设置会保留,不受包名变化影响。

从本地目录安装(开发 / 测试指定提交)

本地开发,或者想测试某个指定提交时,可以 clone 仓库后按目录安装:

git clone --depth 1 https://github.com/Small-tailqwq/dsh-deep-whale
node <clone 的绝对路径>/.agents/skills/dsh-skin-install/scripts/stage-mutual-exclusion.mjs --profile web --target maid-atelier
dsh plugin --profile web add <clone 的绝对路径>/skin-manager
dsh plugin --profile web add <clone 的绝对路径>/maid-atelier
dsh plugin --profile web add <clone 的绝对路径>/orca-link
  • 第二行 node 命令可以跳过。它的作用是提前选好默认皮肤,让第一次启动直接就是这套皮肤;--target 可以写 maid-atelier、orca-link 或 official(官方默认)。跳过的话,首次启动是官方界面,再去皮肤管理里切换即可。
  • 路径请尽量写绝对路径,Windows 下正斜杠、反斜杠都行,例如 C:/Users/<你>/code/dsh-deep-whale/maid-atelier。
  • 不要只写目录名:dsh plugin --profile web add maid-atelier 会被当成 npm 包名去下载,结果 404。相对路径要以 ./ 或 ../ 开头,并且是相对于你运行 dsh 命令时所在的目录,不是皮肤仓库目录;路径算错时命令不会报错,但皮肤不会生效。
  • 本地目录和 npm、GitHub 来源用的是同一个包名,以最后一次 add 为准。
皮肤互斥原理

同一时间只能启用一套皮肤;皮肤管理器本身不算皮肤,需要一直开着。

每套皮肤的开关记录在两个配置文件里:~/.dsh/profiles/web/cordis.patch.yml(profile 层)和 ~/.dsh/cordis.patch.yml(home 层,优先级更高)。文件里没有写某套皮肤时,它默认是开启的,所以一次装两套又从没切换过,它们就会同时运行,导致界面错乱。

皮肤管理器会处理这件事:

  • 每次启动时,如果发现有两套以上皮肤同时开着,会把它们全部关掉、回到官方默认,已经选好的单套皮肤不受影响;
  • 在「设置 → 皮肤管理」里切换时,会自动把开关写进两个配置文件并即时生效。

管理器用不了时,可以手动修改。把下面的内容同时加到上面两个文件里,想启用哪套,就把哪套设为 false,另一套设为 true:

- id: ui-skin-maid-atelier
  disabled: false
- id: ui-skin-orca-link
  disabled: true
- id: ui-skin-deep-whale-manager
  disabled: false

如果文件还是 DSH 的默认模板(几行注释加一行 []),请用上面的内容替换掉 [] 那一行,否则文件格式会出错。也可以运行上一节的 stage-mutual-exclusion.mjs 自动写好,或者用 dsh plugin --profile web remove <包名> 直接卸掉不用的皮肤。

皮肤的个性化设置(例如「不那么二次元模式」的生效时段)保存在当前浏览器里,由管理器统一应用。

确认安装是否成功
dsh plugin --profile web list          # 应该能看到三个 @smalltailqwq/dsh-client-ui-skin-* 包
dsh --profile web --dump-config        # 管理器应为 disabled: false;两套皮肤中恰好一套为 false

刚装完、还没重启时,两套皮肤可能都显示为启用,这是正常的,重启后管理器会处理。

重启后还可以在浏览器控制台运行下面这行,确认页面确实加载了皮肤脚本:

document.documentElement.outerHTML.match(/\/plugins\/@smalltailqwq\/[^"'\s]+/g) ?? []

结果里应包含管理器和当前启用的那套皮肤;停用的皮肤不出现是正常的。

常见安装报错
现象 原因 处理
ERR_PNPM_FETCH_404 包名拼错、网络不通,或本地安装时只写了目录名 直接复制本页的包名;本地安装改用绝对路径
The matching commit... / 无法解析 ref pnpm 版本低于 9,不支持 #path: 写法 升级 pnpm:npm i -g pnpm@latest
ERR_PNPM_EXOTIC_SUBDEP 试图安装一个会再拉取 Git 依赖的聚合包(pnpm 11 的安全限制,本仓库不提供这类包) 按本页命令分别安装三个包
pnpm not found on PATH 没有安装 pnpm npm i -g pnpm 后重试
包已安装但页面没变化 皮肤处于停用状态,或浏览器没刷新 在皮肤管理里启用它,然后刷新页面
PowerShell 命令不完整或报错 包名没加引号,# 后面被当成注释截掉了 包名一律用单引号包住

贡献者

感谢以下开发者对 dsh-deep-whale 的贡献:

有价值但未合入的 PR

以下 PR 因与现有上游实现冲突未能合入,但其功能需求已在仓库中落地,特此致谢:

  • @yaoyiqun — 按所选模型切换角色位置(#15)
  • @Chartreuse310 — 对话区衬线字体(#22)
  • @Vergemesh — 原版/鲸鱼娘皮肤即时切换(#27)
  • @joejojoking-cloud — top-trim 装饰层级(#26)、字符舞台层级(#31)修复

许可

项目自有代码采用 MIT,许可范围见 LICENSE。美术资源保留原作者版权与既有授权:两套皮肤的全部美术(包括 AI 生成及加工的图片)按 CC BY-NC-SA 4.0 使用,禁止商业性使用,署名链见各自 NOTICE,许可正文见 LICENSE-ARTWORK。图片即使嵌入源码、CSS 或构建产物,也不属于 MIT 授权范围。第三方材料保留其适用许可;历史版本已授出的权限不因本说明而撤销。

皮肤工程脚手架来自 zhu1090093659/dsh-web-ui,本仓库仅分发皮肤成品,不包含脚手架。

Install

🧩 Let your agent install it (recommended)

Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:

dsh plugin add dshbase-catalog

Then say "install dsh-deep-whale for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.

This plugin is GitHub source (not published to npm) — install it straight from the repo:

Web profile:

dsh plugin --profile web add github:Small-tailqwq/dsh-deep-whale

Headless (CLI) profile:

dsh plugin --profile headless add github:Small-tailqwq/dsh-deep-whale

Test report

Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.

When to use it

Swap the whole DSH Web UI into a whale-girl themed look with one install, when you want the workspace to feel less like a tool.

Who it's for

Users who spend hours in the web UI and want a distinctive, cohesive visual identity rather than default chrome.

For developers — extending it

It is a skin series, so adding a new character or colorway means authoring another skin entry that follows the existing theme manifest.

✓ Low risk static scan · 25 files · 2026-09-29

Share this badge

More in UI & Skins

Browse all 7797 plugins →