fewoot/dsh-whale-particles

dsh-whale-particles

npm version
npm downloads
license

把“点阵鲸鱼/照片点阵”作为 DSH Web 界面背景的浏览器端插件。

dsh-whale-particles 效果示例

上图为界面示例(点阵主体 + 界面透明化后的观感)。

- 每颗粒子都有自己独立、低频、平滑的“外力”(非统一流场、非逐帧白噪声),像官网鲸鱼一样:每颗各自动作柔和、彼此不齐;
- 手动模式:光标靠近时圈内各点柔和躁动,移开即平滑归位;
- 自动模式(屏保):“波”沿 360° 任意方向扫过主体(自动避开与上一道过近的方向,斜向按系数减速)+ “全屏呼吸”(缓缓起、维持、缓缓落),间隔默认 0(波连着波);
- 主体可切换:
- 🐋 鲸鱼(默认剪影);
- 🖼 照片:导入透明 PNG,引擎按 alpha 取主体、内部压成几 KB 小蒙版,仅存本地(localStorage),不上传;
- 参数面板(设置 → 插件 → 「鲸鱼点阵背景」标签页,直接铺开、无需展开):按「鼠标扰动 / 自动模式 / 外观 / 主体来源 / 轮廓 / 模式」六组排列;手动·自动、鲸鱼·照片都是高亮分段控件(当前选中项一眼可见);全部即时生效并自动保存,底部带「恢复默认」与版本号;
- 主界面不占位:没有右下角悬浮条,参数与手动/自动切换都在设置页里;
- 附带调整:空会话(hero)输入栏整体下移,避免盖住主体;有对话后自动恢复贴底布局;鲸鱼中心自动跟随左侧栏宽窄(内容区居中,平滑补间)。

安装

方式一:npm(推荐,之后可在插件市场里一键更新)

dsh plugin --profile desktop add dsh-whale-particles

装好后 profile 会把它记成依赖,npm 上发了新版本时,DSH 插件市场
(设置 → 插件)就能检测到并一键更新。

方式二:本地目录

dsh plugin --profile desktop add ./dsh-whale-particles

方式三:离线包(免命令行)

见 release/ 目录:解压 dsh-whale-particles-offline-*.zip 后双击
install-whale.bat,脚本会自动备份 profile 的 package.json、拷入插件并注册 bundle。

不借助 dsh CLI 手动安装(与离线包内部做法相同):
1. 把 dsh-whale-particles 文件夹复制到
%USERPROFILE%\.dsh\profiles\\node_modules\dsh-whale-particles;
2. 在 …\profiles\\package.json 的 dsh.profile.bundles 里追加
"dsh-whale-particles"(改前先备份);
3. 重启 DSH Desktop。

注意:手动拷进去的副本不会出现在插件市场的"已安装"列表里,也就没有一键更新;
想走市场更新请用方式一。

profile 名默认 desktop(桌面版);若你的 profile 不叫这个,换成实际的即可。
安装/更新后需要重启 DSH Desktop(客户端 bundle 在启动时装载)。

版本适配(重要)

插件的“界面透明化”与“空会话输入栏下移”依赖 DSH Web 界面里 CSS Module 哈希类名;
不同 DSH/Desktop 版本这些前缀会变。点阵引擎本身不依赖界面类名,任何版本都能渲染,
变了的只是“让界面透明、露出背景”那几条规则和 composer 下移规则。

需要调整时,编辑 lib/client.js 中 STYLE 常量开头几条与
measureContentCenter() 里的选择器,把哈希前缀换成本机实际类名:

| 作用 | 选择器(0.1.5-rc.1 / Desktop v2.0.9,与 0.1.2-rc.1 / v2.0.5 相同) |
| --- | --- |
| 主框架透明 | ._1qAH1q_frame |
| 会话/根容器透明 | .uPhUma_root |
| 侧栏半透明 | ._1qAH1q_sidebarCol |
| 内容区中心测量 | ._1qAH1q_sidebarCol、[data-slot="sidebar"] |
| 空会话输入栏下移 | .uPhUma_root[data-phase=hero] .uPhUma_composerSeat |

实测:DSH Desktop v2.0.5(web 前端 0.1.2-rc.1)的哈希前缀是 _1qAH1q
(主框架/侧栏,来自 @deepseek-ai/dsh-client-ui-layout)与 uPhUma
(会话/根容器/输入栏,来自 @deepseek-ai/dsh-client-ui-conversation);旧的
v2.0.3(0.1.1-rc.2)使用 pI_x6G、wSkVaW、ydkMvW。换版本后按上述办法
重新取值(DevTools 选中元素,取 _frame、_sidebarCol、_composerSeat
对应项的新前缀;全局替换这两处前缀即可)。改动后重启生效。

卸载 / 临时隐藏

dsh plugin --profile desktop remove dsh-whale-particles

或 Settings → 插件里停用;临时隐藏可在 DevTools 执行:

document.body.removeAttribute('data-dsh-whale');
document.getElementById('dsh-whale-particles-layer')?.remove();

说明
- 默认鲸鱼轮廓路径内联自 dsh-homepage-skin（MIT，来源见该仓库 README），保留为默认主体；
如需商用/换形，替换 lib/client.js 里的 WHALE_PATH（Path2D 数据）即可，照片模式不受影响。
- 纯浏览器插件：宿主半区 lib/index.js 为空实现；构建产物 lib/client.js 为
window.__ModuleLoader__.load 格式，免二次构建。
- 参数与照片蒙版保存在浏览器 localStorage（键 dsh-whale:cfg / dsh-whale:auto /
dsh-whale:photo），每台机器各自保存，不随插件文件迁移。

仓库结构

package.json          dsh.bundle.patch(bundle 资格)+ dsh.client(Web 客户端半边)
cordis.patch.yml      把本插件 insert 进 profile 的层栈
lib/index.js          宿主半边(空实现,纯浏览器插件)
lib/client.js         全部实现:点阵引擎 + 界面透明化 CSS + 参数面板(免构建)
assets/               README 用示例图
release/              发行物:最新 tgz、离线安装 zip、一键安装/卸载脚本