简介：一款基于Python3.7与PyQt5开发的桌面宠物程序，适合Python学习者、桌面应用开发者或对桌面美化感兴趣的用户。程序默认每10秒播放一个动作，支持鼠标双击激活行走、右键呼出快捷功能，并提供托盘与守护进程模式，整体交互轻量有趣。核心动作与图片配置分离，可根据需要增减动作或替换素材，便于二次开发与扩展。资源包共46个文件，以31张png动作序列帧和9个py源码文件为主，配合说明文档、依赖清单、打包脚本等，压缩后仅457KB。文件结构清晰，core目录下分别管理宠物动作、能力与配置逻辑，适合直接阅读和修改。目前已有1759人学习下载。通过源码可了解PyQt5定时器、鼠标事件、托盘图标及多状态动画的实现思路；附带的run.spec还提供了打包参考（在macOS上验证），可帮助快速将项目转为可执行程序，整体麻雀虽小、五脏俱全。

1. 桌面宠物不是小游戏，是一个会移动的透明窗口

桌面上养一只会走来走去、睡觉、被鼠标拖着跑的小宠物，看起来像个小玩具，但真正动手做的人会发现：它既不是图形引擎渲染，也不是什么动画特效，核心就三件事——一个无边框透明窗口、一套帧动画循环、一个行为状态机。用 Python 实现这套东西并不复杂，Tkinter 加 Pillow 加一个小托盘库就能搞定。

这个标题下的技术落地，解决的是“桌面个性化、轻量常驻应用、GUI 事件编程入门”这一类真实需求，而不是游戏开发。适合的人群也很明确：想学 Python GUI 又想立刻看到趣味结果的新手，以及想快速验证窗口管理、透明色键、事件绑定、打包发布这套链路的中级开发者。它会用一种“看着像玩具，处处是门道”的方式帮你把桌面应用的骨骼摸清楚。

2. 先跑通一只会动的宠物：选型、透明窗口与逐帧动画

2.1 用 Tkinter 还是 PySide6：先想清楚三件事

做桌面宠物，第一个技术抉择就是 GUI 框架。常见的做法是二选一：Tkinter 或者 PySide6。有人一上来就选 PySide6，觉得“反正功能强”，结果打包出来 80MB，初始化还要写一堆类；也有人死守 Tkinter，结果想要半透明毛玻璃效果时发现根本做不到。

我的建议是分三件事来判断。第一，你需不需要真正的 alpha 透明。Tkinter 的transparentcolor是单色色键透明，也就是说它只允许一整块颜色隐去，不支持半透明渐变。如果你要的宠物是像素风、硬边、Q 版贴图，Tkinter 完全够用。如果素材是带抗锯齿圆角、投影、半透明光的精细插画，那真的别纠结，直接 PySide6。

第二，包体和分发成本。Tkinter 是 Python 自带的标准库，配合 PyInstaller 打包出来通常只有 15~25MB。PySide6 哪怕只用到 QtWidgets，单文件也随便奔着 50MB 以上去。桌面宠物这种“图一乐”的项目，用户不会愿意为一个 100MB 的 exe 买单。

第三，托盘和常驻生态。Tkinter 本身没有托盘 API，但配合 pystray 十几行代码就能实现，这也是桌面宠物项目里最主流的组合。PySide6 则要用 QSystemTrayIcon，功能更强，但坑也不少。

所以我的选型结论是：默认 Tkinter + Pillow + pystray。这套组合覆盖了 80% 桌面宠物的需求，依赖少、代码短、打包容易。只有当你明确需要半透明边缘、毛玻璃背景、复杂动画插帧时，才换 PySide6。

2.2 透明无边框窗口的最小代码：色键与置顶

先做一个最小可用的透明悬浮窗。核心是overrideredirect(True)去掉标题栏和边框，再用attributes("-transparentcolor", KEY_COLOR)把某个颜色作为透明色键。这一步会直接决定后续所有素材的处理方式：素材里凡是这个颜色的像素都会在屏幕上消失。

