前言¶
DSH 的理念是「一切皆插件」,Web GUI 的對話區同樣可以換皮。做智能體開發時,對話區是待得最久的地方,默認樣式看久了容易疲勞:圓角、漸變、軟陰影都是”通用感”的來源。dsh-pixel-crt 是社區作者 kingdawangXTA 維護的一個 DSH 插件,屬於「趣味換裝」分類,做的事很單一——把 Web GUI 的對話區和輸入區整體改成深色 CRT 像素風:硬 2px 邊框、塊狀投影、位圖風格標題、掃描線。側欄、標題欄和其它面板保持默認,不動佈局、不動字號。
下面介紹這個插件能做什麼、怎麼裝、有哪些已知的限制。
這是什麼¶
一句話定位:一個純前端的 DSH Web GUI 皮膚 bundle,只作用於對話區的聊天區([data-conversation-region="chat"])和輸入區([data-conversation-region="composer"])。
維護者:kingdawangXTA。分類:趣味換裝。倉庫地址見文末。許可證:MIT。
它不引入任何後端路由、配置或狀態,也不向磁盤寫文件,卸載方式是直接禁用或移除該 bundle。
核心功能¶
- 在聊天區和輸入區內重定義配色:接近純黑的底色、青色強調色、圓角歸零。凡是讀取
--dsw-alias-*變量的組件會自動跟隨這套 token。 - 補上像素風的”傢俱”:2px 邊框、
3px 3px 0的塊狀投影、按下時的位移、平坦的代碼塊、方形滾動條、青色光標、像素選區。 - 標題和按鈕切到位圖字體(
Unifont/Zpix/WenQuanYi Zen Hei Sharp,按系統裏裝了哪個來)。正文保持原來的 14px 和系統字體——位圖字體在小字號下會糊成一團,所以不動正文。 - 用一層重複漸變做輕微的掃描線效果。
它明確不做什麼¶
這部分和功能同樣重要,README 裏專門列了一節:
- 不碰側欄和對話區之外的任何面板,標題欄保持默認。
- 不改消息佈局、間距和字號。什麼都不動,只換皮。
- 是純前端 bundle:沒有宿主路由、沒有配置項、沒有持久化狀態。
安裝與啓用¶
安裝命令直接來自 README,不要憑倉庫名去拼 dsh plugin add github:owner/repo。
一種是讓插件管理器從倉庫安裝,把倉庫地址傳給命令:
dsh plugin add <this-repo-url>
另一種是已經 clone 過代碼時,讓插件管理器指向本地 checkout:
dsh plugin install ./pixel-crt
裝完需要重新加載 Web GUI 纔會生效。卸載時禁用或移除 dsh-pixel-crt 這個 bundle 即可。
典型的「對比度修正」¶
深色皮膚最容易遇到的坑,是有些組件把背景色寫死在自己的局部變量裏(比如 --deliverable-fill),或者用 color-mix(#fff 50%, transparent) 現算顏色,沒有走 --dsw-alias-* 這些別名 token。結果就是深色底上會留下一些淺色卡片,配着淺色文字,典型的場景是文件名直接讀不出來。
這個 bundle 的處理辦法是:每次渲染之後跑一個”對比度清掃”,邏輯很簡單——如果一個元素落在淺色背景上,並且它的文字也是淺色的,就把這個背景壓暗。深色表面和”淺底深字”的卡片一律不動。清掃是防抖的,避免每次渲染都重複掃描。
已知的粗糙之處¶
README 裏給了三條,安裝前值得先評估:
- 只帶圖標的窄按鈕在 2px 邊框下會顯得粗笨。
- 所有標題統一塌到 16px。位圖字體只在 12/16px 這樣的網格上才清晰,所以做不了字號層級。
- 掃描線只是一條 CSS 規則,不想要就刪掉對應的
background-image行。
第 3 條順便說明整個皮膚的實際實現思路:核心是對 data-conversation-region 作用域做 CSS 改寫,所以調整成本很低。
適用場景與注意事項¶
適合誰:想在 Web GUI 裏要一套統一深色、像素風、只換皮不改結構的人;以及想更清楚地看到對比度清掃實際效果的人。像素字體只在特定字號下成立,追求排版層級的不適合。
需要注意兩點:
- 插件運行在當前 dsh 進程的權限內,安裝前應檢查源碼與許可證。本插件的許可證是 MIT,源碼規模不大,可以直接讀。
- 安裝命令裏的
<this-repo-url>需要替換成實際的倉庫地址,README 只是以佔位符形式給出的。
結尾¶
dsh-pixel-crt 的價值在於範圍小而明確:只改對話區和輸入區的觀感,不動佈局、不動數據、不寫磁盤。想換皮的人可以在低風險下試一套 CRT 風格的皮膚,不滿意就移除 bundle。需要說明的是,它所在的社區目錄是獨立站點,與 DeepSeek / 幻方沒有官方從屬關係,不是官方應用商店。
- 目錄頁:https://www.skillhub.cn/plugins/kingdawangXTA/dsh-pixel-crt
- GitHub:https://github.com/kingdawangXTA/dsh-pixel-crt