Skip to main content

How to use dsh-deep-whale

Applies the "Orca Link" skin to the DSH web interface: pearl white mechanical cabin, obsidian orca operator, and electric blue link signals. Pure display layer only—no access to any DSH services.

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

orca-link · Whale Link

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add github:Small-tailqwq/dsh-deep-whale#path:orca-link

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

After installing, the interface doesn't change and there's no error, what should I do?

Installation alone won't activate it automatically. You need to check 'Orca Link' in the DSH Skin Center (dsh-skin) to trigger apply(); similarly for uninstall, uncheck it in the Skin Center and the deactivator will restore everything (cordis.patch.yml:1-7).

Can it be used simultaneously with official themes/other third-party skins?

No. cordis.patch.yml:1-7 uses home-layer mutual exclusion switching (wiring.id is ui-skin-orca-link), so only one skin can be active at a time.

Can it be used on desktop (Electron)?

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

Will it slow down DSH or require internet?

No. Backgrounds, characters, decorations and other assets are all converted to data URIs and embedded into lib/client.js during build; activating the skin doesn't request any remote URLs or resource servers.

Will dark theme switch automatically?

Yes. MutationObserver monitors body data-ds-dark-theme changes (src/client/settings-overlay.ts:27-34,46-55), switching to mechanical cabin night scene background and corresponding decoration layers in dark mode.

What's the use of the 'LINK ACTIVE' text next to the sidebar badge?

This is a real-time projection of the current session state, sourced from link-status.ts, mapping session phase and conditions like approval/issues/plan review/running state into ten states: standby/working/approval/input/review/complete/fault (src/client/link-status.ts:15-26,53-79).

Will there be residuals after uninstall?

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

Can it be used commercially? Do I need to attribute?

Not for commercial use, and full attribution chain must be preserved. The skin is released under CC BY-NC-SA 4.0 (package.json:27 / NOTICE:1-21), attribution chain: 上善 (Orca original) → Small-tailqwq (this skin derivative).

— 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