深海字符水母 yudaxia1/dsh-jellyfish-background

DSH 深海字符水母背景

DSH 实际运行中的水母背景动图

实际界面：全窗口截图 · 设置开关与强度滑块

适用于 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风格的水母动效制作（提示词分享》，笔记 ID 6ad97ec4000000002c0263ef。

效果预览

仓库中的动图和截图均来自 DSH 0.2.1-rc.3 的实际运行页面，不是模拟界面。