import tkinter as tk # 选一个画面中基本不会出现的颜色作为透明色键 # 不要用纯黑 #000000，很多素材阴影里会带它 KEY_COLOR = "#010101" root = tk.Tk() root.overrideredirect(True) # 去掉系统边框和标题栏 root.attributes("-topmost", True) # 让窗口始终置顶 root.attributes("-transparentcolor", KEY_COLOR) # 把 KEY_COLOR 视为透明 root.configure(bg=KEY_COLOR) # 窗口背景填充为色键色 label = tk.Label(root, bg=KEY_COLOR, bd=0, highlightthickness=0) label.pack() label.configure(text="desktop-pet") # 这里先放文字，后面换成图片 root.mainloop()

这段代码里，overrideredirect和transparentcolor是配套使用的，缺一不可。去掉边框之后，窗口没有关闭按钮，所以退出要么靠右键菜单，要么靠托盘，后面会补上。

-topmost是置顶参数，布尔值。桌面宠物一般需要置顶，但要注意它会把所有窗口都压在下面，包括全屏播放视频时的播放器。很多人的宠物会“消失”，就是因为某个全屏程序把置顶窗口遮掉了，解决方法是把topmost改为可切换，比如在托盘菜单里加一个“前端显示”的开关。

transparentcolor这个参数在 Windows 上行为最稳定；Linux 下取决于桌面合成器，可能完全失效；macOS 上则需要特殊处理。如果你是 Windows 为主，直接照抄；如果是 macOS 用户，建议走 PySide6 的setMask方案，别在 Tkinter 上死磕。

2.3 逐帧动画播放：不要用 sleep，用 after 加绝对时间戳

窗口起来了，下一步是让宠物动起来。桌面宠物的动画本质上就是逐帧切换图片，和 GIF 播放没有区别。常见的错误写法是直接用time.sleep卡在循环里，这会直接卡死 Tk 的窗口事件循环，拖拽、点击全部失效。

正确做法是用root.after(ms, callback)轮询，再配合绝对时间戳做帧对齐。下面的例子是完整的最小动画窗口：

import tkinter as tk import time from PIL import Image, ImageTk FRAMES = ["0.png", "1.png", "2.png", "3.png"] # 按顺序放帧图 FRAME_MS = 120 # 每帧停留 120ms CHECK_MS = 16 # 事件轮询间隔，约 60fps 的检查频率 KEY_COLOR = "#010101" class DesktopPet: def __init__(self): self.root = tk.Tk() self.root.overrideredirect(True) self.root.attributes("-topmost", True) self.root.attributes("-transparentcolor", KEY_COLOR) self.root.configure(bg=KEY_COLOR) self.label = tk.Label(self.root, bg=KEY_COLOR, bd=0, highlightthickness=0) self.label.pack() # 素材必须统一尺寸，否则窗口会随着帧变化而抖动 self.images = [] for f in FRAMES: frame = Image.open(f).convert("RGBA") base = Image.new("RGB", frame.size, KEY_COLOR) base.paste(frame, mask=frame.split()[3]) self.images.append(ImageTk.PhotoImage(base)) self.idx = 0 self.deadline = time.time() * 1000 + FRAME_MS self.root.after(CHECK_MS, self.tick) def tick(self): now = time.time() * 1000 if now >= self.deadline: self.idx = (self.idx + 1) % len(self.images) self.label.configure(image=self.images[self.idx]) # 按绝对时间累加，而不是按 now + FRAME_MS，避免误差累积 self.deadline += FRAME_MS if now - self.deadline > FRAME_MS: # 如果落后已经超过一帧，直接跳到最新时间，防止积压 self.deadline = now + FRAME_MS self.root.after(CHECK_MS, self.tick) if __name__ == "__main__": DesktopPet().root.mainloop()

先把帧图存成0.png到3.png，同一目录运行就能看到一只会动的宠物。代码里base.paste(frame, mask=frame.split()[3])这行很关键：它把带透明通道的 PNG 合成到#010101纯色背景上，这样 Tkinter 才能用色键把背景抠掉。如果你直接把 RGBA 的 PhotoImage 丢给 label，透明区域会变成黑色或残留边缘。

FRAME_MS决定动画速度，120ms 大约 8fps，对桌面宠物来说已经足够顺滑，再快会占用更多 CPU。CHECK_MS是轮询间隔，16ms 是一个折中值，既有派发事件的刷新率，又不会让主循环空转。tick里用deadline做帧对齐，比“每次调用 after 再加延时”更可靠，因为帧处理本身耗时，按调用时刻累加延时会让动画整体越跑越慢。

3. 让宠物“像活的”：动作状态机、拖拽与托盘菜单

3.1 为什么需要动作状态机：从播放动画到行为控制

