把喜欢的角色请进桌面DyberPet 桌宠框架上手与模组开发指南【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet如果你曾经下载过某个桌宠软件结果发现里面只有几只固定的猫猫狗狗、动作僵硬、还不许你自己换形象那你大概能理解我想要什么——桌宠应该是我喜欢的角色做我喜欢的事而不是软件替我决定的几个模板。DyberPet呆啵宠物就是这样一个基于 PySide6 的开源桌宠框架它把动画播放、养成数值、任务系统、商店背包、迷你宠物甚至对话分支都做成了可插拔的模块你既可以把它当成一个能动的桌面老婆/老公来养也可以把它当成一套练手 PySide6 GUI 开发的现成教材。这篇文章不打算面面俱到只想用最少的篇幅带你把它跑起来、玩明白、再亲手做一个角色模组。先说它有多好玩这不是一个GIF 展示器很多桌宠项目的本质只是循环播放几张图片而 DyberPet 一上来就是完整的一套养成循环。实际用起来你会发现屏幕上的小家伙是活的它会饿、会困、会闹情绪饱食度随时间下降不同饱食度阶段播放完全不同的动画——饱着的时候满地乱跑饿昏了就只剩睡觉这个逻辑不是写死的而是每个角色都能用 JSON 配置。它会跟你互动拍拍它会冒爱心、给反馈拖起来有重力、松手会掉落、落地还有缓冲动作点得太频繁还会弹你现在应该专注在任务上的吐槽气泡。它不只是宠物还是工具内置番茄钟和专注时间专注期间宠物会切换到focus专属动画像个小监工一样陪着你干活完成后掉落物品和金币。它可以带小弟迷你宠物比如自带的派蒙会跟在主角色身后排队走你拖走一个它还会自动补位细节做得很足。最值得先试的是右键菜单这个入口。在宠物身上点右键你会看到角色面板、选择动作、召唤伙伴、更换角色等一串菜单——你可以在里面手动指挥它站立、左右行走、打盹、睡觉也可以打开动画面板随机播放设定好的动作组。配合对话气泡和通知栏整个投喂 → 冒爱心 → 好感度升级 → 解锁新动作的反馈闭环非常顺畅第一次玩很容易不知不觉就陪它待了一个下午。30 分钟从零跑起来安装与首次启动环境准备很简单核心就是 Python 3.9 加几个依赖。推荐用 conda 开一个干净环境免得污染其他项目conda create --name Dyber_pyside python3.9.18 conda activate Dyber_pyside conda install -c conda-forge apscheduler conda install -c conda-forge pynput pip install PySide6-Fluent-Widgets1.5.4 pip install pyside66.5.2 pip install tendo然后把仓库克隆到本地运行入口文件即可git clone https://gitcode.com/GitHub_Trending/dy/DyberPet cd DyberPet python run_DyberPet.py第一次启动程序会扫描res/role/目录下的所有角色自带的 Kitty、ChrisKitty 和系统角色就能直接玩。macOS 用户把pynput换成 1.7.6 版本即可其余步骤一致Windows 用户甚至可以直接下载官方打包的 EXE双击就能跑适合只想先体验的人。新手最容易踩的坑我在 README 和更新日志里帮你提前划出来一是不要用中文或带特殊字符的文件夹名做角色名某些压缩环境会乱码甚至闪退二是单帧时长建议所有动作保持一致否则自定义动作播放时会卡一帧三是如果发现角色悬浮在任务栏上方多半是动画缺了anchor参数后面会说怎么补。为什么它看起来像活的状态与动画的悄悄联动这个项目最让我佩服的一点是它没有把动画和数值写死而是让两者互相影响。用大白话讲每个角色身上同时挂着饱食度和好感度两个数字而动画模块会实时读取这两个数字来决定接下来播什么。你可以在res/role/[角色名]/pet_conf.json里给每个动作组标注一个状态类型比如act_type: [2, 1]表示饱食度 2 级时概率最大好感度到 1 级才解锁。程序在后台每隔几秒就重算一遍各动作的权重饱食度满的时候活泼动作占比极高一旦降到 0权重表里就只剩act_type为[0, 0]的睡觉动作了。这就是为什么饿昏只会睡觉不需要你写任何 if 判断——把规则交给 JSON把计算交给框架。好感度也做了同样的设计等级从 1 级一路升到 200 级每一级要 120 点等级徽章从星星、月亮、太阳一路换到皇冠。喂养角色喜欢的食物好感度翻倍讨厌的食物减半——这些喜爱度倍率同样写在角色配置里。整套东西玩下来你会发现它其实是一个数据驱动的小型养成游戏PySide6 的图形界面只是最外面的一层壳。进阶玩法用 JSON 造一个你自己的角色等官方角色玩腻了就到了 DyberPet 最出彩的部分——模组开发。好消息是你完全不需要会写 Python。做一个基础角色只需要三样东西动画帧透明背景的 PNG 序列放在res/role/[角色名]/action/下命名成动作名_0.png、动作名_1.png这种顺序就行动作配置文件act_conf.json告诉程序每个动作用什么图片、播放几次、要不要移动、每帧间隔多久角色配置文件pet_conf.json把动作组合成动作组设定随机概率、状态阈值、拍拍动画、特殊动作等。有一个原则值得先记住所有图片里角色的脚底必须对齐画布底部并尽量保证角色大小一致。如果某个动作的角色位置偏了就在该动作里加一个anchor: [x, y]把偏移量找回来——这是切换动作时不闪现的关键。仓库的素材开发文档 docs/art_dev.md 里对每个参数都有表格说明照着填基本不会出错。想再进一步物品和对话系统也很好玩。物品用res/items/下的items_config.json定义一个物品可以配置加多少饱食度、多少好感度、掉落权重、商店价格还能挂一个buff比如使用后 10 分钟内饱食度不下降。对话类物品则绑定了msg_conf.json里的多分支对话树——你只需要把文字节点和选项节点用relationship字段连起来就能做出带选项的剧情对话作者在文档里给的实操建议很实在先画流程图再填配置。把每个分支的箭头翻译成text_1: [option_1, option_2]这样的映射一个选项对应一段后续文字就能拼出任意复杂度的对话树。进阶玩法还包括可穿戴物品Equip——在物品模组里定义一件收藏品再在角色的accessory_act里定义一个同名的acc_type: equip组件就能实现给角色穿上翅膀/披风这种持续显示的外观效果。项目还支持昼夜作息给夜间动画打上phase: night标记再写一个day_night块宠物到点就会自己上床睡觉深夜被拍还会有被吵醒的专属动画。这些内容在 docs/art_dev.md 都有完整示例跟着抄一遍就能跑通。一句话总结与资源清单DyberPet 把一个桌面宠物该有的样子做得很完整又用 JSON 把创作的主动权完全交还给了用户——它既是能陪你写代码、做番茄钟的桌面伙伴也是一套零代码做模组的绝佳练手项目。无论你是想找一个能换角色的桌宠还是想研究 PySide6 桌面应用的模块怎么组织都值得花一个晚上跑起来试试。想继续深挖推荐按这个顺序逛快速体验与安装说明README.md环境、运行、版本信息都在这里素材开发文档做角色/物品/对话/迷你宠物的完整指南docs/art_dev.md现成角色与模组合集下载后可通过 App 自动导入docs/collection.md数值、动画与 Buff 系统的实现参考DyberPet/modules.py、DyberPet/Dashboard/buffModule.py最后提醒一句官方角色素材来自画师的原创成果下载和二次创作时请尊重原作者的劳动。祝你早日做出属于自己的那只桌宠让它真的住进你的桌面。【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考