# Desktop-Pixel-Pet
**Repository Path**: CanFlyhang/Desktop-Pixel-Pet
## Basic Information
- **Project Name**: Desktop-Pixel-Pet
- **Description**: Desktop Pixel Pet（桌面像素宠物）是一个轻量、可扩展的桌面陪伴应用：在你的电脑桌面上展示可爱的像素宠物，让它在屏幕角落里待机、走动、互动，陪你工作与学习。项目内置宠物商城与解锁机制，支持使用运行时间作为货币购买/激活宠物与粮食，并提供本地数据导入/导出能力，方便在不同设备间迁移账号与进度。整体架构清晰，宠物资源以像素帧数据驱动，便于社区创作与扩展更多角色与动画，适合作为桌面小工具、像素动画资源管理与 GUI 项目实践的开源范例。
- **Primary Language**: HTML
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-19
- **Last Updated**: 2026-02-02
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 🐾 Desktop Pixel Pet（桌面像素宠物）
Desktop Pixel Pet（桌面像素宠物）是一个 **轻量、可扩展、以像素动画驱动的桌面陪伴应用**。
它会在你的电脑桌面角落展示一只（或多只）可爱的像素宠物，让它待机、走动、互动，陪你一起工作与学习 ✨
---
## 📸 项目预览
---
## ✨ 项目特性
- 🐶 **桌面像素宠物**
- 宠物常驻桌面，不干扰正常操作
- 支持待机、行走、互动等动画状态
- 🛒 **宠物商城与解锁机制**
- 以 **运行时间作为货币**
- 可购买 / 解锁新的宠物与粮食
- 💾 **本地数据存储 & 迁移**
- 支持数据导入 / 导出
- 方便在不同设备间迁移账号与进度
- 🎨 **像素资源驱动**
- 宠物基于像素帧数据（Frame-based）
- 易于社区创作新角色、新动画
- 🧩 **清晰可扩展的架构**
- 适合作为：
- 桌面小工具示例
- GUI 项目实践
- 像素动画资源管理项目
---
## 🧱 技术栈
- 🐍 **Python**
- 🖼️ GUI：Tkinter / PyQt / 其他（按实际填写）
- 📦 数据存储：本地文件（JSON / SQLite 等）
- 🎞️ 像素动画：帧数据驱动
---
# Desktop-Pixel-Pet
Desktop Pixel Pet（桌面像素宠物）是一个轻量、可扩展的桌面陪伴应用：在你的电脑桌面上展示可爱的像素宠物，让它在屏幕角落里待机、走动、互动，陪你工作与学习。项目内置宠物商城与解锁机制，支持使用运行时间作为货币购买/激活宠物与粮食，并提供本地数据导入/导出能力，方便在不同设备间迁移账号与进度。整体架构清晰，宠物资源以像素帧数据驱动，便于社区创作与扩展更多角色与动画，适合作为桌面小工具、像素动画资源管理与 GUI 项目实践的开源范例。
## 简介
- 使用 Python 3.8+、Tkinter、Pygame、pywin32 构建的本地像素桌宠养成小游戏
- 全程离线，用户与宠物数据存储于 `data/*.json`
- 运行时间为唯一“货币”，可在商城解锁更多桌宠；桌宠支持悬浮窗展示与互动
## 依赖安装（Windows）
```bash
pip install pygame pillow pywin32
```
Tkinter 为 Python 自带库，无需安装。
## 启动方式
```bash
python main.py
```
首次运行将自动创建 `data/users.json` 与 `data/pets.json` 等模板。
## 功能概览
- 账号系统：注册/登录/密码找回（密保问题）
- 数据存储：JSON 文件本地化，异步写入，原子落盘
- 主页：显示用户名与总运行时间，网格展示已解锁宠物
- 悬浮窗：置顶透明、可拖拽、右键菜单（返回/更换/关闭）、点击互动（随机动作）
- 商城：展示未解锁宠物，价格为运行时间；购买后扣减总时间并解锁
## 文件结构
```
core/
account.py # 注册/登录/找回
data_manager.py # JSON 缓存与异步写
runtime_tracker.py # 每秒累计时间
assets_loader.py # 像素矩阵 → Pygame Surface
pet.py # 动画与互动
float_window.py # 悬浮窗（pywin32 优先）
ui/
login_view.py
register_view.py
recover_view.py
home_view.py
mall_view.py
assets/
pets/
pixel_dog.json / pixel_cat.json / pixel_rabbit.json
data/
users.json
pets.json
main.py
README.md
```
## 👥 项目贡献者
感谢所有为本项目贡献过代码的小伙伴 ❤️
[](https://github.com/CanFlyhang/desktop-pixel-pet/graphs/contributors)
## 关于商业化的思考与设计（作者说明）
Desktop Pixel Pet 是一个面向开源社区的桌面像素宠物项目：核心体验尽量保持开放、透明、可扩展；同时也预留了**可持续的商业化路径**，用以支持长期维护、内容创作与生态建设。
### 为什么需要商业化
开源项目的长期发展往往需要稳定投入，包括但不限于：
- 新宠物与动画资源的持续制作
- 交互玩法与性能优化的迭代
- 用户反馈处理、兼容性适配与 Bug 修复
- 服务器/分发/运营等基础成本（如未来引入更多在线能力）
因此，本项目选择在不影响核心可用性的前提下，提供一种“**可选的付费解锁机制**”，让愿意支持项目的用户获得更多内容，同时反哺开发。
### 商城与卡密兑换：可选、克制、可持续
项目内置商城体系，并预留了“**卡密兑换/激活**”入口，用于解锁特定像素宠物（或特殊内容）。该机制遵循以下原则：
- **默认不强制付费**：基础体验与开源部分不设门槛
- **内容型付费**：更多以新宠物/皮肤/特殊动画等内容扩展为主
- **最小化侵入**：不引入干扰式广告，不影响使用体验
### 针对二手倒卖的设计：绑定用户名的兑换密钥
为了避免常见的“卡密被转卖/重复使用/二手倒卖”问题，本项目采用“**按用户名生成兑换密钥**”的思路：
- 兑换密钥由系统根据 `用户名 + 宠物标识 + 盐值` 等信息生成
- 采用哈希/签名类算法使密钥**不可逆**、难以伪造
- 校验时同样基于当前用户名与宠物标识进行验证，确保“**一人一密**”
这样带来的效果是：
- 同一串密钥无法给其他用户名使用，降低二手转售价值
- 即使密钥被泄露，也难以大规模复用
- 商业化更偏向“支持作者获得内容”而非“投机套利”
### 开源与商业的边界
我希望这个项目在开源社区里保持清晰边界：
- **核心框架与基础能力**继续开源，方便学习与二次开发
- **可商业化内容**（例如部分宠物资源、特殊动画、增值包）可以作为可选扩展
- 在不违背开源精神的前提下，建立一个对作者与用户都更健康的长期模式
如果你喜欢这个项目，欢迎 Star、提 Issue、贡献宠物资源或 PR；你的支持会直接推动 Desktop Pixel Pet 变得更好。
## 常见问题
- 无法创建悬浮透明窗：确保已安装 `pywin32`；若缺失将自动降级为 Tkinter 顶层窗体。
- 资源预览为空：使用了占位帧，实际像素素材可替换 `assets/pets/*.json`。
- 进程意外退出：数据写入采用原子落盘与异步队列，尽量避免损坏；如损坏可删除 `*.tmp` 并重启。
## 本地化与安全
- 密码以 SHA256 存储于本地 `users.json`；“记住密码”将明文写入 `data/config.json`（仅用于本机开发与演示）。
- 项目不进行任何网络通信。
## 版权与扩展
- 可自由扩展更多像素宠物与动画帧、增加音效等。