企业官网建设流程全解析

DyberPet 完整指南：用 JSON 配置 5 分钟做出你的桌面宠物

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

下午写代码写到一半，桌面上的角色自己踱到任务栏边、打了个哈欠，又举出一个要饭的气泡；把它拎起来一松手，它按重力摔落、落地再弹起来。这是开源桌面宠物框架 DyberPet 的日常：基于 PySide6 构建，角色的动画、对话、养成全部由 JSON 配置驱动，你一行框架代码都不用写。

DyberPet 解决什么问题

市面上的桌宠大多是"循环播放的动图"：不能互动、不能养成，想换个角色得等作者重写代码。DyberPet 把桌宠做成了一份数据而不是代码：

• 角色素材放进一个文件夹就能用，动画、对话、物品全是 JSON + 图片
• 自带完整系统：饱食度、好感度、商店、背包、任务与提醒
• 社区 MOD 与内置角色通用同一套导入流程，导入即可激活

适合谁

• 想要一个会提醒、会互动的学习工作陪伴
• 想把喜欢的角色（自制的或社区的）放到桌面上动起来的创作者
• 想参考 PySide6 桌面应用如何分模块拆分的开发者

不适合谁

• 只想要"放上去就不用管"的纯展示型宠物
• 需要游戏级物理与关卡能力的场景——它是桌宠框架，不是游戏引擎

🚀 三条命令装好并跑起来

准备 Python 3.9+ 环境，然后克隆、装依赖、运行入口文件：

git clone https://gitcode.com/GitHub_Trending/dy/DyberPet cd DyberPet && pip install PySide6==6.5.2 PySide6-Fluent-Widgets==1.5.4 apscheduler pynput tendo && python run_DyberPet.py

首次运行后，桌面上会出现内置的像素猫 Kitty，旁边带一个系统面板：可以在角色管理里切换宠物，打开商店、背包、任务面板，也可以直接开一个番茄钟。Windows 用户更省事——Release 里提供了打包好的 EXE，双击即用，无需配置环境。

功能全景：从你要做的事找它给的能力

✏️ 动手改一改：改一个 JSON 就能看到行为变化

以内置的 Kitty 为例，它的文件夹就是一个角色的最小完整形态：

• res/role/Kitty/action/：各动作的序列帧图片
• act_conf.json：动作定义——每个动作对应哪个帧前缀、几帧、什么帧率、播放时是否位移
• pet_conf.json：行为配置——默认动作、随机动作列表及触发概率

关键在pet_conf.json的random_act数组：

"random_act": [ {"name": "站立", "act_list": ["default"], "act_prob": 1.0}, {"name": "左右行走", "act_list": ["left_walk", "right_walk"], "act_prob": 0.1}, {"name": "睡觉", "act_list": ["fall_asleep", "sleep"], "act_prob": 0.05} ]

把0.05改成0.5，小猫走几步就趴下睡觉的概率明显变高；把0.1改成0，它就再也不会左右踱步。改完重启即生效，不需要理解框架代码。图片、帧名、配置字段的完整规范见素材开发文档。

高频用法速览

• 不改代码新增角色：从素材合集里挑一个现成 MOD（纳西妲、流萤、像素猫等十余个角色、6 个迷你宠物），下载素材包后在角色管理面板导入即可启动。
• 和宠物一起专注：任务面板开一个 25 分钟番茄钟，计时期间角色进入专注动作，结束时通知栏弹消息并可能掉落物品奖励。
• 无人值守设置：打开自动喂食和自动锁定选项，锁屏时饱食度、好感度停止衰减，长时间工作也不必担心角色"饿死"。

技术看点

• 配置与代码彻底分离：角色等于"图片 + 3 个 JSON"，框架只负责读数据，新增角色等价于新增一个文件夹。
• 模块间用数据信号驱动：动画、交互、状态、对话各自独立，饱食度、好感度等状态变化会自动调整动作概率并解锁内容，模块之间不硬编码调用。
• PySide6 + Fluent-Widgets 界面：无边框透明窗口、多屏适配、高分屏缩放开箱即用，UI 贴近 Windows 11 风格。

📦 社区与更新

• MOD 生态已具规模：素材合集收录了 10 余个社区角色、6 个迷你宠物和多组物品包，下载后在 App 内一键导入，欢迎按素材开发文档创建自己的角色并提交。
• 近期版本要点：
  • v0.6.7：设置中新增关闭对话气泡的选项，并微调气泡触发概率
  • v0.6.6：背包升级为可自由拖动交换的格子，新增自动喂食
  • v0.6.5：新增自动锁定选项，锁屏状态下数值停止变化

上手清单

1. 克隆仓库运行run_DyberPet.py，先让 Kitty 在桌面上跑起来
2. 从素材合集导入一个自己喜欢的角色
3. 打开res/role/Kitty/pet_conf.json，改一个act_prob数值，观察行为变化
4. 通读一遍素材开发文档，开始做属于你自己的角色

动图展示了完整的交互循环：拖拽、喂食、对话气泡与物品反馈。

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