dsh-skin-digital-arcade:給 DSH Web GUI 換一套數碼電玩風 HUD 皮膚

前言

DSH 的理念是「一切皆插件」,Web GUI 的外觀同樣可以交給插件處理。默認主題看久了想換風格,常見做法是直接改頁面樣式:要麼動 Harness 源碼,升級時被覆蓋;要麼散落一堆用戶樣式,難以維護。dsh-skin-digital-arcade 把整套皮膚做成獨立分發的 bundle,安裝時注入、卸載時還原,不碰源碼。下面介紹它的功能、原理和安裝步驟。

這是什麼

dsh-skin-digital-arcade(Rizen Signal Console)是 DeepSeek Harness Web GUI 的數碼電玩風 HUD 皮膚,由 RizenHNT 維護,當前版本 v0.1.1,倉庫代碼以 MIT 許可分發。

它不是隻換一套顏色,而是把配色、像素字體、動畫 HUD 和交互反饋做成一個整體;同時把可讀性放在第一位——編輯器文字始終保持在官方渲染路徑上。

核心特性

霓虹配色

皮膚使用青 #6fffe0、紫羅蘭 #d28cff、品紅 #ff62bd、琥珀 #ffc36b 四種顏色的賽博 HUD 語言,替代默認藍金配色。

像素字體

按鈕、標題、標籤使用 Fusion Pixel 12px 字體(OFL-1.1,latin + 簡體中文子集,覆蓋全 CJK 常用字),英文數字與中文統一在 12px 像素網格上,混排協調。

動畫 HUD 與像素資產

動畫部分包括:背景網格漂移、hero 光暈脈動、側邊欄雷達/粒子、選中項狀態信標、輸入卡掃描線、發送能量幀動畫、氣泡懸停 chroma 掃描、底部 HUD 狀態條。

像素資產全部爲程序化生成並經 WebP 壓縮:arcade 城市背景、數據核心/碎片精靈、信號吉祥物 sprite sheet、能量 FX atlas、十字準星光標。

交互反饋系統

頁面像遊戲界面一樣回應操作:

  1. 按鈕 / 鏈接 hover 時青紫雙重光暈;
  2. 按下時琥珀色命中確認;
  3. 鍵盤聚焦時品紅瞄準框;
  4. 輸入框聚焦時顯示 INPUT // DECODE 01,並帶 RGB 分離與短暫亂碼。

自定義光標

十字準星光標(32×32)應用於可交互元素,文本輸入處恢復文本光標。

可讀性與設置面板兼容

對話正文使用系統字體,輸入框爲靜態網格加底部掃描線,無干擾動畫。打開設置面板時,皮膚會臨時提升側邊欄層級並解除裁剪,不使用 backdrop-filter,fixed 面板保持全視口。

工作原理

插件由三部分組成:

  1. cordis.patch.yml 插入一行 host 插件 skin-digital-arcade
  2. index.js 在 apply 時註冊 /skin-assets/* 前綴路由,服務包內字體與精靈圖(含路徑穿越防護),並 tap index 渲染,把 skin.css 內聯進 <head>(帶 data-plugin 標記);
  3. skin.css 是純聲明層:覆蓋 --dsw-* 令牌與穩定 DOM 屬性,不觸碰編輯器佈局屬性。

插件本體是 JavaScript + CSS + 靜態資源,無需單獨編譯。

安裝與啓用

先安裝插件,支持從 GitHub 或本地目錄兩種方式:

# 從 GitHub 安裝
dsh plugin --profile web add https://github.com/RizenHNT/dsh-skin-digital-arcade

# 或從本地目錄安裝
dsh plugin --profile web add /path/to/dsh-skin-digital-arcade

若使用 Harness 源碼版 CLI(pnpm dsh ...),需先按官方文檔構建 Harness;安裝版 CLI(dsh)不需要。

安裝或更新後建議重啓當前 dsh web 進程,確保新的 bundle、資源路由和 index 注入全部加載:

dsh --profile web

卸載與開發自檢

卸載只需一條命令,頁面恢復默認主題:

dsh plugin --profile web remove dsh-skin-digital-arcade

開發者可以運行插件自檢,模擬 webServer 驗證資源路由、路徑防護與 CSS 注入:

node test-plugin.mjs

如需重新生成 skin.css(可選,從 Harness 倉庫的 personal.css 轉換資源路徑):

python tools/gen-skin-css.py

該腳本需要 Harness 源碼樹中的 personal.css 作爲輸入;直接使用倉庫現成的 skin.css 無需運行它。

適用場景與注意

適合想給 DSH Web GUI 換一套完整視覺風格、且接受像素街機審美的用戶。經過上面的步驟,安裝並重啓後即可生效;不喜歡隨時卸載還原。

兩點注意:

  1. 插件以當前 dsh 進程權限運行,安裝前建議先檢查源碼與許可證。本倉庫代碼、素材包裝與文檔爲 MIT;像素字體 Fusion Pixel(© TakWolf)爲 OFL-1.1。
  2. 版本更新記錄:v0.1.0 爲初始發佈(霓虹 HUD 主題、像素字體、動畫精靈、交互反饋、自定義光標);v0.1.1 增加了側邊欄會話樹像素化、全 CJK 像素字體,並更新了預覽圖。

結尾

dsh-skin-digital-arcade 把換裝做成可安裝、可卸載、不碰源碼的獨立 bundle,想給 DSH Web GUI 換個樣子時可以一試。

  • GitHub:https://github.com/RizenHNT/dsh-skin-digital-arcade
  • 社區目錄頁:https://www.skillhub.cn/plugins/RizenHNT/dsh-skin-digital-arcade (社區獨立站點,與 DeepSeek / 幻方無官方從屬關係,頁面信息以實際爲準)
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