Tisitan/dsh-live2d-companion3

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

包名
dsh-live2d-companion
版本
1.1.0
许可证
MIT
最近更新
2026年8月16日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Tisitan/dsh-live2d-companion

配置

patch config(cordis.patch.yml

默认说明
modelnori/ARGNori.model3.json模型路径(相对 public/model/
widgettrue是否向 DSH 页面注入网页挂件
petfalse是否随 DSH 自动拉起桌面桌宠
petDir./petElectron 壳目录

quips.json(前端热重载,30 秒内生效)

说明
rotation台词节奏:holdMs(单句停留)/ intervalMs(轮换间隔)/ doneHoldMs
behavior行为阈值:sleepAfterMs(闲置入睡)/ seriousAfterMs(加班严肃脸)/ overtimeAfterMs(加班焦虑)
pools15 个台词池: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 官方并不规定动作组/表情的语义命名,故无标配模型一律可用下方编辑器手动绑定。