DSH 深海字符水母背景 / Deep-Sea ASCII Jellyfish Background
中文 · English
DSH 实际运行中的水母背景动图 / Animated demo in DSH
全窗口截图 / Full-window screenshot · 设置界面 / Settings
动图和截图均来自 DSH 0.2.1-rc.3 的实际运行页面。 / The GIF and screenshots were captured from a running DSH 0.2.1-rc.3 instance.
中文
适用于 DSH 0.2.1-rc.2 和 0.2.1-rc.3 Web 界面的动态主题插件。它在整个应用窗口后方绘制字符方格水母、暗蓝网格和漂浮星点，并把面板切换为深色半透明外观。DSH 原有的侧边栏、聊天、设置和输入功能继续使用。
动画由 Canvas 实时绘制，不依赖远程图片或视频；背景不拦截鼠标与键盘，页面隐藏时暂停，并响应系统“减少动态效果”设置。
使用
首次安装后背景默认开启。打开 设置 → 通用设置 → 深海字符水母，可以关闭背景、调整动效强度和水母数量。水母数量可选 0–12 只，默认 6 只；设为 0 时仅保留星点背景。调整立即生效，刷新后保留；旧版本设置自动沿用 6 只。关闭时恢复此前选择的主题。启用期间若选择 DSH 的其他外观，该选择会在关闭本插件后生效。
页面隐藏时暂停并保留动画进度；恢复页面或调整动效强度时延续当前位置。系统开启“减少动态效果”或动效强度设为 0 时显示静态画面。设置保存在当前浏览器的 localStorage，同一来源的多个标签页会同步。
在线安装（Web）
适用于 DSH 0.2.1-rc.2 和 0.2.1-rc.3。macOS、Linux、Windows 都可以在任意目录运行以下命令，无需手动下载安装包或克隆仓库：
dsh --version
dsh plugin --profile web add https://raw.githubusercontent.com/yudaxia1/dsh-jellyfish-background/main/dist/dsh-background-style-plugin-0.1.6.tgz
第一行应输出 0.2.1-rc.2 或 0.2.1-rc.3。安装完成后，先停止旧的 Web 进程，再运行：
dsh web
安装和启动要使用同一个 dsh 可执行文件及同一个 DSH_HOME。如果机器上有多个 DSH 版本，把上述每处 dsh 换成受支持版本的完整路径。启动后在 设置 → 通用设置 → 深海字符水母 调整开关、强度和数量。
Desktop：首次打开并初始化 profile 后完全退出应用，使用安装版附带的 dsh 命令把上述安装命令中的 --profile web 改为 --profile desktop，然后重新打开应用。
从源码构建
此源码使用 DSH 0.2.1-rc.3 的 Client 打包工具。将本仓库的插件源码和配置文件复制到该版本源码的 packages/client/dsh-background-style-plugin，在 DSH 仓库根目录安装依赖并依次执行：
node --max-old-space-size=4096 .\node_modules\typescript\bin\tsc -b tsconfig.host.json
pnpm exec tsdown --config-loader native --env.DSH_BUILD_FACE host
pnpm exec tsc -b packages/client/dsh-background-style-plugin/tsconfig.json
pnpm exec tsdown --config-loader native --config packages/client/dsh-background-style-plugin/tsdown.config.ts --env.DSH_BUILD_FACE client
cd packages/client/dsh-background-style-plugin
pnpm pack
构建产物是 Host 入口 lib/index.js 和浏览器入口 lib/client.js。插件通过 dsh.bundle 把自己加入 profile，通过 dsh.client 加入浏览器插件表；主题使用 ctx.theme.register，设置项使用 settings.general.item 插槽。不修改 DSH 源码。
限制
此包的 engines.dsh 列出已验证的 0.2.1-rc.2 和 0.2.1-rc.3。其他 DSH 版本需要重新核对插件 API、主题 token 和全窗口背景层级，再调整兼容范围。
视觉参考：小红书「ASCII 风格的水母动效制作」。插件中的动画为独立绘制。
English
An animated full-window theme plugin for DSH 0.2.1-rc.2 and 0.2.1-rc.3. It draws character-cell jellyfish, a faint grid, and drifting stars behind the Web interface while applying a dark translucent palette. Native DSH controls and interactions remain in place.
The Canvas layer is procedural and ships without remote image or video assets. It ignores pointer events, pauses in hidden tabs, honors reduced-motion settings, and adjusts for viewport size and pixel density.
The background starts enabled on first install. Open Settings → General → Deep-sea ASCII jellyfish to disable it or adjust motion intensity and jellyfish count. Choose 0–12 jellyfish, with 6 by default; 0 keeps only the starry background. Changes take effect immediately and persist across reloads. Saved settings from earlier versions keep the original 6 jellyfish. Disabling restores the last selected DSH appearance. Appearance changes made while the plugin is enabled take effect after disabling it.
The animation pauses while hidden and resumes from its current position. Changing intensity keeps the swimming paths continuous. Reduced-motion mode and intensity 0 render a static scene. Preferences use browser localStorage and synchronize across tabs on the same origin.
Online install (Web)
Works with DSH 0.2.1-rc.2 and 0.2.1-rc.3. Run these commands from any directory on macOS, Linux, or Windows. No manual package download or repository clone is needed.
dsh --version
dsh plugin --profile web add https://raw.githubusercontent.com/yudaxia1/dsh-jellyfish-background/main/dist/dsh-background-style-plugin-0.1.6.tgz
The first command should print 0.2.1-rc.2 or 0.2.1-rc.3. After installation, stop the old Web process, then run:
dsh web
Use the same dsh executable and DSH_HOME for installation and launch. If multiple DSH versions are installed, replace each dsh above with the full path to a supported version. Open Settings → General → Deep-sea ASCII jellyfish for the toggle, intensity, and count controls.
Desktop: launch it once to initialize its profile, quit fully, use the installed app's bundled dsh command with --profile desktop in the installation command above, then reopen the app.
Build from source
Copy the plugin sources and configuration files to packages/client/dsh-background-style-plugin inside the DSH 0.2.1-rc.3 source tree. From the DSH root, install dependencies and run in order:
node --max-old-space-size=4096 ./node_modules/typescript/bin/tsc -b tsconfig.host.json
pnpm exec tsdown --config-loader native --env.DSH_BUILD_FACE host
pnpm exec tsc -b packages/client/dsh-background-style-plugin/tsconfig.json
pnpm exec tsdown --config-loader native --config packages/client/dsh-background-style-plugin/tsdown.config.ts --env.DSH_BUILD_FACE client
cd packages/client/dsh-background-style-plugin
pnpm pack
The Host entry and browser bundle are declared in package.json; the bundle patch installs the plugin into a profile. The browser half uses the official theme and Settings slot services, and does not patch DSH source files.
engines.dsh lists the tested 0.2.1-rc.2 and 0.2.1-rc.3 releases. Recheck the client APIs, CSS tokens, and window layers before expanding the supported version range.
Visual reference
Inspired by a Xiaohongshu ASCII jellyfish animation post. This plugin draws its own animation and keeps DSH's native interface.