只会循环播放一组帧，宠物看起来像个复读机，不像生物。要让用户觉得它“活”，需要行为层和播放层分离：播放层只负责按当前动作切换帧，行为层负责决定当前该做什么动作、什么时候切换。

最常见的做法是一个简单的加权状态机。每个动作是一个状态，状态之间用概率权重跳转。比如空闲时 60% 概率继续发呆、30% 概率走两步、10% 概率睡觉；睡觉时 80% 概率继续睡，睡得久一点才自然。直接每帧随机挑动作会显得神经质，也不可控。

import random # 状态跳转权重表：当前状态 -> 目标状态 -> 选中概率 TRANSITIONS = { "idle": {"idle": 0.6, "walk": 0.3, "sleep": 0.1}, "walk": {"idle": 0.5, "walk": 0.4, "sleep": 0.1}, "sleep": {"sleep": 0.8, "idle": 0.2}, "drag": {"drag": 1.0}, # 拖拽中锁定动作，松手后回 idle } def pick_next(state): opts = list(TRANSITIONS[state].keys()) weights = list(TRANSITIONS[state].values()) return random.choices(opts, weights=weights)[0]

random.choices的权重不需要归一化，它会自动按比例抽取。这里的参数要调的是各个状态的持续性。桌面宠物的体感来自“行为节奏”，idle 自循环概率太高会呆，sleep 的自循环太低会频繁醒，通常我会把 sleep 的自持权重调到 0.7~0.8，让它一次睡十几秒以上。

状态机确定动作之后，播放层只要根据动作名去加载对应的帧序列即可。我习惯的文件组织是按前缀命名：idle0.png、idle1.png、walk0.png、walk1.png等，状态机和播放层通过动作名解耦，新增一个动作只需要加一组帧和一个跳转权重的映射。

外部事件也可以驱动状态机。被拖拽时进入 drag 状态，松手回 idle；鼠标悬停时可以加一个“好奇”状态抬个头。事件驱动的状态注入和周期性的随机跳转不冲突，只是把状态机的输入来源从“随机”扩展为“随机 + 事件”。

3.2 拖拽移动：记录偏移，再更新 geometry

去掉窗口边框之后，用户没法通过系统标题栏拖动宠物，所以拖拽必须自己实现。这里最经典的翻车点是：直接把鼠标的屏幕坐标当成窗口坐标用，结果按下鼠标那一刻，窗口会跳到鼠标位置。

正确做法是按下时记录鼠标在窗口内部的偏移，移动时用屏幕坐标减去这个偏移，得到窗口左上角的新坐标。

class PetDragMixin: def setup_drag(self): self._offset = (0, 0) self._dragging = False self.root.bind("<ButtonPress-1>", self.on_press) self.root.bind("<B1-Motion>", self.on_motion) self.root.bind("<ButtonRelease-1>", self.on_release) def on_press(self, event): # event.x / event.y 是鼠标在窗口内的相对坐标 self._offset = (event.x, event.y) self._dragging = True self.state = "drag" def on_motion(self, event): if not self._dragging: return # event.x_root / event.y_root 是鼠标在屏幕上的绝对坐标 x = event.x_root - self._offset[0] y = event.y_root - self._offset[1] self.root.geometry(f"+{x}+{y}") def on_release(self, event): self._dragging = False self.state = "idle"

这里event.x和event.x_root的区别是核心。前者是相对当前 widget 的坐标，后者是相对屏幕的坐标。记录偏移用的是相对坐标，计算新窗口位置用的是屏幕坐标，两边不能混用。

geometry(f"+{x}+{y}")只传偏移量，不传宽高，Tk 会保留当前窗口尺寸，这是最轻量的移动方式。如果你的帧图尺寸很大，拖动时可能会感觉到掉帧，那是因为每次geometry调用都会触发一次完整的重算。解决办法是在on_motion里做节流：记录上一次移动的时间，距离上一次不足 16ms 就忽略这次事件。

3.3 右键菜单与托盘常驻：退出入口要统一

无边框窗口没有系统菜单，所以右键菜单和系统托盘必须自己接。右键菜单用 Tk 的Menu，托盘用 pystray，两者都要指向同一个退出函数。这里的关键教训是：退出逻辑必须只有一个入口，否则会出现“窗口关了进程还在”的灵异现象。

