前言¶
DeepSeek Harness（DSH）把對話、渲染和會話 UI 拆成可組合的插件。純文字或靜態頭像很難讓人感知模型當前是在解釋、驚訝還是在打趣。社區裏也有外掛渲染進程、獨立 Mac 客戶端一類做法，部署和維護成本更高。
dsh-plugin-lumi-avatar 是面向 web profile 的伴侶插件：保留 Lumi 角色資源，內置渲染與協議橋接，根據會話上下文切換表情與動作，並按文本節奏驅動口型。下面介紹它是什麼、能做什麼，以及如何安裝與使用。
這是什麼¶
Lumi Companion for DeepSeek（倉庫名 dsh-plugin-lumi-avatar）由 lazyalexander 維護，歸類爲趣味換裝類 DSH 插件。一句話定位：原生 DSH 伴侶插件，帶捆綁的角色表達、動作與客戶端渲染，對對話上下文做情緒與口型反饋。
- 目錄頁：https://www.skillhub.cn/plugins/lazyalexander/dsh-plugin-lumi-avatar
- 源碼：https://github.com/lazyalexander/dsh-plugin-lumi-avatar
- 插件包版本（
package.json）：0.4.4 - 代碼許可證：MIT；角色插畫：CC BY-NC-SA 4.0（詳見倉庫
ASSET-NOTICES.txt與docs/character-attribution.md）
本文爲獨立社區項目說明，不等同於 DeepSeek 或幻方官方產品；DSH 生態奉行「一切皆插件」，社區目錄站點與官方無從屬關係。
核心功能¶
資料中已覈實的能力如下。
- 上下文情緒與動作：支持 explanation、joy、laughter、seriousness、surprise、cuteness、idle，含狀態過渡、打斷與口型復位。
- 口型與文本節奏：對真實 DeepSeek 回覆做與文本節奏同步的嘴部動畫（無 TTS、無攝像頭追蹤）。
- 內置 web 渲染：首次安裝會下載角色資源；插件在 loopback 地址提供角色服務，DSH 銷燬時自動停止。無需 npm 賬號、獨立 Mac 應用或額外渲染進程（GitHub 安裝使用預構建客戶端，README 未要求額外 prepare 構建）。
- DSH 集成：通過
lumi.overlay.yml注入會話側欄等 UI 模塊；複用 DSH 裏已有的 DeepSeek 配置，API 費用由你的賬號承擔。
角色與動作來源、渲染協議見倉庫 docs/（如 renderer-protocol.md、motion-sources.md）。
環境要求¶
README 寫明（其他版本未驗證）：
- DeepSeek Harness 0.2.2-rc.1
- Node.js 24.9+，以及 DSH 所要求的 pnpm
- 支持 WebGL 的瀏覽器
- 可用的 DeepSeek 配置
package.json 中 engines.node 爲 >=24.9.0，依賴 @deepseek-ai/dsh-tools 0.2.2-rc.1。
安裝與啓用¶
從 GitHub 安裝¶
在已安裝 DSH 的前提下，執行：
dsh plugin --profile web add github:lazyalexander/dsh-plugin-lumi-avatar
再用同一 profile 重啓 DSH：
dsh --profile web
在對話頁點擊 Lumi 打開頭像側欄。若你使用的不是 web profile，將上述命令中的 profile 名換成你現有的名稱。
側欄按鈕未出現時¶
將倉庫中的 lumi.overlay.yml 保存到本地後執行：
dsh --profile web --patch ./lumi.overlay.yml
同樣按需替換 web。
從插件市場索引安裝¶
在 DSH 中：Plugins → Discover → Add index source（若缺少 Discover，需先在 Experimental plugins 中啓用 Custom plugin index），添加索引：
https://lazyalexander.github.io/dsh-plugin-lumi-avatar/index.json
從列表安裝 Lumi Avatar；與上述 Git 安裝爲同一 bundle，索引指向已發佈 commit。
典型用法¶
- 完成安裝並
dsh --profile web（或你的 profile）啓動。 - 打開 DSH 對話頁，點擊 Lumi 打開右側頭像欄。
- 正常與 DeepSeek 對話；插件根據上下文切換表情與上半身動作，回覆過程中口型隨文本推進，結束後口型回零。
README 中的 Validation 記載：在全新隔離 web profile 下從 GitHub 安裝、側欄自動激活無需額外 overlay、真實 DeepSeek 回覆下口型動畫與回零均已驗證；本地 12 項測試通過（含無損模型服務、路徑隔離、打斷與播放完成）。平臺註明在 Apple Silicon Mac 上測試，其他平臺未驗證。
替代安裝方式（獨立 Mac 應用）見 docs/install-macos.md，本文不展開。
適用場景與注意¶
適合誰：希望在 DSH web 對話界面裏增加可感知情緒與肢體反饋、又不想單獨起渲染進程或額外客戶端的開發者與個人用戶。
務必注意：
- 插件權限：插件隨當前 DSH 進程與用戶權限運行。安裝前應閱讀倉庫源碼與 MIT / CC BY-NC-SA 4.0 條款；角色二次分發、商用或併入其他作品前須覈對各原始授權（README Credits 一節有角色、頭部模型與自研動作說明）。
- 費用與配置：沿用 DSH 內 DeepSeek 配置，調用 API 計入你的賬戶。
- 能力邊界：不提供 TTS 與攝像頭追蹤；情緒集與動作集以 README 列出的爲準。
結尾¶
lazyalexander/dsh-plugin-lumi-avatar 把 Lumi 角色、上下文情緒與 web 側欄渲染收進一個 DSH 插件，安裝命令與 overlay 補丁均在 README 中給出，適合在 Harness web 場景裏做趣味換裝式交互增強。
