dsh-whale-particles
把“点阵鲸鱼/照片点阵”作为 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 手动安装(与离线包内部做法相同):
- 把
dsh-whale-particles 文件夹复制到
%USERPROFILE%\.dsh\profiles\<profile>\node_modules\dsh-whale-particles;
- 在
…\profiles\<profile>\package.json 的 dsh.profile.bundles 里追加
"dsh-whale-particles"(改前先备份);
- 重启 DSH Desktop。
注意:手动拷进去的副本不会出现在插件市场的"已安装"列表里,也就没有一键更新;
想走市场更新请用方式一。
profile 名默认 desktop(桌面版);若你的 profile 不叫这个,换成实际的即可。
安装/更新后需要重启 DSH Desktop(客户端 bundle 在启动时装载)。
版本适配(重要)
插件的“界面透明化”与“空会话输入栏下移”依赖 DSH Web 界面里 CSS Module 哈希类名
(如 qNbT7G_frame、_0cyzDW_composerSeat)。这些前缀每次重新构建都会变,旧版本把前缀写死,
所以每次 DSH/Desktop 升级这两项都会失效。
0.3.1 起改为运行时自发现,不再需要跟着版本改代码:UI 各包把自己的 CSS 以
<style data-plugin-css="<包名>/<模块>.module.css"> 注入文档,同一模块里类名的后缀
(_frame / _sidebarCol / _root / _composerSeat)是稳定的,只有前缀是哈希。
插件在挂载时扫描这些样式表,按模块定位、按后缀取前缀;UI 样式表若在本插件之后注入,
MutationObserver 会补扫一次并重建样式。
- 点阵引擎本身不依赖任何界面类名,任何版本都能渲染;受影响的只有“让界面透明、露出背景”
和 composer 下移这几条规则。
- 升级后想确认解析结果:DevTools 里执行
__dshWhale.selectors(),会列出每个类名及其来源
(discovered = 自发现 / fallback = 回退到内置值);__dshWhale.rescan() 可手动重扫并重建样式。
- 解析失败时控制台会留一条
[dsh-whale-particles] 界面类名未能在样式表里定位… 告警
(不再静默);此时用 maintain/extract-ui-css.mjs 取出本机真实类名,按需更新
lib/client.js 里的 FALLBACK_BY_VERSION 兜底表。
各版本实测类名(下表只是兜底表的来源,正常路径是自发现):
| 作用 | 后缀 | 0.1.5-rc.2(Desktop v2.0.13) | 0.1.2-rc.1 / 0.1.5-rc.1(v2.0.5~v2.0.9) | 0.1.1-rc.2(v2.0.3) |
|---|
| 主框架透明 | _frame | qNbT7G_frame | _1qAH1q_frame | pI_x6G_frame |
| 侧栏半透明 | _sidebarCol | qNbT7G_sidebarCol | _1qAH1q_sidebarCol | pI_x6G_sidebarCol |
| 会话/根容器透明 | _root | _0cyzDW_root | uPhUma_root | wSkVaW_root |
| 空会话输入栏下移 | _composerSeat | _0cyzDW_composerSeat | uPhUma_composerSeat | wSkVaW_composerSeat |
对照的模块:@deepseek-ai/dsh-client-ui-layout/AppFrame.module.css(框架/侧栏)、
@deepseek-ai/dsh-client-ui-conversation/ConversationRoot.module.css(会话根/输入栏座)。
临时用 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();
排查界面透明化/输入栏下移为何没生效(升级后最常用):
__dshWhale.selectors() // 每个类名的值 + 来源(discovered / fallback)+ 当前点数
__dshWhale.rescan() // 重新扫描样式表;有变化返回 true
__dshWhale.apply() // 按当前 SEL 重建样式
说明
- 默认鲸鱼轮廓路径内联自 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、一键安装/卸载脚本
