如何让喜欢的角色住进桌面：DyberPet 桌宠从零上手完整指南

如何让喜欢的角色住进桌面：DyberPet 桌宠从零上手完整指南

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

你喜欢的角色困在游戏账号和动漫播放页里，切回工作界面时桌面空荡荡。DyberPet 是一个基于 PySide6 的桌面宠物框架，把动画角色直接放到你的桌面上，让它走路、接受抚摸、喂食、成长，同时不打断你干活。

项目速览 🧩

• 一套完整可玩的宠物—— 饱食度、好感度、金币构成养成闭环，不是 GIF 播放器。
• 模组化创作—— 角色、物品、音效全靠 JSON + PNG 序列配置，照着 res/role/ 的目录结构就能做自己的桌宠。
• AI 是加分项而非前提—— 可接大模型陪聊、管理待办；不接 AI，核心桌宠功能依然完整可用。
• Windows 与 macOS 双平台—— Windows 有打包好的 EXE，macOS 用 conda 环境跑源码。

如何快速上手 DyberPet 桌宠 🚀

免配置安装

Windows 用户最省事的路径：从 Release 下载最新打包的 EXE（当前最新版为 v0.8.5），双击运行，首次启动会自动创建配置与存档目录。

想体验最新功能或做二次开发，则拉代码并建一个 Python 3.9 环境：

git clone https://gitcode.com/GitHub_Trending/dy/DyberPet conda create --name Dyber_pyside python=3.9.18 conda activate Dyber_pyside conda install -c conda-forge apscheduler conda install -c conda-forge pynput pip install PySide6-Fluent-Widgets==1.5.4 pip install pyside6==6.5.2 pip install tendo python run_DyberPet.py

macOS 的差异仅在于 pynput 用 pip install pynput==1.7.6 安装，其余命令一致。程序内置单实例锁（由 tendo 提供），重复启动会直接拒绝，目的是防止两个进程同时写存档数据。

第一次打开该做什么

启动后宠物直接出现在桌面上。右键它，从菜单进入「系统 - 角色管理」，选一个顺眼的角色点「启动」。角色面板会显示饱食度、活力、好感度三个数值条，下方的状态日志把每次数值变动逐条记下来。

基础操作：左键、右键与拖拽

三个操作就够入门：

• 左键点宠物：播放摸摸动画，点击位置冒出浮动心心，偶尔弹出对话气泡。
• 按住拖拽：宠物跟手移动，松手后依次播放 prefall 与 fall 动作落地。
• 右键菜单：角色面板、商店、待办、日常任务等入口都收在这里。

图中依次演示桌宠本体、右键菜单、对话气泡、通知栏四种交互形态

DyberPet 桌宠模组制作：JSON 配置搭出自己的角色

一个角色文件夹就是一套模组

新角色只需在 res/role/ 下建一个文件夹，程序启动时会自动扫描并把它列进「角色管理」。文件夹里关键的两个文件：pet_conf.json 定义角色属性，其中 default（静息）、drag（拖拽）、fall（下落）是必须提供的动作名；act_conf.json 定义动画的播放参数。action/ 目录里放同前缀、按 0、1、2 编号的 PNG 序列帧，程序按帧间隔依次显示，移动类动作还会按配置的方向和速度位移，效果等同于 GIF 动画。

参考素材去哪里找

不想自己画，可以先逛 docs/collection.md，里面收录了现有角色、迷你宠物和物品模组，下载后按 App 内指南导入即可。想从零创作就读 docs/art_dev.md，从帧命名到昼夜作息、对话气泡全有说明；「系统」里的自动添加功能会检查模组文件夹并提示潜在错误，开发时边测边修。

左侧为角色管理面板可切换角色，右侧为角色状态面板，展示饱食度、活力、好感度数值条与状态日志

DyberPet 养成系统：喂食、金币与好感度等级

实时下降的数值与状态日志

饱食度会随时间下降，所有数值与物品变动都会写进状态日志。数值过低时，随机动作的触发概率随之变化，宠物可能进入生气或掉线边缘的状态，提醒你该管管它了。

金币掉落、商店与背包

摸摸宠物有小概率掉落物品，物品按抛物线落在任务栏，金币也有掉落动画。用赚到的金币在商店买食物喂它，好感度随之上涨：好感度等级上限 200 级，每级固定需要 120 点好感度，升级后在右键菜单和角色面板上会亮起星星、月亮、太阳、皇冠这类等级徽章。背包是可自由拖动交换格子的面板，食物与收藏品分栏摆放。

DyberPet 任务系统：把宠物变成番茄钟

番茄钟与专注时间绑定宠物动作

开启番茄钟或专注时间后，宠物会切换到 focus 动作，倒计时进度条悬浮在它头顶。提醒事项和待办支持到时提醒与间隔提醒，通知合并显示，不会刷屏。

专注结束你能得到什么

专注任务结算后会发放物品奖励，宠物从摆设变成陪工工具。如果开启了「自动锁定」，屏幕锁定期间饱食度与好感度停止变化，合上笔记本也不会让宠物挨饿。

DyberPet 个性化配置与常见避坑 ⚙️

两条配置建议：刚开始用时，先在系统设置里关闭弹出通知栏，等习惯了再打开；做模组时文件名务必用英文，中文文件名在部分地区系统上会解压乱码甚至导致崩溃。

问：能一屏摆好几个宠物吗？答：程序是单实例的，二次启动会被拒绝。想同屏展示多个角色，用右键菜单里的「召唤同伴」，迷你宠物会自动排队跟随，收回后队列自动补位。

问：更新后宠物位置错乱或者启动失败怎么办？答：先重启程序。仍异常的话，进「系统 - 存档管理」导出当前存档备份再重新导入；data/ 下的 json 不要手改，旧格式由程序自动转换。

问：macOS 没有现成 EXE，能用吗？答：可以。按上文源码安装的步骤建好 conda 环境后运行 run_DyberPet.py，首次运行可能需要授予辅助功能权限。

下一步该做什么

用 Windows 的话，先去 Release 下载 EXE 双击启动，5 分钟内右键宠物走一遍菜单。想做自己的角色，先读 docs/art_dev.md，在 res/role/ 下新建文件夹，用「系统」的自动添加功能校验后再发布。更省事的选择是从 docs/collection.md 导入现成模组。宠物上线后，记得每天回去看一眼它的饱食度条。

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