前言¶
DSH 生态强调“一切皆插件”,Web GUI 的外观扩展也可以由插件完成。dsh-pixel-ui 是 zhang66633 维护的一个 DSH 皮肤插件,用于把 dsh Web GUI 重皮肤成像素 RPG 风。它提供四个主题,并保留一键切回现代默认 UI 的出口,适合希望在保持默认 UI 可用的前提下快速切换外观的用户。
核心功能¶
定位¶
dsh-pixel-ui 是一个外观类插件,不新增 DSH 核心能力,主要将现有 dsh Web GUI 换装成像素 RPG 风格。
主题¶
插件提供四个主题 id:
pixel-wood:像素·木屋pixel-paper:像素·羊皮纸pixel-warm:像素·暖阳pixel-retro:像素·终端绿
用户也可以点「现代默认」整体退出皮肤。
字体与样式¶
插件使用 fusion-pixel 与 Press Start 2P 像素字体,并包含以下样式:
- 阶梯硬阴影
- 8-bit 凸起按钮
- 木纹条纹
- CRT 扫描线
- 暗角
- 像素光标
切换与记忆¶
设置页会新增「像素主题」行,可切换主题。最后的选择保存在浏览器 localStorage 的 dsh-pixel-ui:theme。
默认主题为 pixel-wood,仅在首次安装时自动激活;之后尊重已有选择。
安装与启用¶
在 dsh 终端中执行:
dsh plugin add dsh-pixel-ui
安装后重启 dsh 或 DSH Desktop。
DSH Desktop 用户可以在托盘右键中选择 Open DSH Terminal,在终端中执行:
dsh plugin add dsh-pixel-ui
DSH Desktop 如需记住主题选择,可在设置中为 dsh-desktop.port 指定固定端口。
典型用法¶
1、安装后重启 dsh 或 DSH Desktop。
2、首次加载会自动激活默认主题 pixel-wood。
3、进入「设置 → 通用 → 像素主题」,选择四个皮肤之一。
4、点「现代默认」可整体退出皮肤,选择会被记住。
兼容与权限¶
- 兼容 dsh 生态
0.1.0-rc.6~0.1.0-rc.7。 - 兼容 DSH Desktop
2.0.x。 - 浏览器支持现代
Chromium/Firefox。 - 插件无配置项,无环境变量、无敏感项。
- 宿主进程只读本包内字体文件,仅注册
/dsh-pixel-ui/fonts/*路由。 - 浏览器侧无网络请求、无遥测、不读凭据,只在
localStorage存一个主题 id。 - 插件许可证为 MIT;字体许可证包括
fusion-pixel(MIT)与Press Start 2P(SIL OFL)。
注意事项¶
DSH 插件以当前 dsh 进程权限运行,安装前建议先检查源码与许可证。
仓库地址:
https://github.com/zhang66633/dsh-pixel-ui