前言¶
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 环境下获得一致的视觉表现。
