桌面宠物框架 DyberPet 快速部署指南让 AI 角色轻松入住你的桌面【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet呆啵宠物 DyberPet 是一款基于 PySide6 开发的开源桌面宠物框架它把让喜欢的角色住进桌面这件事做成了开箱即用的完整方案——动画、交互、养成、任务、商店、迷你宠物以及可选的大模型对话全部替你打包妥当。如果你正想拥有一只会互动、能养成、还会提醒你专注的桌面宠物这篇桌面宠物框架上手指南会带你按步骤装好环境、跑起程序、导入第一个角色最后再解锁自制模组的能力。桌面宠物只动不会应先看看这三个真实困境很多人第一次尝试桌面宠物都是从一张会动的 GIF 开始的。新鲜感消退后问题就来了它永远在循环同一段动作点击没反应喂食没反馈像一张精致的贴纸贴在桌面上——这大概是桌面宠物最常见的劝退时刻。另一类人想要更进一步于是去搜索各种桌宠工具结果发现要么内置角色不合口味要么想换角色就要付费解锁。真正让人卡住的往往是第三种情况你想把自己喜欢的角色做进桌面但一想到要处理透明窗口、动画帧切换、任务栏躲避、鼠标拖拽这些底层逻辑热情瞬间归零。这三个困境指向同一个结论你需要的不是一个会动的图片而是一个把桌宠底层工作全部代劳、只把创作与选择留给你的桌面宠物框架。DyberPet 正是为此而生。一句话搞懂DyberPet 是什么、能替你解决什么用一句话概括DyberPet 是一个基于 PySide6 的桌面宠物框架你把角色文件放进它的目录它就能在桌面上把动画、数值、通知、商店整套系统跑起来——你负责选角色或做角色它负责养角色。它的定位有三类人非常契合只想好好养只桌宠的普通用户下载现成角色模组一键导入即玩画师与模组作者想把自己的角色变成可交互桌宠无需从零写代码PySide6 学习者想研究桌宠类应用的模块划分与动画调度源码就是现成教材。上图是项目的主界面截图左侧是角色管理窗口可以浏览、添加并启动角色右侧是角色状态面板饱食度、好感度、状态日志一目了然。项目内置了 Kitty、ChrisKitty、派蒙等示例角色导入新角色后会自动出现在角色列表里点一下启动它就会落到桌面底部。能力矩阵速览桌面宠物框架值得知道的五个功能在深入操作之前先用一张表把 DyberPet 的能力边界看清楚方便你判断哪些功能是自己真正需要的。能力一句话说明适合谁 角色模组自由扩展角色、迷你宠物、物品、音效均可通过文件夹 JSON 配置加载想换角色的玩家、模组作者 完整养成数值体系饱食度、好感度 200 级成长、金币经济、Buff 增益喜欢养过程的玩家⏱️ 生产力工具内置番茄钟、专注时间、日常任务、提醒事项一应俱全学生与上班族 可选 AI 对话可接入大模型做桌面 AI 助手不接 AI 也完整可玩想体验 AI 陪伴的用户 迷你宠物与个性化通知附属宠物跟随、角色专属气泡与语音追求陪伴感的细节控这套能力不是概念清单而是已实装可用的功能。比如好感度系统上限 200 级、每级需要 120 点好感度升级时会在菜单和角色面板显示星星、月亮、太阳、皇冠四档徽章物品按消耗品、收藏品、对话物品、迷你宠物四种类型区分商店价格默认按50 × (解锁等级 1)计算也可手动指定。这些细节都意味着它不是玩具 demo而是一套完整的桌宠 App。三步上手桌面宠物框架从安装到首次运行下面这三步针对想从源码跑起、或日后打算自制模组的读者。如果只想快速体验Windows 用户也可以直接下载 Release 中打包好的 EXE 双击运行跳过本段。第一步准备 Python 3.9 环境并安装依赖DyberPet 依赖 PySide6 与几个辅助库建议用 conda 单独建一个环境避免污染你现有的 Python 安装。在终端中依次执行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其中apscheduler负责计划任务调度比如饱食度定时下降pynput负责全局键鼠监听UI 则基于 Fluent-Widgets 风格的 PySide6。macOS 用户只需把pynput换成pynput1.7.6其余一致。依赖装完环境就绪。第二步拉取源码并启动主程序把仓库克隆到本地然后运行入口脚本git clone https://gitcode.com/GitHub_Trending/dy/DyberPet cd DyberPet python run_DyberPet.py首次启动时程序会自动创建配置与数据目录并加载res/role/下的内置角色。你会看到桌面底部出现一只小宠物右键点击它会弹出完整菜单——角色状态、背包、商店、日常任务都在里面此时第一步部署就成功了。这张动图演示了日常互动链路右键呼出菜单选择动作 → 喂食触发数值变化 → 宠物头顶弹出对话气泡回应比如牛奶 1、好感度 8、饱食度 1这类实时反馈。整个过程流畅无卡顿因为动画模块独立于主界面运行不会因加载动画阻塞 UI 响应。第三步导入角色模组完成首次个性化设置打开系统面板进入角色管理点击添加角色选择你下载的角色模组文件夹程序会自动校验结构并给出错误提示。导入后可在设置中按角色独立调整大小、重力参数、拖拽速度与音量甚至自定义主题色。到这里你已经拥有了一个会走动、会被喂食、会随饱食度状态改变行为的桌面宠物。接下来值得探索的是它真正的深度所在。进阶玩法如何给桌面宠物定制专属动作与剧情DyberPet 之所以叫框架而非软件是因为整个角色体系都以开放目录结构组织res/role/角色名/下一个文件夹就是一个完整角色。官方素材开发文档docs/art_dev.md对每一项配置都有详细说明这里拆解两个最有代表性的场景。场景一两个 JSON 文件 一组 PNG做出自己的角色一个基础角色只需要三样东西角色名/ ├── action/ # 动画帧 PNG命名如 stand_0.png、stand_1.png... ├── act_conf.json # 动作参数每帧时长、移动方向、循环次数 └── pet_conf.json # 角色参数尺寸、默认动作、随机动作池、组件动作动画原理很朴素程序按frame_refresh设定的间隔依次播放action/下同一前缀的 PNG 帧实现逐帧动画效果需要移动的动作加上need_move、direction、frame_move即可让角色边走边播帧。act_conf.json里最有价值的是anchor参数——它指定每帧图片相对角色底部中心的偏移用来消除不同动作切换时的位置跳跃比如睡觉时让角色自然贴地。pet_conf.json则负责行为。你可以通过random_act组合多个动作并设置概率让角色在饱食度满时活泼、饥饿时消沉、饿昏时只睡觉用accessory_act添加带组件特效的动作如跟随鼠标的特效框甚至给不同饱食度等级分别定义拍拍动画。这意味着角色的性格完全由你编排。场景二用对话物品写一段带分支的剧情DyberPet 支持把对话做成物品角色携带对话类收藏品玩家在背包中使用它就会弹出带选项的对话框选项会导向不同后续文本实现文字游戏式的分支体验。对话逻辑写在msg_conf.json中用text_编号表示文本、option_编号表示选项、relationship定义两者之间的跳转关系。上图是分支对话的结构示意一段文本后可以挂多个选项每个选项各自导向不同的后续文本形成多路径剧情。官方开发文档建议先画流程图再填配置把每一条连线转成一行文本key: [选项key]或选项key: [文本key]即可支持任意复杂的组合——只要别把自己绕进死循环。进阶玩家还可以组合可穿戴装备Equip在物品模组里定义收藏品再在角色accessory_act中定义一个同名且acc_type为equip的组件玩家使用该物品后翅膀、披风等外观就会持续出现在角色身上再次使用即可收回。模组的组合深度基本取决于你的想象力。避坑答疑桌面宠物框架使用中的高频问题Q1运行后直接闪退或报错怎么办先确认三件事Python 是否为 3.9.xPySide6 是否为 6.5.2、Fluent-Widgets 是否为 1.5.4是否在 conda 环境中执行了全部安装命令。版本不一致是闪退的最常见原因。另外程序禁止多开请确认没有残留的旧进程。Q2导入角色后动作错位、悬空或重叠多半是anchor参数缺失或图片底边中心不一致。开发文档强调所有动作的所有帧角色的底部中心必须对齐统一基准点动作切换时也请检查图片中角色的绝对像素大小是否一致。Q3模组素材解压后乱码甚至导致程序崩溃已知繁体中文地区的压缩工具可能导致文件名乱码。官方文档的明确建议是所有文件名一律使用英文命名再放入res/role/或res/items/。Q4电脑配置一般跑起来卡怎么办可以降低动画帧率、控制同屏角色数量。另外注意仓库源码目前开源至 v0.6.7而 Windows 打包版已发布到 v0.8.5功能以 Release 版本为准若使用源码版本部分新功能可能尚未包含。Q5AI 对话功能为什么用不了LLM 模块仍在开发中相关能力暂未完全开源。但正如项目定位所说AI 是加分项不是前置条件——不接大模型养成、任务、商店、迷你宠物依然是完整体验。收尾把会互动的桌面宠物带回家回到开头的问题桌面宠物只动不会应的尴尬根源在于它缺少一个真正的运行框架。DyberPet 用一套可扩展的目录结构与 JSON 约定把养一只桌面宠物和做一个桌面宠物两件事同时变成了简单操作——普通用户几分钟装完即玩创作者按文档写配置即可发布自己的角色。想要动手试试直接克隆仓库并按上文三步操作即可git clone https://gitcode.com/GitHub_Trending/dy/DyberPet想深入了解细节素材开发文档docs/art_dev.md覆盖了角色、物品、迷你宠物与进阶功能的全部配置说明现有角色与模组合集收录在docs/collection.md下载后通过 App 即可导入。核心源码位于DyberPet/目录UI 模块集中在DyberPet/Dashboard/与DyberPet/DyberSettings/感兴趣的话翻代码本身就是一份不错的 PySide6 桌宠开发教材。从今天起你的桌面不必再是一张安静壁纸。【免费下载链接】DyberPetDesktop Cyber Pet Framework based on PySide6项目地址: https://gitcode.com/GitHub_Trending/dy/DyberPet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考