import threading import pystray from PIL import Image import tkinter as tk def quit_pet(icon=None, item=None): # 先停托盘，再退出主循环，顺序不能反 if icon is not None: icon.stop() root.quit() root.destroy() root = tk.Tk() menu = tk.Menu(root, tearoff=0) menu.add_command(label="退出宠物", command=quit_pet) root.bind("<Button-3>", lambda e: menu.tk_popup(e.x_root, e.y_root)) tray_icon = pystray.Icon( "desktop_pet", # 托盘图标的唯一标识 Image.open("icon.png"), # 托盘图标，建议 32x32 "桌面宠物", # 鼠标悬停在托盘图标上的提示 menu=pystray.Menu( pystray.MenuItem("退出宠物", quit_pet) ), ) threading.Thread(target=tray_icon.run, daemon=True).start() root.mainloop()

pystray 的run()是一个阻塞调用，它会启动自己的消息循环，所以必须放进独立线程，否则root.mainloop()永远执行不到。daemon=True保证 Python 主线程退出时，托盘线程不会成为进程残留的元凶。

菜单项里的quit_pet和右键菜单里的quit_pet是同一个函数，这是统一退出入口的关键。如果右键菜单调root.quit()，托盘菜单调icon.stop()，两者都会留下一半的清理工作，表现就是用户杀不干净进程。另外，托盘图标建议在初始化时判断一下系统是否支持，有些精简 Windows 环境没有 Shell_TrayWnd，pystray 启动会直接抛异常，这个异常要在线程里 catch 住并打印日志。

4. 桌面宠物避坑实录：透明残留、拖拽跳动、托盘退不干净等 5 个坎

4.1 坑一：圆角边缘发白、透明色变成马赛克块

现象：宠物贴图边缘出现一圈白边，圆角处尤其明显，甚至整块不规则的半透明像素变成灰白相间的马赛克。

原因：Tkinter 的transparentcolor是色键透明，它只能识别“完全等于该颜色”的像素。而 PNG 素材的 Alpha 通道是 8bit 渐变，在透明与不透明交界处存在大量中间值像素，这些像素既不是完全不透明，也不是完全透明，色键机制处理不了它们，只能原样画出来。JPEG 压缩产生的颜色污染也会让本应是背景色的像素产生波动，出现脏边。

解决：素材统一使用 PNG，并且在加载时把 Alpha 通道合成为色键色背景上的不透明像素，就是用Image.new("RGB", size, KEY_COLOR)打底，再用frame.split()[3]作为 mask 进行paste。这个操作会把半透明边缘像素过渡成接近色键色的实色，让边缘看起来至少是干净的。如果素材本身带高精度抗锯齿效果，可以把边缘裁剪成硬边风格，用设计上的取舍绕开色键缺陷。

4.2 坑二：动画越跑越慢，半小时后变成 PPT

现象：宠物刚启动时动画秒切换，运行十分钟后明显变慢，半小时后像幻灯片，重启程序后恢复。

原因：root.after(FRAME_MS, self.tick)的延时是从调用时刻开始计算的。如果tick函数里帧切换、图片更新耗时 40ms，而你设定的是 120ms，实际每帧变成 160ms，这还不是最要命的。真正的问题是当系统忙时某次after被阻塞了 300ms，恢复后计时器依然按 120ms 累加，误差就永久累积了。

解决：用绝对时间戳对齐帧。代码里维护一个deadline，每帧切换后deadline += FRAME_MS，与当前时间比较。如果落后超过一整帧，直接deadline = now + FRAME_MS跳帧，避免积压。这也是为什么我在第 2 章把tick写成那样而不是简单的after(FRAME_MS)。

4.3 坑三：拖拽时位置跳动或窗口闪烁

现象：鼠标按下宠物时，宠物先飞到手边再开始跟随；拖动过程中窗口一抖一抖的，边缘有残影。

原因：飞到手边是因为没有记录偏移，直接把event.x_root当成了窗口左上角。抖动则是因为B1-Motion事件触发的频率远高于屏幕刷新率，每次触发都调用geometry，Tk 被迫频繁重算窗口位置，GPU 合成跟不上就闪。

解决：按下时用event.x和event.y记录鼠标在窗口内部的偏移，移动时用event.x_root - offset_x计算窗口位置。如果还闪，在on_motion里加时间戳节流，例如记录上一次移动的毫秒时间，距离不足 16ms 直接 return。这两个动作一起做，拖拽手感基本能达到系统窗口的水平。

