# desktop_pet

**Repository Path**: xuscode1/desktop_pet

## Basic Information

- **Project Name**: desktop_pet
- **Description**: desktop_pet
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-09
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 桌面宠物 🐱

一只会跟随鼠标的桌面小猫。

## 安装

```bash
pip install -r requirements.txt
```

## 运行

```bash
python main.py
```

## 功能

- ✅ **鼠标跟随** - 小猫会跟着你的鼠标移动
- ✅ **左右摆动** - 移动时身体会倾斜
- ✅ **上下跳动** - 走路时会上下小跳
- ✅ **方向识别** - 向左/向右走会自动翻转
- ✅ **左键拖拽** - 可以把小猫拖到任意位置
- ✅ **右键菜单** - 快速切换大小 / 退出
- ✅ **桌面透明** - 没有窗口边框, 只显示小猫
- ✅ **窗口置顶** - 一直浮在最前面

## 自定义

修改 `config.py` 可以调整:

| 参数 | 说明 | 默认值 |
|---|---|---|
| `PET_WIDTH` / `PET_HEIGHT` | 宠物大小 (像素) | 120 × 120 |
| `FOLLOW_SPEED` | 跟随速度, 越小越慵懒 | 0.08 |
| `TILT_AMOUNT` | 移动时的倾斜角度 | 15° |
| `BOUNCE_AMPLITUDE` | 上下跳动幅度 | 6 像素 |
| `BOUNCE_SPEED` | 跳动速度 | 0.25 |
| `ASSET_IDLE` | 待机图片路径 | assets/cat_idle.png |
| `ASSET_WALK_LEFT` / `RIGHT` | 走路图片 (右边会自动翻转) | assets/cat_walk.png |

## 替换成你自己的小猫图片

1. 准备一张 **透明背景的 PNG** (正方形最佳)
2. 放到 `assets/` 目录, 命名为 `cat_idle.png`
3. 运行即可

如果你有多张图:
- `cat_idle.png` - 静止待机
- `cat_walk.png` - 走路动画 (会自动水平翻转得到反方向)

> 想用 GIF 动画? 可以把 `pet.py` 中的 `QPixmap` 改为 `QMovie` 来播放 GIF

## 项目结构

```
desktop_pet/
├── main.py          # 主入口
├── pet.py           # 宠物窗口类 (动画/跟随/摆动)
├── config.py        # 配置
├── requirements.txt # 依赖
└── assets/
    ├── cat_idle.png # 待机图 (已生成占位)
    └── cat_walk.png # 走路图 (已生成占位)
```

## 操作

- **左键按住拖拽** → 移动小猫到任意位置
- **右键点击** → 打开菜单 (改变大小 / 退出)
- 鼠标不动 → 小猫站在你旁边轻微呼吸