前言¶
DeepSeek Harness（DSH）通過插件化架構擴展功能。對於希望在對話界面獲得更直觀、沉浸式視覺反饋的開發者或用戶，現有的純文本或靜態展示往往難以滿足需求。dsh-live2d-avatar 插件正是爲了解決這一視覺呈現問題而生，它將 Live2D 角色形象引入 DSH 的對話流程中。
插件介紹¶
dsh-live2d-avatar 由開發者 clown139880 維護，採用 MIT 許可證。該插件爲 DSH 提供了可切換的 Live2D 對話舞臺、軌跡展示和桌寵模式。
核心功能聚焦於視覺表現和可選的語音交互，它不替代 DSH 的對話邏輯、Agent、記憶、工具或歷史記錄。插件內置了可公開使用的 Live2D Haru 示例模型，同時也支持用戶導入自己的 Cubism 2/3+ 模型。
核心功能¶
視圖與舞臺¶
插件提供三個主要視圖：對話、軌跡和形象。其中「形象」視圖提供 Live2D 舞臺，用於展示角色。
模型支持¶
- 內置模型：安裝後即可看到內置的 Live2D Haru 示例模型。
- 自定義模型：支持用戶導入自己的 Cubism 2/3+ 模型。在「形象」設置中可配置模型目錄、入口文件（如
.model.json或.model3.json）以及縮放和位置。模型文件也可以直接放置在插件的assets/models/<名稱>/目錄下。
桌寵模式¶
- Web 模式：在普通的
dsh web中，桌寵顯示爲頁面內可拖動的浮層。 - Desktop 模式：在 TokensCowork Desktop 中，插件可以創建透明、無邊框、置頂的獨立窗口。當主窗口最小化或被遮擋時，角色仍會顯示在桌面上。如果原生窗口不可用，會自動退回頁面內桌寵。
可選功能¶
- 表情控制：提供可選的表情控制 prompt，允許 LLM 在臺詞前輸出動作指令。首次安裝默認關閉，並支持按對話授權。
- 語音服務：ASR（語音轉文字）和 TTS（文字轉語音）默認關閉，不影響沒有配置語音服務的用戶使用視覺功能。如需啓用，需填寫 HTTP API 地址，密鑰通過 DSH host 的環境變量讀取。
安裝與啓用¶
安裝插件需要使用 DSH 的命令行工具。
dsh plugin --profile web add dsh-live2d-avatar
dsh web
安裝完成後，打開一個非空對話，在界面中選擇「形象」即可看到內置的 Haru 模型。
使用說明¶
配置模型¶
若要使用自定義模型，進入「形象」設置頁面。在此處指定模型目錄、相對路徑的入口文件，並調整縮放和位置。由於模型文件會由 DSH 服務提供給瀏覽器，請務必選擇包含專用模型文件的目錄，避免意外暴露本地隱私文件。
卸載插件¶
如需移除插件，執行以下命令：
dsh plugin --profile web remove dsh-live2d-avatar
注意事項¶
- 授權與依賴：內置 Haru 模型使用 Live2D 的 Free Material License，其授權不包含在本項目 MIT 許可證中，請閱讀
assets/models/haru/NOTICE.md瞭解詳情。 - WebView2 依賴：桌面端獨立窗口功能依賴 WebView2。插件隨包分發了
Microsoft.Web.WebView2版本1.0.3595.46的 DLL，但 Windows 系統仍需安裝 WebView2 Evergreen Runtime。 - 隱私與安全：
- API 密鑰不會填寫到瀏覽器設置中，僅從環境變量讀取。
- 語音服務爲用戶自部署或自行信任的服務，插件不代替用戶判斷其隱私策略。
- 功能定位：該插件僅負責視覺表現和可選語音交互，不處理對話、記憶等核心邏輯。
總結¶
dsh-live2d-avatar 是一個專注於 Live2D 視覺體驗的 DSH 插件。它通過提供對話舞臺、軌跡展示和桌寵模式，增強了用戶與 AI 的交互臨場感。無論是使用內置的 Haru 模型還是導入自定義模型，都能在 Web 或 TokensCowork Desktop 環境下獲得一致的視覺表現。
