前言¶
在 DeepSeek Harness（DSH）里长时间写提示、盯推理过程时，界面往往是纯色底加标准组件。换主题能改配色，但很少同时提供「铺满窗口的环境光场、与推理档位联动的动效，以及不挡面板的输入区玻璃感」。若你希望在不替换宿主 UI 的前提下，给整个窗口加一层可关、可拆分的视觉背景，社区插件 dsh-starlight-background（维护者 Darcy79，分类：趣味换装）就是面向这一需求的 Web 客户端覆盖层方案。下面介绍它是什么、能做什么，以及如何安装与日常使用。
这是什么¶
dsh-starlight-background 是注册在 shell.overlay 上的 DSH Web 客户端插件（当前资料版本 0.4.1，MIT 许可证）。它不替换 Harness 界面，而是在 UI 上方铺光场，并通过主题令牌统一底色；对输入框使用 [data-composer-seat]、[data-composer-card] 施加玻璃样式。README 概括的能力包括：海风主题插画（内嵌动效）、玻璃 composer、右下角齿轮设置，以及随推理等级与对话节奏变化的流星。
插件清单见 SkillHub 目录页，源码与变更说明见 GitHub 仓库。SkillHub 为独立社区目录，与 DeepSeek / 幻方无官方从属关系；DSH 生态本身是「一切皆插件」的思路，安装前仍应自行查看源码与许可证。
核心功能¶
光场、底色与玻璃输入框¶
开启后，侧栏、标题栏与主区域在深色主题下统一到 --dsw-alias-bg-base（深色 #151517）；浅色为 #ffffff。输入框为同色半透明加 backdrop-filter: blur(22px)，并保留顶部光边与内侧柔光。总开关关闭时会撤销主题令牌覆盖及玻璃/tooltip 样式，恢复宿主外观。
每次切换总开关（按钮或 Alt+L），会有一条约 1.1 秒的柔光带沿左上 → 右下扫过；启用时固定流星跟在光带后从路径起点飞入，关闭时光场约 1 秒内淡出。开关 UI 为 34×20px 标准胶囊样式，深浅色轨道与滑块颜色在 README 中有具体色值。
海风插画（「大肥鱼」）¶
插画源文件 assets/deepseek-ocean.png 在构建时内嵌进 client.js，加载不依赖额外路径。画面等比铺满窗口高度、靠右摆放，左缘渐隐；深浅色与窄屏下透明度分别调整。动效基于单张完整插画的 WebGL 局部形变（非 Live2D 分层骨骼）：发梢与裙边随左上 → 右下微风摆动，鲸尾轻摆，约每 4–8 秒眨眼一次。0.3.x 起还包含脸侧发束、双手小幅晃动与脚边水花等细节。
齿轮设置里可独立控制「大肥鱼显示」与「大肥鱼动效」：隐藏人物时动效开关联动禁用；仅关动效时使用静态原图并停止 GPU 绘制。系统 prefers-reduced-motion: reduce 时显示静止画面；prefers-contrast: more 时隐藏插画并停止绘制。
流星与推理、对话联动¶
固定流星按 Harness 推理档位变化数量（资料中的对应关系）：
| 档位 | 数量 |
|---|---|
| Off | 2 |
| Low | 4 |
| High | 7 |
| Max | 10 |
固定流星从左上沿各自路径飞向右下，升档时新增流星从路径起点飞入，降档时多余的继续沿路径飞出并淡出。颜色跟随模型：Flash 青白、Flow 冰蓝、Reason 蓝紫、Aurora 粉白。另有周期性流星（速度约为固定流的 30%、密度更高）以及「新想法」高亮流星：通过 conversation.input.left 观察最近 Chat 节点，在 agent 进入新 assistant-step 且仍在运行时亮一颗更白更长的流星；用户 20 秒内发 user / steering 则标记已执行，否则过期飞走（6 秒防抖，每会话最多 4 颗）。该逻辑不读消息正文，只看节点类型与顺序。
齿轮里「流星」开关可独立关闭周期性与新想法流星；关闭时停止周期生成并阻止新增想法流星，再开启时按当前档位以 2 / 4 / 7 / 10 颗恢复固定流星。
右下角齿轮设置（0.4.0 / 0.4.1）¶
右下角仅显示齿轮图标（0.4.1 去掉底色与边框，保留悬停旋转约 65° 与键盘聚焦）。点击打开四行开关弹窗，点击外部或 Escape 关闭；设置保存在本机，刷新后保留。
| 开关 | 行为 |
|---|---|
| 总开关 | 一键开关全部背景效果与玻璃样式；Alt+L 仍可用；关闭时保留子项选择 |
| 流星 | 独立控制固定、周期性与新想法流星 |
| 大肥鱼显示 | 显示或隐藏背景人物；关闭时同时关闭大肥鱼动效 |
| 大肥鱼动效 | 控制人物、双手、鲸尾、水花、眼神、眨眼及海风 |
总开关关闭时子项禁用，齿轮仍可打开；重新开启后恢复子项选择。
性能与无障碍¶
画布上限 1024×1536、最多 30fps；窗口不可见或开关关闭时暂停 GPU 绘制。WebGL 不可用或上下文丢失时回退静态原图，恢复后自动继续动效。固定流星最多 10 颗，每颗带 4–8 颗尾焰粒子；周期性流星最多 10 颗。
安装与启用¶
SkillHub 提供的安装方式是交给 DeepSeek Harness 读取后端安装计划后执行，而非在资料中给出单独的 dsh plugin add … 命令行。在目录页「发送给 DeepSeek Harness 安装」中，作者给出的请求文案为：
请安装 DSH 插件 Darcy79/dsh-starlight-background。先读取..
（完整句子以 SkillHub 页面为准。）
安装完成后，若此前关闭过插件，可点击右下角齿轮内的总开关，或按 Alt+L 开启光感。更新插件或升级版本后，README 要求 刷新 Harness 页面（Ctrl+R） 以加载新的 client.js 模块。
典型用法¶
在 Harness 中日常使用¶
- 开启总开关后，背景光场与插画叠在 UI 之上，面板与浏览器浮层内容仍保持可读（README 样图展示了 Harness 内打开网页时的效果）。
- 按推理档位观察固定流星数量变化；在 agent 连续推理时留意高亮「新想法」流星（若流星子开关开启）。
- 用齿轮分别关闭流星或插画动效，在需要专注或省电时保留静态底图。
本地预览与开发（维护者脚本）¶
维护者在 README 中说明，可用本地预览查看动效与深浅色，但实际 Harness 叠放仍以宿主加载为准：
npm run preview
默认预览地址为 http://127.0.0.1:4177。修改 src/ocean-artwork.js 或图片后：
npm run build:artwork
npm run check
npm run check 会执行 scripts/check.mjs 与 scripts/check-behavior.mjs。浏览器插画检查需本机已有 playwright 和 sharp，可选 ARTWORK_BROWSER 指定浏览器路径后运行 npm run check:artwork。
插画强度可通过 .dhl-artwork 上的 CSS 变量 --dhl-art-opacity 调整（默认深色 0.42、浅色 0.29，再乘以全局光感强度）。
适用场景与注意¶
适合希望在 DSH 里获得统一深色底、环境流星与右侧插画、且能细粒度关掉动效或流星的开发者。若你依赖高对比度界面、或系统开启了「减少动态效果」，插件会按偏好降级或隐藏部分层，行为以 README「性能与可访问性」一节为准。
权限与安全：DSH 插件以当前 Harness 进程权限运行，客户端脚本可订阅会话 UI 与主题 API（package.json 中 dsh.client.inject 列出了 @deepseek-ai/dsh-api-remotes、dsh-client-ui-conversation 等依赖）。安装前应阅读 GitHub 源码 与 MIT 许可证，确认可接受其读取对话节点结构以实现流星启发式逻辑。
生态说明：SkillHub 目录页显示该插件 GitHub 星标为 0（以目录页展示为准），属社区「趣味换装」类贡献，并非官方内置主题。
结尾¶
经过上面的步骤，你可以在不动 Harness 核心布局的前提下，用 dsh-starlight-background 叠加星轨光感、玻璃输入框与可独立控制的插画和流星。需要安装入口与简介时打开 SkillHub：Darcy79/dsh-starlight-background；需要版本历史、开关细节与构建命令时查阅 GitHub：Darcy79/dsh-starlight-background。
