dsh-whale-bg

English | 简体中文

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

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

主要功能：

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

兼容性

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

安装

需要先安装带有 dsh 命令的 DeepSeek Harness。dsh web 固定启动名为 web 的 profile，因此插件也必须安装到该 profile。

# 从本地源码目录安装
dsh plugin --profile web add /absolute/path/to/dsh-whale-bg

# 发布到 npm 后安装
dsh plugin --profile web add dsh-whale-bg

然后启动或重启 Web UI：

dsh web

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

发布

npm run check
npm publish

prepare 脚本会在 npm 打包和从 Git 安装时自动从源码构建插件。

项目结构

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

参数调整

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