DyberPet 桌宠完整上手指南：从安装到自定义模组的全流程攻略

DyberPet 桌宠完整上手指南：从安装到自定义模组的全流程攻略

【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet

深夜十一点，项目还没跑通，屏幕右下角只有托盘图标在陪你。光标在代码里来回游走，你突然发现：这个逼仄的工位上，缺一个"活物"。DyberPet 桌宠就是为这个瞬间而生的开源桌面宠物框架——基于 PySide6 打造，把动画、养成、任务、商店全部装进一只小宠物里，让喜欢的角色真正住进你的桌面。这篇文章按"是什么 → 怎么装 → 怎么玩 → 怎么魔改"的顺序，带你走完全流程。

动手前先弄清三件事：是什么、解决什么、适合谁

它是什么？一句话：一个用 Python 写的、会跑会跳的桌面宠物 App，而不是一张循环播放的动图。它自带完整的数值系统、任务系统、商店背包和模组生态。

它解决什么问题？两个。一是"屏幕太冷"——工作时的陪伴需求；二是"习惯难坚持"——把番茄钟、待办这些枯燥工具包装成养宠玩法，让自律这件事有个软乎乎的反馈出口。

它适合谁？想要桌宠打发时间的普通用户、想给角色做动画素材的画师、想研究 PySide6 桌面应用架构的开发者。三类人对应文章的三个板块，各取所需。

两条上手路线：Windows 零门槛捷径与开发者深度玩法

零门槛捷径（适合所有人）：Windows 用户直接下载 Release 里的 EXE 文件，双击运行，连 Python 都不用装。这是最快看到桌宠的方式。

深度玩法（适合开发者）：用 conda 建一个独立环境，避免污染系统 Python：

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

macOS 用户只需把pynput换成 1.7.6 版本，项目对 Mac 做了针对性适配。启动后右键点击桌宠，"角色面板""选择动作""召唤伙伴""更换角色"这几个菜单项，就是你管理它的全部入口。

养成与互动：为什么这只宠物"需要"你

DyberPet 的第一层魅力，是它不把你当观众，而把你当"饲养员"。

它能做什么：饱食度随时间递减，好感度是 200 级的长线养成，每升一级需要 120 点好感。徽章从星星到月亮、太阳再到皇冠，每一级都看得见成长。点击会冒"摸摸"气泡，心情好时飘出爱心，喂食和升级各有专属文案；专注时拍它、1 秒内狂点超过 7 次，都会触发吐槽气泡。

怎么开启：右键菜单打开"角色面板"，数值一目了然；互动直接上手——点、拖、喂。

对你意味着什么：陪伴是需要理由的——一只永远满状态的宠物，很快会被你遗忘。而"会饿、会回应、会吐槽"的角色，让你和屏幕之间产生了真实的羁绊。屏幕锁定时数值还会自动暂停，避免你离开时它悄悄"掉血"。

任务系统：把番茄钟和待办变成养宠动力

如果说养成是"情"，那任务系统就是"利"——它把效率工具和养宠奖励焊在了一起。

它能做什么：内置番茄钟、专注时间、每日目标和待办事项。倒计时实时显示在宠物上方，开启专注模式后桌宠会切换成对应的专注动画，安安静静陪着你。专注结束或中途取消，都会按已投入时长结算物品奖励。

怎么开启：打开 Dashboard 的任务页，选一个番茄钟或专注任务，开始即可。

对你意味着什么：你不再靠意志力硬撑，每完成一段专注，宠物就多一口口粮。工作 → 掉落物品 → 喂给宠物 → 好感度上涨 → 解锁更多内容，奖励链条就此闭环。把自律变成闯关游戏，大概是坚持下来最省力的办法。

商店、背包与 Buff：喂食也是一场策略游戏

养宠养到中期，喂食就不是"有啥吃啥"那么简单了。

它能做什么：商店支持搜索、按标签筛选和批量购买，背包可以自由拖动整理。更妙的是物品系统带 Buff 机制——汉堡能让你"5 分钟内饱食度不再下降"，薯条则变成"每 30 秒掉落 5 枚金币"的迷你印钞机。喂食策略瞬间有了取舍的深度。

