Plugin directory / UI & Skins / dsh-deep-whale
dsh-deep-whale
Verified · install-tested on dsh Small-tailqwq
What it does
DSH Web whale-girl skin series
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 | ![]() |
![]() |
| 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
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.



