前言¶
DeepSeek Harness（DSH）提供了智能体开发环境，除了功能性的工具链，界面的个性化也是常见需求。dsh-whale-particles 是一个运行在浏览器端的 Web 插件，旨在为 DSH Web 界面添加一个互动的点阵背景。该插件通过粒子系统模拟“鲸鱼”或自定义照片的轮廓，并提供手动交互与自动屏保模式。
插件定位¶
- 名称：dsh-whale-particles
- 作者：fewoot
- 分类：趣味换装
- 许可证：MIT
安装¶
安装该插件需要 DSH Desktop 客户端。安装/更新后必须重启 DSH Desktop 才能生效。
方式一：npm 安装（推荐）
使用官方 CLI 安装，插件会记录在 profile 依赖中，后续可在插件市场检测更新。
dsh plugin --profile desktop add dsh-whale-particles
方式二：本地目录
dsh plugin --profile desktop add ./dsh-whale-particles
方式三：离线包
解压 dsh-whale-particles-offline-*.zip 后，双击 install-whale.bat 脚本，脚本会自动处理备份和注册。
方式四：手动安装
1. 将 dsh-whale-particles 文件夹复制到 %USERPROFILE%\.dsh\profiles\<profile>\node_modules\dsh-whale-particles。
2. 在 …\profiles\<profile>\package.json 的 dsh.profile.bundles 中追加 "dsh-whale-particles"（改前备份）。
3. 重启 DSH Desktop。
注意：手动拷贝的副本不会出现在插件市场的“已安装”列表中，因此无法通过市场进行一键更新。
核心功能¶
插件的核心逻辑包含点阵引擎与界面适配两部分。
1. 粒子物理与模式
* 独立外力：每颗粒子拥有独立、低频且平滑的“外力”，模拟真实流体或官网鲸鱼的柔和动作，而非统一流场。
* 手动模式：光标靠近时，圈内粒子会柔和躁动；光标移开后，粒子会平滑归位。
* 自动模式（屏保）：支持 360° 任意方向扫波（自动避开上一道过近的方向，斜向减速）以及全屏呼吸效果（缓缓起、维持、缓缓落）。
2. 主体与外观
* 主体切换：默认使用鲸鱼剪影（路径来自 dsh-homepage-skin）。支持导入透明 PNG 照片，引擎会按 alpha 通道提取主体，压缩蒙版并保存在浏览器 localStorage 中，不上传云端。
* 参数面板：进入设置 → 插件 → 「鲸鱼点阵背景」标签页。参数按“鼠标扰动/自动模式/外观/主体来源/轮廓/模式”分组。所有设置即时生效并自动保存，支持恢复默认。
* 界面适配：主界面不占位（无右下角悬浮条）。插件会自动将空会话（hero）的输入栏整体下移，避免遮挡背景主体。
使用方法¶
1. 导入自定义照片
在设置页的「主体来源」中选择照片，上传透明 PNG。插件会自动解析并生成点阵蒙版。
2. 切换交互模式
在参数面板的「模式」组中切换手动/自动模式。
3. 调整参数
根据喜好调整外力强度、呼吸速度等参数，或点击「恢复默认」重置。
技术细节与注意事项¶
1. 界面适配依赖
界面的透明化与输入栏下移功能依赖于 DSH Web 的 CSS Module 哈希类名（如 _frame, _composerSeat）。旧版本插件将类名写死，因此每次 DSH Desktop 升级后这两项功能可能会失效。0.3.1 版本起改为运行时自发现，但仍建议在升级后检查。
2. 故障排查
如果界面适配未生效，可在浏览器 DevTools 控制台执行以下命令：
* __dshWhale.selectors()：查看每个类名的值、来源（自发现/兜底）及当前点数。
* __dshWhale.rescan()：手动重新扫描样式表并重建样式。
* __dshWhale.apply()：按当前解析结果重建样式。
3. 数据存储
照片蒙版数据存储在浏览器的 localStorage 中（键名如 dsh-whale:photo），参数配置存储在 dsh-whale:cfg，每台机器独立保存。
4. 许可与更新
默认鲸鱼轮廓路径内联自 MIT 许可的 dsh-homepage-skin 仓库。如需商用或更换形状，需自行修改源码中的路径数据。照片模式不受影响。
资源¶
- 目录页：dsh-whale-particles (SkillHub)
- GitHub 仓库：fewoot/dsh-whale-particles