4.4 坑四：托盘点了退出，窗口关了进程却在后台常驻

现象：托盘菜单点“退出宠物”，图标消失，宠物窗口也关掉了，但任务管理器里进程依然存在，CPU 偶尔还占一点。

原因：退出函数只调了icon.stop()，没有调root.quit()。pystray 的stop()只是让托盘线程结束，Tk 主循环还活着。反过来只调root.quit()不调icon.stop()，托盘线程因为没有显式回收，会阻塞 Python 解释器退出，同样形成残留。两条退出路径各管一半，是最常见的场景。

解决：统一退出入口，先icon.stop()，再root.quit()，最后root.destroy()。右键菜单、托盘菜单都调用同一个函数。另外给pystray.Icon.run()加一个 try/except，避免某些 Windows 环境下托盘线程抛出异常导致退出流程中断。

4.5 坑五：高分屏下宠物尺寸和坐标全乱

现象：同样的代码在 1080p 正常，在 4K 屏上宠物变得特别小，或者拖到屏幕边缘定位不准，点不到想点的地方。

原因：Tk 默认不感知进程 DPI 缩放。在系统缩放为 150% 或 200% 时，event.x_root返回的坐标和窗口实际显示位置之间产生了比例偏差，winfo_screenwidth()拿到的也是未经缩放的分辨率。程序被系统强制虚拟化，坐标系就乱了。

解决：入口处提前设置 DPI 感知，必须在创建tk.Tk()之前执行。

import ctypes def enable_dpi_awareness(): try: ctypes.windll.shcore.SetProcessDpiAwareness(2) except Exception: try: ctypes.windll.user32.SetProcessDPIAware() except Exception: pass enable_dpi_awareness()

SetProcessDpiAwareness(2)是 Per-Monitor DPI Aware，窗口坐标按实际像素计算，不再缩放。旧版 Windows 没有这个 API，所以回退到SetProcessDPIAware()。PySide6 用户不需要这段，只需要设置QGuiApplication的高 DPI 策略即可。

5. 进阶与验证：打包成 exe、开机自启与单实例锁

桌面宠物做到能跑能交互只是第一步，投入日常使用还需要解决三件事：打包、自启、防双开。

打包用 PyInstaller，命令里的参数每一个都有实际意义。-F打单文件；-w禁止控制台窗口，否则开机自启时会弹黑框；--collect-all pystray是血泪教训，pystray 在 Windows 上运行时动态寻找后端，打包经常漏文件，导致目标机器上托盘消失或直接崩溃。

pyinstaller -F -w desktop_pet.py --collect-all pystray --noconfirm

打包完验证两件事：第一，双击 exe 后托盘图标是否正常出现；第二，拖拽和右键菜单是否都在。透明色键在 PyInstaller 打包后偶尔会失效，原因是 tcl 资源没有打进包，这种情况给 PyInstaller 加--collect-tcltk基本都能解决。

开机自启的常见做法是把 exe 放进启动目录，用%APPDATA路径定位。

cp dist/desktop_pet.exe "$APPDATA/Microsoft/Windows/Start Menu/Programs/Startup/"

开机自启后立刻面临一个现实问题：如果用户又从命令行手动开一次，桌面上会出现两只宠物互叠，状态机各跑各的。所以加一个单实例锁，用临时目录下的锁文件实现。

import os import sys import tempfile LOCK = os.path.join(tempfile.gettempdir(), "desktop_pet.lock") def check_single_instance(): if os.path.exists(LOCK): return False open(LOCK, "w").close() return True

注意退出时要显式删除锁文件，否则程序崩溃后锁会残留，用户以后再也打不开宠物。这个坑我在调试时撞上过：托盘退出逻辑调顺了，单实例锁又因为异常没有清理，排查了半天才发现是锁文件没删。

我的习惯是给项目加一个 debug 开关，打开后把状态切换、拖拽、退出事件全部打进日志文件。桌面宠物这类交互逻辑看起来简单，真出了问题光靠看窗口现象很难定位，日志是最直接的排错方式。如果你决定照着做，从最小透明窗口跑通，再到状态机和模块，然后补打包，这一趟下来，你对 Tkinter 的窗口模型会有很完整的认知。希望帮到你。

本文还有配套的精品资源，点击获取