本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

maid-atelier · 深海女仆工坊

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:Small-tailqwq/dsh-deep-whale#path:maid-atelier

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 相对路径（./、../ 开头）按 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 到错误位置（命令不报错、但皮肤不生效）。不确定就用绝对路径。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个皮肤装上后能立即看到效果吗？

需要先在 DSH 皮肤中心（dsh-skin）里勾选启用。仅安装不会触发 apply()，需在皮肤中心激活；激活时通过 ctx.effect 注册的反激活器负责还原。

皮肤和官方主题/其他第三方皮肤能同时用吗？

不能。cordis.patch.yml:4 明确走 home-layer 互斥切换（wiring.id 为 ui-skin-maid-atelier），同一时刻只能激活一套皮肤。

桌面端（Electron）能用这套皮肤吗？

不行。package.json 第 14-22 行声明 dsh.client.platform: web，皮肤只注入到 Web GUI，桌面壳走自己的宿主，加载路径不通。

会拖慢 DSH 或要联网吗？

不会。背景、角色、装饰 11 张 webp 素材在构建时全部转 data URI 内嵌进 lib/client.js（README.md:8-11），激活皮肤不请求任何远程 URL 或资源服务器。

浏览器没开 WebGL 加速会怎样？

apply() 启动时通过 hasAcceleratedWebGL() 探测（src/client/index.ts:163-178），未检测到则挂载 data-maid-low-power 标识，CSS 走轻量渲染路径，仍可使用。

暗色主题会自动切换吗？

会。MutationObserver 监听 body 的 data-ds-dark-theme 变化（src/client/index.ts:707,744），暗色时切换为宫殿夜景背景与对应装饰图层。

卸载后会留下残留吗？

不会。apply() 入口注册 ctx.effect 反激活器（src/client/index.ts:349-391），负责还原 body 属性、移除全部 [data-skin-chrome] 节点、还原 document.title、断开所有 Observer。

可以商用吗？要不要署名？

不可商用，且必须保留完整署名链。皮肤以 CC BY-NC-SA 4.0 发布（package.json:27），署名链：上善（鲸鱼娘原作）→ ZipZipPipe（女仆鲸鱼娘二创）→ Small-tailqwq（本皮肤三创）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: 未声明
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则