dsh-whale-bg

English | 简体中文

一个非官方的 DeepSeek Harness Web UI 背景插件，将 DeepSeek 鱼形轮廓重建为 由不同尺寸粒子组成的动态效果。

这是一个社区项目，与 DeepSeek 不存在从属、维护或背书关系。鱼形几何数据 复用自采用 MIT 许可证的 DeepSeek Harness 仓库，详情参见 THIRD_PARTY_NOTICES.md。

主要功能：

• 入场动画——粒子从散落状态逐渐组装成鱼形
• 待机游动——轮廓边缘保持松散，尾部带有行波效果
• 悬停交互——带三次衰减和单粒子角度扰动的径向推力
• 手电筒照明——鱼形平时近乎不可见，光线随光标移动并照亮附近粒子
• 主题适配——浅色主题使用正片叠底和深蓝色，深色主题使用滤色和辉光
• 30 FPS 渲染——限制装饰层的资源开销

兼容性

本插件基于 @deepseek-ai/[email protected] 的 Web profile 开发并完成测试。 DeepSeek Harness 目前仍处于开发者预览阶段，后续版本可能需要同步调整插件。

安装

请先按照 DeepSeek Harness 官方说明 安装 dsh 命令。当前插件通过本地源码目录安装：

git clone https://github.com/gooosie/dsh-whale-bg.git
cd dsh-whale-bg
npm ci
npm run check
dsh plugin --profile web add .
dsh web

dsh web 固定启动名为 web 的 profile，因此插件必须安装到该 profile。 本地安装会链接到当前源码目录；插件保持安装期间，请勿移动或删除这个目录。

dsh.bundle 补丁会插入 whale-bg 配置行，dsh.client 声明则会将浏览器端 模块挂载为 /plugins/dsh-whale-bg/client.js。

可以通过以下命令检查合成后的配置：

dsh web --dump-config

卸载插件：

dsh plugin --profile web remove dsh-whale-bg

开发

npm ci
npm run build   # tsdown -> ESM Host + DSH ModuleLoader Client
npm test        # 检查清单、入口、模块交接、依赖注入和主题 API
npm run check   # 严格类型检查 + 全新构建 + 包级验证
npm run watch

项目结构

dsh-whale-bg/
├── package.json       # dsh.bundle 与 dsh.client 清单
├── cordis.patch.yml   # 插入 whale-bg 配置层
├── tsdown.config.ts   # ESM Host 与 CJS Client 构建配置
├── scripts/            # 包级回归验证
├── README.md           # 英文文档
├── THIRD_PARTY_NOTICES.md
└── src/
    ├── index.ts       # 无行为的 Host 入口，用于 Loader 扫描
    └── client.ts      # 鲸鱼粒子背景的浏览器端实现

参数调整

所有可调参数均位于 src/client.ts：

| 参数 | 位置 | 默认值 | | --- | --- | --- | | 粒子密度 | SAMPLE_SIZE、MODEL_STEP | 60、0.18 | | 鱼形尺寸与位置 | computeLayout | 不超过 720×540，居中 | | 手电筒半径 | lightDistance / 7 | 7 个模型单位 | | 待机最低可见度 | light = 0.05 + … | 0.05 | | 鼠标推力半径 | distance < 4.9 | 4.9 个模型单位 | | 帧率 | 1000 / 30 | 30 FPS |

贡献与许可证

欢迎参与贡献，具体要求参见 CONTRIBUTING.md。项目代码采用 MIT License，第三方资产说明和非官方声明参见 THIRD_PARTY_NOTICES.md。