DyberPet 桌面虚拟宠物框架：3 步上手的介绍与上手教程

【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet

DyberPet 是一个基于 PySide6 的开源桌面虚拟宠物框架，让喜欢的角色住进桌面：喂食、互动、做任务、逛商店，还能召唤迷你宠物跟随。它不需要你会编程，下载即用；想深度定制时，用一份 JSON 配置就能导入全新角色。

一、从一个真实场景说起 🖥️

打开电脑写代码、做表格，屏幕右下角往往空着一块区域。DyberPet 让一个桌宠角色"住"进这块区域：它会随机走动、睡觉，饿了会冒出讨食的对话气泡，你拍拍它还会播放专属动画。数值、动作、语音都来自模组文件，不写代码也能换成自己喜欢的角色。

二、快速跑起来 🚀

2.1 创建 Python 环境与安装依赖

目标：把运行依赖装进一个独立的 conda 环境（conda 可以理解成"给每个项目准备一套干净工具箱"的软件）。

conda create --name Dyber_pyside python=3.9.18 conda activate Dyber_pyside pip install PySide6-Fluent-Widgets==1.5.4 pyside6==6.5.2 tendo

这一组命令会依次建好 Python 3.9 环境、激活环境，再安装界面框架 PySide6（Qt 的 Python 版）、UI 组件库 PySide6-Fluent-Widgets 和防多开工具 tendo；版本号建议与 README 保持一致，避免组件不兼容。Windows 用户另外执行conda install -c conda-forge apscheduler和conda install -c conda-forge pynput，macOS 用户执行pip install pynput==1.7.6。

2.2 获取仓库并启动程序

目标：把代码取到本地并运行。

git clone https://gitcode.com/GitHub_Trending/dy/DyberPet cd DyberPet python run_DyberPet.py

这两步把仓库克隆到本地，再运行入口脚本run_DyberPet.py；仓库里的 Kitty 是开箱即用的默认角色。

预期结果：屏幕底部出现一只会走动、会掉落的小猫，右键它可打开系统面板；首次启动会自动创建配置文件。

三、看懂核心功能

3.1 养成数值：饱食度、好感度与金币 🐾

DyberPet 给每个角色配了三个数值：饱食度随时间缓慢下降，喂食能补回来；好感度随互动累积，升到一定等级会解锁物品与动作；啵币则是做任务赚到的零花钱，可以在商店里换东西。

你只需要右键角色，打开面板里的状态页、背包和商店，点"使用"给角色喂食即可。数值变化会伴随弹窗通知和气泡反馈。

用下来你会得到一条完整的养成线：角色饿了会讨食，喂对了喜好食物有专属动画，好感度升级还能领奖励物品。

3.2 对话气泡与分支对话

角色头顶的气泡是它的"说话"方式。程序内置 9 种触发条件：好感度升级、饱食度低于 80、讨食、专注时被打断、点击过于频繁等等，文字和音效都可以通过note/bubble_conf.json改成自己的内容。

更进一步，角色可以携带"对话物品"：使用它后弹出带选项的对话框，每个选项指向不同的后续文字。分支关系写在msg_conf.json的relationship字段里，先画流程图、再照图填配置，就能做出多轮互动。

配置完成后，你的角色会按自己的"人设"和你对话，而不是千篇一律的默认文案。

3.3 专注任务：番茄钟、专注与待办

面板中的任务页把宠物变成了效率工具：番茄钟、专注时间、待办事项、日常目标四类都内置其中。开始番茄钟后，角色会切换成focus专属动画，进度条悬浮在它头顶；提前结束也会按已进行时长结算奖励。

每天完成设定目标后，角色会掉落物品和啵币作为回报。

你得到的是一个软性督促：想偷懒时抬头看它一眼，比生硬的弹窗提醒更容易接受。

3.4 模组生态：换个角色只需导入 🧩

角色、迷你宠物、物品、音效四类内容都以"文件夹 + JSON 配置"的形式存在，这就是模组。想换角色时，下载现成模组后通过 App 的角色管理面板导入即可，程序会自动检测并给出错误提示。

仓库的res/role/Kitty/是一个完整范例：action/目录放动画帧图片，pet_conf.json定义尺寸与动作组合，act_conf.json定义每个动作的帧前缀与移动参数；迷你宠物（如派蒙）本质是一种subpet类型物品，使用后召唤出来跟随主角色。

把这套结构吃透，你就可以照着 素材开发文档 从零画一个自己的角色。

四、典型应用场景

• 长时间写代码的上班族：把番茄钟和待办挂给桌宠，工作时段角色安静地播放focus动作，结束一圈后掉落啵币，休息节奏由它来提醒。
• 喜欢某个游戏或番剧的玩家：从 素材合集 里挑一个同好角色模组导入，让它以桌面桌宠的身份陪伴，再叫上几只迷你宠物跟在身后。
• 会画画的创作者：按文档把透明背景 PNG 按动作名_序号.png命名，配好两个 JSON，就能把自己的形象变成可交互的桌宠。

五、常见问题 ❓

Q：运行时报缺少依赖或界面错乱，怎么办？A：确认PySide6-Fluent-Widgets==1.5.4与pyside6==6.5.2两个版本严格匹配，它们之间有依赖关系，随意升级容易出兼容问题。

Q：macOS 上装完依赖启动失败？A：macOS 需要额外安装pynput==1.7.6，并注意系统屏幕缩放设置；当前源码开源到 v0.6.7，Windows 的打包 Release 版本更新到 v0.8.5，注意两者功能进度不同。

Q：导入角色后动作不显示？A：依次检查三件事：图片是否按动作名_序号.png命名、pet_conf.json里引用的动作名是否与act_conf.json一致、JSON 是否有中文引号等语法错误。开发过程中也可以利用系统面板的自动检测功能，它会检查模组文件夹并提示潜在错误。

Q：可以同时启动多个宠物吗？A：程序本身禁止多开，避免存档数据互相覆盖；同屏多只宠物的正确做法是在"召唤同伴"中拉出第二个角色，它们共享一套存档数据。

写在最后

DyberPet 的价值在于把"桌宠"从一段 Gif 动画变成一套有数值、有任务、有模组的养成系统，而它的全部门槛只有三步：装依赖、克隆仓库、运行脚本。

现在就去把仓库克隆下来，先让默认角色 Kitty 跑起来；想更进一步，就去 素材合集 挑一个你喜欢的角色导入桌面，让它陪你度过接下来的每一个工作日。

【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet