前言¶
DeepSeek Harness(DSH)桌面版在 Windows 上默認是不透明窗口疊多層頁面底色,長時間開着像一塊實心面板,和桌面壁紙割裂。社區裏常見做法是隻改 CSS 主題色,窗口側仍由 Electron 主進程決定,很難真正「透」出壁紙。
下面介紹維護者 JianHeShui 的 dsh-desktop-glass(GitHub:JianHeShui/dsh-desktop-glass,社區目錄:skillhub 插件頁)。它在 DSH 插件體系裏歸類爲「趣味換裝」,當前倉庫約 3 stars。目標很明確:頁面半透明、去掉分隔線,並在 Windows 上配合系統 Mica / Acrylic,讓主窗口能透出桌面壁紙。
這是什麼¶
dsh-desktop-glass 是 DSH 桌面版的毛玻璃主題包,版本 1.0.0,許可證 MIT。
DSH 插件只能向頁面注入 CSS;窗口材質(BrowserWindow 的 backgroundMaterial、透明 backgroundColor)寫在宿主 app.asar 的 main.js 裏。因此本倉庫拆成兩半,需一起安裝纔有完整效果:
- 插件(倉庫根目錄):半透明底色、三列漸變、切換動畫、去掉分隔線。
- 補丁器(
windows-acrylic/):給主窗口補回材質與透明背景。
只裝插件時頁面會半透明,窗口仍不透明;只打補丁時窗口可透,頁面仍有純色覆蓋。二者缺一不可。
平臺:僅適用於 Windows,使用系統自帶的 Mica / Acrylic。使用前請將 DSH 設爲淺色模式,README 說明這樣效果最佳。
核心功能¶
頁面側(插件)¶
插件針對 Windows 佈局裏多層不透明背景疊加的問題:把 .frame 設爲完全透明,側欄與頁面底色改爲半透明 rgba,三列各鋪漸變以保留層次。類名用 [class*="_centerCol"] 等後綴匹配,前端重建換哈希名時仍可用。運行時僅在頁面插入一個 <style> 標籤。
窗口側(補丁)¶
補丁腳本在 main.js 中插入 backgroundMaterial 與透明 backgroundColor,並通過等量刪註釋保持 main.js 長度不變,只更新該條目哈希,避免重寫整個 asar 的 offset 鏈。
可調項¶
透明度可在 lib/client.js 裏改多組 rgba 的 alpha(越大越不透明)。README 給出了頁面底色、側欄、三列漸變起點/終點等行號與默認值。第 35–37 行的 bg-layer-1/2/3 控制浮在內容上的卡片表面;調得過透時設置界面會難以辨認。藍色深淺可改三個漸變起點的 RGB,同色系參考 #F0F9FF → #38BDF8。
補丁可選 -Material mica 切換材質(Acrylic 失焦時 Windows 會降級爲更實,屬系統行爲)。
安裝與啓用¶
環境要求 Node.js 18+。打補丁時用 node --check 校驗語法;PATH 裏沒有 node 時腳本會嘗試 DSH 自帶運行時。
在已下載的插件倉庫目錄中操作(資料未提供 dsh plugin add 一類命令,請勿憑插件名自行拼接)。
1、安裝插件:
node scripts/install-plugin.mjs
腳本會把倉庫拷到 <DSH_HOME>\profiles\desktop\node_modules\dsh-desktop-glass,並在 profile 的 package.json 裏補上 bundle 條目與依賴。完成後重啓 DSH。
2、打窗口材質補丁(Windows):
powershell -ExecutionPolicy Bypass -File .\windows-acrylic\apply-acrylic.ps1
腳本會等待 DSH 退出(可從托盤右鍵退出);隨後打補丁並重啓 DSH。常用參數:-Material mica、-AppRoot(手動指定安裝目錄)、-DryRun(只檢測生成,不改文件)。
若窗口仍不透明,請到 設置 → 個性化 → 顏色 打開透明效果。
改完 lib/client.js 後需再跑一遍安裝腳本並重啓;安裝時若用了 --link,改完直接重啓即可。
典型用法與卸載¶
卸載按相反順序:
node scripts/uninstall-plugin.mjs
powershell -ExecutionPolicy Bypass -File .\windows-acrylic\restore-asar.ps1
插件側卸載後不再殘留樣式注入。
目錄結構(便於自查):
package.json 插件清單
cordis.patch.yml bundle patch
lib/client.js 瀏覽器端 CSS
lib/index.js 宿主端(空)
windows-acrylic/ 窗口補丁
scripts/ 安裝、卸載
適用場景與注意¶
適合誰:在 Windows 上使用 DSH 桌面版、希望窗口與聊天界面與壁紙融在一起、並能接受改宿主 app.asar 的維護者。
權限與信任:插件與補丁腳本以你當前用戶權限運行;補丁會修改已安裝的 DSH 程序文件。安裝前應閱讀倉庫源碼與 MIT 許可證,自行評估風險。README 明確說明改 app.asar 屬對宿主動手,插件僅作分享。
已知限制(來自 README):
- DSH 更新會覆蓋
app.asar,補丁失效後需重跑apply-acrylic.ps1。 - 若 DSH 更改主窗口結構,補丁腳本會報錯退出且不會改動已安裝文件。
- 若某構建開啓 Electron embedded asar integrity validation,打補丁後可能無法啓動,可用
restore-asar.ps1還原;資料稱目前 DSH 未開放該選項。
DSH 生態強調「一切皆插件」;skillhub.cn 爲社區目錄,與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-desktop-glass 把「頁面 CSS 主題」和「Windows 窗口材質」拆成插件 + 補丁兩條線,在 DSH 只能注入樣式的約束下儘量做到壁紙一覽無餘。需要完整效果時記得兩樣都裝,並保持淺色模式與系統透明效果開啓。