U1s1-king/dsh-live2d-hhw

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

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH), adding an interactive Live2D desktop pet based on the Hello, Happy World! (HHW) band from the mobile game BanG Dream! (Bandori). It includes all five members of the band: Kokoro Tsurumaki, Kaoru Seta, Hagumi Kitazawa, Kanon Matsubara, and Misaki Okusawa, with a total of 429 unique costume sets built on the Cubism 2 framework. All model assets total around 1.3GB, extracted from the official Bandori standalone app data, and run fully offline with no external dependencies after installation. To install, you can run the DSH CLI command dsh plugin --profile web add "github:U1s1-king/dsh-live2d-hhw#main" to pull directly from GitHub, or add a local clone manually before starting DSH Web.

The plugin displays the interactive Live2D character anchored to the bottom right corner of the DSH Web interface, and users can drag it anywhere on the screen to adjust its position. It includes a dedicated panel for switching between characters and changing costumes, with access to all regular, event, birthday, and holiday limited costumes. The pet responds to clicks, petting, and dragging with interactive animations, and will trigger character-specific dialogue, emotes, greetings, and holiday wishes based on the current season, time of day, and user input. It automatically saves the character’s position and display state between sessions, using dedicated localStorage keys that avoid conflicts with other installed DSH pet plugins.

The plugin follows DSH plugin conventions, using a dedicated /hhw-assets route prefix that keeps it separate from other Bandori pet plugins like Roselia, MyGO, and RAS. All original model data from the Bandori app has been converted and adjusted to work properly with this plugin, so no additional setup or model downloads are required after installation. The dialogue is written to match each character’s canonical personality: KOKORO is happy-go-lucky, KAORU is dramatic, HAGUMI is upbeat, KANON is shy, and MISAKI is the snarky straight man. It runs fully offline once installed, so there are no ongoing data usage costs or privacy risks from external network calls.

这是一个专为DeepSeek Harness(DSH)开发的原生Live2D桌宠插件,主题为《BanG Dream!》中的Hello, Happy World!(HHW)乐队。插件包含乐队全部五位成员:弦卷心、濑田薰、北泽育美、松原花音、奥泽美咲,共计429套换装资源,基于Cubism 2开发,总模型资源约1.3GB。所有模型都取自BanG Dream独立版数据,完全本地运行,无需外部联网依赖。

插件核心功能是在DSH Web界面右下角展示可互动的Live2D看板娘,支持拖拽移动位置,提供角色切换和换装面板,包含全部常规、活动、生日、节日限定服装。桌宠支持点击、抚摸、拖拽等互动操作,会根据季节、时刻、用户操作触发对应表情包、问候台词和节日祝福,还能自动记忆模型位置和显示状态。存储使用独立键名,和其他桌宠插件互不干扰。

安装方式可直接通过DSH CLI从GitHub拉取,也可本地添加后启动DSH Web即可使用。插件使用独立路由前缀和localStorage键空间,支持和Roselia、RAS等其他BanG Dream桌宠插件同时共存不冲突。所有模型都已经过转换适配,不需要额外下载依赖,开箱即用,完全离线运行满足隐私需求。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
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-hhw#main"

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

READMEREADME

dsh-live2d-hhw

Hello, Happy World!(HHW)Live2D 桌宠插件 for DeepSeek Harness(本地模型同源加载,零外部依赖)。

收录

Hello, Happy World!:弦卷心 KOKORO(主唱)、濑田薰 KAORU(吉他)、北泽育美 HAGUMI(贝斯)、松原花音 KANON(鼓手)、奥泽美咲 MISAKI(键盘·米歇尔),合计 429 套换装(Cubism 2,约 1.3GB 模型资源)。

模型取自 BANDORI 独立版 Live2D 数据(D:\za\文件\models 的 zst 包,编号 009/012/013/015/022),与 Roselia / Poppin'Party / RAISE A SUILEN 插件同源;本地模型 + 本地运行时,完全离线。

功能

  • 右下角 Live2D 看板娘(5 角色:KOKORO / KAORU / HAGUMI / KANON / MISAKI),支持拖拽
  • 角色切换 + 换装面板(429 套换装,含全部 Live/活动/生日/节日服装)
  • 桌面宠物(点击 / 抚摸 / 拖拽互动)
  • 表情包 + 每日问候 + 节日祝福(按季节 / 时刻 / 操作触发台词)
  • 模型位置、显示状态自动记忆(独立 localStorage 键 hhw-waifu-*,互不干扰)

安装

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

或从 GitHub 安装:

dsh plugin --profile web add "github:U1s1-king/dsh-live2d-hhw#main"

结构

src/
  index.ts          # host 半区:cordis 插件入口(inject webServer)
  routes.ts         # 静态资源路由(/hhw-assets)
  client/
    index.ts        # client 半区:__ModuleLoader__ 挂载 + VENDOR 加载
    waifu/
      characters.js # 角色元数据(KOKORO / KAORU / HAGUMI / KANON / MISAKI)
      config.js     # 通用配置(状态 / 位置 / 面板)
      modelList.js  # 模型列表(由 assets/model 生成,5 角色 × 429 套)
      tips.js       # HHW 台词包(5 角色人设台词)
      model.js      # Live2D 模型加载(index.json + 动作过滤)
      tools.js      # 工具按钮(换装 / 拍照 / 信息 / 退出)
assets/
  model/            # 模型资源(009_* HAGUMI / 012_* KANON / 013_* KAORU / 015_* KOKORO / 022_* MISAKI)
  vendor/           # live2d.min.js / pixi.min.js / live2d-display.cubism2.min.js
  waifu.css         # 桌宠样式(右上角定位 + z-index 防遮挡)
  character.png     # 角色图
  assets/           # 角色头像(chara_icon_9/12/13/15/22.png)

说明

  • 路由前缀:/hhw-assets(与 Roselia /ro-assets、MyGO /pet-assets、RAS /ras-assets 互不冲突,可多插件共存)
  • localStorage:使用 hhw-waifu-display / hhw-waifu-pos 独立键,与其他桌宠插件隔离
  • 模型来源:BANDORI 独立版全量数据(zst 压缩包解压转换),model.json → index.json
  • 台词包:按 5 角色人设撰写(KOKORO 快乐主义 / KAORU 戏剧王子 / HAGUMI 元气少女 / KANON 胆小害羞 / MISAKI 吐槽役)
← 上一个 Prev dsh-desktop 下一个 Next dsh-client-ui-trace-graph →