前言¶
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 角色的方案。适合希望在开发或交互过程中增加趣味性的用户。
