前言¶
在 DeepSeek Harness（DSH）里長時間開智能體會話時，默認界面往往是統一的淺色或深色卡片風格。若你希望整個界面背後是自己選的圖片或循環靜音視頻，又不想把對話框、審批提示和設置頁弄得難以閱讀，需要在「全屏媒體」和「可讀交互面」之間做分層控制。社區插件 dsh-plugin-wallpaper（維護者 william-godric-han，目錄分類爲趣味換裝）就是做這件事的：在 Harness Web UI 裏導入本地圖片或視頻作爲背景，用遮罩、模糊、填充和表面不透明度等參數調節觀感，並讓彈窗、菜單等交互區域保持可讀下限。
這是什麼¶
dsh-plugin-wallpaper 是一個 Harness bundle：一條 cordis.patch.yml 記錄加瀏覽器端模塊，面向已啓用 Web UI 的 DSH 環境。宿主側 index.js intentionally 爲空，邏輯集中在 client.js。插件不向網絡上傳任何內容，安裝後行爲以當前 DSH 進程與瀏覽器中的模塊爲準；使用前建議自行查看倉庫源碼與 MIT 許可證。README 寫明在 0.2.2-rc.1（桌面端與 dsh web）上構建與測試；支持 Harness Web UI 所運行的各操作系統，無獨立構建步驟與額外依賴。
核心功能¶
下面按 README 已列能力歸納，不超出文檔表述。
- 自有媒體：通過系統文件選擇器導入任意
image/*或video/*（視頻靜音循環播放），僅保存在當前瀏覽器。 - 玻璃化外殼：框架、側欄、標題欄等 shell 令牌設爲透明，媒體成爲界面底色而非窄條背景。
- 表面不透明度：單一滑塊控制環境表面（氣泡、輸入區、色調等）保留多少「實體感」；
0%接近純壁紙，100%接近默認白卡片觀感。 - 交互面可讀性：對話框、問題卡片、審批提示、菜單、彈出層與 toast 至少保持約 88% 主體不透明度；設置頁強制完全不透明。
- 六種漸變預設：無文件時也可使用，或作爲後備方案。
- 遮罩、模糊與填充：按明暗主題在媒體上疊加白/黑遮罩；模糊 0–24 px；填充模式
cover或contain。 - 持久化：媒體存 IndexedDB，設置存 localStorage，刷新或重啓後仍保留。
- 單文件上限：每個文件最大 200 MB；插件不進行網絡請求。
安裝與啓用¶
插件以本地 bundle 形式安裝。資料給出三種路徑，任選其一即可。
在應用內：打開左側邊欄 Plugins，選擇從本地目錄安裝，指向包含本插件的文件夾（需先自行取得倉庫或解壓後的目錄，路徑因環境而異）。
在 Agent 會話中：讓 Harness Agent 安裝 bundle，或對插件管理工具傳入絕對路徑，例如：
{ "action": "install_bundle", "target": "D:\\path\\to\\dsh-plugin-wallpaper" }
通過 CLI：在 Harness 檢出目錄下執行（將路徑替換爲本機絕對路徑）：
dsh plugin --profile <profile> add /absolute/path/to/dsh-plugin-wallpaper
bundle 通過 HMR 激活。若頁面仍顯示舊構建，請 reload 一次頁面（或重啓應用），因瀏覽器會按圖版本保留客戶端模塊。
若 Wallpaper 藥丸按鈕未出現，多在 Plugins 中未啓用 bundle，需在插件頁打開後再試。
典型用法¶
- 打開任意會話，在 composer 塢右側找到 Wallpaper 藥丸（靠近 round/token 計數器）。
- 在面板中：
- Image / Video：選擇文件，立即生效並記住。
- Presets：六種漸變，適合尚未準備媒體時。
- Veil：媒體上的變暗層（淺色主題爲白、深色主題爲黑）。
- Blur：0–24 px；媒體會略放大以避免模糊露出邊緣。
- Surface opacity：環境表面主體強度；對話框等仍遵守可讀下限。
- Fill：Cover或Fit。
- Enable wallpaper：臨時關閉顯示但保留媒體與設置。
- Reset all：清除媒體與全部設置。 - 藥丸上的圓點表示壁紙處於啓用狀態。
數據落點（便於排查或理解隱私邊界）：
| 內容 | 位置 |
|---|---|
| 圖片 / 視頻 blob | IndexedDB dsh-beautify，對象庫 media，鍵 image / video |
| 設置 | localStorage["dsh-beautify/settings/v1"] |
適用場景與注意¶
適合誰：希望在 Harness Web UI 裏個性化背景、又需要對話框與設置頁保持可讀的開發者或個人用戶；偏「趣味換裝」類體驗，不改變 Agent 核心能力。
權限與信任：插件隨 DSH Web 客戶端在瀏覽器內運行，讀寫本機 IndexedDB 與 localStorage。安裝前應閱讀 GitHub 倉庫 中的 client.js 等源碼，確認符合你的環境與合規要求。資料明確說明無上傳、無插件發起的網絡調用。
使用注意（摘自官方故障排除表）：
| 現象 | 處理 |
|---|---|
| 亮圖導致文字難讀 | 提高 Veil 或 Surface opacity |
| 視頻卡頓 / CPU 高 | 將模糊設爲 0，或改用圖片 |
| 提示文件過大 | 單文件上限 200 MB |
| 清除站點數據後壁紙消失 | 媒體僅存當前瀏覽器，需重新導入 |
| 更新後界面無變化 | 重新加載頁面或重啓應用以拉取新 client 模塊 |
卸載：在 Plugins 禁用或移除 Wallpaper，或從 profile 的 dsh.profile.bundles 去掉對應項；瀏覽器數據可能殘留，若需徹底清除可先使用面板 Reset all。
結尾¶
dsh-plugin-wallpaper 把 Harness Web UI 的背景換成本地圖片或視頻，並用主題令牌覆蓋與交互面不透明下限，在個性化與可讀性之間做了文檔化的折中。社區目錄頁：william-godric-han/dsh-plugin-wallpaper；源碼與完整說明：github.com/william-godric-han/dsh-plugin-wallpaper。
