前言¶
DeepSeek Harness（DSH）的 Web GUI 默認是統一的淺色或深色底。長時間對着同一套界面工作時，有人會希望換一張自己的背景圖，但又不能動佈局、不能把文字和控件糊成一片。社區插件 DSH Background Image（倉庫 ASUKAq01/dsh-background-image）走的就是這條線：只在瀏覽器里加一層背景，用滑塊調不透明度和虛化，主畫布和側欄底色變透明以便露出圖片，卡片和輸入框仍用不透明表面。下面介紹它是什麼、能做什麼，以及如何安裝和使用。
這是什麼¶
DSH Background Image 是由維護者 ASUKAq01 發佈的輕量 客戶端 Web 插件（當前版本 1.0.0，MIT 許可）。SkillHub 目錄將其歸類爲 趣味換裝。
一句話定位：爲 DeepSeek Harness Web UI 上傳自定義背景圖，調節不透明度與虛化，只改外觀，不移動任何宿主控件。圖片與設置保存在當前瀏覽器的 localStorage，插件不上傳圖片、不讀取會話內容，也不爲此發起網絡請求。
核心功能¶
以下能力均來自倉庫 README 與 package.json 說明。
- 上傳即用：支持選擇或拖入 JPG / PNG / WebP / GIF；瀏覽器內自動縮放、重新編碼。
- 兩個滑塊：背景不透明度（0–100%）與虛化程度（0–40 px），拖動實時生效。
- 主題自適應：淺色 / 深色主題分別疊加白色、
#151517的主題色薄紗；切換主題自動跟隨。 - 不改變佈局：背景層
z-index: -1、pointer-events: none，不參與佈局、不攔截點擊。 - 可讀性優先：僅讓主畫布、會話區和側欄的底色透明；卡片、輸入框、彈層仍用不透明表面。
- 本地存儲：壓縮後的圖片與設置寫入
localStorage（鍵名見下文「存儲與隱私」）。 - 乾淨卸載：禁用或卸載時清理樣式、CSS 變量、令牌覆蓋與類名。
- 雙語界面：設置頁隨 Harness 界面語言顯示中文或英文。
兼容性：DeepSeek Harness >=0.1.7-rc.1 <0.3.0-0。插件使用 ctx.slots、ctx.locale、ctx.theme.overrideTokens，註冊槽位 settings.plugins.tab 與 plugins.row.config；client.js 直接以 Harness 模塊格式加載，無單獨構建步驟。
安裝與啓用¶
插件目前通過 GitHub 分發，尚未發佈到 npm（package.json 已命名爲 @asukaq01/dsh-background-image，發佈後可用 CLI 從 npm 添加）。
安裝前請確認 Harness 版本落在上述區間內。插件在 當前 DSH 進程與 Web 客戶端 中運行；安裝前應自行查看倉庫源碼與 MIT 許可證，再決定是否啓用。
方式一：DSH 插件管理器¶
先把倉庫克隆到本地（官方 README 給出的命令如下）：
git clone https://github.com/ASUKAq01/dsh-background-image.git
在 Harness 中打開 設置 → 插件，通過添加/安裝本地目錄的入口選擇克隆下來的 dsh-background-image 目錄，啓用後 刷新一次頁面。
方式二：dsh CLI¶
同樣先克隆倉庫：
git clone https://github.com/ASUKAq01/dsh-background-image.git
dsh plugin --profile <profile> add ./dsh-background-image
將 <profile> 換成正在使用的 profile（例如 desktop 或 web），然後重啓或刷新 Harness。
npm（尚未可用）¶
README 說明發布後預期命令爲：
dsh plugin --profile <profile> add @asukaq01/dsh-background-image
當前請勿依賴 npm 安裝，除非維護者已正式發佈包。
典型用法¶
經過上面的步驟啓用並刷新頁面後，可按 README 中的流程操作：
- 打開 設置 → 插件 → 背景圖（或從插件列表中本插件的配置入口進入）。
- 點擊「選擇圖片」，或將圖片拖進預覽框。
- 調整「背景不透明度」和「虛化程度」；關閉設置面板即可查看整窗效果。
- 需要恢復默認外觀時，使用「移除背景」：刪除本地圖片並恢復宿主原始樣式。
首次安裝完成後需刷新一次頁面，瀏覽器纔會加載新的客戶端模塊。
存儲與隱私¶
dsh.background-image.image.v1：壓縮後的圖片與尺寸。dsh.background-image.settings.v1：不透明度與虛化值。
圖片在瀏覽器內縮放至最長邊 2560 px，並優先編碼爲 WebP，以適配 localStorage 配額。清除站點數據或在設置頁點擊「移除背景」會刪除已保存的圖片。
適用場景與注意¶
適合誰：希望在 DSH Web 界面做輕度「換裝」、又需要保持控件可讀性與原佈局的用戶；數據敏感場景下可接受「僅本地瀏覽器存儲、無上傳」的實現方式。
注意：
- 背景僅存在於當前瀏覽器 profile 的站點數據中，換設備或清緩存需重新上傳。
- 與 Harness 主版本強相關：
peerDependencies要求@deepseek-ai/dsh在>=0.1.7-rc.1 <0.3.0-0範圍內，升級 Harness 前宜覈對插件是否仍兼容。 - 社區目錄 SkillHub 插件頁 與 GitHub 倉庫由社區維護，與 DeepSeek / 幻方無官方從屬關係；安裝來源以你信任的倉庫與 commit 爲準。
開發或二次修改時，可將倉庫目錄安裝到某個 profile 後直接改 client.js，刷新頁面即可驗證；倉庫提供 node scripts/validate.mjs 做字段、locale、圖標與語法校驗，GitHub Actions 在 push 與 PR 時運行同一腳本。
結尾¶
DSH Background Image 把「自定義壁紙」收束成上傳、兩枚滑塊和本地存儲，並通過令牌覆蓋與固定背景層避免破壞佈局與可讀性。若要查看元數據與分類，可打開 SkillHub 目錄頁；源碼、CHANGELOG 與 issue 見 GitHub：
