xmnathan/dsh-skin-galactic-opera

dsh-skin-galactic-opera

DSH Web GUI 非官方 太空歌剧风 暗色 动态 皮肤插件

English · 简体中文

English

Unofficial cinematic space-opera dark skin bundle for the DSH Web GUI.

It uses generic sci-fi visual language: deep-space backgrounds, neon HUD chrome, a central black-hole accretion disk, a planet with orbital elements, scanner UI, comet trails, energy beams, subtle starfighter silhouettes, telemetry chrome, and a hyperspace-style send effect.

This package is not affiliated with, endorsed by, or derived from any specific franchise. It does not include or recreate official logos, characters, ship designs, quotes, proprietary names, or protected visual designs.

Features

- Registers and enables the galactic-opera dark theme.
- Overrides DSH Web GUI theme tokens for backgrounds, borders, text, brand colors, state colors, scrollbars, and sidebar surfaces.
- Adds global space-opera styling:
- deep-space background layers;
- diagonal hyperspace lanes;
- hover glow for buttons, inputs, messages, and code blocks;
- sci-fi text selection and code block glow.
- Adds decorative visual elements:
- central black-hole accretion disk with subtle infall particles;
- top-right planet, moon, and elliptical satellite orbit;
- bottom-left rotating scanner HUD and holographic route map;
- red, cyan, and gold energy beams;
- sparse twinkling stars, comets, and generic V-shaped starfighter silhouettes;
- gold mission-briefing crawl panel.
- Adds interactions:
- subtle pointer parallax;
- click energy pulse;
- scanner target ping projected from the clicked position;
- automatic hyperspace burst after submitting a new instruction or message;
- fixed bottom-right telemetry/status HUD panel.
- Uses Shadow DOM for the decorative layer to reduce interference from host application styles.
- Respects prefers-reduced-motion: reduce by disabling major animations.

Compatibility

Recommended DSH version: 0.1.0-rc.7 or newer.

Known incompatible versions:

- 0.0.1-rc.1
- 0.0.1-rc.2

These early versions of @deepseek-ai/dsh-client-ui-theme do not expose theme.overrideTokens(), which this skin uses for its token override layer.

Versions from 0.0.1-rc.3 onward include the required theme APIs in static inspection, but DSH releases before 0.1.0-rc.7 are not actively tested by this package. If you are using an older DSH release, upgrade DSH first before reporting skin issues.

Telemetry panel

When DSH Web exposes bottom status/usage data, the skin keeps the original UI layout in place and mirrors the detected global telemetry into a non-interactive bottom-right HUD panel.

The panel is intended to show a consistent five-line status block:

312 轮 · 8732 步
LLM 2253m42s · 工具调用 972m8s
首 token 平均 10.5s · 58 tok/s
缓存命中 97%
输入 1369M tok · 输出 2.5M tok
该皮肤将每个原始的以管道符分隔的底栏片段视为一个完整的信息块，因此诸如 首 token 平均 ... · ... tok/s 和 输入 ... · 输出 ... 这样的组合项会保持完整。它还会过滤附近的消息级计时文本以及设置/菜单文本，从而使面板专注于全局会话遥测数据。

安装

前提条件

- 先安装 DSH，并确保终端中可以使用 dsh 命令。
- 使用与你想要自定义的 Web 实例相同的用户账户和 DSH home/profile 环境。以下示例针对 web profile。
- 如果 dsh 无法被识别，请修复你的 DSH 安装/PATH，或使用你现有的 DSH 启动器。对于源码检出，请在 DSH 仓库根目录下运行 pnpm dsh ...，而不是 dsh ...。

从 npm 安装（推荐）

通过 DSH 的插件管理器安装或更新到最新发布的皮肤：

dsh plugin --profile web add dsh-skin-galactic-opera@latest

这会将 npm 包安装到 Web profile 中，并注册其 bundle 配置。在任意目录中运行 npm install dsh-skin-galactic-opera 并不会在 DSH 中启用该皮肤。 npm 网站上的通用 npm i ... 命令并不是此插件的完整安装流程。

然后按照下面的重启步骤操作。更新现有安装使用相同的命令和重启流程。

npm 包页面

从 GitHub 安装

dsh plugin --profile web add https://github.com/xmnathan/dsh-skin-galactic-opera.git

从本地检出安装

在此包的父目录中：

dsh plugin --profile web add ./dsh-skin-galactic-opera

或使用绝对路径：

dsh plugin --profile web add D:\path\to\dsh-skin-galactic-opera

重启并验证（所有安装方法）

