前言¶

在 DeepSeek Harness（DSH）里长时间用 Web 界面时，外观往往依赖主题插件或宿主默认配色。普通静态背景或外链图片皮肤，很难做连续卷动的星云、视差星点，还要兼顾侧栏与正文的对比度。dsh-skin-galaxy 是维护者 haoranx98 发布的独立皮肤插件，用浏览器原生 WebGPU 与 WGSL 在客户端实时绘制紫蓝星云、银河尘带和偶发流星，并通过 theme.overrideTokens 适配宿主 light / dark / system，不引入 CDN、图片下载或额外运行时依赖。下面按定位、能力、安装、配置与注意事项说明用法。

这是什么¶

• 名称与包名：星河 · Galaxy，dsh-skin-galaxy（当前 npm 版本 0.1.5，MIT 许可）。
• 归属：仓库 github.com/haoranx98/dsh-skin-galaxy，社区目录分类为「趣味换装」。
• 解决的问题：在 DSH Web 上提供一套可配置的深空视觉层，同时保证 Markdown 正文、表格、侧栏与输入框在明亮阅读底板上的可读性；停用插件时撤回 GPU 资源与主题覆盖，恢复宿主原外观。

核心功能¶

实时 WebGPU 画面¶

插件在页面背后挂载画布，默认约 30 FPS，像素比上限 1.25，画布最大 1920 × 1200，大屏按比例缩放。星云宽阔云团缓缓卷动，细丝与尘带差速流动，远近星点带轻微视差与闪烁。自 0.1.3 起在着色器内绘制随机流星：方向 360° 随机，拖尾衰减；默认每次结束后约 7～16 秒 再出现下一颗，持续约 0.85～1.35 秒。speed 为 0 或系统开启「减少动态效果」时不播流星，且流星计时不随星云 speed 倍率变化。

页面隐藏时停止绘制；speed 为 0 或减少动态效果时只绘静态 GPU 帧。适配器不可用、WGSL 编译失败或设备丢失时保留静态渐变底色，并在开发者控制台说明原因。

主题与阅读层¶

通过 dsh 的 theme.overrideTokens 提供皮肤层，宿主异步读设置时皮肤不闪退。0.1.1 起正文为明亮近白色，Markdown 与表格有半透明蓝灰阅读底板，侧栏与输入框提高不透明度；对比度检查覆盖正文与控件，并按最亮背景验证至少 4.5:1（需已停用其他普通皮肤）。

无额外运行时负担¶

不加载运行时 CDN、不下载图片或视频、无遥测；lib/ 产物可随仓库直接使用。预览与动图来自真实 WebGPU 出帧（README 中 20 帧循环 GIF），非后期示意图。

安装与启用¶

推荐从 npm 安装，版本固定、可校验完整性：

dsh plugin --profile web add dsh-skin-galaxy

也可跟踪 GitHub 仓库最新提交：

dsh plugin --profile web add github:haoranx98/dsh-skin-galaxy

本地开发可指向目录或打包的 dsh-skin-galaxy-<version>.tgz：

dsh plugin --profile web add /绝对路径/dsh-skin-galaxy

安装后先做两件事：在「设置 → 插件」里停用其他普通皮肤（只保留皮肤市场与本皮肤），再重启并刷新：

dsh web

不要用两个普通皮肤同时接管外观；在插件页用启用开关停用旧皮肤，不要直接改文件，以免宿主管理器覆盖启停清单。若出现「星河背景 + 白侧栏」或旧皮肤 !important 盖住主题色，检查是否仍启用了第二套皮肤。

README 写明：本皮肤在 DSH Web（0.2.2-alpha.2） 上验证通过；官方 Desktop 尚未实测，无效时请停用 dsh-skin-galaxy 并反馈。

典型用法：调整动效与亮度¶

在 profile 的 cordis.patch.yml 中覆盖插件配置（config 替换整行）：

- id: galaxy-skin
  config:
    speed: 0.65
    intensity: 0.8
    pixelRatio: 1.25
    fps: 30
    meteorInterval: 10

新安装默认 speed 为 0.65；profile 里已有显式 speed 仍优先。修改后重启服务并刷新；非法值会明确报错。

确认生效：插件页中 dsh-skin-galaxy 为启用状态，页面出现星河背景，开发者工具无 WebGPU 脚本错误；真实 dsh 页面可看到 data-galaxy-renderer="webgpu"。

适用场景与注意¶

适合谁：在 DSH Web 上希望深空动效、又需要可读 Markdown 界面的开发者；环境需浏览器提供 WebGPU（本机 localhost 或 HTTPS 优先，参见 WebGPU 运行条件）。

权限与信任：插件随当前 dsh 进程在浏览器中运行，会注入客户端主题与 GPU 绘制逻辑。安装前应阅读仓库源码与 MIT 许可证；README 说明插件不修改聊天记录、不自动发起模型请求。

兼容性：开发与验证环境为 dsh 源码 0.2.2-alpha.2、Node 24.22.1、macOS；自动测试 11/11 通过。package.json 未声明 engines.dsh，其他 dsh 版本需自行验证。

维护者提供本地预览：在仓库内执行 node build.mjs、node preview/server.mjs，访问 http://127.0.0.1:4318 查看独立演示（着色器与产物与插件一致）。

结尾¶

dsh-skin-galaxy 把 procedurally 星云、银河尘带和随机流星放在 WebGPU 一层，用主题 token 与阅读底板对接 DSH 界面，适合作为 Web profile 下的单一普通皮肤使用。目录与说明见 SkillHub 插件页，源码与安装细节见 GitHub 仓库。