dsh-deep-whale

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 里会让界面显示错乱。

官方桌面版

1. 按需选择一套或多套皮肤。打开侧栏「插件」，点击「添加插件」，逐个填入下面对应的 npm 包名并安装。

插件 · npm 包名 maid-atelier · @smalltailqwq/dsh-client-ui-skin-maid-atelier orca-link · @smalltailqwq/dsh-client-ui-skin-orca-link 皮肤管理器 · @smalltailqwq/dsh-client-ui-skin-deep-whale-manager

1. 只装一套皮肤时，管理器可选；不装就无法使用配置面板、图形化版本兼容放行和自动多皮肤互斥管理。同时装多套皮肤必须安装并保持管理器启用，否则皮肤同时启用会让界面错乱。管理器一旦安装，即使只用一套皮肤也应保持启用。安装完成后按提示启用插件，然后重启一次 DSH。
2. 如果安装了皮肤管理器，重启后打开「设置 → 皮肤管理」。首次启动若仍显示官方界面，到这里选择要启用的皮肤即可。

想用 main 上的最新代码，也可以按所选皮肤和管理器，在同一个安装框里逐个填入对应的 GitHub 地址（只填地址，不加 dsh plugin add）：

github:Small-tailqwq/dsh-deep-whale#main&path:/skin-manager
github:Small-tailqwq/dsh-deep-whale#main&path:/maid-atelier
github:Small-tailqwq/dsh-deep-whale#main&path:/orca-link

在默认配置下，DSH 捆绑的 pnpm 11.7.0 优先选择发布满 24 小时的 npm 版本。想立即安装某个刚发布的新版，可以在同一个「添加插件」框里填入 包名@^版本号，例如 @smalltailqwq/dsh-client-ui-skin-orca-link@^0.1.9（不加命令前缀）。这次显式 add 会安装新版，并把具体版本写入 pnpm-workspace.yaml 的 minimumReleaseAgeExclude，依赖仍保持 caret 范围。此行为对应捆绑版本及默认配置，其他 pnpm 版本或自定义策略可能不同。GitHub 来源不受这项 npm 包龄检查影响。

桌面版通过应用管理自己的 desktop profile，不需要先配置 dsh 命令。下面的 web 命令不会给桌面版安装皮肤。

CLI 安装的 Web 版

本页命令以 web profile 为例；如果你启动的是其他 CLI profile，请把命令中的 web 换成对应名称。

皮肤可以从 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#main&path:/skin-manager' && dsh plugin --profile web add 'github:Small-tailqwq/dsh-deep-whale#main&path:/maid-atelier' && dsh plugin --profile web add 'github:Small-tailqwq/dsh-deep-whale#main&path:/orca-link'

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

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

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

• 只装一套皮肤时，可以删掉另一套皮肤和管理器的 add；不装管理器就无法使用配置面板、图形化版本兼容放行和自动多皮肤互斥管理。管理器一旦安装就应保持启用；同时装多套皮肤必须安装并保持管理器启用，避免皮肤同时启用。
• 两套都装了的话，首次重启后界面还是官方默认的样子，这是正常的：两套皮肤同时启用会互相打架，管理器会先把它们都关掉，等你来选。
• 不想自己敲命令，可以把这句话发给任意 AI（或 DSH 本身），它会按 INSTALL.md 帮你装好：

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

更新

桌面版：截至 DSH 0.2.0-rc.2，插件页没有升级入口，也不会自动更新第三方插件。在「插件」列表卸载要更新的插件，再按上面的步骤重新安装并启用，完成后重启 DSH。

CLI Web 版：只保留你实际安装的包名。

# 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 更新全部插件。

在默认配置下，DSH 内置的 pnpm 11.7.0 优先选择发布满 24 小时的 npm 版本，所以 update 可能仍停在旧版。要立即安装某个新版，可以显式 add 包名加 @^版本号：pnpm 会安装新版，并把具体版本写入 pnpm-workspace.yaml 的 minimumReleaseAgeExclude，依赖仍保持 caret 范围。其他 pnpm 版本或自定义策略可能不同。版本号见 Releases：

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

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

遇到问题

升级 DSH 后皮肤不见了

每套皮肤只声明支持自己适配过的 DSH 版本（目前是 0.2 系列，从 0.2.0-rc.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//cordis.patch.yml（profile 层，` 为 web 或桌面版的 desktop 等实际名称）和 ~/.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 直接卸掉不用的皮肤。

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

确认安装是否成功

桌面版：在「插件」列表确认所装的包已出现，重启后查看皮肤效果；装了管理器的，再到「设置 → 皮肤管理」选择皮肤。桌面版的 desktop profile 不支持 CLI 的 --dump-config，无需运行下面的命令。

CLI Web 版：

dsh plugin --profile web list          # 应该能看到你选择安装的包
dsh --profile web --dump-config        # 所选皮肤应为 disabled: false；如装了管理器，也应为 false