DeepSeek Harness plugin

dsh-live2d-poppinparty

Poppin'Party Live2D 桌宠插件 for DeepSeek Harness:本地模型同源加载、拖拽/换装/拍照/台词气泡

Jump to install

Source facts

Repository
U1s1-king/dsh-live2d-poppinparty
Latest update
Aug 17, 2026
Category
Just for Fun
GitHub stars
2
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/U1s1-king/dsh-live2d-poppinparty
Plugin: dsh-live2d-poppinparty
Author: U1s1-king

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

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 半区为函数插件四要素的子集:导出 nameapply(无用户可配置项,故省略

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。