在实际开发或学习过程中我们常常需要一个轻松、有趣的桌面伴侣来调节工作节奏或者作为一个简单的自律监督工具。一个开源的桌面宠物桌宠项目不仅能让你的桌面变得生动更能让你通过参与其开发深入理解桌面应用开发、图形界面编程、事件驱动以及跨平台技术。本文将围绕一个虚构的“蓝色大肥鱼”桌宠项目从零开始带你完成一个具备基础交互功能的桌面宠物应用。我们将使用 Python 语言和 PyQt5 库因为它简单易学且能快速构建跨平台的图形界面。通过本文你将掌握如何创建一个可移动、可交互、能响应事件的桌宠并理解其背后的核心机制。1. 理解桌面宠物的核心机制与架构桌面宠物本质上是一个没有边框、始终置顶、且能响应鼠标和键盘事件的图形窗口应用。它的核心挑战在于如何让一个窗口“活”起来既能自由移动又能执行动画和交互逻辑同时不影响用户对其他窗口的正常操作。1.1 桌宠应用的核心组件一个典型的桌宠应用由以下几个核心部分组成主窗口Main Window这是桌宠的载体。它必须是一个无边框Frameless窗口这样才能隐藏传统的标题栏和边框只显示宠物图像。同时它需要设置为“置顶”AlwaysOnTop确保宠物始终显示在其他应用窗口之上。图形资源Graphics Resources即桌宠的视觉表现通常是一系列 PNG 格式的图片用于表现宠物的不同状态如静止、移动、眨眼、说话等。这些图片需要支持透明通道以实现不规则形状的显示。事件处理Event Handling这是桌宠交互的灵魂。主要包括鼠标事件允许用户通过拖拽来移动桌宠。需要处理鼠标按下、移动、释放等事件。定时器事件用于驱动动画。例如每隔几秒让宠物眨眼一次或者执行一个循环的待机动画。键盘事件可选可以响应全局快捷键例如按CtrlShiftP让宠物执行特定动作或隐藏。行为逻辑Behavior Logic定义桌宠的“性格”。例如当用户长时间不操作电脑时宠物可能会打瞌睡当用户点击它时它会做出一个反应动作。这部分逻辑通常由状态机或一系列条件判断来实现。1.2 技术选型为什么选择 Python PyQt5对于快速原型开发和初学者入门Python 配合 PyQt5 是一个极佳的选择开发效率高Python 语法简洁PyQt5 封装完善能快速构建出功能完整的 GUI 应用。跨平台PyQt5 支持 Windows、macOS 和 Linux编写的代码稍作调整即可在不同系统上运行。功能强大PyQt5 提供了完整的 GUI 组件、强大的绘图能力和便捷的事件系统足以满足桌宠开发的需求。资源丰富社区有大量关于 PyQt5 无边框窗口、透明背景、全局热键的示例和解决方案。2. 环境准备与项目初始化在开始编码之前我们需要搭建好开发环境并创建项目结构。2.1 安装 Python 与必要库确保你的系统已安装 Python推荐 3.8 及以上版本。然后使用 pip 安装 PyQt5 和用于处理系统托盘图标的 PyQt5-sip通常 PyQt5 已包含。# 安装 PyQt5 pip install PyQt5 # 可选安装 pillow 库用于更灵活的图片处理非必需但推荐 pip install pillow2.2 创建项目目录与资源创建一个名为blue_fat_fish_desktop_pet的项目文件夹并建立如下目录结构blue_fat_fish_desktop_pet/ ├── main.py # 主程序入口 ├── pet_agent.py # 桌宠核心逻辑类 ├── resources/ # 资源文件夹 │ ├── images/ # 存放所有图片 │ │ ├── fish_idle_1.png │ │ ├── fish_idle_2.png │ │ ├── fish_blink.png │ │ └── fish_sleep.png │ └── sounds/ # 存放音效可选 └── requirements.txt # 项目依赖列表在requirements.txt中写入PyQt55.15 pillow9.0注意你需要自行准备或绘制一套“蓝色大肥鱼”的图片。至少需要一张静态图fish_idle_1.png和一张眨眼图fish_blink.png。图片背景应为透明PNG格式。3. 构建桌宠核心类PetAgent我们将创建一个PetAgent类它继承自QWidget作为桌宠的主窗口和逻辑控制器。3.1 初始化无边框透明窗口首先在pet_agent.py中创建类并初始化一个无边框、透明、置顶的窗口。import sys import random from PyQt5.QtWidgets import QWidget, QApplication from PyQt5.QtCore import Qt, QTimer, QPoint from PyQt5.QtGui import QPixmap, QPainter class PetAgent(QWidget): def __init__(self): super().__init__() self.initUI() self.initPet() self.initTimer() def initUI(self): # 设置窗口无边框、透明背景、始终置顶 self.setWindowFlags(Qt.FramelessWindowHint | Qt.WindowStaysOnTopHint | Qt.Tool) self.setAttribute(Qt.WA_TranslucentBackground) # 设置窗口初始大小和位置屏幕右下角 screen_geometry QApplication.desktop().screenGeometry() self.pet_width, self.pet_height 150, 150 # 宠物显示大小 self.setGeometry( screen_geometry.width() - self.pet_width - 50, screen_geometry.height() - self.pet_height - 50, self.pet_width, self.pet_height ) # 鼠标跟踪用于实现拖拽 self.setMouseTracking(True) self.dragging False self.drag_position QPoint() def initPet(self): 初始化宠物状态和图像 self.pet_state idle # 状态idle, blink, sleep, move self.frame_index 0 self.idle_frames [] # 待机动画帧列表 self.blink_frames [] # 眨眼动画帧列表 # 加载图片资源这里需要替换为你的实际图片路径 try: # 示例加载两张待机帧和一张眨眼帧 self.idle_frames.append(QPixmap(resources/images/fish_idle_1.png).scaled(self.pet_width, self.pet_height, Qt.KeepAspectRatio, Qt.SmoothTransformation)) self.idle_frames.append(QPixmap(resources/images/fish_idle_2.png).scaled(self.pet_width, self.pet_height, Qt.KeepAspectRatio, Qt.SmoothTransformation)) self.blink_frames.append(QPixmap(resources/images/fish_blink.png).scaled(self.pet_width, self.pet_height, Qt.KeepAspectRatio, Qt.SmoothTransformation)) self.current_pixmap self.idle_frames[0] # 当前显示的图像 except Exception as e: print(f加载图片资源失败: {e}) # 创建一个简单的替代图像红色圆形 self.current_pixmap QPixmap(self.pet_width, self.pet_height) self.current_pixmap.fill(Qt.transparent) painter QPainter(self.current_pixmap) painter.setBrush(Qt.red) painter.drawEllipse(10, 10, self.pet_width-20, self.pet_height-20) painter.end() def initTimer(self): 初始化定时器驱动动画和状态更新 # 动画定时器控制帧切换 self.animation_timer QTimer(self) self.animation_timer.timeout.connect(self.updateAnimationFrame) self.animation_timer.start(500) # 每500毫秒更新一帧 # 行为定时器控制状态切换如眨眼、睡觉 self.behavior_timer QTimer(self) self.behavior_timer.timeout.connect(self.updateBehavior) self.behavior_timer.start(3000) # 每3秒检查一次行为 def paintEvent(self, event): 重绘事件将当前图像画到窗口上 painter QPainter(self) painter.drawPixmap(0, 0, self.current_pixmap) def updateAnimationFrame(self): 更新动画帧根据当前状态切换图像 if self.pet_state idle and self.idle_frames: self.frame_index (self.frame_index 1) % len(self.idle_frames) self.current_pixmap self.idle_frames[self.frame_index] elif self.pet_state blink and self.blink_frames: # 眨眼通常只播放一次然后回到idle self.current_pixmap self.blink_frames[0] QTimer.singleShot(300, self.backToIdle) # 300毫秒后恢复idle状态 self.update() # 触发重绘 def updateBehavior(self): 更新宠物行为状态例如随机眨眼 if self.pet_state idle and random.random() 0.3: # 30%概率眨眼 self.pet_state blink self.updateAnimationFrame() # 立即切换到眨眼帧 def backToIdle(self): 从其他状态如眨眼恢复到待机状态 self.pet_state idle self.frame_index 03.2 实现鼠标拖拽移动功能为了让用户能拖动桌宠我们需要处理鼠标事件。# 在 PetAgent 类中继续添加以下方法 def mousePressEvent(self, event): 鼠标按下事件开始拖拽 if event.button() Qt.LeftButton: self.dragging True self.drag_position event.globalPos() - self.frameGeometry().topLeft() event.accept() def mouseMoveEvent(self, event): 鼠标移动事件如果正在拖拽则移动窗口 if self.dragging and event.buttons() Qt.LeftButton: self.move(event.globalPos() - self.drag_position) event.accept() def mouseReleaseEvent(self, event): 鼠标释放事件结束拖拽 if event.button() Qt.LeftButton: self.dragging False event.accept() def mouseDoubleClickEvent(self, event): 鼠标双击事件可以定义为特殊动作例如隐藏或说话 if event.button() Qt.LeftButton: # 示例双击时切换到一个“说话”状态需要额外图片资源 # self.saySomething(不许偷懒) print(Pet says: Get back to work!) # 这里可以触发一个显示文字气泡的动画4. 编写主程序入口与系统托盘集成一个完整的桌宠通常需要支持最小化到系统托盘而不是直接关闭。我们将在main.py中实现。4.1 创建主程序与系统托盘import sys from PyQt5.QtWidgets import QApplication, QSystemTrayIcon, QMenu, QAction from PyQt5.QtGui import QIcon from pet_agent import PetAgent def main(): app QApplication(sys.argv) app.setQuitOnLastWindowClosed(False) # 防止关闭窗口后程序退出 # 创建桌宠实例 pet PetAgent() pet.show() # 创建系统托盘图标 tray_icon QSystemTrayIcon() # 需要准备一个托盘图标文件例如 tray_icon.png try: tray_icon.setIcon(QIcon(resources/images/tray_icon.png)) except: # 如果找不到图标使用默认图标可能不显示 pass # 创建托盘菜单 tray_menu QMenu() show_action QAction(显示/隐藏, triggeredlambda: pet.setVisible(not pet.isVisible())) quit_action QAction(退出, triggeredapp.quit) tray_menu.addAction(show_action) tray_menu.addSeparator() tray_menu.addAction(quit_action) tray_icon.setContextMenu(tray_menu) tray_icon.show() # 可选双击托盘图标显示/隐藏宠物 tray_icon.activated.connect(lambda reason: pet.setVisible(not pet.isVisible()) if reason QSystemTrayIcon.DoubleClick else None) sys.exit(app.exec_()) if __name__ __main__: main()4.2 运行与验证现在在项目根目录下运行命令启动你的桌宠python main.py如果一切正常你应该能看到一条“蓝色大肥鱼”或你设置的替代图像出现在屏幕右下角。宠物会以一定频率切换图像模拟待机动画。宠物会随机“眨眼”。你可以用鼠标左键按住并拖动宠物到屏幕任意位置。在系统托盘区会出现一个图标右键点击可以显示菜单选择“显示/隐藏”或“退出”。5. 核心功能扩展让桌宠“监督工作”最初的桌宠只是一个动画窗口。现在我们为其注入“灵魂”让它能根据用户行为做出反应实现“监督”功能。5.1 监听系统空闲时间监督工作的一个核心是判断用户是否在“偷懒”。我们可以通过监听系统输入鼠标、键盘事件来估算用户空闲时间。这里使用pynput库来全局监听输入事件。首先安装pynputpip install pynput然后修改PetAgent类增加空闲检测逻辑# 在 pet_agent.py 文件开头导入 from pynput import mouse, keyboard from datetime import datetime, timedelta import threading class PetAgent(QWidget): def __init__(self): super().__init__() # ... 保持原有的初始化代码 ... self.initIdleMonitor() # 新增初始化空闲监视器 def initIdleMonitor(self): 初始化空闲时间监视器 self.last_activity_time datetime.now() self.idle_threshold timedelta(seconds60) # 空闲阈值60秒 self.is_user_idle False # 启动鼠标监听线程 mouse_listener mouse.Listener(on_moveself.on_activity, on_clickself.on_activity) mouse_listener.daemon True # 设置为守护线程主程序退出时自动结束 mouse_listener.start() # 启动键盘监听线程 keyboard_listener keyboard.Listener(on_pressself.on_activity) keyboard_listener.daemon True keyboard_listener.start() # 空闲检查定时器 self.idle_check_timer QTimer(self) self.idle_check_timer.timeout.connect(self.checkIdleStatus) self.idle_check_timer.start(5000) # 每5秒检查一次 def on_activity(self, *args, **kwargs): 当有任何鼠标或键盘活动时调用更新最后活动时间 self.last_activity_time datetime.now() if self.is_user_idle: self.is_user_idle False self.onUserActive() # 用户恢复活动 def checkIdleStatus(self): 检查用户是否空闲超过阈值 if datetime.now() - self.last_activity_time self.idle_threshold: if not self.is_user_idle: self.is_user_idle True self.onUserIdle() # 用户进入空闲状态 def onUserIdle(self): 当用户空闲时的处理宠物做出提醒 print(用户已空闲超过1分钟宠物开始提醒...) # 改变宠物状态为“提醒”或“生气” self.pet_state remind # 可以切换到一个“生气”或“提醒”的图片帧 # self.current_pixmap QPixmap(resources/images/fish_angry.png) # 也可以让宠物“说话”显示一个文字气泡需要额外UI组件 self.showMessageBubble(我允许你偷懒了吗快回来工作) self.update() def onUserActive(self): 当用户恢复活动时的处理宠物恢复正常 print(用户恢复活动宠物停止提醒。) self.pet_state idle self.hideMessageBubble() self.update() def showMessageBubble(self, text): 显示一个文字气泡简化版实际需要更复杂的UI绘制 # 这里可以创建一个QLabel作为气泡并设置定时器自动消失 # 为简化示例我们仅在控制台打印 print(f[Pet Bubble]: {text}) def hideMessageBubble(self): 隐藏文字气泡 pass5.2 实现更丰富的状态与动画为了让监督更有趣我们可以定义更多状态和对应的动画序列。状态触发条件宠物行为对应图片资源idle默认状态循环播放待机动画轻微摆动fish_idle_1.png,fish_idle_2.pngblink随机或定时触发播放一次眨眼动画fish_blink.pngsleep用户长时间空闲后播放睡觉动画打呼噜fish_sleep_1.png,fish_sleep_2.pngremind用户空闲超过阈值播放提醒动画跳动、生气并显示气泡fish_angry.pnghappy用户完成一项任务需与其他应用集成播放高兴动画fish_happy.png你需要准备相应的图片序列并在initPet和状态切换逻辑中加载它们。6. 常见问题排查与调试在开发过程中你可能会遇到以下典型问题。这里提供排查思路和解决方案。6.1 窗口问题排查问题现象可能原因检查与解决方式窗口有白色背景或边框透明背景属性未生效或图片背景不透明1. 确认setAttribute(Qt.WA_TranslucentBackground)已调用。2. 确认使用的 PNG 图片背景为透明在图片查看器中检查。3. 尝试在paintEvent中先填充透明色painter.fillRect(self.rect(), Qt.transparent)。无法拖动窗口鼠标事件未被正确捕获或处理1. 检查mousePressEvent,mouseMoveEvent,mouseReleaseEvent方法是否已重写。2. 确认setMouseTracking(True)已设置。3. 在事件处理函数中调用event.accept()。窗口无法置顶窗口标志设置不正确检查setWindowFlags中是否包含Qt.WindowStaysOnTopHint。关闭主窗口后程序不退出系统托盘图标保持程序运行这是预期行为。需要通过托盘菜单的“退出”选项来结束程序。确保app.setQuitOnLastWindowClosed(False)已设置。6.2 资源与路径问题问题现象可能原因检查与解决方式图片加载失败显示红色方块图片路径错误或文件不存在1. 使用绝对路径或相对于脚本运行路径的正确相对路径。2. 使用os.path模块构建路径os.path.join(os.path.dirname(__file__), resources, images, fish.png)。3. 在代码中添加异常捕获并打印错误信息。动画播放卡顿或不流畅定时器间隔太短或图片过大1. 调整QTimer的间隔如从 100ms 改为 200ms。2. 确保图片尺寸与窗口大小匹配避免运行时缩放。在加载时使用scaled一次性缩放好。系统托盘图标不显示系统不支持或图标路径错误1. 某些 Linux 桌面环境可能需要额外的依赖。2. 确保托盘图标文件存在且格式受支持如 PNG。3. 可以尝试使用QIcon.fromTheme获取系统默认图标进行测试。6.3 功能逻辑问题问题现象可能原因检查与解决方式空闲检测不生效pynput监听器未启动或权限问题1. 在 macOS/Linux 上可能需要授予辅助功能权限。2. 检查监听器线程是否成功启动无报错。3. 在on_activity方法中打印日志确认事件能被捕获。状态切换混乱多个定时器或事件冲突导致状态被覆盖1. 在改变pet_state的地方打印日志跟踪状态流转。2. 确保状态切换是原子的避免在动画播放中途被另一个定时器打断。可以使用一个状态锁。宠物“说话”气泡不显示气泡 UI 组件未正确创建或父窗口问题1. 确保气泡 QLabel 的父窗口设置为宠物窗口 (self)。2. 调用show()方法并设置合适的几何位置。3. 使用QTimer.singleShot控制气泡的自动消失。7. 生产环境考量与最佳实践如果你希望将这个桌宠用于日常使用或者分享给他人需要考虑以下几点。7.1 打包与分发使用 PyInstaller 将 Python 脚本打包成独立的可执行文件方便在没有 Python 环境的电脑上运行。安装 PyInstallerpip install pyinstaller创建打包规范由于项目包含图片等资源文件需要创建一个.spec文件或使用命令行参数将它们包含进去。pyinstaller --onefile --windowed --add-data resources;resources --iconresources/images/fish_icon.ico main.py--onefile打包成单个 exe 文件。--windowed不显示控制台窗口对于 GUI 程序。--add-data将resources文件夹复制到打包程序中。分号前是源路径后是目标路径Windows用;macOS/Linux用:。--icon设置可执行文件的图标。处理路径问题打包后程序的运行路径会改变。在代码中获取资源路径时应使用以下方式import sys import os def resource_path(relative_path): 获取资源的绝对路径。在开发环境和打包后都有效。 if hasattr(sys, _MEIPASS): # 运行在 PyInstaller 创建的临时文件夹中 base_path sys._MEIPASS else: # 运行在正常的开发环境中 base_path os.path.abspath(.) return os.path.join(base_path, relative_path) # 使用示例 image_path resource_path(os.path.join(resources, images, fish_idle_1.png)) pixmap QPixmap(image_path)7.2 性能与资源优化图片优化确保图片尺寸适中如 150x150 像素并使用 PNG-8 或优化过的 PNG-24 格式以减小内存占用和打包体积。定时器管理不需要时停止定时器timer.stop()例如当宠物隐藏或进入休眠时。事件监听pynput的全局监听是系统级操作确保在程序退出时正确停止监听器虽然设置了守护线程但显式停止是良好习惯。7.3 扩展方向一个基础的桌宠已经完成你可以在此基础上添加更多有趣的功能语音交互集成语音合成如pyttsx3库让宠物可以“说出”提醒的话。任务集成与番茄钟Pomodoro应用或任务列表如 Todo.txt集成在专注时间结束后让宠物休息在休息结束后让宠物提醒。网络功能从网络获取天气、名言警句并显示在宠物的气泡中。多宠物系统支持加载不同的宠物角色和皮肤。配置界面创建一个设置窗口让用户可以调整空闲阈值、宠物大小、动画速度等。通过这个从零构建开源桌宠的过程你不仅学会了 PyQt5 创建无边框窗口、处理事件、使用定时器还实践了多线程监听、状态机设计以及资源打包。最关键的是你将一个简单的创意变成了一个可运行、可交互的桌面应用。接下来你可以尝试为你的“蓝色大肥鱼”绘制更精美的动画帧或者实现更复杂的“监督”逻辑让它真正成为你工作学习中的有趣伙伴。 
长河君 · 2026/8/21 20:19:00 · 阅读 1.2k Python PyQt5开发桌面宠物：从零构建交互式桌宠应用
在实际开发或学习过程中我们常常需要一个轻松、有趣的桌面伴侣来调节工作节奏或者作为一个简单的自律监督工具。一个开源的桌面宠物桌宠项目不仅能让你的桌面变得生动更能让你通过参与其开发深入理解桌面应用开发、图形界面编程、事件驱动以及跨平台技术。本文将围绕一个虚构的“蓝色大肥鱼”桌宠项目从零开始带你完成一个具备基础交互功能的桌面宠物应用。我们将使用 Python 语言和 PyQt5 库因为它简单易学且能快速构建跨平台的图形界面。通过本文你将掌握如何创建一个可移动、可交互、能响应事件的桌宠并理解其背后的核心机制。1. 理解桌面宠物的核心机制与架构桌面宠物本质上是一个没有边框、始终置顶、且能响应鼠标和键盘事件的图形窗口应用。它的核心挑战在于如何让一个窗口“活”起来既能自由移动又能执行动画和交互逻辑同时不影响用户对其他窗口的正常操作。1.1 桌宠应用的核心组件一个典型的桌宠应用由以下几个核心部分组成主窗口Main Window这是桌宠的载体。它必须是一个无边框Frameless窗口这样才能隐藏传统的标题栏和边框只显示宠物图像。同时它需要设置为“置顶”AlwaysOnTop确保宠物始终显示在其他应用窗口之上。图形资源Graphics Resources即桌宠的视觉表现通常是一系列 PNG 格式的图片用于表现宠物的不同状态如静止、移动、眨眼、说话等。这些图片需要支持透明通道以实现不规则形状的显示。事件处理Event Handling这是桌宠交互的灵魂。主要包括鼠标事件允许用户通过拖拽来移动桌宠。需要处理鼠标按下、移动、释放等事件。定时器事件用于驱动动画。例如每隔几秒让宠物眨眼一次或者执行一个循环的待机动画。键盘事件可选可以响应全局快捷键例如按CtrlShiftP让宠物执行特定动作或隐藏。行为逻辑Behavior Logic定义桌宠的“性格”。例如当用户长时间不操作电脑时宠物可能会打瞌睡当用户点击它时它会做出一个反应动作。这部分逻辑通常由状态机或一系列条件判断来实现。1.2 技术选型为什么选择 Python PyQt5对于快速原型开发和初学者入门Python 配合 PyQt5 是一个极佳的选择开发效率高Python 语法简洁PyQt5 封装完善能快速构建出功能完整的 GUI 应用。跨平台PyQt5 支持 Windows、macOS 和 Linux编写的代码稍作调整即可在不同系统上运行。功能强大PyQt5 提供了完整的 GUI 组件、强大的绘图能力和便捷的事件系统足以满足桌宠开发的需求。资源丰富社区有大量关于 PyQt5 无边框窗口、透明背景、全局热键的示例和解决方案。2. 环境准备与项目初始化在开始编码之前我们需要搭建好开发环境并创建项目结构。2.1 安装 Python 与必要库确保你的系统已安装 Python推荐 3.8 及以上版本。然后使用 pip 安装 PyQt5 和用于处理系统托盘图标的 PyQt5-sip通常 PyQt5 已包含。# 安装 PyQt5 pip install PyQt5 # 可选安装 pillow 库用于更灵活的图片处理非必需但推荐 pip install pillow2.2 创建项目目录与资源创建一个名为blue_fat_fish_desktop_pet的项目文件夹并建立如下目录结构blue_fat_fish_desktop_pet/ ├── main.py # 主程序入口 ├── pet_agent.py # 桌宠核心逻辑类 ├── resources/ # 资源文件夹 │ ├── images/ # 存放所有图片 │ │ ├── fish_idle_1.png │ │ ├── fish_idle_2.png │ │ ├── fish_blink.png │ │ └── fish_sleep.png │ └── sounds/ # 存放音效可选 └── requirements.txt # 项目依赖列表在requirements.txt中写入PyQt55.15 pillow9.0注意你需要自行准备或绘制一套“蓝色大肥鱼”的图片。至少需要一张静态图fish_idle_1.png和一张眨眼图fish_blink.png。图片背景应为透明PNG格式。3. 构建桌宠核心类PetAgent我们将创建一个PetAgent类它继承自QWidget作为桌宠的主窗口和逻辑控制器。3.1 初始化无边框透明窗口首先在pet_agent.py中创建类并初始化一个无边框、透明、置顶的窗口。import sys import random from PyQt5.QtWidgets import QWidget, QApplication from PyQt5.QtCore import Qt, QTimer, QPoint from PyQt5.QtGui import QPixmap, QPainter class PetAgent(QWidget): def __init__(self): super().__init__() self.initUI() self.initPet() self.initTimer() def initUI(self): # 设置窗口无边框、透明背景、始终置顶 self.setWindowFlags(Qt.FramelessWindowHint | Qt.WindowStaysOnTopHint | Qt.Tool) self.setAttribute(Qt.WA_TranslucentBackground) # 设置窗口初始大小和位置屏幕右下角 screen_geometry QApplication.desktop().screenGeometry() self.pet_width, self.pet_height 150, 150 # 宠物显示大小 self.setGeometry( screen_geometry.width() - self.pet_width - 50, screen_geometry.height() - self.pet_height - 50, self.pet_width, self.pet_height ) # 鼠标跟踪用于实现拖拽 self.setMouseTracking(True) self.dragging False self.drag_position QPoint() def initPet(self): 初始化宠物状态和图像 self.pet_state idle # 状态idle, blink, sleep, move self.frame_index 0 self.idle_frames [] # 待机动画帧列表 self.blink_frames [] # 眨眼动画帧列表 # 加载图片资源这里需要替换为你的实际图片路径 try: # 示例加载两张待机帧和一张眨眼帧 self.idle_frames.append(QPixmap(resources/images/fish_idle_1.png).scaled(self.pet_width, self.pet_height, Qt.KeepAspectRatio, Qt.SmoothTransformation)) self.idle_frames.append(QPixmap(resources/images/fish_idle_2.png).scaled(self.pet_width, self.pet_height, Qt.KeepAspectRatio, Qt.SmoothTransformation)) self.blink_frames.append(QPixmap(resources/images/fish_blink.png).scaled(self.pet_width, self.pet_height, Qt.KeepAspectRatio, Qt.SmoothTransformation)) self.current_pixmap self.idle_frames[0] # 当前显示的图像 except Exception as e: print(f加载图片资源失败: {e}) # 创建一个简单的替代图像红色圆形 self.current_pixmap QPixmap(self.pet_width, self.pet_height) self.current_pixmap.fill(Qt.transparent) painter QPainter(self.current_pixmap) painter.setBrush(Qt.red) painter.drawEllipse(10, 10, self.pet_width-20, self.pet_height-20) painter.end() def initTimer(self): 初始化定时器驱动动画和状态更新 # 动画定时器控制帧切换 self.animation_timer QTimer(self) self.animation_timer.timeout.connect(self.updateAnimationFrame) self.animation_timer.start(500) # 每500毫秒更新一帧 # 行为定时器控制状态切换如眨眼、睡觉 self.behavior_timer QTimer(self) self.behavior_timer.timeout.connect(self.updateBehavior) self.behavior_timer.start(3000) # 每3秒检查一次行为 def paintEvent(self, event): 重绘事件将当前图像画到窗口上 painter QPainter(self) painter.drawPixmap(0, 0, self.current_pixmap) def updateAnimationFrame(self): 更新动画帧根据当前状态切换图像 if self.pet_state idle and self.idle_frames: self.frame_index (self.frame_index 1) % len(self.idle_frames) self.current_pixmap self.idle_frames[self.frame_index] elif self.pet_state blink and self.blink_frames: # 眨眼通常只播放一次然后回到idle self.current_pixmap self.blink_frames[0] QTimer.singleShot(300, self.backToIdle) # 300毫秒后恢复idle状态 self.update() # 触发重绘 def updateBehavior(self): 更新宠物行为状态例如随机眨眼 if self.pet_state idle and random.random() 0.3: # 30%概率眨眼 self.pet_state blink self.updateAnimationFrame() # 立即切换到眨眼帧 def backToIdle(self): 从其他状态如眨眼恢复到待机状态 self.pet_state idle self.frame_index 03.2 实现鼠标拖拽移动功能为了让用户能拖动桌宠我们需要处理鼠标事件。# 在 PetAgent 类中继续添加以下方法 def mousePressEvent(self, event): 鼠标按下事件开始拖拽 if event.button() Qt.LeftButton: self.dragging True self.drag_position event.globalPos() - self.frameGeometry().topLeft() event.accept() def mouseMoveEvent(self, event): 鼠标移动事件如果正在拖拽则移动窗口 if self.dragging and event.buttons() Qt.LeftButton: self.move(event.globalPos() - self.drag_position) event.accept() def mouseReleaseEvent(self, event): 鼠标释放事件结束拖拽 if event.button() Qt.LeftButton: self.dragging False event.accept() def mouseDoubleClickEvent(self, event): 鼠标双击事件可以定义为特殊动作例如隐藏或说话 if event.button() Qt.LeftButton: # 示例双击时切换到一个“说话”状态需要额外图片资源 # self.saySomething(不许偷懒) print(Pet says: Get back to work!) # 这里可以触发一个显示文字气泡的动画4. 编写主程序入口与系统托盘集成一个完整的桌宠通常需要支持最小化到系统托盘而不是直接关闭。我们将在main.py中实现。4.1 创建主程序与系统托盘import sys from PyQt5.QtWidgets import QApplication, QSystemTrayIcon, QMenu, QAction from PyQt5.QtGui import QIcon from pet_agent import PetAgent def main(): app QApplication(sys.argv) app.setQuitOnLastWindowClosed(False) # 防止关闭窗口后程序退出 # 创建桌宠实例 pet PetAgent() pet.show() # 创建系统托盘图标 tray_icon QSystemTrayIcon() # 需要准备一个托盘图标文件例如 tray_icon.png try: tray_icon.setIcon(QIcon(resources/images/tray_icon.png)) except: # 如果找不到图标使用默认图标可能不显示 pass # 创建托盘菜单 tray_menu QMenu() show_action QAction(显示/隐藏, triggeredlambda: pet.setVisible(not pet.isVisible())) quit_action QAction(退出, triggeredapp.quit) tray_menu.addAction(show_action) tray_menu.addSeparator() tray_menu.addAction(quit_action) tray_icon.setContextMenu(tray_menu) tray_icon.show() # 可选双击托盘图标显示/隐藏宠物 tray_icon.activated.connect(lambda reason: pet.setVisible(not pet.isVisible()) if reason QSystemTrayIcon.DoubleClick else None) sys.exit(app.exec_()) if __name__ __main__: main()4.2 运行与验证现在在项目根目录下运行命令启动你的桌宠python main.py如果一切正常你应该能看到一条“蓝色大肥鱼”或你设置的替代图像出现在屏幕右下角。宠物会以一定频率切换图像模拟待机动画。宠物会随机“眨眼”。你可以用鼠标左键按住并拖动宠物到屏幕任意位置。在系统托盘区会出现一个图标右键点击可以显示菜单选择“显示/隐藏”或“退出”。5. 核心功能扩展让桌宠“监督工作”最初的桌宠只是一个动画窗口。现在我们为其注入“灵魂”让它能根据用户行为做出反应实现“监督”功能。5.1 监听系统空闲时间监督工作的一个核心是判断用户是否在“偷懒”。我们可以通过监听系统输入鼠标、键盘事件来估算用户空闲时间。这里使用pynput库来全局监听输入事件。首先安装pynputpip install pynput然后修改PetAgent类增加空闲检测逻辑# 在 pet_agent.py 文件开头导入 from pynput import mouse, keyboard from datetime import datetime, timedelta import threading class PetAgent(QWidget): def __init__(self): super().__init__() # ... 保持原有的初始化代码 ... self.initIdleMonitor() # 新增初始化空闲监视器 def initIdleMonitor(self): 初始化空闲时间监视器 self.last_activity_time datetime.now() self.idle_threshold timedelta(seconds60) # 空闲阈值60秒 self.is_user_idle False # 启动鼠标监听线程 mouse_listener mouse.Listener(on_moveself.on_activity, on_clickself.on_activity) mouse_listener.daemon True # 设置为守护线程主程序退出时自动结束 mouse_listener.start() # 启动键盘监听线程 keyboard_listener keyboard.Listener(on_pressself.on_activity) keyboard_listener.daemon True keyboard_listener.start() # 空闲检查定时器 self.idle_check_timer QTimer(self) self.idle_check_timer.timeout.connect(self.checkIdleStatus) self.idle_check_timer.start(5000) # 每5秒检查一次 def on_activity(self, *args, **kwargs): 当有任何鼠标或键盘活动时调用更新最后活动时间 self.last_activity_time datetime.now() if self.is_user_idle: self.is_user_idle False self.onUserActive() # 用户恢复活动 def checkIdleStatus(self): 检查用户是否空闲超过阈值 if datetime.now() - self.last_activity_time self.idle_threshold: if not self.is_user_idle: self.is_user_idle True self.onUserIdle() # 用户进入空闲状态 def onUserIdle(self): 当用户空闲时的处理宠物做出提醒 print(用户已空闲超过1分钟宠物开始提醒...) # 改变宠物状态为“提醒”或“生气” self.pet_state remind # 可以切换到一个“生气”或“提醒”的图片帧 # self.current_pixmap QPixmap(resources/images/fish_angry.png) # 也可以让宠物“说话”显示一个文字气泡需要额外UI组件 self.showMessageBubble(我允许你偷懒了吗快回来工作) self.update() def onUserActive(self): 当用户恢复活动时的处理宠物恢复正常 print(用户恢复活动宠物停止提醒。) self.pet_state idle self.hideMessageBubble() self.update() def showMessageBubble(self, text): 显示一个文字气泡简化版实际需要更复杂的UI绘制 # 这里可以创建一个QLabel作为气泡并设置定时器自动消失 # 为简化示例我们仅在控制台打印 print(f[Pet Bubble]: {text}) def hideMessageBubble(self): 隐藏文字气泡 pass5.2 实现更丰富的状态与动画为了让监督更有趣我们可以定义更多状态和对应的动画序列。状态触发条件宠物行为对应图片资源idle默认状态循环播放待机动画轻微摆动fish_idle_1.png,fish_idle_2.pngblink随机或定时触发播放一次眨眼动画fish_blink.pngsleep用户长时间空闲后播放睡觉动画打呼噜fish_sleep_1.png,fish_sleep_2.pngremind用户空闲超过阈值播放提醒动画跳动、生气并显示气泡fish_angry.pnghappy用户完成一项任务需与其他应用集成播放高兴动画fish_happy.png你需要准备相应的图片序列并在initPet和状态切换逻辑中加载它们。6. 常见问题排查与调试在开发过程中你可能会遇到以下典型问题。这里提供排查思路和解决方案。6.1 窗口问题排查问题现象可能原因检查与解决方式窗口有白色背景或边框透明背景属性未生效或图片背景不透明1. 确认setAttribute(Qt.WA_TranslucentBackground)已调用。2. 确认使用的 PNG 图片背景为透明在图片查看器中检查。3. 尝试在paintEvent中先填充透明色painter.fillRect(self.rect(), Qt.transparent)。无法拖动窗口鼠标事件未被正确捕获或处理1. 检查mousePressEvent,mouseMoveEvent,mouseReleaseEvent方法是否已重写。2. 确认setMouseTracking(True)已设置。3. 在事件处理函数中调用event.accept()。窗口无法置顶窗口标志设置不正确检查setWindowFlags中是否包含Qt.WindowStaysOnTopHint。关闭主窗口后程序不退出系统托盘图标保持程序运行这是预期行为。需要通过托盘菜单的“退出”选项来结束程序。确保app.setQuitOnLastWindowClosed(False)已设置。6.2 资源与路径问题问题现象可能原因检查与解决方式图片加载失败显示红色方块图片路径错误或文件不存在1. 使用绝对路径或相对于脚本运行路径的正确相对路径。2. 使用os.path模块构建路径os.path.join(os.path.dirname(__file__), resources, images, fish.png)。3. 在代码中添加异常捕获并打印错误信息。动画播放卡顿或不流畅定时器间隔太短或图片过大1. 调整QTimer的间隔如从 100ms 改为 200ms。2. 确保图片尺寸与窗口大小匹配避免运行时缩放。在加载时使用scaled一次性缩放好。系统托盘图标不显示系统不支持或图标路径错误1. 某些 Linux 桌面环境可能需要额外的依赖。2. 确保托盘图标文件存在且格式受支持如 PNG。3. 可以尝试使用QIcon.fromTheme获取系统默认图标进行测试。6.3 功能逻辑问题问题现象可能原因检查与解决方式空闲检测不生效pynput监听器未启动或权限问题1. 在 macOS/Linux 上可能需要授予辅助功能权限。2. 检查监听器线程是否成功启动无报错。3. 在on_activity方法中打印日志确认事件能被捕获。状态切换混乱多个定时器或事件冲突导致状态被覆盖1. 在改变pet_state的地方打印日志跟踪状态流转。2. 确保状态切换是原子的避免在动画播放中途被另一个定时器打断。可以使用一个状态锁。宠物“说话”气泡不显示气泡 UI 组件未正确创建或父窗口问题1. 确保气泡 QLabel 的父窗口设置为宠物窗口 (self)。2. 调用show()方法并设置合适的几何位置。3. 使用QTimer.singleShot控制气泡的自动消失。7. 生产环境考量与最佳实践如果你希望将这个桌宠用于日常使用或者分享给他人需要考虑以下几点。7.1 打包与分发使用 PyInstaller 将 Python 脚本打包成独立的可执行文件方便在没有 Python 环境的电脑上运行。安装 PyInstallerpip install pyinstaller创建打包规范由于项目包含图片等资源文件需要创建一个.spec文件或使用命令行参数将它们包含进去。pyinstaller --onefile --windowed --add-data resources;resources --iconresources/images/fish_icon.ico main.py--onefile打包成单个 exe 文件。--windowed不显示控制台窗口对于 GUI 程序。--add-data将resources文件夹复制到打包程序中。分号前是源路径后是目标路径Windows用;macOS/Linux用:。--icon设置可执行文件的图标。处理路径问题打包后程序的运行路径会改变。在代码中获取资源路径时应使用以下方式import sys import os def resource_path(relative_path): 获取资源的绝对路径。在开发环境和打包后都有效。 if hasattr(sys, _MEIPASS): # 运行在 PyInstaller 创建的临时文件夹中 base_path sys._MEIPASS else: # 运行在正常的开发环境中 base_path os.path.abspath(.) return os.path.join(base_path, relative_path) # 使用示例 image_path resource_path(os.path.join(resources, images, fish_idle_1.png)) pixmap QPixmap(image_path)7.2 性能与资源优化图片优化确保图片尺寸适中如 150x150 像素并使用 PNG-8 或优化过的 PNG-24 格式以减小内存占用和打包体积。定时器管理不需要时停止定时器timer.stop()例如当宠物隐藏或进入休眠时。事件监听pynput的全局监听是系统级操作确保在程序退出时正确停止监听器虽然设置了守护线程但显式停止是良好习惯。7.3 扩展方向一个基础的桌宠已经完成你可以在此基础上添加更多有趣的功能语音交互集成语音合成如pyttsx3库让宠物可以“说出”提醒的话。任务集成与番茄钟Pomodoro应用或任务列表如 Todo.txt集成在专注时间结束后让宠物休息在休息结束后让宠物提醒。网络功能从网络获取天气、名言警句并显示在宠物的气泡中。多宠物系统支持加载不同的宠物角色和皮肤。配置界面创建一个设置窗口让用户可以调整空闲阈值、宠物大小、动画速度等。通过这个从零构建开源桌宠的过程你不仅学会了 PyQt5 创建无边框窗口、处理事件、使用定时器还实践了多线程监听、状态机设计以及资源打包。最关键的是你将一个简单的创意变成了一个可运行、可交互的桌面应用。接下来你可以尝试为你的“蓝色大肥鱼”绘制更精美的动画帧或者实现更复杂的“监督”逻辑让它真正成为你工作学习中的有趣伙伴。