1. 等待插件安装命令成功完成。重启 Web 服务可能会中断正在进行的工作，因此请选择合适的时间。
2. 重启现有的 DSH Web 实例：
- 终端启动： 使用 Ctrl + C 停止原来的 Web 进程，然后再次运行你原来的启动命令。对于默认的 Web profile：

dsh web

- 服务或计划任务启动： 使用你部署的管理工具或重启脚本重启现有的服务/任务。保持其原有的账户、DSH home、profile、端口和启动参数不变。不要同时再启动第二个 dsh web 进程。
- 源码检出： 使用你原来的源码启动器；对于默认的 Web profile，请在 DSH 仓库根目录下运行 pnpm dsh web。
3. 打开与之前相同的 Web URL（通常是 http://127.0.0.1:3080；如果配置了不同的地址，请使用你配置的地址），并在 Windows/Linux 上使用 Ctrl + F5、在 macOS 上使用 Cmd + Shift + R 进行强制刷新。
4. 确认深空背景、右上角行星和左下角扫描器出现。遥测 HUD 仅在可识别的原生状态数据可用时才会出现。

如果皮肤缺失，请检查安装是否成功、插件是否安装到与正在运行的 Web 实例相同的 DSH home/profile，以及原始服务器是否确实已重启。仅刷新浏览器标签页不会重启 DSH，也不保证新安装的客户端 bundle 被加载。

卸载

dsh plugin --profile web remove dsh-skin-galactic-opera

卸载后，重启同一个 DSH Web 实例，并使用上述步骤对浏览器进行强制刷新。

开发

检查浏览器端 JavaScript 语法：

npm run check

发布前预览 npm 包内容：

npm run pack:dry

发布到 npm：

npm publish

包结构

dsh-skin-galactic-opera/
├─ package.json
├─ cordis.patch.yml
├─ README.md
├─ LICENSE
├─ CHANGELOG.md
└─ lib/
├─ index.js
└─ client.js

- package.json：包元数据、npm 发布设置、DSH bundle 声明和 Web 客户端插件声明。
- cordis.patch.yml：将 dsh-skin-galactic-opera 客户端插件插入 Web profile。
- lib/index.js：宿主端空操作入口。
- lib/client.js：浏览器端主题、装饰和交互实现。

许可证

MIT

返回顶部 ↑

简体中文

DSH Web GUI 的非官方电影感太空歌剧暗色皮肤插件。

它使用通用科幻视觉语言：深空背景、霓虹 HUD、中央黑洞吸积盘、行星与轨道元素、扫描器界面、彗星轨迹、能量束、克制的战机剪影、遥测信息面板，以及发送消息时的超空间风格特效。

本插件不隶属于、不受认可于、也不派生自任何特定影视或游戏系列。它不包含也不复刻任何官方 logo、角色、飞船设计、台词、专有名称或受保护视觉设计。

功能特性

- 注册并启用 galactic-opera 暗色主题。
- 覆盖 DSH Web GUI 的主题 token，包括背景、边框、文本、品牌色、状态色、滚动条和侧边栏表面。
- 添加全局太空歌剧风格：
- 深空背景层；
- 斜向超空间航道；
- 按钮、输入框、消息和代码块的悬停辉光；
- 科幻风格文本选中与代码块辉光。
- 添加装饰性视觉元素：
- 带轻微吸入粒子的中央黑洞吸积盘；
- 右上角行星、卫星和椭圆卫星轨道；
- 左下角旋转扫描盘 HUD 和全息路线图；
- 红、青、金三色能量束；
- 稀疏闪烁星点、彗星和通用 V 形战机剪影；
- 金色任务简报滚动面板。
- 添加交互效果：
- 轻微鼠标视差；
- 点击能量脉冲；
- 根据点击位置投影到扫描盘的目标 ping；
- 提交新指令或消息后的自动超空间爆发；
- 固定在右下角的 telemetry / 状态 HUD 面板。
- 装饰层使用 Shadow DOM，减少宿主应用样式对行星、扫描盘、点击脉冲等几何形态的污染。
- 遵循 prefers-reduced-motion: reduce，会关闭主要动画。

兼容性

推荐 DSH 版本：0.1.0-rc.7 或更新版本。

已知不兼容版本：

- 0.0.1-rc.1
- 0.0.1-rc.2

这些早期版本的 @deepseek-ai/dsh-client-ui-theme 不提供 theme.overrideTokens()，而本皮肤需要它来应用主题 token 覆盖层。

