# re_pet

**Repository Path**: sanker347/re_pet

## Basic Information

- **Project Name**: re_pet
- **Description**: 搭建属于自己的桌面宠物
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-14
- **Last Updated**: 2026-09-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 桌面宠物, Python

## README

# 桌面宠物 [由散客提供支持]

一个基于 PyQt5 + PyGame 的明日方舟主题桌面宠物应用。宠物以无边框透明置顶窗口漫步在桌面上，支持多角色热切换、戳一戳语音互动、系统托盘与农历日历。

![版本](https://img.shields.io/badge/version-1.1.0-orange) ![Python](https://img.shields.io/badge/python-3.7+-blue) ![Platform](https://img.shields.io/badge/platform-Windows-lightgrey)

## 功能特点

- 🐾 多角色桌宠（阿米娅 / 安塞尔 / 浊心斯卡蒂），运行中热切换
- 🎮 桌面随机漫步：待机 / 走动 / 被戳三态动画，边界自动折返
- 💬 右键单击戳一戳：互动动画 + 语音（音量可调）
- 🖱️ 左键拖动移动，右键双击打开主控制面板
- 🎨 明日方舟风格深色 UI（v1.1.0 全面改版）
- ⚙️ 设置中心：走动间隔 / 速度 / 音效开关 / 音量，保存即生效
- 📅 日历：公历 + 农历双历显示
- 🎬 开场动画（可跳过）
- 🗂️ 系统托盘：关闭主面板最小化到托盘

## 快速开始

```bash
# 安装依赖（Python 3.7+）
pip install -r requirements.txt

# 启动（任意目录均可）
python src/main.py
```

## 操作一览

| 操作 | 效果 |
|---|---|
| 左键拖动宠物 | 移动位置 |
| 右键单击宠物 | 戳一戳（动画+语音） |
| 右键双击宠物 | 打开主控制面板 |
| 不进行操作 | 宠物定时随机漫步 |

更多详见 [docs/04_使用说明.md](docs/04_使用说明.md)。

## 项目结构

```
re_pet/
├── data/                  # 资源（动画GIF/语音/图片/视频/配置）
├── docs/                  # 📚 项目文档
│   ├── 01_程序说明.md     #   架构、启动流程、状态机、热切换机制
│   ├── 02_环境条件.md     #   运行环境、依赖、资源条件
│   ├── 03_程序接口.md     #   模块/类/方法接口参考
│   ├── 04_使用说明.md     #   用户手册与FAQ
│   ├── 05_可复用逻辑函数.md # 可复用组件与工程模式
│   └── 06_界面特性.md     #   设计语言与各窗口特性
├── logs/                  # 📝 修改日志
│   └── 2026-09-24_v1.1.0_界面与架构全面升级.md
├── src/
│   ├── main.py            # 入口
│   └── top/sanker/ark/
│       ├── config.py      # 配置中心（角色注册表/设置持久化）
│       ├── style.py       # 全局QSS深色主题
│       ├── role/          # 宠物角色（PetAll基类+三角色）
│       └── windows/mainwindow/  # 主面板/欢迎页/换角色/设置/日历/退出
└── requirements.txt
```

## 新增角色

只需两步，无需改动切换逻辑：

1. 放置资源：`data/ark/<角色>/` 四个 GIF + `data/ark_se/<角色>/CN_034.wav` + 立绘头像；
2. 在 `src/top/sanker/ark/config.py` 的 `ROLE_REGISTRY` 与 `PORTRAIT_INFO` 登记，并新建角色类（继承 `PetAll`）。

模板见 [docs/03_程序接口.md](docs/03_程序接口.md#4-rolepet_allpetall--宠物基类)。

## 版本历史

| 版本 | 要点 |
|---|---|
| 1.1.0 | 深色UI全面改版、布局管理器、主界面惰性加载、设置中心、卡片式换角色、修复日历布局bug |
| 1.0.4.5 | 优化UI、修复托盘问题 |
| 1.0.4 | 新增日历/换角色/托盘 |
| 1.0.0 | 首版 |

完整变更明细见 [logs/](logs/) 目录。

## 许可证

版权所有 © 2024-2026 联合散客