Skip to main content

How to use dsh-deep-whale

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 article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.

This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

maid-atelier · Deep Sea Maid Atelier

— source: plugin_wiki.wiki_content

Install & verify

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

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

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

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

Can I see the effect immediately after installing this skin?

You need to first check and enable it in the DSH Skin Center (dsh-skin). Just installing won't trigger apply(); it needs to be activated in the Skin Center. The deactivator registered via ctx.effect during activation is responsible for restoration.

Can the skin be used simultaneously with the official theme or other third-party skins?

No. cordis.patch.yml:4 explicitly uses home-layer mutual exclusion switching (wiring.id is ui-skin-maid-atelier), so only one skin can be active at a time.

Can this skin be used on the desktop client (Electron)?

No. package.json lines 14-22 declare dsh.client.platform: web; the skin only injects into the Web GUI, the desktop shell uses its own host with a different loading path.

Will it slow down DSH or require internet connection?

No. The 11 webp assets for background, character, and decorations are all converted to data URIs embedded in lib/client.js during build (README.md:8-11). Activating the skin doesn't request any remote URLs or resource servers.

What happens if the browser doesn't have WebGL acceleration enabled?

Yes. apply() detects via hasAcceleratedWebGL() (src/client/index.ts:163-178). If not detected, it mounts the data-maid-low-power attribute, and CSS uses the lightweight rendering path, still usable.

Will the dark theme switch automatically?

Yes. MutationObserver monitors body for data-ds-dark-theme changes (src/client/index.ts:707,744). When dark mode is on, it switches to the palace night scene background and corresponding decoration layer.

Will there be any residue left after uninstallation?

No. apply() entry registers ctx.effect deactivator (src/client/index.ts:349-391), responsible for restoring body attributes, removing all [data-skin-chrome] nodes, restoring document.title, and disconnecting all Observers.

Can it be used commercially? Do I need to give credit?

Not for commercial use, and full attribution must be preserved. The skin is released under CC BY-NC-SA 4.0 (package.json:27), attribution chain: 上善 (original whale girl) → ZipZipPipe (maid whale girl derivative) → Small-tailqwq (this skin third creation).

— source: plugin_wiki.faq_json

Compatibility

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

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule