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

The skin treats each original pipe-separated bottom-bar segment as a complete information block, so combined items such as 首 token 平均 ... · ... tok/s and 输入 ... · 输出 ... remain intact. It also filters nearby message-level timing text and settings/menu text so the panel stays focused on global session telemetry.

Installation

Prerequisites

• Install DSH first and make sure the dsh command is available in your terminal.
• Use the same user account and DSH home/profile environment as the Web instance you want to customize. These examples target the web profile.
• If dsh is not recognized, fix your DSH installation/PATH or use your existing DSH launcher. For a source checkout, run pnpm dsh ... from the DSH repository root instead of dsh ....

From npm (recommended)

Install or update to the latest published skin through DSH's plugin manager:

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

This installs the npm package into the Web profile and registers its bundle configuration. Running npm install dsh-skin-galactic-opera in an arbitrary directory does not enable the skin in DSH. The generic npm i ... command on npm's website is not the complete installation procedure for this plugin.

Then follow the restart steps below. Updating an existing installation uses the same command and restart procedure.

npm package page

From GitHub

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

From a local checkout

From the parent directory of this package:

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

Or with an absolute path:

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

Restart and verify (all installation methods)

1. Wait for the plugin installation command to finish successfully. Restarting the Web service can interrupt ongoing work, so choose an appropriate time.
2. Restart the existing DSH Web instance:

   • Terminal launch: stop the original Web process with Ctrl + C, then run your original startup command again. For the default Web profile:

     dsh web
     

   • Service or scheduled-task launch: restart the existing service/task using your deployment's management tool or restart script. Keep its original account, DSH home, profile, port, and startup arguments. Do not also launch a second dsh web process.

   • Source checkout: use your original source launcher; for the default Web profile, run pnpm dsh web from the DSH repository root.

3. Open the same Web URL as before (usually http://127.0.0.1:3080; use your configured address if different) and hard-refresh with Ctrl + F5 on Windows/Linux or Cmd + Shift + R on macOS.
4. Confirm the dark space background, top-right planet, and bottom-left scanner appear. The telemetry HUD only appears when recognizable native status data is available.

If the skin is missing, check that installation succeeded, the plugin was installed into the same DSH home/profile as the running Web instance, and the original server was actually restarted. Refreshing a browser tab alone does not restart DSH or guarantee a newly installed client bundle is loaded.

Uninstall

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

After uninstalling, restart the same DSH Web instance and hard-refresh the browser using the procedure above.

Development

Check browser-side JavaScript syntax:

npm run check

Preview the npm package contents before publishing:

npm run pack:dry

Publish to npm:

npm publish

Package structure

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

• package.json: package metadata, npm publish settings, DSH bundle declaration, and Web client plugin declaration.
• cordis.patch.yml: inserts the dsh-skin-galactic-opera client plugin into the Web profile.
• lib/index.js: host-side no-op entry.
• lib/client.js: browser-side theme, decoration, and interaction implementation.

License

MIT

Back to top ↑

---

简体中文

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

返回顶部 ↑