前言¶
DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」，主题系统也是通过插件的形式接入的。dsh-theme-blackhole 是一个为 DSH Web UI 定制的主题插件，它提供了一套视觉样式，而不是核心功能逻辑。
插件概述¶
- 插件名：
dsh-theme-blackhole - 维护者：jiangwangyang
- 分类：趣味换装
- 定位：Web UI 主题插件，提供 WebGL 史瓦西黑洞背景和深空玻璃面板配色。
核心功能¶
该插件包含以下能力：
- WebGL 史瓦西黑洞背景：使用 null-geodesic（零测地线）光线追踪渲染重力透镜、吸积盘和光子环，并带有缓慢的自动相机轨道。
- 深空玻璃面板：通过半透明的深色设计令牌覆盖和背景模糊，让黑洞背景在内容后方若隐若现，品牌强调色变为吸积盘的琥珀色。
- 一等主题支持：注册到主题运行时。设置行的开关与外观设置双向同步，切换持久化，且启动时不会出现默认主题的闪烁。
- 性能友好的降级处理：采用半分辨率渲染和 30fps 帧率限制，并遵守系统的减少动画偏好。如果 WebGL 不可用，会自动降级为纯黑深空背景。
安装与启用¶
安装前请确认当前 DSH 进程拥有 Web 服务权限。该插件仅支持包含 web 服务器的 profile。
- 安装插件：
dsh plugin --profile web add github:jiangwangyang/dsh-theme-blackhole
- 启用主题：
安装并启动后，进入 设置 > 通用 > 主题 - 黑洞。
典型用法¶
在启用该主题后，其行为如下：
- 开启：切换到黑洞主题。开关状态会被持久化保存，刷新页面或重启后依然生效。
- 关闭：恢复之前的内置主题（浅色/深色/跟随系统）。原来的外观偏好不会被覆盖。
- 一致性维护：如果在外观设置行切换回内置主题，插件内部的开关会自动写入“关闭”，保证两个设置的一致性。
适用场景与注意事项¶
- Profile 依赖：该插件依赖 web profile 的
webServer服务，仅适用于包含 web 服务器的 profile（例如webprofile）。不要将其安装到无头 profile 中。 - 许可证：基于 MIT 许可证开源，使用时请遵守相关条款。
结语¶
dsh-theme-blackhole 通过 WebGL 渲染技术，为 DSH Web UI 带来了极具视觉冲击力的背景效果，同时保持了良好的性能表现和主题系统的集成度。如果你需要在 Web 界面中展示更具科技感或科幻感的视觉风格，这是一个可以直接使用的主题方案。
- 源码地址：https://github.com/jiangwangyang/dsh-theme-blackhole
