呆啵宠物 DyberPet 桌面宠物完整上手指南3 步让角色住进你的电脑桌面【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet呆啵宠物DyberPet是一款基于 PySide6 的桌面宠物框架把动画、养成、任务、商店与 AI 对话打包成一套开箱即用的桌宠应用既可直接使用现成角色也能用 JSON 配置自由扩展。这篇完整上手指南从安装讲起一路带你玩到自制模组。先想象一个场景你的桌面多了一位室友下午三点你正对着代码发呆屏幕角落里一只像素猫从右向左溜达过去头顶弹出一句要不要休息一下。你顺手点了一下它喂了块小饼干饱食度和好感度的通知条依次弹出它还回了一句谢谢主人的爱心投喂❤️。番茄钟响起时它准时切换成专注动画陪你一起工作——这不是什么科幻片而是呆啵宠物每天的日常。这个项目的初衷很简单让喜欢的角色真正住进桌面而不是待在相册或壁纸里当一张静态图。它把桌宠从GIF 播放器升级成了一个带养成、任务、商店、交互反馈甚至能接入大模型的完整小应用。左栏管理你拥有的全部角色右栏实时查看饱食度、好感度与互动日志 扩展包生态角色、迷你宠物、物品都能一键加装DyberPet 最讨喜的一点是万物皆可扩展。整个项目围绕模组也就是扩展包设计你不需要会写代码只要把下载好的文件夹放进指定目录程序启动时就会自动扫描并识别。目前支持三类扩展包每一类都有一套标准化的目录结构角色扩展包一个角色就是一个文件夹内含action/动作帧序列、info/角色信息、pet_conf.json宠物配置、act_conf.json动作配置。把整个文件夹丢进res/role/就能被自动加载。迷你宠物扩展包类似宠物的宠物可以跟随主角色排队散步也能自由活动。项目自带的派蒙就是很好的示例放在res/pet/派蒙/下供参考。物品扩展包食物、收藏品、可穿戴装备都算物品通过items_config.json声明属性和效果价格随星级递增。想直接白嫖现成素材文档 docs/collection.md 里收录了流萤、纳西妲、魈、饮月等热门角色以及原神/崩铁/猫meme 等物品包下载后用 App 的自动导入功能即可完成安装。更妙的是每个角色的金币图标、通知声音、对话气泡都可以单独定制换一个角色就像换了一个全新游戏。 AI 对话把桌宠升级成桌面助理如果说扩展包是皮那 AI 就是魂之一。DyberPet 已经接入了大语言模型能力让桌宠从会卖萌升级为会聊天、能帮忙的桌面助理——它认得你的昵称可以陪你闲聊、帮你梳理待办、提醒你喝水休息。需要说明的是AI 是加分项而非前置条件。就算完全不启用大模型桌宠依然拥有完整的交互与养成体验对话气泡系统支持分支逻辑你可以给角色编写多轮对话树让它在不同状态下说出不同的话。比如角色饱食度见底时会弹出feed_required气泡你连拍它 7 下会触发特殊回应专注模式下拍拍它还会有专属台词。这套对话系统的设计思路可以参考项目中的对话流程文档与源码 DyberPet/bubbleManager.py。 养成与效率玩的是陪伴攒的是生产力别被可爱的外表骗了DyberPet 的内核其实是一套相当扎实的数值与任务系统这也是它和普通桌宠拉开差距的地方。成长数值体系饱食度随时间下降喂食恢复好感度靠互动和投喂提升升级后解锁新动作和新物品。好感度等级上限高达 200 级并通过星星、月亮、太阳、皇冠四档徽章展示你的养成成就。经济与背包喂食、完成任务、专注时间都能赚金币商店支持购买与出售背包支持拖拽交换、自动整理甚至还有自动喂食功能。生产力工具番茄钟标准 255 周期、可自定义时长的专注模式支持暂停/取消、每日任务、定时提醒一应俱全。专注模式下角色会播放专属 focus 动画把效率工具和桌宠陪伴缝合在了一起。喂食后饱食度与好感度实时反馈右键菜单一站式管理所有功能3 步完成安装Windows 与 macOS 都能跑第 1 步准备 Python 环境推荐用 conda 单独建一个环境避免依赖互相打架。项目要求 Python 3.9 及以上下面是目前社区验证过的组合conda create --name Dyber_pyside python3.9.18 conda activate Dyber_pyside conda install -c conda-forge apscheduler conda install -c conda-forge pynput pip install PySide6-Fluent-Widgets1.5.4 pip install pyside66.5.2 pip install tendo注意macOS 上建议把 pynput 固定为1.7.6版本兼容性更稳。第 2 步获取源码并启动git clone https://gitcode.com/GitHub_Trending/dy/DyberPet cd DyberPet python run_DyberPet.py首次启动会自动生成存档和配置文件目录Windows 用户也可以直接下载 Release 里的 EXE双击即可连环境都不用配。第 3 步导入角色开始陪伴打开角色管理界面点击添加角色选择你下载好的角色扩展包或者直接点角色合集跳转到素材页面。导入成功后点启动按钮角色就会从屏幕角落落到桌面此时你可以左键拖拽它到处走松手后它会有下落和反弹的物理效果单击/连拍它触发随机对话与心心特效连拍还有小概率掉落物品右键呼出菜单切换角色、打开面板、管理任务。进阶玩法动手做一个属于自己的角色模组玩熟了现成素材之后你完全可以给自己的角色做一套皮肤。开发文档 docs/art_dev.md 是很好的起点里面详细解释了动画播放原理程序按固定时间间隔依次显示action/目录下的stand_0.png、stand_1.png、stand_2.png……就形成了动作循环。你只需要提供一组序列帧再在act_conf.json里声明每帧的间隔和位移即可。几个实用的定制点动作触发通过pet_conf.json的patpat字段可以为每个饱食度等级单独指定拍拍动画附件动画给角色挂上会跟随移动的装饰物如帽子、尾巴支持独立循环或一次播放对话树用 文本 选项 的嵌套结构编写多轮对话让角色根据你的选择走向不同的回应分支迷你宠物res/pet/目录下的示例模组可直接参考配置好跟随锚点后它就会自动排队跟在主角色身后。常见问题 FAQ新手最关心的 5 个问题Q1运行时报 ModuleNotFoundError 怎么办多半是某个依赖没装全对照第 1 步的清单逐条检查重点确认 PySide6-Fluent-Widgets 的版本号是否为 1.5.4。Q2不启用 AI桌宠还能玩吗完全可以。AI 只是可选模块日常的动画、喂食、养成、任务全部照常运转只是少了对话功能。Q3能不能同时召唤多只宠物程序默认禁止进程多开防止存档写乱但内置了召唤同伴功能可以让多只宠物同屏活动。Q4存档存在哪里怎么备份存档按角色独立存放在系统面板的存档管理里可以随时导出、导入和快速存档建议换角色前手动备份一次。Q5切换角色后数值会重置吗每个角色的数值独立保存切换后会读取对应存档金币图标和物品配置也会跟随角色自动切换。避坑指南这几点值得提前知道文件名尽量用英文已知繁体中文环境下解压素材可能出现乱码甚至崩溃这是素材包最容易踩的坑。别在运行中手动删存档文件项目在关闭时会主动冻结并写入数据外部改动可能造成闪退。素材来自画师原创docs/collection.md里的每个扩展包都有署名作者请尊重劳动成果不要倒卖。LLM 模块仍在施工中AI 相关能力目前尚未完全开源遇到不完整的部分可以到 Issue 区反馈作者很欢迎共建者。同类项目横向对比DyberPet 的差异点在哪项目类型代表与 DyberPet 的差异静态桌宠Desktop-Cat只做动画展示无养成与任务窗口小人Shimeji偏纯娱乐无数值与商店体系串流宠箱Live2D 类应用需美术资源较多扩展门槛高完整桌宠框架DyberPet动画 养成 任务 商店 AI 一体JSON 即可扩展一句话总结DyberPet 的定位不是某一种桌宠而是一个自带完整玩法的桌宠框架上手门槛低上限却很高。社区生态从使用者到创作者只有一步之遥这个项目最打动人的地方在于它的活——素材由社区画师持续创作功能按用户反馈滚动更新比如背包拖动交换、自动喂食、好感度等级上限提升到 200 级都是顺着 Issue 和社区声音做出来的。如果你有喜欢的角色素材想分享直接修改 docs/collection.md 提交 PR 即可想参与功能开发也可以从 DyberPet/Dashboard/、DyberPet/DyberSettings/ 这些核心目录开始读代码。养一只桌面宠物听起来像是小时候的愿望但在 DyberPet 这里它真的可以被实现、被定制、被分享。源码可以通过git clone https://gitcode.com/GitHub_Trending/dy/DyberPet获取项目采用 MIT 协议欢迎任何形式的二次创作与共建。现在去给你的桌面挑一位室友吧。【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
