前言¶
DeepSeek Harness 的 Web 界面默認以簡潔爲主。爲了豐富界面的視覺體驗和交互感，可以在頁面右下角添加一個 Live2D 角色。dsh-live2d 是一個爲此目的設計的插件，它無需手動編寫前端代碼，即可在 DSH Web 界面中集成 Live2D 看板娘。
插件介紹¶
dsh-live2d 是一個用於 DeepSeek Harness Web 界面的 Live2D 寵物伴侶插件。該插件由 hacxy 維護，屬於趣味換裝類別。它解決了在 Web 界面中直接嵌入 Live2D 模型並對其進行可視化管理的問題。
核心功能¶
插件具備以下能力：
- 右下角 Live2D 角色：默認在網頁右下角渲染 Live2D 角色。
- 加載進度條：模型資源下載時顯示進度，加載完成自動隱藏。
- 可拖拽：角色支持拖拽，可放置在屏幕任意位置。
- 全量配置 Web 化：13 個字段（包括模型地址、尺寸、位置、縮放、透明度、層級、音量等）均在 Web 設置界面調整。
- 跟隨主題：設置面板配色與 DSH 界面（淺色/深色）自動保持一致。
- 零依賴安裝：Live2D 運行時已打包進插件包，安裝後無需額外依賴。
- 配置安全：多開頁面或外部修改配置時，會自動刷新爲最新值，避免配置衝突。
- 模型支持：支持任意
.model.json（Cubism 2）與.model3.json（Cubism 6）格式。
安裝與啓用¶
使用官方 CLI 安裝插件，無需額外操作。
dsh plugin --profile web add dsh-live2d
dsh web
安裝完成後，啓動 DSH Web 界面即可看到角色。
使用方法¶
- 打開 DeepSeek Harness Web 界面。
- 點擊左下角側邊欄的「設置」。
- 在設置列表中選擇「Live2D」。
在設置面板中，你可以進行以下操作：
- 保存即生效：修改尺寸、位置等參數並保存後，改動會原地應用；修改模型地址並保存後，會自動重載模型。
- 恢復默認：點擊「恢復默認」可一鍵清除自定義配置，回到部署默認值。
- 實時同步：其他標籤頁或外部對配置文件的修改，會自動熱更到所有已打開的頁面。
注意事項¶
- 零模型資源：插件不包含、不分發任何 Live2D 模型資源。用戶需自行提供合法的模型文件。
- 商用許可：若用於商用，需遵循模型本身的許可協議以及 Live2D 的專有軟件許可協議。
結語¶
dsh-live2d 通過 Web 化配置和零依賴設計，爲 DeepSeek Harness Web 界面提供了快速添加 Live2D 角色的方案。適合希望在開發或交互過程中增加趣味性的用戶。
