dsh-desktop-glass:爲 DSH 桌面版加上毛玻璃與壁紙透出

前言

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 只能注入樣式的約束下儘量做到壁紙一覽無餘。需要完整效果時記得兩樣都裝,並保持淺色模式與系統透明效果開啓。

羽毛球分组比赛记分
小程序二维码

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

小夜