从 0.0.1-rc.3 开始，静态检查显示已具备本插件需要的 theme API；但 0.1.0-rc.7 之前的 DSH 版本本包不会主动测试。如果你正在使用更早的 DSH 版本，建议先升级 DSH，再反馈皮肤兼容问题。

Telemetry 面板

当 DSH Web 暴露底部状态/用量信息时，皮肤会保留原始 UI 布局，并将检测到的全局 telemetry 镜像到右下角的非交互 HUD 面板中。

面板目标是稳定显示五行状态信息：

312 轮 · 8732 步
LLM 2253m42s · 工具调用 972m8s
首 token 平均 10.5s · 58 tok/s
缓存命中 97%
输入 1369M tok · 输出 2.5M tok

皮肤会把原始底栏中用竖线分隔的每一段都视为完整信息块，因此 首 token 平均 ... · ... tok/s、输入 ... · 输出 ... 这类组合信息不会被拆散。同时也会过滤附近的单条消息耗时、设置菜单文本等内容，让面板聚焦于全局会话 telemetry。

安装

安装前提

- 先安装 DSH，并确认终端能使用 dsh 命令。
- 使用与目标 Web 实例相同的用户账户及 DSH home/profile 环境执行安装。以下示例针对 web profile。
- 如果提示找不到 dsh，请检查 DSH 安装和 PATH，或使用已有的 DSH 启动器。源码部署可在 DSH 仓库根目录使用 pnpm dsh ... 代替 dsh ...。

通过 npm 安装（推荐）

通过 DSH 插件管理器安装或更新到最新发布版本：

dsh plugin --profile web add dsh-skin-galactic-opera@latest

该命令会将 npm 包安装到 Web profile，并注册其 bundle 配置。在任意目录单独执行 npm install dsh-skin-galactic-opera，不会自动在 DSH 中启用皮肤。 npm 网站展示的通用 npm i ... 命令不是本插件的完整安装流程。

安装后请继续执行下方重启步骤。更新已安装的皮肤也使用同一条命令和重启流程。

npm 包页面

通过 GitHub 安装

dsh plugin --profile web add https://github.com/xmnathan/dsh-skin-galactic-opera.git

通过本地源码安装

在本包的上级目录执行：

dsh plugin --profile web add ./dsh-skin-galactic-opera

也可以使用绝对路径：

dsh plugin --profile web add D:\path\to\dsh-skin-galactic-opera

重启与验证（适用于所有安装方式）

1. 等待插件安装命令成功完成。重启 Web 服务可能中断正在进行的工作，请选择合适时机操作。
2. 重启原来正在使用的 DSH Web 实例：
- 终端启动：在原 Web 进程所在终端按 Ctrl + C 停止，然后重新执行原启动命令。默认 Web profile 可使用：

dsh web

- 服务或计划任务托管：通过部署时使用的管理工具或重启脚本，重启原服务/任务。保持原用户账户、DSH home、profile、端口及启动参数不变；不要另外再启动一个 dsh web 进程。
- 源码部署：沿用原源码启动器；默认 Web profile 可在 DSH 仓库根目录执行 pnpm dsh web。
3. 打开原来的 Web 地址（通常为 http://127.0.0.1:3080，自定义部署请使用实际地址），并硬刷新：Windows/Linux 使用 Ctrl + F5，macOS 使用 Cmd + Shift + R。
4. 确认深空暗色背景、右上角行星和左下角扫描盘出现。Telemetry HUD 仅在检测到可识别的原生状态数据时显示。

如果皮肤未出现，请检查安装命令是否成功、插件是否安装到了正在运行的 Web 实例所使用的同一个 DSH home/profile，以及是否确实重启了原服务进程。仅刷新浏览器标签页不会重启 DSH，也不能保证新安装的客户端 bundle 已加载。

卸载

dsh plugin --profile web remove dsh-skin-galactic-opera

卸载后按上方流程重启同一个 DSH Web 实例，并硬刷新浏览器。

开发

检查浏览器端 JavaScript 语法：

npm run check

发布前预览 npm 包内容：

npm run pack:dry

发布到 npm：

npm publish

包结构

dsh-skin-galactic-opera/
├─ package.json
├─ cordis.patch.yml
├─ README.md
├─ LICENSE
├─ CHANGELOG.md
└─ lib/
├─ index.js
└─ client.js

- package.json：包元数据、npm 发布设置、DSH bundle 声明和 Web client 插件声明。
- cordis.patch.yml：将 dsh-skin-galactic-opera client 插件插入 Web profile。
- lib/index.js：宿主侧空实现入口。
- lib/client.js：浏览器侧主题、装饰层和交互实现。

许可证

MIT

返回顶部 ↑