前言¶

如果你要在 DSH Web 中更換網頁背景，又不希望直接修改主題或自行寫樣式，dsh-background 提供了一個獨立入口：在「設置 → 通用設置 → 外觀」的「背景圖片」行填寫本地圖片文件的絕對路徑，即可把該圖片設爲網頁背景，並通過蒙層強度調整文字可讀性。

DSH 的插件生態通常以獨立插件形式接入，社區目錄也不是官方應用商店。下面只根據該插件已提供的能力，說明它適合做什麼、怎麼裝、有哪些限制。

這是什麼¶

dsh-background 是 luoyu-xingu 維護的 DeepSeek Harness Web 插件，許可證爲 MIT。它解決的是“把網頁背景換成本地圖片，同時保留默認外觀、明暗主題和文字可讀性”的需求。

安裝後，它會在外觀設置中增加「背景圖片」行，讓你通過本地絕對路徑替換背景，並提供即時預覽和 0–100% 蒙層強度滑塊。

本地路徑設置：在「設置 → 通用設置 → 外觀」的「背景圖片」行填寫本地圖片文件的絕對路徑，將圖片以 cover 方式填充爲網頁背景。
特殊字符路徑：支持包含空格等特殊字符的本地圖片絕對路徑，輸入後回車或失焦生效。
即時預覽：提供與默認外觀控件同尺寸（180 × 88，圓角 16px）的即時預覽框；輸入框聚焦時，預覽跟隨輸入即時變化。
宿主端圖片路由：瀏覽器本身無法直接加載本地文件路徑，圖片由宿主端通過 /dsh-background/image 路由提供給瀏覽器。
持久化：配置保存到 $DSH_HOME/settings.yaml 的 ui-background 段，刷新、重啓後自動恢復；未配置時無背景，且插件不內置默認圖片。
跟隨明暗主題：兜底色自動跟隨淺色/深色靜態色板，並自動疊加淺色主題白蒙層或深色主題深蒙層，以提高文字可讀性。
蒙層強度可調：外觀行內提供 0–100% 滑塊，步進 5，默認 70%，即時調整蒙層透明度並持久化。
圖片格式與大小：支持 jpg / jpeg / png / gif / webp / avif / svg / bmp / ico，單個文件上限 25MB。

先執行安裝命令：

dsh plugin --profile web add dsh-background

安裝完成後需重啓 dsh web，刷新頁面後纔會在「設置 → 通用設置 → 外觀」中看到「背景圖片」行。

1、打開「設置 → 通用設置」，在外觀下方找到「背景圖片」。

2、在輸入框粘貼本地圖片路徑，按回車或點擊其它位置生效。

3、拖動「蒙層強度」滑塊，調整文字可讀性與圖片可見度的平衡。

4、預覽框會即時反映效果；刷新頁面後背景依然保留。

5、如果不想保留背景，點擊「清除背景」恢復默認外觀。

該插件的配置保存在 $DSH_HOME/settings.yaml 的 ui-background 段。圖片由宿主端讀取本地文件後，通過 /dsh-background/image 路由提供給瀏覽器，而不是讓瀏覽器直接讀取本地路徑。

當前版本（dsh 0.1.0-rc.6）的 settings 網關只對硬編碼白名單內的命名空間開放瀏覽器讀寫，第三方插件註冊的命名空間會收到 settings-not-exposed 拒絕；插件改用自定義 RPC 通道。

dsh-background 把“換背景”收進通用設置的外觀行，用本地路徑、即時預覽和蒙層強度處理 DSH Web 界面的背景個性化需求。

GitHub：https://github.com/luoyu-xingu/dsh-background

目錄頁鏈接未在本文材料中提供；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。