DyberPet 桌面宠物框架完整指南把喜欢的角色搬进桌面【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPetDyberPet 是一个基于 PySide6 的开源桌面宠物框架它把一套二维帧图变成一个会走动、会被拍、会被喂食、还能陪你跑番茄钟的桌面宠物。它既适合想在桌面上放一个喜爱角色的普通用户也适合想创作自己宠物模组的开发者。启动后的第一分钟桌宠长什么样双击启动后你看到的第一样东西不是主窗口而是坐在屏幕底部的一个角色宠物本身就是界面。点它一下它会播放拍拍动画点击位置飘出几颗红色爱心按住左键拖动角色会被拎到空中松手后带着重力掉下来落地时还有轻微回弹。右键能呼出菜单可以切换角色、召唤同伴、打开 Dashboard。整个第一分钟的体验是它不是挂在墙上的 GIF而是一只带物理、带状态、带互动的桌面宠物。一句话定位基于 PySide6 的桌面宠物开源框架DyberPet 把自己定位成框架宠物本身是可替换的模组内置的派蒙、Kitty 只是示例。它同时服务两类人——用宠的人和做宠的人。项目采用 GPL-3.0 开源任何行为的实现都能直接翻源码确认按自己的需要改。技术栈Python 3.9PySide6、PySide6-Fluent-Widgets 负责界面apscheduler 负责定时任务支持平台仓库提供 Windows 与 macOS 的源码安装说明Windows 另有预编译版许可证GPL-3.0文档入口docs/art_dev.md 素材开发文档docs/collection.md 素材合集先跑起来最快的安装路径对新手来说最快的途径是官方 Release 里的预编译版Windows 用户下载 EXE 双击即用完全不用准备 Python 环境。想跑源码或在 macOS 上运行克隆仓库、装好依赖执行入口文件即可git clone https://gitcode.com/GitHub_Trending/dy/DyberPet.git cd DyberPet pip install PySide66.5.2 PySide6-Fluent-Widgets1.5.4 apscheduler pynput tento python run_DyberPet.py先体验、后看代码启动后先熟悉右下角的宠物和右键菜单设置入口都在菜单里熟悉之后再对照源码会快很多。功能拆解这只桌面宠物能做什么跑起来之后值得花几分钟看看它实际能做什么而不是停留在会动的贴图层面。会拍、会喂、会拖的交互宠物核心收益是随时有事可互动。单击触发拍拍动作不同饱食度下动画不一样按住拖动可以把宠物放到屏幕任意位置松手后按物理规律下落右键能切换常驻动作、召唤同伴。它还会在启动、喂食、升级等不同时机弹出对话气泡显示对应的台词。和挂着看的桌宠不同DyberPet 的每一帧交互都有反馈。饱食度、好感度与等级宠物有随时间下降的饱食度需要从背包里喂食物不同食物回复的数值不同部分还附带 Buff。好感度随互动积累最高 200 级等级越高解锁的物品和动作越多。这套数值系统的意义在于给你每天打开它的理由相当于一个轻量的养成循环而不是单纯的动图展示。番茄钟、专注与待办Dashboard 的任务面板内置番茄钟、专注时间和提醒事项。开始专注后宠物会切换到 focus 动作陪你工作结束或取消时会播放对应动画并发放奖励。对长时间对着屏幕的人这部分是整个框架最实用的地方桌面宠物同时是你的工作节奏提醒器。物品、商店与迷你宠物背包是可自由拖动交换的格子物品分食物和收藏品两类商店可以用金币买入或卖出部分物品带 Buff比如汉堡能让饱食度 5 分钟内不下降薯条每 30 秒额外掉 5 个金币。还能召唤迷你宠物跟随主宠物多只自动排队。这一整套系统全部由 JSON 数据驱动也是模组生态存在的基础。DyberPet 桌面宠物框架的完整界面状态、物品、商店、任务面板都收在 Dashboard 里宠物本体常驻在桌面上方。桌面宠物交互动图拖拽、对话气泡弹出、右键菜单与状态变化。把它变成你的三层定制想让宠物变成你的DyberPet 把定制拆成三层素材标准都写在 docs/art_dev.md 里。外观层帧图素材在角色文件夹的 action/ 目录下放同前缀、按序号命名的 PNGstand_0.png、stand_1.png……程序就会按帧率播放成一串动画。内置的 res/role/Kitty/ 是一个可以直接对照的完整示例头像等形象文件放在 info/ 目录。行为层两份 JSON 配置pet_conf.json 定义角色属性尺寸、默认动作、跟随方式、锚点等act_conf.json 定义每个动作的帧数、帧间隔、是否需要位移和移动方向。两个文件一起决定这只宠物怎么动、往哪走改配置就能调整行为不需要碰代码。内容层物品与对话物品放在 res/items/ 下用 items_config.json 配置 effect_HP、effect_FV 和 buff 效果角色专属的对话气泡图标、文案与语音放在角色目录的 note/ 子目录用 bubble_conf.json 定义每种情境下弹出什么气泡。外观、行为、内容三层互相独立你只改其中任何一层都能生效。上手之后还能做什么体验完内置内容有三件事可以做。把自己的角色模组发布出去docs/collection.md 是官方素材合集维护者欢迎通过 PR 收录新作品。参与 LLM 接入工作README 中说明大模型接入功能仍在开发中这也是项目当前最希望得到帮助的方向。再小的贡献也可以比如提交 Issue 反馈问题或补充 res/language/ 下的翻译文件。踩坑提醒几个高频问题导入的角色不显示→ 原因文件夹结构不完整或 JSON 格式有误至少需要 pet_conf.json、act_conf.json、action/ 三件套。对策用系统面板里角色管理的自动检测功能程序会检查模组文件夹并给出错误提示。文件名解压后乱码→ 原因素材文件名或文件夹名用了中文部分系统解压后乱码甚至导致程序崩溃。对策文件名和目录一律用英文素材开发文档对此有明确说明。界面卡顿或角色抽搐→ 原因同时运行角色和迷你宠物过多或帧图分辨率过高。对策减少同屏角色数量降低帧图尺寸必要时关闭置顶。存档数据异常→ 原因异常退出时写入了不完整的存档文件。对策定期用存档面板的导出功能备份导入新存档前也先导出面板里自带这条提示。第二次启动没反应→ 原因程序做了单例设计禁止多开以避免数据混乱。对策想让多只宠物同屏用右键菜单里的召唤同伴而不是再启动一个进程。写在最后还是屏幕底部那只角色鼠标划过时它等着被拍你拖动它它就跟着走开始专注后它会安静地待在角落陪你。DyberPet 有趣的地方在于宠物和框架是同一件事——用得越多越想改一改改着改着就明白这个开源桌面宠物框架是为谁做的。如果你的桌面也想住进一个角色克隆仓库跑一遍 run_DyberPet.py第一分钟你就能见到它。【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考