前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的架構，社區生態中的插件目錄與官方應用解耦。在使用 Web 界面進行智能體開發或交互時，默認主題往往無法滿足對視覺細節的定製需求。dsh-bloomglass 是一個 Web 主題插件，它將 10 套 OKLCH 莫蘭迪配色與磨砂玻璃效果結合，並提供本地壁紙支持，旨在提升界面的視覺質感，並專門適配 DS Bot（Bot 團隊）界面。
插件定位¶
dsh-bloomglass 是一個由 CosmoSail 維護的 DSH Web 主題插件。它通過覆蓋官方的 Token 層，在不修改 settings.yaml 的情況下，爲用戶提供了獨立的磨砂玻璃主題設置入口。
核心功能¶
10 套莫蘭迪配色
提供黛藍、硃砂、桃夭、天青等 10 套配色方案。這些配色支持明暗自適應，能夠根據系統或手動切換自動調整顏色深淺。
磨砂玻璃效果
磨砂玻璃效果覆蓋了左側欄、會話區、右側欄、設置彈窗，以及 DS Bot 的固定面板與彈層。開啓壁紙後，表面色會根據玻璃濃度轉爲半透明，而文字與邊框保持不透明，確保可讀性。
本地壁紙支持
支持上傳本地 JPEG、PNG、WebP 或 GIF 格式的壁紙。插件對壁紙文件大小無限制，文件存儲在 IndexedDB 中。
獨立設置欄
在 DSH 設置中提供獨立的「Bloom Glass」配置頁。用戶可以在此選擇配色，並通過滑桿調整玻璃濃度、模糊度、飽和度及壓暗程度。
DS Bot 界面適配
插件會接管 DS Bot 的界面渲染。它會優先處理 --bt-* 變量，並覆蓋 ds-bot 原有的 6 個 DSH token，確保 Bot 界面的側欄、氣泡、面板等完全跟隨當前主題配色。
安裝與啓用¶
前提條件是 dsh web 已在運行。
- 執行安裝命令：
dsh plugin --profile web add dsh-bloomglass
或從倉庫直接安裝：
dsh plugin --profile web add github:CosmoSail/dsh-bloomglass
-
必須重啓
dsh web（僅刷新頁面不足以加載插件）。 -
打開設置，找到「Bloom Glass」選項進行配置。
首次啓動時，插件會自動讀取舊版插件留下的配色（localStorage 中的 dsh-bloom-variant）和玻璃參數（dsh-frosted-window:knobs），以及 IndexedDB 中的壁紙設置。
技術細節與注意事項¶
實現機制
插件不寫入 settings.yaml，也不請求任何遠程 URL。它利用官方的 overrideTokens 覆蓋層來實現主題切換，而非調用 setTheme('custom')。
數據存儲
壁紙文件存儲在 IndexedDB 中；旋鈕參數（玻璃濃度等）存儲在 localStorage 中。
與 ds-bot 的交互
插件具有 Token 優先權。當檢測到 ds-bot 註冊了同名 Token 時，插件會重新壓回自己的值。因此，ds-bot 的「外觀設置」（主題/強調色）對 Bot 界面不再生效，Bot 界面完全由 Bloom Glass 控制。
官方主題保留
官方的 Light / Dark / System 主題仍然掌權，插件通過覆蓋層疊加效果，不會破壞默認的明暗切換邏輯。
結語¶
dsh-bloomglass 提供了一套無需修改配置文件即可實現的 Web 界面美化方案，特別適合需要高度定製視覺體驗的開發者。
- 項目地址: https://github.com/CosmoSail/dsh-bloomglass
- 許可證: MIT
