Tisitan/dsh-live2d-companion ↗★ 3
dsh-live2d-companion
Live2D companion for DeepSeek Harness: 8-state AI status lamp, web widget, and always-on-top desktop pet with expressions, motions and bubbles
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Tisitan/dsh-live2d-companion说明文档
阅读完整 README ↗配置
patch config(cordis.patch.yml)
| 键 | 默认 | 说明 |
|---|---|---|
model | nori/ARGNori.model3.json | 模型路径(相对 public/model/) |
widget | true | 是否向 DSH 页面注入网页挂件 |
pet | false | 是否随 DSH 自动拉起桌面桌宠 |
petDir | ./pet | Electron 壳目录 |
quips.json(前端热重载,30 秒内生效)
| 区 | 说明 |
|---|---|
rotation | 台词节奏:holdMs(单句停留)/ intervalMs(轮换间隔)/ doneHoldMs |
behavior | 行为阈值:sleepAfterMs(闲置入睡)/ seriousAfterMs(加班严肃脸)/ overtimeAfterMs(加班焦虑) |
pools | 15 个台词池:thinking/working/done/waiting/error/overtime/sleeping/click/pat/drag/greet/greet_morning/greet_night/idle/busy |
模型切换也可以不改配置:URL 加 ?model=/xxx.model3.json 临时指定。
第一级:自动嗅探(零配置)
启动时前端会拉取模型的 .model3.json,解析 FileReferences 里的表情/动作清单,按关键词模糊匹配槽位(如文件名含 shy/害羞 → 害羞位,含 nod → 点头位)。任何命名规范的 Cubism 模型丢进来即可获得完整情绪表现;匹配不到的槽位静默跳过,不会报错。
🌐 生态惯例兼容:自动呼吸依赖官方示例框架的
Idle组惯例(绝大多数模型遵守);点击反应池优先取官方示例惯例的Tap*/Reaction/Touch组并自动剔除生气动作。Live2D 官方并不规定动作组/表情的语义命名,故无标配模型一律可用下方编辑器手动绑定。