Apply the "Deep Sea Maid Workshop" skin to DSH Web: dual maid background, deep sea blue lace UI, and chibi-style sidebar. Display layer only.
ⓘ This plugin is a sub-package of the Small-tailqwq/dsh-deep-whale monorepo — stars and activity count the whole repository.
- Language
- TypeScript
- Branch
- main
Install
$ dsh plugin --profile web add github:Small-tailqwq/dsh-deep-whale#path:maid-atelierRun the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial
Install via your agent
Install the DeepSeek Harness plugin Small-tailqwq/dsh-deep-whale/maid-atelier for me: review the repository at https://github.com/Small-tailqwq/dsh-deep-whale first, then run the install command and verify the plugin loads successfully.
Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.
One-Line Description
maid-atelier is a display-oriented skin package for the DeepSeek Harness Web frontend, themed around "Deep Sea Maid Atelier" applied to conversation backgrounds, sidebars, decorative elements, and system icons. It does not modify any DSH behavior—no new services, no Cordis events, no model request interference—it merely dresses up the Web interface with a new skin.
Core Features
- Replaces the conversation area background with "Dual Maid Atelier" illustrations, automatically switching between palace day and night scenes based on system light/dark theme
- Decorates the collapsible sidebar: adds lace corner ornaments to the four corners, places a chibi character at the top of the sidebar, and adds "workspace/conversation line" labels to session tree nodes
- Adds borders and bottom decorations to the input composer: the landing page features a large character display, which animates away to a safe edge within 560ms when switching to the conversation page
- Automatically updates favicon, document title, and system theme-color to follow DSH themes (Deep Sea Blue
#0b193f) - Listens to sidebar width via ResizeObserver, synchronizing CSS variables like
--maid-sidebar-widthin real-time—the curtain "instant-follows" with the sidebar width - Monitors DSH UI changes (settings panel, conversation activation, better-sidebar, cordis-panel, etc.) via MutationObserver, automatically mounting/removing corresponding state attributes on the body to provide hooks for CSS
Technical Implementation
- Language: TypeScript (also bundled as ESM)
- Key Dependencies:
@deepseek-ai/cordis(^4.0.1, corresponding to DSH rc.6+),lightningcss(build-time CSS Modules compilation),tsdown(build packaging) - Architecture Pattern: Cordis
ctx.effectlifecycle—when apply() starts, it registers a deactivator that restores all DOM, CSS, Observers, document.title, and theme-color in one go when DSH unloads or hot-swaps - Entry File:
src/index.ts(placeholder with no host-side operations); the real implementation is insrc/client/index.ts, built tolib/client.js(2.7 MB, containing all assets as data URIs) - Host Injection: Registered to the Web plugin whitelist via
cordis.patch.ymlasui-skin-maid-atelier, switched mutually exclusively by DSH skin center (dsh-skin) based on home-layer
Use Cases
Users who want to transform their DSH Web frontend into a "Whale Girl" themed anime style; users who only want decoration without touching any DSH behavior; users concerned about offline capability and privacy, preferring all assets localized (no external network requests). Prerequisites: already using DSH Web frontend and willing to check/enable this skin in the skin center.
Prerequisites & Compatibility
| Dependency | Minimum Version | Description |
|---|---|---|
| DSH | 0.1.0-rc.6+ | peerDependencies locks @deepseek-ai/cordis ^4.0.1; source comments explicitly note compatibility with rc.6 sidebar search behavior (src/client/index.ts:562) |
| Node | Not declared | Repository doesn't require Node; this skin loads only in browser, build completed by repository owner |
| Platform | Cross-platform | dsh.client.platform = "web" (package.json:14-22), runs on any desktop/mobile OS with modern browsers |
| Native Modules | None | All assets embedded as data URIs in client.js, no Node native modules or external resources required |
Installation
dsh plugin --profile web add github:Small-tailqwq/dsh-deep-whale/maid-atelier
After installation, you must also check/enable this skin in the DSH skin center (
dsh-skin) to triggerapply().
Configuration
This plugin requires no additional configuration. All "parameters" are hardcoded as fixed values in the source code (such as system chrome color #0b193f, sidebar three-tier width breakpoints 120/220px, ResizeObserver throttling, etc.). The skin center only handles on/off toggle.
| Config | Type | Description | Default |
|---|---|---|---|
| None | — | This plugin requires no additional configuration | — |
FAQ
Q: After installation, the interface shows no changes and no errors. What should I do?
A: Installation alone doesn't auto-activate. Open the DSH skin center (dsh-skin), check "Deep Sea Maid Atelier" in the skin list to enable; to uninstall, uncheck in the skin center—the deactivator will restore everything.
Q: Can this skin coexist with DSH's built-in themes or other third-party skins?
A: No. cordis.patch.yml uses home-layer mutual exclusive switching (wiring.id is ui-skin-maid-atelier)—only one skin can be active at a time.
Q: Can it be installed on desktop (Electron)?
A: No. package.json explicitly declares dsh.client.platform: "web"—the skin only injects into Web GUI; desktop shells use their own hosts.
Q: After switching skins, the settings panel won't open / sidebar width doesn't change?
A: Most likely because DSH is still loading or concurrent plugins like better-sidebar are modifying DOM, triggering the MutationObserver's recovery loop. Refreshing the page once lets both plugins' Observers establish properly.
Q: After uninstalling, the page layout is broken?
A: Rare, but theoretically possible: if forced uninstall before apply() completes, some body attributes may not be restored. Re-enable and uninstall again to recover.
Q: What happens if the browser disables WebGL acceleration?
A: When apply() starts, hasAcceleratedWebGL() detection fails, and data-maid-low-power is mounted on the body—CSS takes the lightweight rendering path—visuals slightly simplified, main functionality unaffected.
Q: Will dark theme auto-switch?
A: Yes. MutationObserver monitors data-ds-dark-theme attribute changes—switching to palace night scene background and corresponding decoration layers in dark mode.
Difficulty Level
Beginner — after installation, just check once in the skin center; no configuration, no commands, no keyboard shortcuts—ordinary users can get started easily.
Known Issues & Limitations
- On browsers without WebGL acceleration or using software rendering, decoration effects downgrade to "low power" path (src/client/index.ts:163-178, 402)
- Compatibility code exists for DSH rc.6's "sidebar search button mounts wide search and outside-click listener in the same click frame" behavior (src/client/index.ts:562-595)—if DSH fixes this behavior in the future, rc.6+ workspace versions will skip this recovery logic
- All skin assets embedded in
lib/client.js(~2.7 MB)—first installation requires downloading/extracting this package - Strictly prohibits any commercial use and requires preserving the three-creation attribution chain (see
NOTICE); modified redistribution must be shared under the same terms - Development builds require working in the upstream
dsh-web-uirepository'sskins/maid-atelier/directory (README.md:35-45)—this repository only distributes finished products
DeepSeek Harness Web GUI 的鲸鱼娘主题皮肤系列(独立分发仓库)。
效果预览
点击图片可查看完整尺寸。
住户
| 皮肤 | 包名 | 说明 | 许可 |
|---|---|---|---|
| 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 |
版权所有人
| 版权所有人 | 版权所有内容 | 对应皮肤 | 个人主页 |
|---|---|---|---|
| 上善 | 鲸鱼娘角色形象原作 | maid-atelier / orca-link | Pixiv · Bilibili(上善无形) |
| ZipZipPipe | 加入 DeepSeek 元素的女仆鲸鱼娘二次设计 | maid-atelier | Pixiv · Bilibili(ZipZipPipe) |
*反馈问题尽可能在 issue 中发起,而不是跑去联系上面两位老师。但是,看鲸鱼娘二创可以去关注一下,谢谢喵
安装
懒人版
对你的 dsh 说:
安装一下这个皮肤包:https://github.com/Small-tailqwq/dsh-deep-whale
dsh 会按 dsh-skin-install 技能走完整流程:列出全部皮肤、交代署名链与许可、用绝对路径注册并激活你选的那一套。
手动安装(推荐绝对路径)
git clone https://github.com/Small-tailqwq/dsh-deep-whale # clone 到任意位置
dsh plugin --profile web add <clone 的绝对路径>/maid-atelier # 深海女仆工坊
dsh plugin --profile web add <clone 的绝对路径>/orca-link # 虎鲸链路
Windows 示例(正斜杠与反斜杠均可,pnpm 会自动规范化):
dsh plugin --profile web add C:/Users/<你>/code/dsh-deep-whale/maid-atelier
相对路径的规则(容易踩坑)
- 相对路径(
./、../开头)按 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-skin-install 技能(.agents/skills/)。dsh 在仓库目录内运行时自动发现该技能;对你的 dsh 说"安装一下这个皮肤包"或"切换皮肤",它会列出仓库全部皮肤、询问你要激活哪一套,并交代作者署名链与许可边界后再安装。无需自行克隆到 dsh 源码里,皮肤开关走配置热重载,无需重启。
许可
本仓库各皮肤为衍生创作,整体以 CC BY-NC-SA 4.0(署名-非商业性使用-相同方式共享)发布,禁止商业性使用。署名链见各皮肤 NOTICE。
皮肤工程脚手架来自 zhu1090093659/dsh-web-ui ,本仓库仅分发皮肤成品,不包含脚手架。
Read the usage guide →
Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.
Listing badge
[](https://deepseek-plugin.org/plugins/Small-tailqwq/dsh-deep-whale/maid-atelier)Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.



