dsh-yiyi-pet

Readme

# dsh-yiyi-pet · 狼兔一一任务宠物

DSH Web GUI 的桌面宠物插件。右下角悬浮一只会在狼狼 🐺 / 兔兔 🐰 / 一一 🐣 之间切换的小宠物，狼、兔各有**全套 16 个表情**，表情会随 Agent 任务状态自动变化，也能展开表情包手动挑选。

## 特性

- **三角色切换**：狼狼 / 兔兔 / 一一，一键切换，选择存 `localStorage`（刷新后保留）。
- **全套表情包**：狼、兔各 16 个表情（默认 / 微笑 / 担心 / 爱心 / 墨镜 / 大哭 / 生气 / 大笑 / 好奇 / 难过 / 嚎哭 / 开心 / 晕了 / 思考 / 恳求 / 含泪）。
- **随任务变化**：表情跟随 Agent 阶段自动切换——
  - 待命 → 默认 · 思考 → 🤔思考 · 干活（调用工具）→ 🛠️好奇 · 完成 → 🎉开心 · 失败 → 😢大哭
- **手动挑表情**：狼、兔模式下点「😊 表情」展开 16 格表情网格。
- **一键隐藏**：点卡片右上角「—」收起为右下角小圆头像（保留当前表情），点小圆头像即可恢复；隐藏状态存 `localStorage`，刷新/重启后保持。
- **自由拖动**：按住卡片（或收起态小圆头像）即可拖到桌面任意位置，自动限制在视口内，位置存 `localStorage`，刷新/重启后保持；**双击卡片**回到默认右下角位置。
- **离线可用**：全部资源持久化打包在包内 `assets/`，由 Host 同源路由 `/yiyi-pet/assets/…` 提供，不依赖公网。

## 安装

### 从插件市场安装

在 DSH 的「插件市场」中搜索 **yiyi-pet** 安装（或 `dsh plugin --profile web add dsh-yiyi-pet`），重启 harness 后生效。

### 手动安装

```bash
dsh plugin --profile web add scubiry-glitch/dsh-yiyi-pet
# 或本地路径
dsh plugin --profile web add /path/to/dsh-yiyi-pet
```

## 目录结构

```
dsh-yiyi-pet/
├─ package.json
├─ cordis.patch.yml
├─ lib/
│  ├─ index.js      # Host：状态路由 + 静态资源路由 + 任务阶段监听
│  └─ client.js     # 客户端：宠物卡片、切换、表情包
└─ assets/          # 狼/兔 16 表情 + 一一头像（持久化打包）
```

## 资源来源与授权

- 代码：MIT（见 LICENSE）。
- 狼、兔表情精灵与一一小鸟：来自狼兔养成小游戏 `couple-game`（`birds-ref/Game/sprites`），用于非商业演示，版权归原游戏作者所有。
- 一一头像：用户提供的本地图片，已去除顶部水印。

## 说明

- 阶段快照轮询自 `GET /api/yiyi-pet/state`（同源，无需额外配置）。
- 若与同名悬浮宠物插件共存，两者都占用右下角，建议只启用一个。