3步让宠物住进桌面：PySide6 桌宠框架 DyberPet 快速上手指南
【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet
如果你曾经想过在桌面上放一个会走路、能被拖着走、还会摔下地板的角色，很快会发现画动画反而是最省事的部分，真正费劲的是那一整套"养"的逻辑——HP、好感度、背包、商店、每日任务，自己搭往往要磨好几个月。DyberPet 把这套系统直接做成了开箱即用的 PySide6 桌面宠物框架：你丢进去帧图和 JSON，它就开始在你的桌面上生活。
它替你省掉的 4 件事
养成数值体系不用你从零搭。HP、好感度、背包、商店、每日任务、番茄钟专注，装好就能玩，角色合集成熟到可以直接上手，见 docs/collection.md。
加角色不用碰主程序。一个角色就是一个文件夹：动画帧图、两个 JSON 配置、立绘，放进规定位置就能跑，资源规范照抄即可。
窗口脏活不用你啃。无边框、置顶、拖拽、掉落、多屏转移都处理完了，你不需要去读窗口消息循环那一套。
交互细节不用你逐个调。它会在桌面上走动、被你拖起来、松手后摔回地板，凌晨零点还会触发跨天事件，这些自己打磨要花掉整个下午。
拆开看，它由哪几块组成
PySide6 解决"窗口和交互"
PySide6 是 Qt 的官方 Python 绑定，Win、macOS、Linux 上行为一致。项目用它做出无边框、置顶、多显示器感知的桌宠窗口，再配 Fluent 风格控件统一观感。对你意味着：拖拽、置顶、缩放这些脏活已经处理完，你可以把精力花在内容上。
信号槽解决"模块协作"
入口脚本里是标准 Qt 写法：宠物窗口、通知、挂件、仪表盘各自独立，全靠 Signal/Slot 连线——一句话翻译，就是"某处发个信号，接线的地方自动跟着动"。好处是改商店逻辑碰不到动画播放器，模块能拆着看、分开改。
JSON 加帧图解决"数据存放"
角色、动作、道具、迷你宠物全是 JSON 配 PNG 帧图，加载时带校验，配置坏了会明确报出哪一级出错。掉落概率、动作权重、对话分支，策划和美术改文件就行，基本不碰代码。
什么人适合拿它上手
- 学习者：把信号槽连线和模块边界拆着读，比啃教程更直观，是理解事件驱动桌面应用的现成样本。
- 做原型的人：改 JSON、丢帧图，一个下午就能出一只可交互的桌宠，先验证创意再谈打磨。
- 想落地产品的人：养成数值、任务商店这些模块可以直接当底座，换皮换角色就是自己的产品。
动手前，先确认这几件事
- 模块能不能拆着看？能，资源、UI、数据各归各的目录，改一处不炸全局。
- 文档够不够自学？模组侧够，docs/art_dev.md 把角色资源讲得很细；但 LLM 能力尚未完全开源，别指望开箱即得的完整 AI。
- 换角色要写代码吗？不用，帧图和 JSON 按结构放进 res/role/，启动时自动扫描加载。
- 环境门槛高吗？不高，Python 3.9+ 加 5 个 pip 依赖，装环境比读文档花时间。
现在就去把它跑起来
总共三步：拉代码、装依赖、跑入口脚本。5 分钟后，一只猫开始在你的桌面上散步。
git clone https://gitcode.com/GitHub_Trending/dy/DyberPet cd DyberPet pip install pyside6 PySide6-Fluent-Widgets apscheduler pynput tendo python run_DyberPet.py跑起来之后，去翻一下res/role/Kitty/act_conf.json，看看每个动作是怎么用帧图前缀加刷新间隔拼出来的。这个结构看懂了，换角色做 MOD 就没有门槛了。🐾
【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
