前言¶
DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」，主題系統也是通過插件的形式接入的。dsh-theme-blackhole 是一個爲 DSH Web UI 定製的主題插件，它提供了一套視覺樣式，而不是核心功能邏輯。
插件概述¶
- 插件名：
dsh-theme-blackhole - 維護者：jiangwangyang
- 分類：趣味換裝
- 定位：Web UI 主題插件，提供 WebGL 史瓦西黑洞背景和深空玻璃面板配色。
核心功能¶
該插件包含以下能力：
- WebGL 史瓦西黑洞背景：使用 null-geodesic（零測地線）光線追蹤渲染重力透鏡、吸積盤和光子環，並帶有緩慢的自動相機軌道。
- 深空玻璃面板：通過半透明的深色設計令牌覆蓋和背景模糊，讓黑洞背景在內容後方若隱若現，品牌強調色變爲吸積盤的琥珀色。
- 一等主題支持：註冊到主題運行時。設置行的開關與外觀設置雙向同步，切換持久化，且啓動時不會出現默認主題的閃爍。
- 性能友好的降級處理：採用半分辨率渲染和 30fps 幀率限制，並遵守系統的減少動畫偏好。如果 WebGL 不可用，會自動降級爲純黑深空背景。
安裝與啓用¶
安裝前請確認當前 DSH 進程擁有 Web 服務權限。該插件僅支持包含 web 服務器的 profile。
- 安裝插件：
dsh plugin --profile web add github:jiangwangyang/dsh-theme-blackhole
- 啓用主題：
安裝並啓動後，進入 設置 > 通用 > 主題 - 黑洞。
典型用法¶
在啓用該主題後，其行爲如下：
- 開啓：切換到黑洞主題。開關狀態會被持久化保存，刷新頁面或重啓後依然生效。
- 關閉：恢復之前的內置主題（淺色/深色/跟隨系統）。原來的外觀偏好不會被覆蓋。
- 一致性維護：如果在外觀設置行切換回內置主題，插件內部的開關會自動寫入“關閉”，保證兩個設置的一致性。
適用場景與注意事項¶
- Profile 依賴：該插件依賴 web profile 的
webServer服務，僅適用於包含 web 服務器的 profile（例如webprofile）。不要將其安裝到無頭 profile 中。 - 許可證：基於 MIT 許可證開源，使用時請遵守相關條款。
結語¶
dsh-theme-blackhole 通過 WebGL 渲染技術，爲 DSH Web UI 帶來了極具視覺衝擊力的背景效果，同時保持了良好的性能表現和主題系統的集成度。如果你需要在 Web 界面中展示更具科技感或科幻感的視覺風格，這是一個可以直接使用的主題方案。
- 源碼地址：https://github.com/jiangwangyang/dsh-theme-blackhole
