U1s1-king/dsh-live2d-poppinparty

Plugin插件 Native原生 ⭐ 3 Pets & Fun桌宠与娱乐

Poppin'Party Live2D 桌宠插件 for DeepSeek Harness(本地模型,零外部依赖)

Project Overview项目介绍

dsh-live2d-poppinparty is a Live2D desktop pet plugin for the DeepSeek Harness Web GUI. It renders a draggable mascot in the bottom-right corner featuring five Poppin'Party members (Kasumi, Tae, Rimi, Saya, Arisa) with 469 outfit sets. Features include character switching, mouse gaze tracking, idle animations, click interactions, and PNG snapshot capture. Models load from local same-origin assets with zero network requests. Use it to decorate the DSH web interface. Note: models are extracted from the BanG Dream! mobile game and are intended only for personal study and research.

dsh-live2d-poppinparty 是为 DeepSeek Harness Web GUI 设计的 Live2D 桌宠插件,提供右下角可拖拽的看板娘,覆盖 Poppin'Party 五位成员(香澄、たえ、りみ、沙綾、有咲)共 469 套换装,支持角色切换、视线跟随、空闲动作、点击互动与拍照导出,模型本地同源加载、零网络请求。适合 DSH 用户装饰 Web GUI 界面。需注意模型源自邦邦手游解包资源,仅供个人学习研究使用。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:U1s1-king/dsh-live2d-poppinparty

把 U1s1-king/dsh-live2d-poppinparty 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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。
← 上一个 Prev claude-in-dsh 下一个 Next dsh-usage →