Small-tailqwq/dsh-deep-whale
Whale Girl skin series for DeepSeek Harness. 适用于 DeepSeek Harness 的，鲸鱼娘系列皮肤。
安装Install
dsh plugin --profile web add github:Small-tailqwq/dsh-deep-whale把 Small-tailqwq/dsh-deep-whale 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
dsh-deep-whale · 鲸鱼娘皮肤系列
DeepSeek Harness Web GUI 的鲸鱼娘主题皮肤系列(独立分发仓库)。
效果预览
点击图片可查看完整尺寸。
| 皮肤 | 亮色模式 | 暗色模式 |
|---|---|---|
| maid-atelier |  |
 |
| orca-link |  |
 |
住户
| 皮肤 | 包名 | 说明 | 许可 |
|---|---|---|---|
| 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 | @dsh-external/dsh-client-ui-skin-deep-whale-manager |
通用皮肤发现、切换与皮肤自声明配置面板 | MIT |
版权所有人
| 版权所有人 | 版权所有内容 | 对应皮肤 | 个人主页 |
|---|---|---|---|
| 上善 | 鲸鱼娘角色形象原作 | maid-atelier / orca-link | Pixiv · Bilibili（上善无形） |
| ZipZipPipe | 加入 DeepSeek 元素的女仆鲸鱼娘二次设计 | maid-atelier | Pixiv · Bilibili（ZipZipPipe） |
*反馈问题尽可能在 issue 中发起，而不是跑去联系上面两位老师。但是，看鲸鱼娘二创可以去关注一下，谢谢喵
安装
皮肤的安装手段只有一个正确姿势：让你的 dsh 读取本仓库的 INSTALL.md（标准安装入口），它会引导 dsh 使用自带的
dsh-skin-install技能执行——默认安装 skin-manager 与仓库内全部皮肤，但只激活你选中的一套。技能会在新增包之前预置互斥开关，避免两套皮肤曾经同时运行（详见皮肤互斥机制与 issue #65）。
标准流程：让 dsh 按 INSTALL.md 安装（推荐，唯一保证互斥的路径）
让你的 dsh 读取本仓库的标准安装入口：
读取 https://github.com/Small-tailqwq/dsh-deep-whale/INSTALL.md 并按其中指引安装皮肤INSTALL.md 会把 dsh 引导到仓库自带的
dsh-skin-install技能（若 dsh 无法读取远端文件：先git clone到本地，在 dsh 中把 clone 目录打开为工作区——技能会被自动发现——或让它读取本地INSTALL.md路径）。技能随后依次完成：列出全部皮肤并明确“全部安装、只选择激活哪一套” → 交代署名链与许可（CC BY-NC-SA 4.0）→ 先原子预置两个 patch 层的互斥
disabled行 → 绝对路径注册 skin-manager 与全部皮肤 → 验证组合配置与冷启动。首次新增包需要用户重启一次；之后切换只走配置热重载，无需重启。已安装/已知目标时走快车道：直接说“切换到 maid-atelier”或“安装 orca-link”，技能跳过询问与扫描，预计 1–2 分钟完成。
皮肤互斥机制（必读）
- 先分清：
skin-manager不是皮肤，而是皮肤管理器（提供发现、切换与定制面板），需要常驻启用；互斥的对象是皮肤本身——本仓库的皮肤是 maid-atelier 与 orca-link。 - 皮肤启停由 patch 层控制：profile 的
~/.dsh/profiles/web/cordis.patch.yml与 home 层的~/.dsh/cordis.patch.yml里各自的- id: <https://github.com/Small-tailqwq/dsh-deep-whale/blob/HEAD/wiring.id>+disabled: true/false行（两层都要写，home 层优先级更高）。 - patch 里没有某皮肤行的
disabled行 → 该皮肤默认启用。一次把多套皮肤（maid-atelier 与 orca-link）都装上、又从未切换时，它们会同时运行：装饰层互相叠加、侧栏/设置区被搅乱，典型症状是设置按钮消失、侧栏宽度/布局异常、界面混乱（原版正常）。 - skin-manager（设置 → 皮肤管理）激活时会自动把互斥行写入两个 patch 层；手写时“只保留一套”必须显式停用其余每一套。
- 第三方市场等渠道若绕过标准安装流程，skin-manager 会在启动时合并 profile→home 两层状态；检测到实际同时启用两套及以上皮肤时，自动原子回退到“官方默认”。已有零套或一套启用的合法选择不会被改写。
- 安装了皮肤管理器后，皮肤定制项（如“不那么二次元模式”的可见时段）保存在当前浏览器，由管理器统一应用。
手动安装（备用路径，必须先预置互斥状态）
git clone --depth 1 https://github.com/Small-tailqwq/dsh-deep-whale # clone 到任意位置（浅克隆足够，跳过历史）
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命令必须在任何plugin add之前执行；它保留非皮肤 YAML，并把 maid-atelier 设为唯一启用项。要默认启用虎鲸则把 target 改成orca-link，要保持原版则改成official。不要整文件覆盖 patch。若跳过这一步，两套新安装皮肤会默认同时启用。
方式 A（推荐）：设置 → 皮肤管理 → 点击要用的那一套「切换」。管理器自动把互斥 disabled 行写入两个 patch 层并热重载，刷新页面即可。
方式 B：手写两个 patch 层。把下面的行追加到 ~/.dsh/profiles/web/cordis.patch.yml 和 ~/.dsh/cordis.patch.yml（两者缺一不可，home 层覆盖 profile 层）：
# 示例：只启用 maid-atelier；改为 orca-link 时把 false 移到它那行，两套皮肤只能有一套是 false
- id: ui-skin-maid-atelier
disabled: false
- id: ui-skin-orca-link
disabled: true
- id: ui-skin-deep-whale-manager
disabled: false
若 patch 文件还是 dsh 的默认模板（注释 + 一行
[]），请用上面的列表整体替换[]那一行——“注释 +[]+ 其他条目”是非法 YAML，配置解析会失败（服务器会保留上一个可用配置继续运行，修复后并刷新即可）。
Windows 示例（正斜杠与反斜杠均可，pnpm 会自动规范化）：
dsh plugin --profile web add C:/Users/<你>/code/dsh-deep-whale/skin-manager
dsh plugin --profile web add C:/Users/<你>/code/dsh-deep-whale/maid-atelier
装多了 / 出现异常怎么办
症状：设置按钮消失、侧栏被装饰层覆盖或宽度异常、界面混乱（停用皮肤后恢复）。
- 打开 设置 → 皮肤管理，点击「官方默认」或任一皮肤——管理器会自动写互斥行并热重载，刷新即可恢复；
- 管理器不可用时（或配置已被写坏）：运行上方
stage-mutual-exclusion.mjs，用--target official或目标皮肤恢复两个 patch 层； - 也可以直接摘掉不用的包：
dsh plugin --profile web remove <包名>，摘除后同样检查互斥行。
相对路径的规则（容易踩坑）
- 相对路径（
./、../开头）按 dsh 命令的调用目录解析，不是皮肤仓库目录。 - 不要直接写裸目录名：
dsh plugin --profile web add maid-atelier会被当作 npm 包名去 registry 拉取而 404 失败。请用./maid-atelier（已在皮肤仓库目录内）、../dsh-deep-whale/maid-atelier（与 dsh-deep-whale 同级）或绝对路径。 cd <harness>后用../dsh-deep-whale/maid-atelier的前提是 dsh-deep-whale 与你的 harness 目录同级；clone 到别处时相对路径会 link 到错误位置（命令不报错、但皮肤不生效）。不确定就用绝对路径。
安装后验证
dsh plugin --profile web list # 应看到 @dsh-external/dsh-client-ui-skin-* 的 link: 依赖
dsh --profile web --dump-config # 皮肤行在组合配置中，disabled 状态正确
刷新浏览器页面即可看到皮肤；皮肤开关走配置热重载，无需重启 dsh（新增/删除插件包才需要重启）。
常见安装失败排查
| 现象 | 原因 | 处理 |
|---|---|---|
ERR_PNPM_FETCH_404 ... <名字> |
传了裸目录名（如 add maid-atelier），被当成 npm 包名 |
改为绝对路径或 .//../ 前缀路径 |
命令成功但 dsh plugin list 没有该包 |
相对路径解析到了错误位置（clone 位置与假设不符） | 用绝对路径重新 add |
pnpm not found on PATH |
环境缺少 pnpm | 安装 pnpm（npm i -g pnpm）后重试 |
| 包在列表里但页面无效果 | 皮肤被 disabled（多皮肤互斥开关）或浏览器未刷新 |
--dump-config 核对 disabled；刷新页面 |
贡献者
感谢以下开发者对 dsh-deep-whale 的贡献：
有价值但未合入的 PR
以下 PR 因与现有上游实现冲突未能合入，但其功能需求已在仓库中落地，特此致谢：
- @yaoyiqun — 按所选模型切换角色位置（#15）
- @Chartreuse310 — 对话区衬线字体（#22）
- @Vergemesh — 原版/鲸鱼娘皮肤即时切换（#27）
- @joejojoking-cloud — top-trim 装饰层级（#26）、字符舞台层级（#31）修复
许可
本仓库各皮肤为衍生创作,整体以 CC BY-NC-SA 4.0(署名-非商业性使用-相同方式共享)发布,禁止商业性使用。署名链见各皮肤 NOTICE。
皮肤工程脚手架来自 zhu1090093659/dsh-web-ui，本仓库仅分发皮肤成品,不包含脚手架。
相关推荐Related
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
Tencent/WeKnora
Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-m…
- Nagi-ovo/voyager Enhancement suite for Gemini, AI Studio, Claude & ChatGPT — plus a prompt manager for any web UI, DeepSeek Harness inclu…
-
EverMind-AI/EverOS
One portable memory layer for every AI agent: local-first, Markdown-native, user-owned, and self-evolving across apps, t…
-
freestylefly/awesome-gpt-image-2
Prompt as Code | GPT-Image2 工业级提示词引擎与模板库，470+ 个案例逆向工程，20+ 套工业级模板，并提炼出Skills，持续更新中
-
MemTensor/MemOS
Self-evolving memory OS for LLM & AI Agents: ultra-persistent memory, hybrid-retrieval, and cross-task skill reuse, with…
-
zhu1090093659/dsh-web-ui
Plugin and skin collection for DeepSeek Harness (DSH) Web UI - task board, git graph, right-side panel, remote mobile UI…
-
edison7009/EchoBird
One-click install + model switch:Claude Code,Codex CLI (OpenAI), Grok Build (xAI), DeepSeek Harness, Kimi Code (Moonshot…