← 返回列表
⚠ 装前注意
deepseek-harness对live2d的支持
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/9/12 · 已提供中文文档
综合分
30.8
GitHub 分
30.8
用户评分
—
★ Stars
2
周下载量
—
兼容 / 相关生态插件（非 dsh 原生，请按其对应运行时安装）
git clone https://github.com/lrplrplrp/dsh-live2d.git信任档位：已验证本站已于 2 天前真实安装成功（L4 · 真实安装）
- 是什么
- 生态插件（可安装，未声明 dsh 能力）
- 装得上吗
- 本站已真实安装成功（L4 · 真实安装，非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 13 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/23
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/19（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包@lrplrplrp/dsh-live2d（未发布到 npm，仅可源码安装）
✓Node 引擎要求 >=22.19 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/20 15:21:15
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成DSH Live2D 看板娘 🎭
在 DeepSeek Harness Web GUI 中渲染可拖动的 Live2D 模型，由 DSH 真实工作状态实时驱动动画，并支持眼睛跟随鼠标。
English · GitHub · Awesome DSH Plugin
预览图
功能
- 🎭 Live2D 模型渲染 — 在 DSH Web GUI 中显示 Live2D 看板娘
- 🖱️ 拖拽移动 — 通过右下角拖拽图标移动看板娘，位置自动保存
- 🎡 滚轮缩放 — 鼠标滚轮实时缩放模型大小，缩放自动保存
- 📐 画布大小调整 — 悬停画布时显示右下角手柄，拖动改变画布尺寸
- 👀 眼睛跟随鼠标 — 模型视线随光标移动（可在设置页开关）
- 🎬 DSH 状态驱动动画 — 基于 Agent 状态（思考/工作/完成/错误）实时切换对应动画
- ⚡ 实时推送 — 状态变化通过 SSE 即时推送，动画切换零延迟
- 📦 内置默认模型 — 开箱即带的 DeepSeek Live2D 模型与完整动画映射，安装即可用
- 📂 模型目录自动扫描 — 把 .model3.json 模型文件夹放进 assets/ 即被自动识别
- ⚙️ 完整设置页 — DSH 设置面板中的 Live2D 配置页面
安装
1. 完全退出 DSH
关闭 DSH Host（不只是浏览器标签页）。
2. 命令安装
从本地目录安装（开发/调试）
dsh plugin --profile web add link:/path/to/dsh-live2d
3. 启动 DSH
dsh web
启动后看板娘会自动出现在页面左下角，并以内置的 DeepSeek 模型与动画映射运行。
交互说明
| 操作 | 方式 |
|------|------|
| 移动看板娘 | 拖动右下角的 ✥ 拖拽图标 |
| 缩放模型 | 鼠标滚轮（悬停在拖拽图标上滚动） |
| 调整画布大小 | 鼠标悬停画布时，拖动右下角的蓝色边角手柄 |
| 眼睛跟随 | 全局开启，视线自动看向光标；可在设置页关闭 |
模型与动画配置
配置保存在浏览器 localStorage（key: dsh-live2d.v1），也可在 DSH 设置 → Live2D 看板娘 中可视化编辑。
内置默认动画映射
插件内置的 DeepSeek 模型已预置以下映射，安装即可使用：
| DSH 状态 | 说明 | 默认动画 |
|---------|------|---------|
| IDLE | 空闲待机 | Idle 组 motion |
| THINKING | Agent 开始思考 | Anima 组 thinking motion |
| THINK_END | 思考结束，准备输出 | Anima 组 thinkend motion |
| WORKING | 工具调用中 | Anima 组 speak motion |
| SPEAKING | 开始输出对话内容 | Anima 组 speak motion |
| SUCCESS | 任务完成 | happy 表情 |
| ERROR | 任务出错 | unhappy 表情 |
每个模型可独立配置：
- motion: { "group": "组名", "index": 0 } — 播放动作（index 为组内序号，留空随机）
- expression: "表情名" — 设置表情
添加本地模型
1. 将含 .model3.json 的模型文件夹复制到插件的 assets/ 目录下（如 assets/my_model/）。
2. 打开 DSH 设置 → Live2D 看板娘，点击「刷新模型列表」。
3. 模型即出现在列表标签中，可在下方配置其动画映射。
无需手动编辑路径——扫描自动识别 assets/ 下所有子目录中的 model3.json。
通用设置
设置页顶部「通用设置」卡片提供：
- 眼睛跟随鼠标 — 勾选后模型视线随光标移动；关闭后视线回到正中。开关即时生效并持久化。
与原项目的关系
本插件基于 lrplrplrp/live2d 改造，移除了对话框、小游戏、外部 API 等，新增了 DSH 状态驱动、拖拽/缩放/画布调整、眼睛跟随、实时推送等能力，并深度集成 DSH 设置页。
技术栈
- PIXI.js 7.x — 2D 渲染引擎
- pixi-live2d-display — Live2D Cubism SDK for Web（含 model.focus 视线跟随）
- DSH 插件系统 — window.__ModuleLoader__ + ctx.slots + webServer SSE
开发与源码结构
host 端只读取单个 lib/client.js 原样投递给浏览器（无打包器，客户端 require
无法加载本地文件）。因此客户端源码按功能拆分在 lib/src/，由构建脚本拼接生成
投放产物：
lib/
index.js # host 端（Node ESM）
shared/states.js # DSH 状态常量单一来源（host import，client 构建时内联）
src/ # 客户端源码分片（按文件名前缀顺序拼接）
00-header.js # 文件头 + window.__ModuleLoader__ 包装 + React
10-config.js # 常量、默认配置、localStorage 持久化
20-libs.js # 本地库加载 + 音频解锁
30-css.js # CSS 注入
40-engine.js # Live2DEngine（渲染/动画/时间映射/点击命中）
50-drag.js # 拖动与画布大小控制手柄
60-state.js # DSH 状态订阅（SSE + 轮询兜底）
70-widget.js # 主组件（画布悬浮控制图标等）
80-settings.js # 设置页
90-apply.js # 插件入口（slot 注入）
client.js # ⚠️ 构建产物，请勿直接编辑
修改源码后必须重新构建：
bash
npm run build # 生成 lib/client.js
npm run check # 校验产物与源码一致 + 语法检查
许可证
MIT