前言¶
DeepSeek Harness（DSH）的 Web 界面默認是功能向的樣式：對話區、側邊欄夠用，但背景與視覺層次往往比較平。若你長期在 desktop profile 裏調試智能體，會希望在不改核心代碼的前提下，統一主色、背景圖，並在界面一角放一個可交互的 Live2D 角色——而不是自己 fork 前端或依賴外網 CDN 拉模型。
下面介紹社區插件 dsh-live2d-theme（維護者 suwenner，GitHub 倉庫 suwenner/dsh-live2d-theme，目錄分類爲「趣味換裝」）。它把背景主題與 Q 版看板娘打包進插件，運行時、默認模型和背景都在包內 assets/，裝好即可用。
這是什麼¶
dsh-live2d-theme 是面向 DSH Web GUI 的美化 / 皮膚類插件：支持替換 Live2D 模型、更換背景圖與主題色、調整面板透明度等。宿主側通過 lib/index.mjs 提供靜態資源與配置接口，瀏覽器側由 client.js 注入主題 CSS、Live2D 渲染與可視化設置面板。插件在 package.json 中聲明 dshTarget 爲 0.2.1-rc.2，依賴 @deepseek-ai/cordis ^4.0.1，Node >= 18。
核心功能¶
背景與主題¶
- 可配置主強調色（鏈接、高亮、焦點環）、文字相關配色，以及深 / 淺兩套徑向漸變（無背景圖時的回退）。
- 支持背景圖；面板採用半透明毛玻璃效果，側邊欄與對話區可透出背景。
- 字段包括
accent、backgroundImage、backgroundOpacity、gradientDark、gradientLight等，默認值寫在包內assets/config.json。
Live2D 看板娘¶
- 內置 Q 版模型 HK416、Pio（Cubism 2，路徑形如
/dsh-live2d-theme/models/HK416/model.json）。 - 支持眼神跟隨、點擊隨機動作、拖動位置、縮放尺寸、隱藏 / 顯示、在面板中切換模型。
- Cubism 4 模型（目錄內存在
*.model3.json）也可識別；插件啓動時會加載 Cubism Core，2 / 4 均可使用。
自包含與註冊¶
- PIXI、Live2D 運行時、模型與默認背景位於
assets/，不依賴外網 CDN。 cordis.patch.yml在 bundle 層自注冊，即使 profile 的cordis.patch.yml被重寫，也不易丟失插件註冊。
可視化設置面板¶
看板娘區域右上角提供快捷操作：⚙ 打開設置（實時改配色、背景、尺寸、模型，保存寫回配置）；✥ 拖動位置；🙈 隱藏 / 顯示。面板內可上傳本地圖片作爲背景，保存時通過宿主 POST /dsh-live2d-theme/config 寫入 live2\config.json，重啓後仍保留；恢復默認 回到包內內置值。模型列表由 GET /dsh-live2d-theme/models 掃描 live2\models\ 目錄得到。
安裝與啓用¶
方式一：插件管理器（推薦）
在已配置 DSH CLI 的環境下，對 desktop profile 執行：
dsh plugin --profile desktop add github:suwenner/dsh-live2d-theme
也可在 DSH 的「插件」頁面通過插件市場或從倉庫安裝。
方式二：手動放進 profile
- 將插件目錄放到
$DSH_HOME/plugins/dsh-live2d-theme/； - 在
$DSH_HOME/profiles/desktop/package.json的dependencies增加"dsh-live2d-theme": "file:../../plugins/dsh-live2d-theme"，並在dsh.profile.bundles中加入"dsh-live2d-theme"； - 在 profile 目錄執行
pnpm install，然後重啓 DSH。
典型用法¶
用面板改外觀（推薦）¶
安裝並刷新 Web GUI 後，點擊看板娘旁的 ⚙，調整主色、背景透明度、背景圖、看板娘寬高與顯示狀態，點擊 保存 持久化。需要換模型時，在「看板娘模型」下拉框選擇 HK416 或 Pio，或點 ⟳ 重新掃描新放入的模型目錄。
手動編輯 config.json¶
改完保存後刷新頁面即可生效（無需重啓應用）。示例結構如下（字段含義以 README 爲準）：
{
"accent": "#7c5cff",
"backgroundImage": "/dsh-live2d-theme/background/bg.jpg",
"backgroundOpacity": 0.55,
"gradientDark": "radial-gradient(...)",
"gradientLight": "radial-gradient(...)",
"modelUrl": "/dsh-live2d-theme/models/HK416/model.json",
"modelWidth": 260,
"modelHeight": 300,
"marginRight": 18,
"marginBottom": 10,
"visible": true
}
換背景圖時，可將圖片放到 live2\background\bg.jpg，或修改 backgroundImage 指向其他路徑；若文件不存在，會自動回退到漸變背景。
添加自定義模型¶
將完整模型目錄放入 live2\models\<名字>\（含 model.json 或 *.model3.json），在設置面板點 ⟳ 刷新列表。README 提到可從 hacxy/l2d-models 獲取模型資源；使用前請遵守各模型與 assets/README.md 中的許可說明。
適用場景與注意¶
適合誰：使用 DSH desktop Web GUI、希望在本地環境快速換膚並保留可交互看板孃的用戶；分類上屬於「趣味換裝」，不改變 Harness 核心推理邏輯。
權限與安全：插件與當前 DSH 進程同權運行，會提供配置讀寫與背景上傳等接口。安裝前建議閱讀 GitHub 源碼 與 MIT 許可證，確認符合你的環境策略。社區插件目錄 skillhub.cn 獨立於 DeepSeek / 幻方，並非官方應用商店。
卸載：刪除 profile 中手動添加的依賴與 bundle 項並重啓，或直接刪除 $DSH_HOME/plugins/dsh-live2d-theme 目錄即可回滾。
結尾¶
dsh-live2d-theme 把背景主題與 Live2D 看板娘收斂到一個可安裝的 DSH 插件裏，默認資源自包含，並可通過 ⚙ 面板或 config.json 持續調整。進一步瞭解與安裝入口：
- 目錄頁：https://www.skillhub.cn/plugins/suwenner/dsh-live2d-theme
- GitHub：https://github.com/suwenner/dsh-live2d-theme
