前言¶
DeepSeek Harness（DSH）在 macOS 上可以利用 NSVisualEffectView 做窗口級 Vibrancy，但上游界面 CSS 往往在會話區、側邊欄、氣泡和輸入框上疊了不透明底色，玻璃效果被擋住。換主題或改佈局能一定程度上緩解，成本卻更高，且容易和第三方側邊欄插件衝突。
下面介紹的 dsh-vibrancy-skin 只做材質層：把相關區域的實心底色換成同族半透明，讓窗口裏原有的毛玻璃透出來；不重建 UI、不改佈局尺寸與間距，也不動第三方插件文件。
這是什麼¶
dsh-vibrancy-skin 由維護者 Natasha123-bit 發佈，在 SkillHub 社區分類爲「趣味換裝」。插件通過純 CSS 注入調整背景與自定義屬性，不髮網絡請求；關閉總開關即可回到原生像素表現。
適用宿主：
- DSH NEXT 2.0.x 或 官方 DeepSeek Harness 客戶端 0.2.x（兩者共用
~/.dsh/profiles/desktop，裝一次兩邊都生效） - 僅 macOS（Windows / Linux 無此窗口材質，安裝後爲空操作）
核心功能¶
README 中列出的效果如下，均可在「設置 → 磨砂玻璃」中即時調節，無需重啓（裝好後若 loader 未加載，見下文常見問題）。
會話與底欄
- 主區域整片磨砂；輸入框、消息氣泡、文件卡片、cost 側欄面板爲半透明
第三方側邊欄
- 例如與 dsh-better-sidebar 共存：面板、標籤欄、底部工作臺同款磨砂
- 可選「深層玻璃」，將內部卡片、列表也玻璃化（對比度會下降）
強度與背景
- 三層強度：磨砂 24% / 均衡 40%（默認）/ 實心 62%
- 微調 0–100，在預設不夠時精確指定
- 背景圖：透到桌面 或 透到壁紙（本地圖片壓縮後存 IndexedDB，不上傳）；壁紙模式可調磨砂度 0–100
其它約定
- 對話框、命令面板等彈層保持不透明，保證可讀性
- 偏好存在本機 localStorage，改動立即生效
環境要求¶
- macOS，且 DSH 窗口材質爲透明（NEXT 默認符合；官方客戶端同樣符合）
- 兼容版本（資料原文）：NEXT 自 2.0.20-next 起（實測 2.0.22-next）；官方客戶端自 0.2.2-rc.1 起
- npm 包當前版本：dsh-vibrancy-skin@1.6.1，許可證 MIT
安裝與啓用¶
從插件市場（推薦）¶
收錄後，在 DSH 中打開 設置 → 插件市場，搜索「磨砂玻璃」或 dsh-vibrancy-skin 安裝，然後重啓 DSH。
資料說明：市場收錄尚在準備中；收錄前可先手動安裝。
手動安裝（npm 包）¶
包已發佈到 npm，安裝與 profile、bundle 列表、備份回滾的完整步驟見倉庫 docs/DEVELOPMENT.md 的「安裝」一節。勿僅憑插件名拼接未在文檔中出現的 CLI 命令。
裝完後用 Cmd+Q 退出再打開 DSH，確保插件進入 loader。手動安裝需確認 profile 的 dependencies 與 dsh.profile.bundles 兩處均包含 dsh-vibrancy-skin。
典型用法¶
裝好後進入 設置 → 磨砂玻璃（導航中緊挨「桌面」頁）。主要控件如下：
| 控件 | 默認 | 說明 |
|---|---|---|
| 啓用磨砂玻璃 | 開 | 總開關；關 = 摘除全部樣式表 |
| 背景圖 | 透到桌面 | 「透到壁紙」可選本地圖片 |
| 側邊欄面板磨砂 | 開 | 第三方側邊欄面板隨主界面磨砂 |
| 深層玻璃（卡片 / 列表） | 關 | 側邊欄內部也玻璃化 |
| 強度 | 均衡 | 磨砂 / 均衡 / 實心三檔 |
| 磨砂度 | 36 | 僅壁紙模式；「透到桌面」時置灰 |
| 微調 | — | 0–100 精確強度 |
臨時關閉用總開關即可；徹底卸載可走市場卸載，或按開發文檔 §4 手動移除。
適用場景與注意¶
適合誰
- 在 macOS 上長期使用 DSH NEXT 或官方 Desktop 客戶端，希望主窗格與側邊欄呈現統一磨砂質感，又不願改佈局或 fork 上游樣式
運行與信任
- 插件以當前 DSH 進程權限運行，僅做客戶端 CSS 注入；安裝前可在 GitHub 查看
index.js、client.js與 MIT 許可證 - 不聲明
peerDependencies（原因見開發文檔 §6），以降低內核升級時兼容性校驗拒載的風險；與 dsh-better-sidebar 等插件共存且不修改對方文件
常見問題（來自 README）
- 裝完沒反應：確認 macOS、總開關已開、必要時重啓 DSH
- 找不到設置頁：檢查是否已正確掛載到 profile / bundles
- 對話框仍實心：屬設計如此，非失效
- 性能：無輪詢與監聽循環；背景裝飾層
pointer-events: none，不參與佈局
社區插件目錄頁與上游倉庫相互獨立，與 DeepSeek / 幻方無官方從屬關係；星標與收錄狀態以各站點當時顯示爲準。
結尾¶
dsh-vibrancy-skin 把 DSH 在 macOS 上已有的 Vibrancy 從被 CSS 擋住的狀態裏釋放出來：材質可調、可關、可卸載，佈局零改動。需要效果圖與開發驗收清單時，可直接查閱倉庫 README 與 docs/DEVELOPMENT.md。
