dsh-live2d-hhw

Readme

# dsh-live2d-hhw

**Hello, Happy World!（HHW）Live2D 桌宠插件** for [DeepSeek Harness](https://github.com/deepseek-ai)（本地模型同源加载，零外部依赖）。

## 收录

**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-*`，互不干扰）

## 安装

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

或从 GitHub 安装：

```bash
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 吐槽役）