前言¶
DSH 的插件化理念意味着外觀擴展可以以插件形式接入。對於需要在 DeepSeek Harness 中維護主題、壁紙素材和預設配置的開發者來說，常見問題是：預設、封面、聊天背景、設置卡、側欄海報分散在不同位置，手工調整不容易複用。
下面介紹一個 DSH 第三方插件：wallpaper-plugin。它提供預設牆、壁紙素材庫、圖層合成壁紙和分享導入導出，安裝後設置頁會出現「外觀預設」入口。
這是什麼¶
wallpaper-plugin 的定位是“DSH 壁紙插件：預設/主題管理 + 壁紙素材庫”。
- 倉庫：
https://github.com/Ayase34/wallpaper-plugin - 許可證：
MIT - 適用對象：需要在 DSH 中管理多套外觀預設、壁紙素材，並把配置分享給其他使用者的開發者
資料中未確認最終插件展示名稱、星標數、分類和目錄頁 URL，因此本文不把它們作爲確定信息。
核心功能¶
預設牆¶
安裝後，設置頁會出現「外觀預設」入口。預設牆支持卡片一鍵切換、封面展示和 diff 告警。
工作室中還提供深度編輯能力，包括：
- 原始令牌
- CSS 補丁
- 主題註冊
- 素材部件
壁紙素材庫¶
壁紙素材庫支持上傳圖片，限制如下：
- 單個圖片不超過
20MB - 素材庫上限
100個
上傳後的素材可以分配給三個部件：
16:9聊天背景1:1設置卡1:5側欄海報
素材會按固定比例裁剪，並支持明暗分別配置和不透明度配置。
圖層合成壁紙¶
圖層合成壁紙支持以下場景：
- 多張小圖拼貼合成
- 多個
GIF按時間軸合成，輸出真動圖 - 單個動圖場景自動分層輸出
AI 協同¶
插件提供 12 個 preset_* / asset_* 工具，用於對話式換膚，包括：
- 創建
- 應用
- 微調
- 自糾
分享與還原¶
分享能力使用 zip 三件套導出：
- 預設
- 封面
- 全部素材內嵌
導入時可以完整還原，包括分層規格。
安裝與啓用¶
先使用已覈實的安裝命令：
dsh plugin --profile <name> add github:Ayase34/wallpaper-plugin
這裏的 <name> 是要安裝到的 DSH profile 名稱。安裝完成後，從設置頁進入「外觀預設」即可應用出廠預設。
可選目錄配置¶
如果需要自定義目錄，可以在 profile 的 cordis.patch.yml 中寫入：
- id: wallpaper-plugin
config:
presetsDir: C:/你的預設目錄 # 可選；默認 <dshHome>/.ui-presets
assetsDir: C:/你的壁紙庫目錄 # 可選；默認 <presetsDir>/assets
presetsDir 用於指定預設目錄，assetsDir 用於指定壁紙庫目錄。
不配置時，默認路徑爲：
<dshHome>/.ui-presets
<presetsDir>/assets
典型用法¶
應用出廠預設¶
1、進入設置頁。
2、打開「外觀預設」。
3、選擇一個出廠預設並應用。
上傳並啓用聊天背景¶
1、進入工作室「素材與部件」區。
2、上傳圖片；單個文件不超過 20MB，素材庫最多 100 個。
3、點「設爲聊天背景」。
4、系統自動按 16:9 裁剪並啓用。
導出與導入¶
1、選擇「導出 ZIP」。
2、把生成的 ZIP 發給其他使用者。
3、對方在工作室或預設牆中「導入」。
4、導入後還原預設、封面和全部內嵌素材，包括分層規格。
開發與測試注意¶
如果要從源碼構建或運行測試，資料中給出以下約束：
DSH_CHECKOUT必須顯式指向deepseek-harnesscheckout。- e2e 必填環境變量：
UIP_PLAYWRIGHT_DIR、UIP_CHROMIUM。 - 測試使用獨立 spike profile 和端口
3180，不觸碰正式 profile。 - Node 引擎要求：
>=20.11。 package.json標記private: true。
這些約束主要面向源碼構建和測試環境。普通安裝與使用主要依賴前面的安裝命令、設置頁入口和工作室入口。
適用場景與注意¶
適合的場景：
- 在 DSH 中維護多套主題預設，並快速切換。
- 統一管理聊天背景、設置卡、側欄海報等壁紙素材。
- 用多張小圖或
GIF合成壁紙。 - 通過
preset_*/asset_*工具進行創建、應用、微調、自糾。 - 把預設、封面、素材打包成 ZIP 分享給他人。
注意事項：
- 該插件以當前
dsh進程權限運行，安裝前應檢查源碼和MIT許可證。 - 壁紙庫有數量與單文件限制：單個圖片不超過
20MB，庫內素材最多100個。 - 資料中未確認星標數、分類、維護者身份和目錄頁 URL，因此本文不展開。
- 資料將其描述爲 DSH 第三方插件，不應把它寫成 DeepSeek / 幻方官方應用商店。
結尾¶
wallpaper-plugin 把 DSH 外觀調整中的預設、封面、壁紙素材和分享流程放在同一個插件裏，適合需要複用外觀配置和壁紙素材的開發者。
已覈實的 GitHub 地址：
https://github.com/Ayase34/wallpaper-plugin
目錄頁 URL 未在已覈實資料中確認，本文不列出。
