DyberPet 桌面宠物快速上手：十分钟，桌面多一位会说话的室友
【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet
下午对着需求文档走神，屏幕角落的像素小猫突然冒出句话，催你该喝水了。DyberPet 是基于 PySide6 的桌面宠物框架：把一串 PNG 变成会走路、会吃饭、会闲聊的桌宠，装完就能喂、能撸、能用番茄钟管时间。想自己养一只，或借它入门 PySide6，这篇刚好。
🐾 认识它：三句话摸清运行逻辑
- 动画走序列帧路线：PNG 按顺序翻，原理同 GIF。
- 状态是真实数值：饱食度、活力、好感度都会随时间走动。
- 配置全是 JSON：每个角色一份档案文件，改字段即改行为。
安装 DyberPet：Windows 三步，源码一条命令
Windows 用户，三步到位：
- 去官方 Release 下载最新的打包版。
- 双击 EXE 运行，控制面板随之打开。
- 左侧列表挑个顺眼的角色，点"启动"。
Mac / Linux 用户跑源码：先建一个干净的 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最后一行跑完，控制面板就开了。选中角色点启动，它从屏幕上方掉下来，落地弹一下，然后自己溜达起来。
🍅 上手玩法：摸头、拖拽与番茄钟
互动全靠鼠标，没有操作门槛：
- 左键点一下，它做摸头反应，头顶冒心心。
- 右键点它，弹出控制菜单，常驻动作、更换角色都在这。
- 按住左键拖走，松手在半空，它会按重力落下。
它还兼管你的时间。番茄钟按 25/5 的经典节奏走：25 分钟专注后休息 5 分钟，时长可以在设置里自己改。每完成一次专注，会掉落物品当奖励，宠物和任务一起往前推。
它还会主动开口：角色会随机冒话，说什么都由你定，自定义的指路在下一节。
动手改数值：回血翻倍只要一个字段
饱食度随时间掉，只能喂回来。每件食物的加值和掉率都写在res/items/Default/items_config.json里，部分物品还带 BUFF——最典型的是汉堡，吃完 5 分钟内饱食度不下降。
想让汉堡更顶饱？在本地目录打开这个文件，找到"汉堡"，把effect_HP从 10 改成 30：
"汉堡": { "name": "汉堡", "effect_HP": 30, "description": "喵当劳招牌 - 牛肉芝士汉堡" }重启程序再喂一口，状态条肉眼可见地长了一截。想让角色说什么，去角色目录的msg_conf.json写对话树，线性流程和分支选项都支持；想调动画节奏，看pet_conf.json的refresh（整体帧率）和act_conf.json的frame_refresh（单个动作）。
🛠 排坑清单：四个高频问题速查
- 动作卡顿或节奏不对 → 先查
pet_conf.json的refresh，再看act_conf.json的frame_refresh。 - 启动或导入角色时崩溃 → 目录与图片统一英文命名，素材文档有明确要求。
- 重装后找不到存档 → Linux 看
~/.config/DyberPet/DyberPet，记得定期备份；Windows 保留程序目录即可。 - 多只同屏内存上涨 → 减少同屏角色数，把动画帧率调低一点。
先把边界说清：它是序列帧动画，达不到 Live2D 那种演出效果；AI 陪聊能力还在打磨，相关部分尚未完全开源。这两点能接受，就从三步开始：
- 装好桌面宠物，挑一只顺眼的角色，点"启动"让它住进来。
- 打开
res/items/Default/items_config.json改一个数字，体验改一处的即时反馈。 - 是画手就看 docs/art_dev.md 的素材规范；想找现成角色与模组，翻 docs/collection.md。
那天下午再走神，桌角的室友不会催你喝水，但会一直在。
【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
