前言¶

在 DeepSeek Harness（DSH）的 Web 界面中，背景通常是固定的。對於希望根據項目、演示或本地工作區臨時更換背景的人，DSH 的插件機制提供了一種擴展方式。dsh-bgwall-plugin 用於把 Web 界面背景換成任意圖片，圖片來源可以是遠程 URL，也可以是服務器本地文件，並提供透明度、模糊和鋪放方式調節。

下面介紹這個插件能做什麼、如何安裝、如何使用，以及使用時需要注意的事項。

這是什麼¶

dsh-bgwall-plugin 是一個 DSH 插件，用於修改 DeepSeek Harness Web 界面背景。它由 hubo980205 維護，許可證爲 MIT，實現方式爲純 JavaScript，無構建步驟。

安裝啓用後，DSH Web 界面的「設置」中會增加「背景圖片」頁，控制面板就位於：

設置 → 背景圖片

這個插件主要解決的是 Web 界面背景不可自定義的問題。你可以使用遠程圖片 URL，也可以使用服務器上的本地文件路徑，並在界面中即時調節顯示效果。

核心功能¶

已覈實的插件能力包括：

• 背景圖片來源：
• 遠程圖片 URL
• 服務器本地文件路徑
• 相對路徑基於工作區根目錄解析
• 透明度：0–100% 即時調節，圖片與原始界面背景色平滑混合，不會出現黑屏
• 模糊：0–40px
• 鋪放方式：鋪滿 / 適應 / 拉伸
• 「側邊欄背景也透明」開關
• 一鍵「清除背景」
• 本地圖片經 Host HTTP 路由同源加載，規避超長 data URL 在 CSS 中失效的問題
• 本地圖片單張上限：15MB

安裝與啓用¶

使用 dsh 插件命令從 GitHub 安裝：

dsh plugin --profile web add github:hubo980205/dsh-bgwall-plugin

安裝完成後，重啓 dsh 的 web profile，並刷新瀏覽器：

dsh --profile web

這一步是必要的，因爲 Host 行與 client 名單在啓動時掃描。刷新後，左下角「設置」中會出現「背景圖片」頁。

如果需要手動安裝，可以把本包放入：

$DSH_HOME/profiles/node_modules

然後在該 profile 的 cordis.patch.yml 中追加：

- insert: [{ id: bgwall, name: dsh-bgwall-plugin }]

卸載時使用：

dsh plugin --profile web remove dsh-bgwall-plugin

典型用法¶

安裝並重啓後，打開左下角「設置」，進入新增的「背景圖片」頁。

1、使用遠程圖片 URL¶

在圖片來源處粘貼圖片 URL，例如：

https://example.com/wallpaper.jpg

然後點「應用」。

2、使用服務器本地文件¶

在圖片來源處填寫服務器本地路徑，例如：

dog.jpg

或：

/root/pic.png

然後點「加載」。

相對路徑會基於工作區根目錄解析。本地圖片通過 Host HTTP 路由同源加載，單張文件上限爲 15MB。

3、調節顯示效果¶

應用或加載圖片後，可以：

• 拖動「透明度」滑桿
• 拖動「模糊」滑桿
• 選擇「鋪放方式」：鋪滿 / 適應 / 拉伸
• 打開或關閉「側邊欄背景也透明」

這些調整會在頁面中即時預覽。

4、還原默認背景¶

如果需要取消當前背景，點「清除背景」即可一鍵還原。

適用場景與注意¶

這個插件適合以下幾類使用場景：

• 使用 DSH Web 界面，希望臨時更換背景
• 希望使用遠程圖片 URL 或服務器本地文件
• 需要調節透明度、模糊和鋪放方式
• 不想引入構建步驟，只需要純 JavaScript 插件

使用前需要注意：

• 插件會在當前 DSH 進程中加載，因此安裝前應檢查源碼與許可證。
• 本插件許可證爲 MIT。
• 背景狀態爲會話內存態，不持久化；頁面刷新後背景恢復默認。
• 本地圖片單張上限爲 15MB。
• 相對路徑基於工作區根目錄解析。
• 安裝或手動安裝後，需要重啓 dsh --profile web 並刷新瀏覽器。

鏈接¶

GitHub 倉庫：

https://github.com/hubo980205/dsh-bgwall-plugin

已覈實資料中未包含可確認的社區目錄頁 URL，因此本文不列具體目錄頁地址。DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。