# desktop_pet

**Repository Path**: liangwei0501/desktop_pet

## Basic Information

- **Project Name**: desktop_pet
- **Description**: oo宠物【支持智能回复模式】旨在为用户提供可爱的桌面宠物，支持自定义宠物行为和外观，增强桌面互动体验。
支持：状态监测、智能提醒
功能互动、 喂食  、喝水 、摸一摸、吃快捷方式  、检测快捷键  、跟随鼠标 、 会自动睡觉 、 饿了会哭 、点击可以跳 、定时设置提醒 、设置宠物透明度，捉迷藏
- **Primary Language**: Python
- **License**: MPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2026-09-20
- **Last Updated**: 2026-09-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 🐾 Desktop Pet - 桌面互动宠物

一款功能丰富的开源桌面宠物程序，为您的Windows桌面增添活力与趣味！

## ✨ 功能特性

### 🎮 基础交互
| 交互方式 | 功能说明 |
|---------|---------|
| **拖拽喂养** | 将桌面快捷方式拖拽到宠物身上，宠物会"吃掉"图标，增加5点清洁值 |
| **点击互动** | 单击宠物触发跳跃动画，长按2秒进入跟随鼠标模式 |
| **右键菜单** | 右键点击宠物唤出环形功能菜单 |
| **摸头互动** | 持续摸头3秒增加10点心情值 |

### 🎨 动画效果
- **正常状态** - 循环播放 `pet.gif` 动画
- **哭泣状态** - 当清洁值过低时显示 `cry.gif`
- **睡眠状态** - 长时间未操作自动进入睡眠，显示 `sleep.gif`
- **庆祝特效** - 清洁值满50触发全屏庆祝动画

### ⚙️ 系统功能
| 功能 | 描述 |
|-----|------|
| **开机自启** | 支持Windows/Linux开机自启动（需管理员权限） |
| **进程监控** | 自动检测Chrome、Steam等指定进程启动并发送提醒 |
| **透明度调节** | 支持10%-100%透明度渐变调节 |
| **快捷指令** | `Ctrl+Shift+C` 清理回收站、`Ctrl+Alt+P` 切换穿透模式 |

### 🔔 智能提醒
- 💧 **定时喝水提醒** - 默认每60分钟提醒一次
- 😴 **睡眠监测** - 长时间未操作自动进入睡眠模式
- 🧹 **系统监控** - 内存使用率>80%时弹出清理建议

### 🤖 智能对话
- 支持配置GPT API实现智能回复
- 气泡弹窗显示AI回复内容
- 可自定义智能回复开关

## 🏗️ 技术架构

- **核心语言**: Python 3.10+
- **界面框架**: Tkinter
- **动画处理**: Pygame + Pillow
- **资源管理**: Pillow (PIL)
- **拖拽支持**: TkDND

## 📦 安装指南

### 环境要求
- Python 3.10 或更高版本
- pip 包管理器

### 安装步骤

1. **克隆项目**
   ```bash
   git clone https://gitee.com/itotonte/desktop_pet.git
   cd desktop_pet
   ```

2. **安装依赖**
   ```bash
   pip install -r requirements.txt
   ```

3. **运行程序**
   ```bash
   python desktop_pet.py
   ```

### 打包为exe（可选）
```bash
pip install pyinstaller
pyinstaller --onefile --noconsole --icon=logo_pet.ico desktop_pet.py
```

## 📖 使用说明

### 基础操作
- **左键单击**: 宠物跳跃
- **左键长按(2秒)**: 进入跟随鼠标模式
- **右键点击**: 打开功能菜单
- **拖拽快捷方式到宠物**: 喂食互动

### 快捷键
| 快捷键 | 功能 |
|-------|------|
| `Ctrl + Shift + C` | 清理回收站 |
| `Ctrl + Alt + P` | 切换宠物穿透模式 |
| `Ctrl + ↑/↓` | 调节透明度 |

### 配置说明
程序支持JSON格式的配置文件，可自定义：
- 跳跃高度
- 喂食/饮水冷却时间
- GPT API配置
- 提醒时间间隔
- 行为规则

## 📁 项目结构

```
desktop_pet/
├── desktop_pet.py      # 主程序文件
├── logo_pet.ico        # 程序图标
├── pet.gif            # 正常状态动画
├── cry.gif            # 哭泣状态动画
├── sleep.gif          # 睡眠状态动画
├── hide.png           # 隐藏状态图片
├── to22.gif           # 备用动画
├── tkdnd/             # 拖拽支持库
│   └── tkdnd2.9.2/
│       ├── libtkdnd2.9.2.dll
│       ├── tkdnd.tcl
│       └── ...
├── imgbandicam025-04-241-29-08-716.gif  # 演示动画1
├── imgbandicam025-04-241-35-18-116_1.gif  # 演示动画2
├── img1.png           # 演示图片
└── README.md          # 说明文档
```

## 🤝 贡献指南

我们欢迎并感谢您的贡献！请查看 [CONTRIBUTING.md](.gitee/CONTRIBUTING.md) 了解详情。

### 报告问题
如发现问题，请在 [Gitee Issues](https://gitee.com/itotonte/desktop_pet/issues) 中提交。

### 功能建议
如果您有新功能建议，欢迎在 Issues 中提出。

## 📄 许可证

本项目基于 MIT 许可证开源，详情请查看 [LICENSE](LICENSE) 文件。

## 🙏 致谢

感谢所有为这个项目贡献代码和提出建议的朋友们！

---

**让您的桌面充满生机与活力！** 🐱✨