前言¶
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
