前言¶
DeepSeek Harness(DSH)默认界面偏工具向:新建会话与日常聊天页多是纯色底和常规输入框。若你希望在这两类页面上有一层可交互的动效背景、hero 页的蓝图风格标题,以及输入框与 HUD 面板的毛玻璃,又不想改 DSH 宿主源码,社区插件 dsh-signal-field 把上述效果做成客户端注入,并在「设置 → UI 动画」里逐项开关。下面介绍它做什么、覆盖哪些页面,以及如何安装与配置。
这是什么¶
dsh-signal-field(GitHub:Ycet/dsh-signal-field,维护者 Ycet)是 DSH Web / 桌面端的动效界面插件,当前版本 v0.3.0,许可证 MIT,平台标注为 DSH Web / Desktop。
一句话定位:在新增会话页与聊天会话页接入抖动信号场背景、新增页「DEEPSEEK HARNESS」蓝图标题动效、输入框毛玻璃;同一套背景与玻璃延伸到 dsh-awesome-hud 的 HUD 面板。插件管理页、自动化任务页及其它面板页保持 DSH 原生外观——v0.1.1 起在这两类目标页之外不创建图层、不写作用域属性、不注入样式,离开页面时会销毁已有图层与画布。
社区目录 skillhub.cn 将其归类为「趣味换装」;SkillHub 为独立社区站点,与 DeepSeek / 幻方无官方从属关系。
核心功能¶
作用范围与区域一览¶
| 区域 | 背景信号场 | 蓝图标题 | 毛玻璃 |
|---|---|---|---|
新增会话页(data-content-phase="hero") |
✓ | ✓「DEEPSEEK HARNESS」 | ✓ 输入框 |
| 聊天会话页 | ✓(含输入框条带) | — | ✓ 输入框 |
HUD 面板(dsh-awesome-hud,两页通用) |
✓ 透出并模糊 | — | ✓ 面板 |
信号场铺满内容区,不覆盖左侧导航栏,以便与 dsh-better-sidebar 等插件的配色少冲突。v0.2.4 起不再给右侧边栏铺信号场;HUD 面板仍靠「补场」让玻璃有内容可模糊,面板关闭时补场一并移除。
背景与交互¶
亮/暗配色跟随 DSH 主题(亮色约 #e7e9f0 / #b6bfd8,暗色约 #070a12 / #3a4a7a)。背景侧:噪声波自走、指针拖尾擦除/点亮、点击涟漪。WebGL2 不可用或上下文丢失时,降级为柔和径向渐变([data-mui-field][data-fallback]),不抖动、不交互,其它功能不受影响。
标题(仅新增会话页)¶
入场揭示、指针靠近时字形转虚线矢量轮廓(可选选框、拖动字块、飞白微粒)。标题与「鲸鱼图标 + 探索未至之境 + 预览版」同处 hero 行并整体居中;字形可拖到页面任意位置且不被画布裁切,松手回弹。挂载点缺失时,设置页会提示「当前 DSH 版本未找到新增会话页标题挂载点」,其它效果照常。
毛玻璃与实现注意点¶
输入框与 HUD 面板的模糊写在宿主元素的 ::before 上(模糊半径固定 14px,v0.2.9 起不再有独立「毛玻璃模糊」滑块),避免 backdrop-filter 在宿主上建立错误包含块导致 HUD 内弹层被裁切。聊天页输入框下方状态栏区域由 data-composer-seat::before 背衬处理滚动遮挡问题(v0.2.5 及后续版本迭代见 README)。
设置:「设置 → UI 动画」¶
配置段落在 DSH 设置里为 signal-field(位置 58)。v0.2.9 起分为两个模块,中间一条分割线:
总开关(模块之上)
- 启用全部动效
页面
- 新建会话页面 / 聊天会话页面(各带说明)
动效
- 标题文字默认动效 / 标题文字鼠标交互
- 标题动画速度(滑块,默认 1×,v0.3.0,范围 0.25×–2×)
- 背景默认动效 / 背景鼠标交互 / 输入框毛玻璃效果
- 背景强度(滑块,默认 30%)
- 背景动画速度(滑块,默认 1×,v0.3.0)
- 重绘帧率上限(滑块,默认 30 fps,v0.2.11,15–60 fps,步长 5)
共 1 个总开关 + 7 个开关 + 4 个滑块。关掉某一页的开关则该页所有效果一起停用;HUD 面板毛玻璃没有独立开关,跟随「聊天会话页面」,且不受「输入框毛玻璃效果」控制。
配置写入浏览器 localStorage(键 dsh-signal-field:v1),支持「恢复默认」。关闭总开关后画布销毁、动画停止、作用域属性移除,界面回到原生外观。
系统开启「减少动效」(prefers-reduced-motion: reduce)时,首次安装会把「默认动效」与「鼠标交互」初始化为关,设置页有说明,可手动再开。
安装与启用¶
插件以 bundle 形式安装,命令须使用资料中的 plugin_manager,不要凭仓库名拼接其它 CLI。
# 安装(target 为插件包目录的绝对路径)
plugin_manager install_bundle target=<absolute-path-to-plugin>/dsh-signal-field
安装前建议在本地阅读 package.json 与源码,确认许可证(MIT)与 dsh.client.inject 等声明;插件在当前 DSH 进程权限下运行,与宿主同域,属于信任边界内的客户端扩展。
升级源码后需重新构建并视情况重装:
node scripts/build.mjs # 重新生成 client.js
# 目录链接安装:刷新页面即可;package.json / exports 变更时需重新 install_bundle
# 若刷新未生效:plugin_manager set_plugin 关→开,或重启 DeepSeek Harness
卸载:
plugin_manager remove_bundle target=dsh-signal-field
典型用法¶
1、按上文命令 install_bundle 指向本机上的 dsh-signal-field 目录,在 DSH 插件管理中启用 bundle。
2、打开 设置 → UI 动画,先确认「启用全部动效」与「新建会话页面 / 聊天会话页面」是否符合预期。
3、新建会话:观察 hero 背景、蓝图标题与输入框毛玻璃;聊天页:观察条带背景与输入框玻璃;若安装了 dsh-awesome-hud,打开 HUD 面板看玻璃是否透出背后信号场。
4、按需调节「背景强度」「重绘帧率上限」与 v0.3.0 的两个速度滑块;设置页自检文本末尾的 --- performance --- 段可对照实测 fps(限帧与失焦降频是否生效的硬证据)。
5、DSH 大版本升级后若动效消失,对照 README「已知限制与版本耦合」中的 DOM 锚点表(如 [data-conversation-content]、[data-composer-card]、.hud-panel 等)排查。
适用场景与注意¶
适合谁:长期在 DSH Web / Desktop 上新建会话与聊天、希望这两类页面有统一动效皮肤,且愿意在设置里细分开关与帧率/速度的用户;可与 dsh-awesome-hud 配合使用 HUD 毛玻璃。
务必注意:
- 作用范围仅新增会话页与聊天会话页;其它页面保持原生,避免误以为全应用换肤。
- 依赖 DSH 的 DOM 契约,宿主结构变更可能导致背景、标题或玻璃单项失效;插件自述为「只读宿主、不改宿主」。
- 右侧边栏已无信号场;HUD 补场与「聊天会话页面」开关绑定。
- 开发环境要求 Node >= 22;构建与测试:
node scripts/build.mjs,node --test test/*.test.mjs。
结尾¶
dsh-signal-field 把信号场背景、hero 蓝图标题与输入框/HUD 毛玻璃收敛到 DSH 的两类核心会话页,并在「设置 → UI 动画」提供总开关、分页开关与强度/帧率/速度调节,同时限定作用范围与 WebGL 降级路径,便于在不动宿主的前提下做界面换装。