前言¶
DSH 的社區生態強調“一切皆插件”。社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係；插件本身由社區維護，使用者需要自行判斷是否適合當前環境。
dsh-wallpaper 是一個 DSH Web 壁紙插件，用來在 DSH Web 界面更換背景圖片，並繼續調整壁紙上的模糊、表面不透明度、文字配色、填充與位置等顯示效果。它支持主界面與軌跡頁分別配置壁紙，也支持無壁紙、內置漸變、上傳圖片、導入文件夾和裁剪圖片。
插件定位¶
dsh-wallpaper 是 RNlao 維護的 DSH Web 壁紙插件，倉庫地址爲：
https://github.com/RNlao/dsh-wallpaper
當前已覈實版本爲 v0.1.0，許可證爲 MIT。包元數據中聲明 peerDependencies: react ^18.2.0。
這個插件解決的是 DSH Web 外觀自定義問題：如果你希望主界面和軌跡頁使用不同背景，或者希望調整背景上的面板透明度與文字可讀性，可以直接在 DSH Web 的設置頁中配置，而不是修改 DSH 本身。
核心功能¶
已覈實的功能包括：
- 在 DSH Web 界面更換背景圖片。
- 主界面 / 軌跡頁獨立壁紙。
- 邊欄自動跟隨當前頁面壁紙。
- 無壁紙。
- 預設漸變：8 個內置漸變。
- 上傳圖片 / 導入文件夾 / 裁剪圖片進入圖片庫。
- 裁剪：拖拽框選保留區域並輸出新圖。
- 模糊 0–50px。
- 表面不透明度 0–1.0。
- 面板半透明。
- 主界面文字顏色：自動 / 淺色 / 深色 / 自定義取色。
- 填充與位置調整：裁切填充 / 完整顯示 / 拉伸、水平 / 垂直位置。
- 界面語言：中文 / English。
- 軌跡頁配色方案：DSH 原生 / 清澈 / 青玉。
- 圖片原始字節存瀏覽器 IndexedDB。
- 當前選擇 + 效果參數存
localStorage。 - 關閉總開關可恢復 DSH 原始外觀。
這裏的“獨立壁紙”指主界面和軌跡頁可以分別配置背景。軌跡頁還提供 DSH 原生、清澈、青玉三套配色方案。
存儲方式¶
dsh-wallpaper 的存儲分爲兩部分：
- 圖片原始字節：存放在瀏覽器 IndexedDB 中。
- 當前選擇 + 效果參數：存放在
localStorage中，僅保存元數據，體積很小。
圖片不壓縮、不 base64，容量不受 localStorage 5MB 限制。
需要注意的是，圖片存在瀏覽器側。瀏覽器清除站點數據、清緩存或使用隱私模式時，相關圖片數據可能一併被清除；換瀏覽器使用時也不會自動共享。
安裝¶
下面介紹幾種安裝方式。安裝前先確認 web profile 是否已經初始化；如果尚未初始化，先運行一次：
dsh web
插件會以當前 dsh 進程可用權限運行。安裝前建議檢查源碼與許可證。
從 GitHub 安裝¶
推薦從 GitHub 安裝 v0.1.0：
dsh plugin --profile web add github:RNlao/dsh-wallpaper#v0.1.0
從 Release 安裝¶
從 Release 下載 dsh-wallpaper-0.1.0.tgz，然後在本地執行：
dsh plugin --profile web add /path/to/dsh-wallpaper-0.1.0.tgz
這裏的 /path/to/dsh-wallpaper-0.1.0.tgz 需要替換爲你實際下載到的文件路徑。
從源碼安裝 / link: 開發鏈接¶
從源碼安裝時，先 clone 倉庫：
git clone https://github.com/RNlao/dsh-wallpaper.git
然後執行：
dsh plugin --profile web add link:./dsh-wallpaper
也可以下載 ZIP，解壓後從上一級目錄執行：
dsh plugin --profile web add link:./dsh-wallpaper-main
link: 是開發鏈接，不是持久安裝。插件會持續依賴該源碼目錄；如果目錄被移動或刪除，插件會失效。
如果修改 lib/client.js，不需要重新 link 或重啓服務，DSH client HMR 會自動重載；如果沒有立即反映到瀏覽器，再強刷瀏覽器。
卸載¶
卸載命令爲：
dsh plugin --profile web remove dsh-wallpaper
啓用與刷新¶
安裝後打開：
設置 → 壁紙 / Wallpaper
如果 dsh web 正在運行，首次安裝或卸載後需要重啓該進程，並強刷瀏覽器，使新的 profile bundle 列表生效。
強刷瀏覽器快捷鍵：
- macOS：
Cmd+Shift+R - Windows / Linux：
Ctrl+Shift+R
如果 host 或掛載配置發生變化，需要重啓 dsh web。本插件爲純瀏覽器實現，host 半爲空插件，無操作系統特定代碼。
典型用法¶
下面是一個可復現的使用流程：
1、從 GitHub 安裝插件：
dsh plugin --profile web add github:RNlao/dsh-wallpaper#v0.1.0
2、如果 web profile 尚未初始化，先運行：
dsh web
3、打開 DSH Web 界面，進入：
設置 → 壁紙 / Wallpaper
4、選擇壁紙來源：
- 無壁紙
- 8 個內置漸變之一
- 上傳圖片
- 導入文件夾
- 裁剪圖片
5、調整顯示效果：
- 模糊：0–50px
- 表面不透明度：0–1.0
- 主界面文字顏色：自動 / 淺色 / 深色 / 自定義取色
- 填充與位置：裁切填充 / 完整顯示 / 拉伸、水平 / 垂直位置
- 軌跡頁配色方案：DSH 原生 / 清澈 / 青玉
6、如果希望恢復 DSH 原始外觀，關閉壁紙效果總開關即可。
平臺與瀏覽器注意¶
dsh-wallpaper 跨平臺，Windows / macOS / Linux 功能一致。差異主要在路徑和瀏覽器快捷鍵：
- 數據目錄：
- macOS / Linux 默認
~/.dsh - Windows 默認
%USERPROFILE%\.dsh - 安裝命令：GitHub、Release 和源碼
link:./dsh-wallpaper安裝在各平臺相同。 - 瀏覽器強刷：
- macOS：
Cmd+Shift+R - Windows / Linux：
Ctrl+Shift+R
導入文件夾依賴 webkitdirectory：Chrome / Edge / Safari 支持，Firefox 不支持；單張上傳不依賴它，因此單張上傳在瀏覽器側更通用。
半透明面板底色通道取自當前 DSH 的 design-platform.css。如果未來 token 色值調整，透明度觀感可能略變；這是外觀層面的差異，不改變插件基本功能。
適用場景與注意¶
dsh-wallpaper 適合需要在 DSH Web 中自定義背景、調整面板透明度、配置軌跡頁配色方案，或者希望用圖片庫管理多張壁紙的用戶。
使用前需要注意：
- 插件由社區維護，當前版本爲
v0.1.0，許可證爲MIT。 - 插件會以當前
dsh進程可用權限運行，安裝前應檢查源碼與許可證。 - 圖片存儲在瀏覽器 IndexedDB 中，清站點數據或隱私模式可能導致圖片丟失。
link:安裝依賴源碼目錄，目錄移動或刪除後插件失效。- 導入文件夾受瀏覽器
webkitdirectory支持情況影響，Firefox 不支持。 - 首次安裝或卸載後，如果
dsh web正在運行，需要重啓進程並強刷瀏覽器。
相關鏈接¶
已覈實倉庫地址：
https://github.com/RNlao/dsh-wallpaper
本文未列出社區目錄頁地址，因爲已覈實資料中沒有可確認的目錄頁 URL。
