dsh-live2d-widget

DSH（DeepSeek Harness）客户端插件：把「三月七」Live2D 看板娘挂件嵌入 Web GUI——角落悬浮、可交互，并实时播报会话状态。

特性

• 🎭 Live2D 渲染：三月七模型（Cubism 5 / WebGL2），眨眼、呼吸、待机动作、表情
• 📍 角落挂件：可拖拽、缩放、靠左/靠右定位（右下角溢出不遮挡对话）
• ✦ 扇形工具菜单：悬浮球展开 135° 扇面（切换模型 / 换装 / 表情 / 截图 / 一言 / 设置 / 隐藏）
• 💬 气泡提示：欢迎语 + 定时提示 + 一言（hitokoto），口型跟随打字机逐字张合
• 🔔 会话状态通知栈：会话完成 / 权限申请（ask_user_question）气泡播报，点击跳转对应会话；通知期间自动暂停一言，全部已读后恢复
• 👀 视线跟随：眼/头跟随鼠标（可开关）
• ⚙️ 设置面板：跟随鼠标 / 拖拽 / 气泡提示 / 定时间隔 / 会话提醒 / 尺寸缩放等开关

安装

dsh plugin --profile web add @liuyidong/dsh-live2d-widget

在 ~/.dsh/profiles/web/cordis.patch.yml 里注册：

- insert:
    - id: live2d-widget
      name: '@liuyidong/dsh-live2d-widget'

重启 dsh web，访问 http://127.0.0.1:3080/ 即可看到看板娘。

开发

插件自包含看板娘构建产物（dist/），发布前需先构建并同步：

# 构建看板娘（monorepo 的 app 目录）
cd app && npm run build:prod

# 同步产物进插件包（dsh-plugin 目录，prepublishOnly 也会自动执行）
cd ../dsh-plugin && npm run sync-dist

本地开发时，插件 lib/index.js 会优先读包内 dist/，找不到则回退到 monorepo 的 app/dist，因此直接用软链 + 回退路径即可热开发，无需每次同步。

注意

• 角色「三月七」版权归 miHoYo 所有，仅限个人学习，勿商用。
• Live2D Cubism SDK 遵循 Live2D Open Software License，Cubism Core 遵循 Proprietary License。