🐾 Desktop lulumumu

🩵🩷让可爱的豚豚馒馒在桌面上陪你一起玩吧！🩷🩵

---

📚 目录 Contents

• 项目动机 Motivation
• 功能介绍 Functions
  • Chill 模式
  • Work 模式
• 使用小技巧 Tips
• 安装&使用指南
• 技术栈 Tech Stack
• 致谢 Acknowledgement

---

💡 项目动机 Motivation

在一个很突然的晚上，想到如果我的桌面上有一个小小的豚豚馒馒，那该多可爱呢！ 感谢科学技术的发展，感谢vibe coding，我也想给lulu和小木做点什么可爱的东西，所以有了今天的桌面宠物。 做这个项目的过程和任何一次比赛/项目都不一样，我第一次每天期待着coding，甚至写下这份README都充满乐趣， 也许这就是如此爱你们的原因，因为你们的存在本身就让人快乐。

祝大家玩的开心，希望lulu和小木可以陪伴大家度过每一个幸福或是悲伤的时刻，祝两个可爱的宝宝星途璀璨🩵🩷

✨ 功能介绍 Functions

😼 Chill 模式

和豚豚馒馒一起玩吧！🥰🥰🥰

支持功能：

• 🩵 摸摸emo猫猫&小海德薇吧
• 🩷 触摸手出现并可拖动
• 🎥 away~
• 🐾 来到豚馒宇宙，和大家俩聊天

---

💼 Work 模式

和豚豚馒馒一起工作吧！🥰🥰🥰

支持功能：

✅ Todos 清单

• 添加任务
• 勾选完成
• 双击删除

📝 Notepad 记事本

• 随时记录想法

🩵 摸摸豚豚馒馒吧🩷

🎥 away~

⏱ 连续工作 10 分钟后解锁lulumumu新形象！ 🎉

---

🩵🩷 使用小技巧 Tips

🥰 给豚馒换个地方

• 鼠标拖动图像

🔁 模式切换

• 点击 Switch 切换 Chill / Work 模式

👋🏻 关闭程序

• 点击 X 直接退出程序

🦉 Chill 模式技巧

• 点击宠物 → 显示菜单
• 再次点击宠物 → 隐藏菜单
• 触摸宠物：
  • 会出现🫳🏻，手可以拖动
  • 6 秒后自动消失

☁️ Work 模式技巧

Todos & Notepad

• 可以拖动位置
• 再次点击 Todos / Notes → 隐藏窗口
• 点击宠物 → 隐藏菜单

Todos

• ➕ 添加任务
• ☑ 勾选完成
• 🖱 双击删除任务

Notepad

• ✍ 自由记录笔记内容

触摸互动

• 触摸手依然可以移动、互动🫳🏻

---

🛠 Setup Guide（安装与运行指南）

想要安装一个豚豚馒馒在桌面陪伴你吗！🩵🩷 本项目是一个使用 Python + PyQt6 开发的桌面桌宠应用，请按照以下步骤进行环境配置和运行 ^_^

---

1️⃣ 安装 Python

请先安装 Python 3.10 或以上版本（推荐 3.11）。

🔗 官方下载地址：
https://www.python.org/downloads/

⚠️ Windows 用户注意：
安装时请务必勾选 ✅ Add Python to PATH

安装完成后，打开终端 / PowerShell，输入：

python --version

若能看到版本号（如 Python 3.11.x），说明安装成功

2️⃣ 获取项目代码

可以使用 Git 克隆 或 直接下载 ZIP

方法一：使用 Git

git clone https://github.com/Junronggg/desktop_lulumumu.git
cd desktop_lulumumu

方法二：下载 ZIP

在 GitHub 页面点击 Code → Download ZIP, 解压到本地任意目录, 使用终端进入项目根目录

3️⃣ 创建并激活虚拟环境（可以跳过这一步哦~）

为了避免依赖冲突，建议为项目创建虚拟环境。

• Windows:

python -m venv venv
venv\Scripts\activate

• macOS / Linux:

python3 -m venv venv
source venv/bin/activate

激活成功后，终端前会显示：

(venv)

4️⃣ 安装项目依赖

确保已经激活虚拟环境，然后运行：

pip install -r requirements.txt

下载python库

5️⃣ 项目结构说明

桌面豚馒的项目结构如下：

desktop-pet/
├── assets/              # GIF / PNG / UI 资源
│   ├── hedwig_emocat.gif
│   ├── workmode.gif
│   └── ...
├── src/
    ├── pet.py               # 豚馒本体（显示、拖拽、动画）
    ├── sidebar.py           # 菜单与模式切换
    ├── window.py            # 主窗口容器
    ├── main.py              # 程序入口
├── requirements.txt     # 依赖列表
└── README.md

6️⃣ 运行桌面豚馒

python main.py

7️⃣ 开发环境推荐

• IDE：PyCharm / VS Code

• Python 版本：3.11

• 系统：Windows / macOS

---

🛠 技术栈 Tech Stack

• 🐍 Python
• 🖼 PyQt6 (Qt for Python)
• 📦 JSON
  • 用于本地数据存储（Todos / Notes / 状态）

---

💖 致谢 Acknowledgement

• 小红书 @小壳kk，@阴雨天🌸，谢谢两位老师的产出

祝我们亲爱的lulumumu星途璀璨，天天开心，睡个好觉

祝大家玩的开心 🐾💗