前言¶
DeepSeek Harness（DSH）的 Web UI 默认以主题纯色铺满工作区，长时间写提示、读回复时，界面层次清晰，但背景缺少动态反馈。若在不大改主题结构的前提下，把 antigravity.google 上那种随鼠标移动的 WebGL 粒子场铺到界面背后，同时保留侧栏、输入框和卡片自身的底色，阅读区仍可读、控件仍像原生壳层——dsh-plugin-agy-bg 就是按这个思路做的 Web UI 插件。下面按定位、能力、安装与用法说明如何接入。
这是什么¶
dsh-plugin-agy-bg 是维护者 drliuhuan 发布的 DeepSeek Harness Web UI 插件（npm 包名同为 dsh-plugin-agy-bg，当前版本 0.1.3，MIT 许可证）。它在界面后方绘制源自 antigravity.google 的鼠标跟随 WebGL 粒子背景；宿主机侧 index.js 为空，逻辑集中在浏览器端的 client.js。社区目录 SkillHub 将其归类为「趣味换装」。
插件以当前 DSH 进程与浏览器环境运行；安装前建议自行查阅仓库源码与许可证，确认符合你的安全与合规要求。
核心功能¶
README 中已明确的能力如下。
- 透明显示策略：覆盖整页高度的主题底色容器会标记为透明，粒子场可透出；侧栏、Composer、卡片与对话框仍保留各自背景。
- 粒子环行为：光标映射到平面后，环心带缓动跟随；半径有呼吸感，并含环带位移与空闲时的缓慢漂移。
- 主题联动：明/暗配色随 Harness 主题自动切换。
- 开关与记忆：Settings → General 中的开关可即时切换（默认开启）；偏好写入
localStorage，键名为dsh-plugin-agy-bg:v1。 - 实现方式：纯 WebGL2，未依赖 three.js；256×256 GPU ping-pong 粒子模拟，再以 point-sprite 绘制。
- 无障碍与降级：在
prefers-reduced-motion: reduce下，密度上限为 110、隔帧模拟；若无 WebGL2 或EXT_color_buffer_float，插件完全不生效，界面外观不变。
环境要求¶
- DeepSeek Harness：
0.2.1-rc.2至0.2.x，且使用带 Web UI 的 profile（package.json中engines.dsh为>=0.2.1-rc.2 <0.3.0-0）。 - 浏览器：支持 WebGL2 且具备
EXT_color_buffer_float的近期桌面浏览器。
安装与启用¶
DSH 生态里插件通常通过 profile 依赖与 bundle 列表挂载；下列命令与步骤来自仓库 README，请按你的环境二选一或组合使用。
通过 Plugins 页面¶
- 侧栏进入 Plugins → Add plugin。
- 填写 npm 包名
dsh-plugin-agy-bg，或指向本仓库的包目录。 - 选择 Enable now，刷新 Web UI 一次。
通过 CLI¶
先把插件以依赖形式加入 web profile；若使用本地目录，可将包名换为 link:/path/to/dsh-plugin-agy-bg。
# 1) install as a link: dependency into the web profile
dsh plugin --profile web add dsh-plugin-agy-bg # or link:/path/to/dsh-plugin-agy-bg for a local checkout
# 2) the plugin is usually added to the bundle list automatically; if not, add it to
# ~/.dsh/profiles/web/package.json → dsh.profile.bundles (after dsh-base / dsh-web-app)
web profile 在 manifest 变更时会 HMR 重组，一般无需重启 dsh.service；改完后刷新页面以加载新的客户端图。卸载时移除依赖与 bundle 项，或在 Plugins 页面操作。
典型用法¶
启用插件后，打开 Settings → General，找到 「Antigravity particle background」（中英文文案通过插件 locale 注册）即可开关背景。无需额外配置文件。
若需验证粒子参数是否与公开页观察值一致，README 记载主场景使用例如 density 230、ringWidth 0.006、particlesScale 0.59 及蓝/红/黄三色；暗色主题采用站点 footer CTA 一侧的调色与参数。日常使用时只需开关，不必改这些常量。
适用场景与注意¶
适合谁：希望在 Harness Web UI 中获得轻量视觉反馈、又不想牺牲输入区与卡片可读性的开发者；分类上属于界面「趣味换装」类增强，不改变 Agent 或工具链行为。
技术注意：
- 插件会扫描 DOM 并为符合条件的全页容器打
data-dsh-antigravity-surface="transparent"，约每 2 秒重复以适配客户端路由；并对 Composer 区域做渐变移除与 veil 画布处理，使粒子贴近输入框下沿。 - 非官方复刻，与 Google 无隶属关系；视觉参数来自对 antigravity.google 公开页面的观察。
- 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，不等同于官方应用商店。
结尾¶
dsh-plugin-agy-bg 把 antigravity 风格的鼠标跟随粒子场嵌进 DSH Web 壳层，用设置项和 localStorage 记住偏好，并在不支持 WebGL2 浮点缓冲时静默降级。需要进一步了解实现细节时，可阅读仓库中 How it works 与 src/ 结构说明。
