前言¶

DeepSeek Harness（DSH）的理念是「一切皆插件」。在 dsh web 中做界面定製時，常見的問題是：背景太明顯會影響閱讀，面板太透明又會讓界面不夠清晰。HaoyueQin/deepseek-harness-background 針對這個場景，爲 DeepSeek Harness Web GUI（dsh web）提供自定義背景圖片：可以上傳本地圖片，也可以粘貼圖片 URL，並調節不透明度、可讀性遮罩、面板透明度和毛玻璃模糊。

社區插件目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。下面介紹該插件的定位、能力、用法和注意事項。

這是什麼¶

• 插件：HaoyueQin/deepseek-harness-background
• 維護者：HaoyueQin
• 目標界面：DeepSeek Harness Web GUI（dsh web）
• 許可證：MIT
• 倉庫：https://github.com/HaoyueQin/deepseek-harness-background

它把自定義背景渲染在應用表面後方，並在設置面板內提供即時預覽。本地圖片會存儲在 harness home 下，並通過同源路由提供；遠程圖片支持 http(s) 鏈接。

核心功能¶

圖片來源¶

支持兩類來源：

1、上傳本地 JPG / PNG / WebP / GIF 圖片。
2、粘貼 http(s) 圖片鏈接。

本地上傳只有在聲明 MIME、檢測簽名和擴展名一致時才接受。

預覽與提交¶

• 在設置面板內即時預覽圖片、遮罩和毛玻璃效果。
• 比例滑塊按 5% 步進。
• 模糊半徑按 1/2px 步進。
• 拖拽滑塊時僅重繪，鬆手後提交。

五項控制¶

插件提供以下控制：

1、背景不透明度
2、可讀性遮罩
3、面板不透明度
4、毛玻璃模糊
5、背景模糊

適配模式支持：

cover
contain

其中 cover 是填充裁剪，contain 是完整顯示。

遮罩¶

插件根據明暗主題自動使用白色或黑色遮罩。

毛玻璃¶

插件對指定表面啓用毛玻璃效果，並保留閱讀表面的官方不透明繪製。

如果需要恢復白名單表面的官方不透明繪製，可以將 panelOpacity 設爲 100%：

panelOpacity = 100%

第三方玻璃註冊¶

插件提供第三方玻璃註冊接口：

window.__DSH_BACKGROUND_GLASS__

以及事件：

dsh-background-glass:ready

第三方插件可以註冊自己的玻璃面板。當該插件缺失時，這一註冊接口會優雅降級。

會話時間線增強¶

插件爲 dsh ≥ 0.1.2 提供會話時間線增強，例如已加載節點平滑滾動。該行爲通過能力檢查而非版本比較來限定。

依賴聲明¶

package.json 中聲明的 peerDependencies 包括：

@deepseek-ai/cordis ^4.0.1
react ^18.2.0

以及特定 @deepseek-ai/dsh-client-* 版本範圍。

安裝與啓用¶

已覈實資料中沒有給出官方安裝命令，因此這裏不提供 dsh plugin add ... 形式的命令，也不根據倉庫名拼接安裝命令。啓用前請以倉庫文檔或插件目錄中的說明爲準。

插件會以當前 dsh 進程權限運行。安裝前建議檢查源碼、許可證和依賴範圍。該插件許可證爲 MIT。

典型用法¶

資料中給出的用法如下：

1、在設置面板上傳本地 JPG / PNG / WebP / GIF 圖片。
2、粘貼 http(s) 圖片鏈接並按 Enter。
3、拖拽滑塊即時預覽，鬆手後自動提交。
4、選擇 cover（填充裁剪）或 contain（完整顯示）適配模式。
5、將 panelOpacity 設爲 100%，以恢復白名單表面的官方不透明繪製。
6、通過 window.__DSH_BACKGROUND_GLASS__ 和 dsh-background-glass:ready 事件註冊第三方玻璃面板。

適用場景與注意¶

適合：

• 想給 dsh web 添加自定義背景，同時保持文字可讀性的用戶。
• 需要調節背景、遮罩、面板透明度和模糊效果的開發者。
• 需要把自定義面板接入統一玻璃效果的第三方插件作者。
• 在 dsh ≥ 0.1.2 會話時間線上希望獲得已加載節點平滑滾動的用戶。

注意：

• 本地上傳僅在聲明 MIME、檢測簽名和擴展名一致時接受。
• 上傳圖片會存儲在 harness home 下，並通過同源路由提供。
• 插件會以當前 dsh 進程權限運行；安裝前應檢查源碼與許可證。
• panelOpacity 設爲 100% 會恢復白名單表面的官方不透明繪製。
• 第三方玻璃註冊接口在插件缺失時會優雅降級。
• 會話時間線增強面向 dsh ≥ 0.1.2，並通過能力檢查而非版本比較限定行爲。
• 本文不給出未覈實的安裝命令；星標數和目錄頁內容未在本次抓取資料中核實。

鏈接¶

• GitHub：https://github.com/HaoyueQin/deepseek-harness-background
• 插件目錄頁線索：https://www.skillhub.cn/plugins/HaoyueQin/deepseek-harness-background（該 URL 來自插件線索，未在本次抓取資料中核實）