前言¶
DSH 的 Web UI 已經有 light、dark 和 system 三檔外觀。如果想在不替換內置主題的前提下,獲得更明顯的邊框、硬陰影和高對比風格,可以安裝 dsh-neo-skin。它是 DSH 插件生態中的一個 Web UI 客戶端皮膚插件,通過官方 theme 服務在內置淺色/深色配色上疊加 neo-brutalism token。
這是什麼¶
dsh-neo-skin 是零依賴客戶端皮膚插件,許可證爲 MIT,倉庫位於 0nt-one/dsh-neo-skin。
它不替換 DSH 內置主題,而是疊加 --dsw-alias-* 語義 token 覆寫。這樣 light、dark 和 system 外觀仍可工作,皮膚會同時作用在淺色和深色兩套配色上。
核心功能¶
- 內置
Blue Command與Aged Newspaper兩套方案,可在Settings → General → Neo 皮膚即時切換。 - 插件開關持久化在
localStorage,默認開啓;關閉後回到官方配色。 - 方案選擇持久化在
dsh-neo-skin.scheme,切換時會應用整套配色和結構覆寫。 - 結構層提供硬偏移陰影、關鍵面板直角化、
2px邊框、按鈕按下位移反饋。 - 適配
dsh-voice-input的彈層、按鈕和狀態色主題化。 - 兼容
light、dark和system主題。
安裝與啓用¶
下面給出資料中可復現的離線/開發安裝步驟。先準備本地倉庫目錄 <path\to\dsh-neo-skin>,然後構建 bundle。
npm run build
構建完成後,將插件安裝到 Web profile。
dsh plugin --profile web add <path\to\dsh-neo-skin>
接着在 .dsh/profiles/web/cordis.patch.yml 中註冊插件行。
- insert:
- id: dsh-neo-skin
name: 'dsh-neo-skin'
最後重啓 Web profile。
dsh --profile web
首次安裝需要 host 重啓以掛載插件;之後如果只是重新構建,瀏覽器硬刷新即可加載新的 bundle。
典型用法¶
安裝並重啓後,在 Settings → General → Neo 皮膚 中開啓或關閉插件,並在同一行選擇 Blue Command / Aged Newspaper。
如果新增或調整方案,在 src/schemes/ 下放置三個文件:
src/schemes/<name>.tokens.json
src/schemes/<name>.meta.json
src/schemes/<name>.css
然後重新構建。
npm run build
改完構建後在瀏覽器硬刷新即可,無需重啓 host。
適用場景與注意¶
適合希望在 DSH Web UI 中獲得更強烈邊框、陰影和高對比風格的用戶,尤其是需要在 light / dark / system 下保持同一套皮膚的人。
需要注意:
- 插件會以當前
dsh進程權限運行,安裝前應檢查源碼與許可證。 - 結構層通過
[class* "_xxx"]這類可讀後綴選擇器命中組件;DSH 大版本重構類名時可能需要微調。 - 開關和方案使用
localStorage持久化。資料說明,host apiproxy 僅對WEB_SETTINGS_NAMESPACES白名單開放settings.describe,第三方插件命名空間會得到settings-not-exposed。 - 當前資料未提供線上/目錄安裝命令,只給出離線/開發安裝命令。
獲取¶
GitHub 倉庫:
https://github.com/0nt-one/dsh-neo-skin
社區目錄頁:
https://www.skillhub.cn/plugins/0nt-one/dsh-neo-skin
該目錄頁屬於社區插件目錄,不應理解爲官方應用商店。