前言¶
在 DeepSeek Harness（DSH）里长时间写提示、切会话、看流式输出，界面多半是静态的：面板切换、发送消息、运行中的会话缺少连贯的视觉反馈。若只想在不改模型、不碰请求与消息内容的前提下，给导航、输入和会话加一点动效，需要自己写客户端补丁或堆第三方动画库，成本和维护都不低。
Ratel Lumina（npm 包名 @ratel-works/dsh-lumina）是面向 DSH 的视觉与动效增强插件，由维护者 golddream-y 发布，支持桌面端与 Web / PWA。下面介绍它的定位、能力与安装配置方式。
这是什么¶
Ratel Lumina 在 DSH 日常操作路径上叠加一层「恰到好处的动效」：面板、菜单、对话框与消息过渡可以连贯呈现，运行中的会话可通过光色变化更有存在感。插件不修改模型、请求或消息正文，不延迟提交，也不阻塞输入、点击与选区。
项目采用 MIT 许可证；当前 npm 版本为 1.1.0（以 package.json 为准）。社区目录页分类为「趣味换装」，SkillHub 上插件线索为 golddream-y/ratel-dsh-lumina。
核心功能¶
交互与动效范围¶
- 连贯交互：导航、运行中的会话、输入与发送等环节可加入 subtle motion；具体 shipped 效果以实现状态文档为准，README 另提供 motion demos 作为设计原型，并非全部已上线客户端。
- Composer 与发送：可配置品牌风格、颜色、动效强度与发送效果（send effect）；各效果可单独关闭。
- 流式反馈：面向 streaming 场景的视觉反馈（与 README 简介中的 streaming feedback 一致，细节见项目文档）。
可定制与无障碍¶
- 逐项开关：主开关可恢复原始界面；单个效果也可关闭。
- 画质档位：在设置中选择 Performance、Balanced（默认）、Quality 或 Ultra；档位独立调整绘制频率、分辨率与细节，与动效强度分开。帧率为上限而非保证值，取决于设备与显示器。
- 减少动态效果：不引入额外动画框架，依赖原生浏览器能力；系统开启「减少动态效果」时，Lumina 会自动减弱或关闭动画。
安装与启用¶
先安装 DeepSeek Harness，再安装本插件。
插件商店：在 DSH 插件商店搜索 ratel-dsh-lumina，作者为 golddream-y。
命令行（将 <profile> 换为实际使用的 profile，桌面端一般为 desktop，Web / PWA 一般为 web）：
dsh plugin --profile <profile> add @ratel-works/dsh-lumina
更新插件后，需完全退出并重新打开客户端以加载新代码；命令行更新时再次执行上述安装命令即可。
插件在 DSH 进程权限下运行。安装前建议阅读 GitHub 源码与 MIT 许可证；社区目录站点与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
典型用法：设置项¶
保存后立即生效，无需重启（与「更新插件后需重启客户端」针对的是插件版本升级，二者不同）。
- 打开 DSH 设置中的 Lumina / 流光。
- 在 Effects and style 中调整颜色、动效强度、发送效果，或关闭不需要的单项效果。
- 在 Performance and quality 中选择画质档位；可将鼠标悬停或聚焦档位按钮查看参数说明。
- 需要完全关闭动效时，使用主开关；若系统已启用 reduced motion，插件会配合系统自动降档或关闭动画。
适用场景与注意¶
适合：希望在 DSH 桌面或 Web / PWA 上获得统一、可关、可降级的界面动效，且明确不改变推理与消息内容的开发者。
注意：
- Lumina 仅做 UI / motion 层增强，不改变模型、请求或消息内容。
- 低性能设备上可优先使用 Performance 或关闭部分效果。
- 功能实现范围与验证范围见仓库内
docs/product/功能实现状态.md；变更记录见CHANGELOG.md。
结尾¶
Ratel Lumina 把 DSH 里分散的界面操作串成可配置的一层动效，并支持系统 reduced-motion 与逐项关闭。若需要核对安装命令与设置项，以 GitHub README 为准。
