前言¶
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、十字準星光標。
交互反饋系統¶
頁面像遊戲界面一樣回應操作:
- 按鈕 / 鏈接 hover 時青紫雙重光暈;
- 按下時琥珀色命中確認;
- 鍵盤聚焦時品紅瞄準框;
- 輸入框聚焦時顯示
INPUT // DECODE 01,並帶 RGB 分離與短暫亂碼。
自定義光標¶
十字準星光標(32×32)應用於可交互元素,文本輸入處恢復文本光標。
可讀性與設置面板兼容¶
對話正文使用系統字體,輸入框爲靜態網格加底部掃描線,無干擾動畫。打開設置面板時,皮膚會臨時提升側邊欄層級並解除裁剪,不使用 backdrop-filter,fixed 面板保持全視口。
工作原理¶
插件由三部分組成:
cordis.patch.yml插入一行 host 插件skin-digital-arcade;index.js在 apply 時註冊/skin-assets/*前綴路由,服務包內字體與精靈圖(含路徑穿越防護),並 tap index 渲染,把skin.css內聯進<head>(帶data-plugin標記);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 換一套完整視覺風格、且接受像素街機審美的用戶。經過上面的步驟,安裝並重啓後即可生效;不喜歡隨時卸載還原。
兩點注意:
- 插件以當前 dsh 進程權限運行,安裝前建議先檢查源碼與許可證。本倉庫代碼、素材包裝與文檔爲 MIT;像素字體 Fusion Pixel(© TakWolf)爲 OFL-1.1。
- 版本更新記錄: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 / 幻方無官方從屬關係,頁面信息以實際爲準)