三步把喜欢的角色搬上桌面开源桌面宠物框架 DyberPet 完整上手指南【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPetDyberPet 是一个基于 PySide6 的开源桌面宠物框架开箱即用桌宠动画、拖拽交互、养成状态、每日任务和商店系统。想把自己喜欢的角色放在桌面上陪自己办公或者想动手做一个自定义桌宠 MOD这篇指南会讲清楚它怎么跑起来、内部怎么运转、以及如何照着 素材开发文档 三步产出自己的角色。第一次运行把呆啵宠物跑到你的桌面上上手有两条路按你习惯选一条。直接下载Windows 用户从 Release 页面拿打包好的 EXE双击就能跑当前版本为 v0.8.5。源码运行clone 仓库后用 conda 建一个 Python 3.9 环境安装 PySide6 6.5.2、PySide6-Fluent-Widgets 1.5.4 等依赖最后执行根目录的run_DyberPet.py即可启动。git clone https://gitcode.com/GitHub_Trending/dy/DyberPet图注桌宠本体的右键菜单、对话气泡和右下角通知提示右侧列表里还能实时看到数值变化启动后你会看到两套东西桌面上一个可以自由拖动、会左右走动的小角色以及一个系统面板。角色支持点击、拖拽、跟随鼠标吃饱了会说谢谢闲久了会打瞌睡——这些都不是 GIF而是逐帧播放的 PNG 序列图。拆解内部一个桌宠靠什么活起来很多人以为桌宠就是贴了张会动的图DyberPet 的做法是分三层来干活。配置层角色的所有行为都写在 JSON 里代码和素材完全分离。比如内置角色派蒙的参数文件res/pet/派蒙/pet_conf.json只有二十几行{ width: 112, height: 128, scale: 1.0, interact_speed: 0.02, default: default, drag: default, random_act: [ {name:default, act_list:[default], act_prob:1.0} ] }width、height决定角色多大interact_speed控制移动快慢random_act则是一份随机行为表程序按概率挑一个动作来演。改数值、加动作都不用碰 Python 代码。动画层按 素材开发文档 的描述程序把动画分给两个模块——动画模块负责常态动作的循环播放独立于主界面运行不会让窗口卡死交互模块专门响应拖拽、点击这类即时操作。播放一个动作时程序按设定间隔依次显示action/文件夹里同前缀的图片比如stand_0.png、stand_1.png排下去就是站立呼吸动画。面板层Dashboard/目录下的几个 UI 文件各管一摊animationUI.py管动画、statusUI.py管饱食度和好感度、taskUI.py管任务、inventoryUI.py和shopUI.py管背包与商店。想看懂哪块逻辑直接对号入座去看对应文件就行。图注左侧是角色管理列表右侧状态面板实时显示等级、饱食度、好感度和状态日志动手做一个专属桌宠一个文件夹 4 类文件这是整个框架最友好的地方——新角色就是一套文件夹放进数据目录后系统自动识别。照着文档走流程是画帧图每个动作一个前缀帧号从 0 递增。想要站立、行走、睡觉三种状态就准备stand_*.png、leftwalk_*.png、sleep_*.png三组文件放进action/。写动作配置act_conf.json里给每个动作填播放间隔和移动距离走路的角色就是靠这里的参数在屏幕上挪位置的。写角色配置pet_conf.json定义尺寸、缩放、默认动作和随机行为表就是上面那段 JSON。可选加对话配合msg_conf.json和气泡配置让角色会说自己的台词框架支持带分支的多轮对话结构可以参考 docs/dialogue_graph2.png 这样的对话流程图。几个实用细节文件名务必用英文繁中系统解压素材可能出现乱码开发时可以用系统面板里对应模组的自动添加功能边测边调程序会检查文件夹结构并提示潜在错误角色还支持昼夜作息和个性化通知睡觉、喊你休息这类行为都可以配出来。养成分身任务、商店和还在路上的 AI桌宠在 DyberPet 里是可以养的。状态面板记录着等级、饱食度和好感度喂一次东西右下角的通知栏会弹出饱食度 1角色也会冒气泡道谢。每日任务系统让你给角色派活完成后掉落金币和道具商店和背包支持购买、拖拽整理这套游戏化机制在buffModule.py等模块里实现数值全部走 JSON 配置所以你自己也可以调整掉率。更值得关注的是 AI 方向框架规划了接入大模型的能力让桌宠承担陪伴聊天、管理待办这类桌面助手职能该模块目前仍在开发中。不接 AI 也完全没问题——养成、任务、商店构成的是独立完整的一整套体验大模型是加分项而非前置条件。从玩家到作者MOD 社区与接下来的方向项目采用 MIT 协议角色、物品、音效、迷你宠物四类素材都可以自由扩展和再创作。仓库里的 docs/collection.md 收录了现有的角色和道具模组清单下载后在应用内导入即可上手想原创内容则以素材开发文档为准。从路线图看接下来主要投入在 LLM 模块的完善上README 里也提到欢迎有意共建的开发者参与。如果你现在只想让桌面热闹一点下载 EXE 导入一个现成角色就够了如果你想把自己的原创角色做出来分发给别人这套文件夹 JSON的规范基本是目前桌宠领域里上手门槛最低的方案之一。【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考