怎么开启：Dashboard 的商店和背包页面，购买、出售、使用、自动喂食都在这里。

对你意味着什么：吃饭不再是数值堆叠，而是"我该在什么时候给宠物吃什么"。一份汉堡的效果，在配置里不过几行：

{ "汉堡": { "effect_HP": 10, "effect_FV": 3, "buff": {"effect": "HP_stop", "expiration": 300} } }

物品可以附带临时 Buff，这正是"喂食策略"的乐趣来源。

对话气泡与分支剧情：角色怎么学会回应你

它能做什么：除了随机的气泡回应，DyberPet 还内置了一个可视化对话系统——文本节点和选项节点组成一棵对话树，你可以设计多分支剧情、问答互动甚至教育类小游戏。角色不再只会"喵"，而是会按你的选择走不同的剧情线。

怎么开启：通过"聊天"入口配合对话类物品触发，素材开发文档docs/art_dev.md里有完整配置说明。

对你意味着什么：对话树是角色"人格"的载体。让桌宠记住你的昵称、按时间问候、在特定剧情里做出不同反应——这正是它区别于普通桌宠的"灵魂"部分。

一个普通上班族的一天：功能如何串成完整流程

把上面所有模块串起来，会是这样一天：

• 9:00 开工：启动桌宠，弹出问候气泡。顺手看一眼角色面板，饱食度有点低，喂个早餐。
• 10:00 写代码：开启 25 分钟番茄钟，角色切到专注动画，安安静静陪你。
• 10:30 番茄结束：系统按时长结算，掉落的物品滚进背包，金币动画弹出。
• 12:30 午休：点两下摸摸，角色冒出"被挠痒痒"的气泡。
• 15:00 开会：把待办事项挂上，完成一个勾一个，每日目标进度同步推进。
• 17:00 摸鱼被抓：1 秒内狂点超过 7 次，角色毫不留情地吐槽你。
• 19:00 收工：用攒下的金币去商店买份薯条，挂上金币 Buff 再下班。锁屏时数值自动冻结，退出前存档主动写盘。

你看，没有一个功能是孤立的——养成给任务提供动力，任务给商店提供金币，商店的 Buff 又反哺养成。整个系统像一台精密的"陪伴机器"。

进阶玩法：用 JSON 打造专属角色模组

玩腻了默认角色？模组生态才是 DyberPet 最上瘾的部分。仓库自带小呆、像素猫 meme 等默认角色，还有会跟着你到处跑的迷你宠物派蒙，更多合集可以翻docs/collection.md。

角色不需要写一行代码。每个角色就是一个文件夹，里面放着图片帧和两个 JSON：

• pet_conf.json定义角色大小、默认动作、随机行为概率
• act_conf.json定义每套动画用哪些图片帧、多久换一帧、要不要移动

动作就是"图片序列 + 时间参数"的简单组合，素材开发文档docs/art_dev.md给出了完整标准和测试流程。

性能与限制：框架把图片统一用 QPixmap 加载替代 QImage，并加入懒加载策略，日常内存占用控制得相当克制；支持多屏移动、迷你宠物排队跟随；存档按角色独立保存，支持导出、导入和快速存档。另外，项目还在开发 AI 助手能力，未来可接入大模型陪聊、管待办——不过就算不接 AI，它现在也已经是一套完整可玩的桌宠了。

新手避坑清单：五个最容易踩的坑

行动指令：今晚就让角色住进你的桌面

回到开头那个深夜加班的场景：现在屏幕右下角多了一只小家伙，你专注工作时它安静陪着，你摸鱼时它毫不留情地吐槽。养成的羁绊、任务的闭环、模组的自由，全都长在这一个框架里。

动手吧：Windows 用户去下载 EXE，开发者执行git clone https://gitcode.com/GitHub_Trending/dy/DyberPet后跑起run_DyberPet.py。十分钟，就能把一只活生生的小家伙请进屏幕——它会饿、会吐槽，还会在你加班时守在右下角。

毕竟，谁会拒绝一个住在桌面右下角的室友呢？

【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet