前言¶
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 场景里做趣味换装式交互增强。
