在 DeepSeek Harness (DSH) 的 web profile 中，用戶經常需要調整面板區域的透明度以適配壁紙或優化閱讀體驗。特別是使用 Wallpaper Engine (WE) 模式時，皮膚通常自帶強制透明的規則，難以覆蓋。dsh-panel-tint 插件通過提供獨立的滑塊控制，解決了側邊欄、正文框和輸入框底色不透明度的問題，同時兼容普通皮膚與 WE 模式。
插件定位¶
這是由 abbccdd 維護的一個 DSH 插件。它的核心作用是給 DSH web 增加 側邊欄 / 正文框 / 輸入框 三個區域的“底色不透明度”獨立滑塊。
插件默認值爲 0，即完全保持皮膚原樣。當滑塊值大於 0 時，會通過內聯 !important 樣式覆蓋皮膚或 WE 的中性化規則，實現對背景色的可控調節。
核心功能¶
-
三個獨立滑塊
分別控制側邊欄、正文框和輸入框的底色不透明度（範圍 0-100%）。- 側邊欄：保留皮膚自帶的背景（含漸變層次），只縮放透明度。
- 正文框：控制每條“正文”（助手回答 / 用戶消息）的文本框底色。注意：
thinking區域不參與此調節。 - 輸入框：保留皮膚原色，0 爲全透明透出壁紙。
-
智能讀色與格式保留
插件在檢測到皮膚元素時，會讀取其原始背景色（支持漸變）和格式（圓角、邊框、陰影等）。- 輸入框 / 側邊欄：保留原色相，只調整透明度。
- 正文框：若皮膚自帶文本框，則完整保留其格式與顏色，僅調整底色透明度；若皮膚未設置文本框，則使用插件自帶的 Word 風格文本框樣式。
-
自適應與持久化
- 當皮膚或主題切換時，插件會自動重讀原色與格式。
- 設置會持久化存儲在
settings.yaml的panel-tint命名空間下。
-
Wallpaper Engine 兼容
在 WE 模式下，插件能壓過皮膚中心的background-color: transparent !important中和規則，爲全透明面板補上可讀底色。
安裝與啓用¶
安裝後需要重啓 DSH web 才能生效。
# 從 GitHub 安裝
dsh plugin --profile web add github:abbccdd/dsh-panel-tint
安裝完成後，進入 DSH web 的 設置 -> 面板底色，即可看到新增的調節選項。
典型用法¶
- 打開設置面板底色。
- 根據當前皮膚或壁紙風格，拖動對應的滑塊。
- 拖動操作即時生效，無需刷新頁面。
技術細節與注意事項¶
-
依賴項
插件依賴宿主端（host）的 peerDependencies：@deepseek-ai/dsh-settings和@deepseek-ai/schemastery。這些依賴在安裝時由宿主 profile 自動解析，插件本身不直接包含。 -
正文框邏輯
正文框在滑塊大於 0 時，通過純色/縮放透明度的方式控制皮膚自帶框的底色。這意味着如果皮膚原本的文本框樣式比較複雜，插件會盡量保留其外框和內邊距，只改變底色透明度。 -
已知邊界
個別皮膚的複雜多圖層背景（如多層漸變疊加），在經過插件處理後可能呈現爲單層效果。這是由於插件在讀取和重應用樣式時的技術限制所致。
總結¶
dsh-panel-tint 爲 DSH web 提供了一種輕量級的底色控制方案，無需修改皮膚源碼即可快速調整面板的可讀性。通過獨立的滑塊和智能讀色功能，它能夠較好地兼容不同風格的皮膚與 WE 壁紙。
插件倉庫：https://github.com/abbccdd/dsh-panel-tint
