10分钟拥有桌面宠物:DyberPet 桌宠框架完整快速上手指南
【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet
想让喜欢的角色搬进你的桌面,会走、会跳、会饿、还会陪你专心工作?这套基于 PySide6 的开源桌宠框架DyberPet(呆啵宠物),把动画引擎、养成数值、任务商店和对话气泡打包成了一只完整的桌面宠物,从零跑起来只需要十分钟。
出发之前:先搞懂这只桌宠到底"会什么"
DyberPet 不是一张会动的壁纸,它更像一个"桌面版角色养成小游戏",值得你期待的核心能力有这些:
- 会饿会亲:饱食度每分钟悄悄下降,饿了你得喂;好感度最高 200 级,互动越多关系越铁
- 会陪你干活:内置番茄钟和专注计时,倒计时实时挂在宠物头顶
- 会碎碎念:点击、喂食、升级、甚至你 1 秒内狂点它 7 次以上,它都会弹出对话气泡回应
- 能换装扩充:角色、迷你宠物、物品、音效全部开放自定义,社区已有一批现成模组
一句话:它不满足于卖萌,而是想成为你桌面上那个"有生活节奏"的伙伴。
第一站:两条路径,选一条就能出发
图省事:Windows 用户直接下载 Release 里的 EXE 文件,双击运行,连 Python 都不用装。
想折腾:用 conda 建独立环境,再克隆仓库跑起来:
conda create --name Dyber_pyside python=3.9.18 conda activate Dyber_pyside conda install -c conda-forge apscheduler pynput pip install PySide6-Fluent-Widgets==1.5.4 pyside6==6.5.2 tendo git clone https://gitcode.com/GitHub_Trending/dy/DyberPet cd DyberPet python run_DyberPet.py上面几行在干嘛?conda帮你搭一个干净的环境(Python 3.9.18),pip装好 PySide6 图形界面依赖,最后运行run_DyberPet.py启动主程序。macOS 用户只需把pynput换成 1.7.6 版本即可。
第二站:首次运行,认识它的三个入口
启动后,你的屏幕角落会出现一只桌宠。右键点击它,菜单里藏着整套系统的入口:
- 角色面板:查看饱食度、好感度、喂养天数,还能看到状态日志
- 背包与商店:管理物品、买卖道具,商店里的好东西会随好感度等级解锁
- 系统设置:更换角色、调整大小、管理存档
第一次接触,建议你先把"拍拍"和"喂食"各试一遍——点击时它会冒出"摸摸"气泡,心情好了还会飘出爱心,喂下去的食物会立刻反映在数值条上。
第三站:核心玩法逐项体验,一套闭环这么运转
为什么它会饿:养成数值系统
桌宠的意义是陪伴,而陪伴需要互动。如果它永远精力满满,你很快会把它忘在角落。所以饱食度设计成像余额会悄悄"发霉"的电子钱包——每一分钟它都在下降,逼你时不时想起它。好感度则是长线养成,200 级封顶、每级 120 点,徽章从星星(1级)一路换成月亮(4级)、太阳(16级)、皇冠(64级),成长路径清清楚楚。
怎么把"专注"变成喂宠物的口粮
DyberPet 最巧妙的设计,是把生产力工具和养宠绑在一起。开启专注模式后,桌宠会切换到对应的"专注"动画,安安静静陪你;专注结束、甚至中途取消,系统都会按已投入的时长结算物品奖励。工作 → 掉落物品 → 喂给宠物 → 好感度上涨 → 解锁更多内容,这条奖励链直接闭环——每一次专注都不再是消耗意志力,而是给自家宠物赚口粮。
一个会"吐槽"你的话痨桌宠
对话气泡是这套系统的血肉。点击、喂食、升级各有专属文案;你专注时拍它、或者 1 秒内狂点超过 7 次,它都会直接"吐槽"你。更贴心的是,屏幕锁定时数值会暂停变化,避免你离开时它"饿死"。
进阶站:JSON 配出来的模组生态
想换角色、加道具?不需要写一行 Python。每个角色就是一个文件夹,装着图片帧和两个 JSON 配置:
pet_conf.json定义角色大小、默认动作、随机行为概率act_conf.json定义每套动画用哪些帧、多久换一帧、要不要移动- 物品则在
items_config.json里描述效果和掉率
比如给一份汉堡定义效果,核心就几行:
{ "汉堡": { "effect_HP": 10, "effect_FV": 3, "buff": {"effect": "HP_stop", "expiration": 300} } }这行配置的意思是:吃下汉堡,饱食度 +10、好感度 +3,并且 5 分钟内饱食度不再下降。图片 + 几行 JSON,一个新角色或新道具就诞生了。对话系统同样支持可视化配置,从下面的结构图可以看到,文本节点和选项分支能组织成一颗对话树,用来做多分支剧情、问答互动都行。
想动手开发自己的角色素材,参考素材开发文档 docs/art_dev.md;想浏览社区现成模组(小呆、流萤、像素猫meme、会跟人跑的派蒙都在里面),翻翻 docs/collection.md。
岔路口:新手最常见的三个疑问
会不会很吃内存?框架做过专门优化,图片统一用 QPixmap 加载并加入懒加载策略,日常运行占用控制得不错。
多显示器能用吗?支持。桌宠可以跨屏移动,拖拽、掉落、屏幕边界都有完整处理。
存档会丢吗?存档按角色独立保存,支持导出、导入和快速存档,退出前还会主动写盘一次,最大限度避免数据丢失。
终点站:把这只小家伙领回家
现在你已经知道 DyberPet 是什么、能干什么、怎么跑起来。接下来就是动手的时刻:打开终端跑一遍命令,或者直接下载 EXE 双击启动,给它喂第一顿饭,然后开启一个番茄钟试试"工作换口粮"的快乐。
等你养熟了第一只,不妨再试试两个进阶玩法:去模组合集挑一只喜欢的社区角色换上;或者照着素材开发文档,亲手捏一版属于你自己的角色——让真正的"你的角色"住进桌面。
【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考