dsh-live2d-poppinparty

Poppin'Party Live2D 桌宠插件 —— 为 DeepSeek Harness Web GUI 添加可拖拽的 Live2D 看板娘。

收录 Poppin'Party 五位成员的 Live2D 桌宠：戸山香澄（主唱）、花園たえ（吉他）、 牛込りみ（贝斯）、山吹沙綾（鼓手）、市ヶ谷有咲（键盘），合计 469 套换装 （常服 / 校服 / 演出 / 活动 / 生日 / 联动等，取自 BANDORI 独立版全量数据）； 模型本地存储、同源加载，零网络请求。

功能

• 右下角 Live2D 看板娘（5 角色：香澄 / たえ / りみ / 沙綾 / 有咲）
• 拖拽自由移动（位置持久化到 localStorage）
• 角色切换 + 换装面板（469 套换装，中文名显示：常服2023 / 活动41 SR / 泳装2023 / 生日2022 等；角色选择面板显示角色头像）
• 视线跟随鼠标、空闲随机动作/台词气泡、点击互动
• 拍照（下载 PNG 截图）
• 隐藏（右下角 Live2D 悬浮钮恢复）
• 纯 DOM 注入，无 React 依赖；卸载时完整清理（监听/定时器/渲染器/DOM）

安装

dsh plugin --profile web add D:\dsh\dsh-live2d-poppinparty

然后重启 dsh web（或热加载 client bundle），硬刷新页面。

结构

package.json            dsh.bundle.patch / dsh.client(platform: web) / exports["./client"]
cordis.patch.yml        补丁层：insert 一行 host 插件
build/
  tsdown.client.ts      client bundle 构建预设（镜像官方 tsdown.client.ts 协议）
  web-platform.ts       平台模块表（与 shell seed 一致）
src/
  index.ts              host 半区：导出 name/apply，注册 /pp-assets/* 同源静态路由
  routes.ts             静态路由（vendor / waifu.css / 角色图标 / 模型），路径防越界
  client/
    index.ts            浏览器半区：ctx.effect 持有启动/清理，注入样式 + 按序加载运行时
    waifu/              widget 源码（改造：vendor 全局惰性解析、生命周期可清理）
assets/
  vendor/               pixi.min.js (PIXI 6.5.2) / live2d.min.js (Cubism 2.1 框架) /
                        live2d-display.cubism2.min.js (pixi-live2d-display 0.4.0 cubism2 版)
  waifu.css             桌宠样式（注入时叠加高 z-index 覆盖）
  assets/               角色头像（chara_icon_14/38/31/34/3.png = 香澄/たえ/りみ/沙綾/有咲）
  model/                模型资源（5 角色 × 469 套，Cubism 2，约 700MB）

开发

pnpm install
pnpm build        # tsdown 双产物：lib/index.js (host) + lib/client.js (browser)

改代码后：pnpm build → 重启 dsh web → 硬刷新页面。 （若 bundle 内容无变化仍未生效，完全重启 dsh web。）

规范说明

• host 半区为函数插件四要素的子集：导出 name 与 apply（无用户可配置项，故省略 Config）；webServer 为必需服务，经 ctx.inject(['webServer'], cb) 声明后使用， 路由注册的 disposer 包进 ctx.effect，卸载/HMR 自动清理。
• client 半区全部副作用（DOM、监听、定时器、PIXI 渲染器）随 fiber dispose： apply 内整体注册为 ctx.effect，返回 disposer 全量回收。
• 浏览器半区只 import 自身模块与类型（@deepseek-ai/cordis 仅 type-only）， 不越过平台模块表，无跨插件值导入。
• 静态路由前缀使用 /pp-assets（与 dsh-live2d-mygo 的 /pet-assets 区分， 两插件可同时安装互不冲突）。
• 分发采用「lib 产物提交进 Git」策略（与 dsh-gbc-ui 一致）：无 prepare 脚本， dsh plugin add github:... 免 allowBuilds 直装。

说明

• 模型为邦邦（BanG Dream!）手游解包资源（源自 D:\za\GitHub\Live2D 自包含版 model-data，编号 003/014/031/034/038），仅供个人学习研究使用。
• 台词包按 5 角色人设撰写（香澄 kirakira 元气 / たえ 天然呆 · 动物与星空 / りみ 害羞结巴 / 沙綾 温柔面包店 / 有咲 傲娇键盘手）。
• 渲染栈：pixi-live2d-display（Cubism 2）× PIXI 6.5.2，与自研 widget 一致。 Cubism 2.1 链只需 live2d.min.js（框架）+ cubism2 版 display，无需 Cubism Core。