前言¶
DeepSeek Harness（DSH）Desktop 在 macOS 上會以原生 vibrancy 和透明窗口（vibrancy: "sidebar"、backgroundColor: "#00000000"）向系統要一層材質。Web GUI 卻把各面板塗成不透明，材質被蓋住，窗口看起來仍是普通實底。
下面介紹社區插件 dsh-frosted-glass（維護者 ViccRondo，目錄分類「趣味換裝」）：通過客戶端樣式把面板改成半透明着色，讓系統自帶的模糊露出來，而不是在 CSS 裏逐幀重算模糊。
這是什麼¶
dsh-frosted-glass 是面向 DeepSeek Harness Desktop 窗口的客戶端插件，一句話定位是：Native macOS frosted glass for the DeepSeek Harness Desktop window——讓 UI 面板顯示窗口真實的 vibrancy 材質，而不是再蓋一層不透明色。
實現方式不改動應用二進制，僅在瀏覽器側注入樣式；宿主側通過 cordis.patch.yml 增加 Loader 行。插件以當前 DSH 進程權限運行，安裝前宜自行查看 GitHub 倉庫 源碼與 MIT 許可證。
核心功能¶
啓用後大致會帶來這些變化（均以 README 描述爲準）：
- 整窗讀作一塊毛玻璃：模糊由 macOS 合成，不在 CSS 裏按幀二次模糊。
- 深度一致：對話頁、日程頁、插件頁等主表面共用同一層着色，避免每層各自疊不透明底。
- 頁面樣式表面：半透明後，原先比正文深一級的 sticky 頁眉條表現會隨設計變化。
系統行爲也會被尊重：降低透明度（Reduce transparency）與 macOS 全屏模式下，會退回實底表面，與原生應用一致。
不支持：瀏覽器裏打開的 Web GUI（沒有窗口材質可透出）；Windows Desktop 無視覺效果（選擇器限定 html[data-platform="darwin"]）。
環境與要求¶
| 項目 | 說明 |
|---|---|
| 宿主 | DSH Desktop，且運行在 macOS |
| DSH 版本 | dsh >= 0.2.0-rc.1（見 package.json 的 engines.dsh） |
| 不適用 | 瀏覽器標籤頁中的 Web GUI |
安裝與啓用¶
在 DSH 中打開 插件 → 添加插件，按 spec 安裝（命令須與官方 README 一致，勿自行拼接 github:owner/repo）：
- npm：
dsh-frosted-glass - 本地目錄：
file:/absolute/path/to/dsh-frosted-glass
安裝後在插件頁將 frosted-glass 開關打開。頁面會重新加載模塊，無需重啓應用。
關閉：在插件頁關閉該 bundle，或從插件列表移除。
調色與微調¶
可調參數寫在 lib/client.js 文件頂部的樣式裏。百分比表示不透明度，數值越低越透：
--dsh-frosted-glass-pane: color-mix(in srgb, #fdfdff 56%, transparent); /* light theme */
--dsh-frosted-glass-pane: color-mix(in srgb, #151517 44%, transparent); /* dark theme */
側欄單獨一層 alpha（macOS 側欄填充本身已帶約 50% 透明混合）：
--dsw-specific-sidebar-fill: color-mix(in srgb, #f9fafb 50%, transparent);
修改文件後，將插件關再開一次以重新加載。
工作原理（簡述）¶
包內同時提供 host 與 browser 兩半：dsh.bundle 指向 cordis.patch.yml，dsh.client 指向瀏覽器 bundle；模塊裝載時瀏覽器側追加一個 <style>。
樣式完全靠選擇器驅動：
- 統一改
--dsw-alias-bg-base，各面板即共用一層玻璃色； html[data-platform="darwin"]使非 macOS 平臺不生效；- 對話根、頁面根、Tab 宿主等會重複塗抹同一 token 的層被設爲透明，保證主表面只有一層 tint。
侷限與維護注意¶
- 僅 macOS Desktop；Windows 與瀏覽器無視覺變化。
- 選擇器依賴 CSS Module 的 local 名（如
pageBar、pageBody、TabHost等），一般能扛過重編譯 hash 變化，但若 DSH 做一次較大布局重構，選擇器仍可能失效。 - 系統「降低透明度」與全屏優先於插件效果，屬設計行爲。
當前 npm 包版本爲 0.1.0（見 package.json）。
目錄與源碼¶
- 社區目錄頁：skillhub.cn — ViccRondo/dsh-frosted-glass
- 源碼與中文說明：GitHub — ViccRondo/dsh-frosted-glass（含
README.zh.md）
DSH 生態強調「一切皆插件」；SkillHub 等目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係。若你長期在 macOS 上使用 DSH Desktop，又希望窗口材質與系統磨砂一致，可先按上文 spec 安裝 dsh-frosted-glass，再按需微調 lib/client.js 中的透明度變量。
