@levisbale0824/eason-pet

Readme

# @levisbale0824/eason-pet 🎤🐾

> 一只住在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web 界面里的 **Eason 主题**桌面宠物。
> A floating desktop pet for the DeepSeek Harness Web UI.

## ✨ 功能特性

- **18 个 Eason 专属手绘透明动画**：单手持麦深情演唱、吉他高歌、敲键盘编程、修复 Bug、举牌 ERROR、完成 100 庆祝、枕头睡觉……（v0.3.0 起移除了素材管线混入的非 Eason 角色动画）
- **会话联动**（v0.5.0，默认开）：宠物镜像当前 agent 会话状态——agent 思考时它敲键盘编程、流式输出时单手持麦"演唱"、跑工具时盯等待进度条、等你回答问题时窗口探头张望；turn 跑完插播「完成100庆祝」、出错举牌「举牌ERROR」，播完自动回去上班
- **任我行 / 固定双模式**：默认固定在角落；**右键宠物**即可切换「任我行模式」（随机起身行走，取名自陈奕迅《任我行》）或重置位置，选择持久化在浏览器里
- **永不停止的动画链**：每段动画播完立即按概率选下一个；漫游开启时 30% 待机 / 10% 转向 / 40% 动作 / 20% 移动，关闭时移动份额并入动作
- **点击 / 拖拽**：点击有随机回应（比心 / 飞吻），拖拽时播放"犹豫欲哭"的委屈反应，可拖到任意位置
- **左右朝向**：动画 CSS 镜像，可朝左 / 朝右；方向步行动画按行进方向选用
- **流畅切换、低占用**：双缓冲 video 交叉淡入零空白帧；换下的视频立即暂停解码，宿主启动时全量预热动画进内存
- **无障碍友好**：支持 `prefers-reduced-motion`

## 📦 安装

```sh
dsh plugin --profile web add @levisbale0824/eason-pet
```

重启 `dsh web`，宠物出现在界面右下角。**右键宠物**可打开菜单：切换任我行模式、重置位置。

可与 `dsh-pet` 等其他桌宠插件共存（插件 id、路由前缀 `/eason/`、CSS 类名前缀均独立）。

## ⚙️ 配置

打开 DSH **设置 → 插件**，切换到 **「神经研究所」** tab（排在官方「可配置」「全部」之后）：

| 设置项 | 说明 |
|---|---|
| 显示宠物 | 关闭后隐藏宠物并停止全部视频解码，其余设置保留 |
| 任我行模式 | 即漫游模式，开启后宠物随机起身行走（右键宠物也可快捷切换）；取名自陈奕迅《任我行》 |
| 会话联动 | 宠物镜像当前 agent 会话状态（思考→敲键盘 / 说话→演唱 / 跑工具→进度条 / 等你回答→探头；完成庆祝、出错举牌），联动期间暂停漫游；默认开 |
| 尺寸 | 显示高度滑杆，160–420px，拖动实时预览 |
| 默认角落 | 未被拖拽/漫游时停靠右下角或左下角 |
| 重置位置 | 立即送回默认角落 |

> **命名**：「神经研究所」是陈奕迅歌迷会的昵称（Eason 人称所长）——本插件以它为这只桌宠命名，右键菜单顶部也有同款所名牌。

以上设置持久化在浏览器 localStorage（键 `eason-pet.*`），与右键菜单实时双向同步，刷新/重启后保持。

> 说明：`cordis.patch.yml` 里的 `size` / `position` / `roaming` 配置值目前**不会下发到浏览器**（DSH 客户端配置管线限制），运行时以设置页为准；`fullRoot`（原始 1200×1200 母版目录，默认 `$DSH_HOME/eason-assets`）是宿主侧配置，需手动放置母版后生效。

## 🗑️ 卸载

```sh
dsh plugin --profile web remove @levisbale0824/eason-pet
```

## 🎬 动画一览

全部 18 个 Eason 专属动画见 `assets/thumb/`：待机×1、转向×1、动作×14（含比心/飞吻）、点击回应×2、拖拽×1（复用犹豫欲哭）、步行×2（向左/向右）。

## 🧭 新桌宠制作指导

想自己做一只 DSH 桌宠？[docs/PET-STATE-CATALOG.md](./docs/PET-STATE-CATALOG.md) 是一份状态设计手册：7 个核心状态的最小集、DSH 会话快照里 20+ 个现成扩展信号（含工具特化）、需自行派生的维度（疲劳/入睡/作息等）、宠物自身与环境信号，以及电平 vs 边沿等设计原则和三批次落地顺序建议。

## 📄 许可与致谢

- 代码：MIT
- 动画素材源自 [dsh-pet](https://github.com/PC2005-cloud/dsh-pet) 项目（其素材由 AI 生成管线产出），遵循其仓库声明的素材许可

## 📒 变更历史

见 [CHANGELOG.md](./CHANGELOG.md)。