DyberPet 桌面宠物框架零基础上手：角色养成、专注陪读与模组创作一篇讲透
【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet
每天大半时间都对着屏幕，可屏幕右下角永远空着一块——壁纸是静的、图标是静的，连光标都懒得挪。有没有可能让那个角落住进一个会跑、会跳、会跟你讨食的小家伙？DyberPet（呆啵宠物）就是答案。这个基于 PySide6 的开源桌面宠物框架，把动画、养成、任务、商店和迷你宠物串成了一套完整玩法，从下载到拥有第一只桌宠，通常用不了一顿饭的功夫。
为什么说你的屏幕一直缺一个"活物"
壁纸类桌宠这几年没少见：一张透明背景的动图在桌面上走来走去，看两天就腻了，因为它跟你没有任何"关系"——你喂不喂它，它都那样走；你不在，它也在走。
DyberPet 把"关系"这件事真正做出来了。它内部跑着一套完整的养成循环：饱食度会随时间下降，饿了会冒泡点名要特定食物；好感度随着你的投喂与陪伴慢慢上涨，每升一级都有徽章和奖励；啵币则撑起商店与掉落系统。换句话说，它不是展示品，而是一个有"今天的状态"、会因为你的一举一动而改变的东西。
一个文件夹装下整套玩法：动画、养成、任务与迷你宠物
不用靠想象，跑起来就是这样：桌宠可以左右行走、跟随鼠标、被你拖起来再自由落体，右键能呼出完整菜单——角色面板、选择动作、召唤伙伴、更换角色都在里面。喂食时头顶冒气泡，数值实时变动，通知栏同步滚动。
除了这些看得见的交互，藏在背后的还有：番茄钟与专注时间组成的任务系统、商店买卖、按角色独立存档、多屏支持，以及会排队跟随的迷你宠物（内置示例res/pet/派蒙/就是一个会跟着主宠跑的迷你伙伴）。它已经把"一个桌宠 App"该有的部件基本配齐了，而不是只丢给你一张会动的图。
两条启动路线：Windows 双击 EXE，或一条命令链跑起源码
最省事的是 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.pymacOS 用户只需在装依赖时把pynput固定到 1.7.6 版本。跑起来之后右键戳一下那个小家伙，你的桌宠生涯就正式开始了。
饱食度、好感度与啵币：桌宠的"生物钟"是这样转起来的
打开角色面板，你会看到三个核心数值：饱食度（HP）、好感度（FV）和啵币。饱食度会随时间下降，桌宠饿了会随机冒泡点名要某样东西——这个feed_required气泡会直接告诉你它想吃汉堡还是薯条。你在背包里选中食物点"使用"，数值立刻变化，头顶还会飘出投喂反馈。
好感度是这条养成线的主轴：升级会弹气泡、解锁新物品和新动作，徽章从星星（1 级）、月亮（4 级）、太阳（16 级）一路换到皇冠（64 级），上限是 200 级，每级需要 120 点好感。这里有个容易忽略的细节：不同角色对同一种食物有喜爱/讨厌倍率，乱喂好感度是要打折的。
更值得研究的是 Buff 系统。默认物品里，汉堡自带"5 分钟内饱食度不下降"，薯条则是"每 30 秒掉 5 啵币、持续 2 分钟"——所以吃什么、在什么时机吃，其实是一场小型排兵布阵。Buff 一共支持 5 种效果：饱食度/好感度/啵币增益，以及暂停饱食度下降、暂停好感度下降，对应实现见 DyberPet/Dashboard/buffModule.py。
番茄钟与专注动画：把桌宠从玩伴变成监工
它真的会"干活"。启动番茄钟或专注时间后，桌宠会自动切换到专属的focus动画，安静蹲在角落陪你。这期间如果手痒去戳它，会被气泡当场教育一句"你应该专注在手头的工作上"。
两个设定建议提前知道：第一，奖励是随时结算的——就算中途取消专注，也会按已投入的时长折算物品掉落；第二，记得在设置里打开"自动锁定"，屏幕锁定时数值会暂停变化，出门一整天回来，它也不会饿到掉好感。
对话气泡与昵称系统：它会直呼你的名字要食物
气泡看起来像写死的台词，其实全是可配置的。默认配置在 res/icons/bubble_conf.json，每一种气泡都能换图标、换文字、配语音，还支持USERTAG、ITEMNAME这类占位符。配合昵称系统，你可以在设置里让它叫你"主人"，它要食物时会直接喊你的名字——那种被点名讨食的感觉，跟养了只会说话的电子宠物差不多。
想加语音也很简单：把音频放进res/role/角色名/note/文件夹，再配置一下气泡文件里对应的字段就行。
自己造角色：一个文件夹加两个 JSON 的模组创作流程
玩腻了默认角色，重头戏才刚开始。在 DyberPet 里，一个角色就是一个文件夹：res/role/角色名/下面放着pet_conf.json（角色大小、默认动作、随机行为概率）、act_conf.json（每套动画用哪些帧、多久换一帧、要不要移动），以及action/目录里的透明 PNG 帧图。
文件命名和路径规则都有现成例子，内置的 Kitty、ChrisKitty 就是最好的模板，系统面板还会自动检查新模组配置并给出错误提示。物品同理，在items_config.json里定义效果、倍率和掉率就能上线。
更进阶的玩法是对话树：使用"对话类物品"会弹出带选项的分支剧情，节点怎么连、选项怎么跳，官方文档 docs/art_dev.md 里有完整的可视化结构图——只要逻辑不写成死循环，你可以做出任意复杂的多分支小剧场，甚至借它做点互动教学。
社区里已经积累了不少现成素材，角色、迷你宠物、物品模组都收录在 docs/collection.md，下载后可通过 App 直接导入，不用自己从零动手。
新手上路最容易误会的三个设定
- 以为奖励要等专注结束才发。番茄钟和专注时间全程都在结算，中途取消同样按已投入时长折算，桌宠还会切到
focus动画安静陪读。 - 以为好感度 7 级就满级了。现在的上限是 200 级，每级 120 点，徽章分四个阶段；喂食还有喜爱/讨厌倍率，别逮着一个食物猛喂。
- 以为气泡台词是写死的。图标、文字、语音全可替换，配好昵称后它甚至会直呼你的名字要东西。
几个被问得最多的零碎问题，一句话答完
- 存档会丢吗？基本不会。按角色独立存档，支持导出、导入和快速存档，退出前还会主动写盘一次。
- 多屏能用吗？能。跨屏移动、拖拽、屏幕边界都有完整处理，召唤出来的迷你宠物还会自动排队跟随。
- 会不会很吃内存？控制得不错。图片统一走 QPixmap 加载，还带懒加载策略，日常占用很克制。
- 不想被打扰怎么办？设置里能关对话气泡、关通知栏、开自动喂食、一键静音，它可以安静到像不存在。
现在就把喜欢的角色装进屏幕
到这里，它是什么、能做什么、怎么跑起来，你都知道了。剩下的动作就三下：Windows 用户下载 EXE（或照上面的命令装环境），运行run_DyberPet.py，然后右键戳一下那个小家伙——喂它一口、开一个番茄钟，再试试拖着它从屏幕边缘自由落体。
等你某天深夜赶工时，发现角落有个小身影被你吵醒，慢悠悠爬起来陪着你——那一刻，屏幕右下角那块空了挺久的角落，终于有住户了。
【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
