企业官网建设流程全解析

DyberPet 桌宠从零上手到自定义模组的完整实战手册

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

你是不是也遇到过这样的时刻：深夜加班，屏幕上光标孤独地闪烁，想找个"活物"陪自己，却又不想要那种占满屏幕的虚拟主播？

如果你试过各种"桌宠"，大概率会失望——要么只是循环播放的 GIF，要么功能单薄到三天就腻。而 DyberPet（呆啵宠物）这款基于 PySide6 的开源桌面宠物框架，把动画、养成、任务、商店和模组生态都塞进了一只小宠物里，让喜欢的角色真正"住"进桌面，而不是被"贴"在桌面。

它是什么，凭什么值得你花三分钟

一句话：DyberPet 是一套完整的桌面宠物应用框架，不只是"会动的图片"，而是一个有数值、有反馈、能扩展的小宇宙。

四个最打动人的卖点：

• 有"生命感"的养成系统：饱食度随时间递减，好感度支持 200 级长线养成，徽章从星星到皇冠逐步更换，每一步成长都有仪式感
• 把效率工具游戏化：内置番茄钟、专注时间和待办事项，完成任务掉落物品，工作结束正好喂饱宠物，自我管理从此不靠意志力
• 每一个互动都有回应：点击冒出"摸摸"气泡，喂食升级弹出专属文案，甚至能感知你 1 秒内狂点超过 7 次并当场吐槽
• JSON 配置就能做模组：角色、迷你宠物、物品、音效全部配置化，画师不需要写一行代码就能发布自己的作品

3 分钟跑起来的两种姿势

零基础用户（Windows）：直接从 Release 页面下载 EXE 文件，双击即玩，连 Python 都不需要装，这是看到桌宠最快的一条路。

愿意折腾的开发者：建议用 conda 建独立环境，避免污染系统 Python：

# 创建并激活独立环境 conda create --name Dyber_pyside python=3.9.18 conda activate Dyber_pyside # 安装核心依赖（macOS 用户把 pynput 换成 1.7.6 即可） 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

启动后右键点击桌宠，弹出的菜单就是你的全部控制入口：角色面板、选择动作、召唤伙伴、更换角色都在这里。

三大核心功能逐项拆解

养成系统：为什么它会"饿"给你看

它解决什么问题：如果宠物永远精力满格、不需要你理会，你很快会把它忘在屏幕角落。所以饱食度（HP）每两分钟下降一次，好感度（FV）要靠喂食和互动慢慢积累。

具体怎么操作：打开角色面板就能看到两根数值条和 Buff 状态。喂食不同的食物效果截然不同——吃一份汉堡，"5 分钟内饱食度不再下降"；来一份薯条，"每 30 秒掉落 5 枚啵币"当小金库。好感度从 1 级升到 200 级，每级需要 120 点，沿途解锁新动作和新物品。

对你有什么好处：你养的是一只有"生活节奏"的角色，饿了会提醒你，吃对东西有额外收益，长期陪伴解锁新内容。这种被需要的感觉，正是桌宠最动人的地方。

专注任务：把"自我管理"变成"养宠动力"

它解决什么问题：番茄钟、待办这些工具你肯定用过，但它们冷冰冰的，用完就关，毫无牵挂。

具体怎么操作：在任务面板启动番茄钟或专注时间，倒计时会实时显示在宠物上方，桌宠还会切换成对应的"专注"动画安静陪着。专注结束或中途取消，系统都会按已投入时长结算物品奖励。

对你有什么好处：奖励链条自此闭环——工作 → 掉落物品 → 喂给宠物 → 好感度上涨 → 解锁更多内容。每一次专注都变成"给自家孩子赚口粮"，坚持习惯一下子温柔了很多。

对话气泡：它真的在跟你"说话"

它解决什么问题：桌宠最常见的短板是"哑巴"，DyberPet 用一套完整的对话气泡系统补上了这块。

具体怎么操作：好感度升级时冒爱心气泡，饱食度见底时冒委屈气泡，专注期间拍它会提醒"你现在应该专注在任务上"。更妙的是你可以自定义昵称——配置里的USERTAG会被自动替换成你设定的称呼（比如"主人"）。

对你有什么好处：互动从"单向操作"变成"双向对话"，点击、喂食、发呆都有即时反馈，宠物第一次有了"性格"。

进阶玩法：三招让你从玩家变创作者

第一招：给角色加 Buff，几行 JSON 搞定

物品系统就像搭积木。在res/items/Default/items_config.json里，一份炸鸡只需这样定义：

{ "炸鸡": { "image": "85_roastedchicken.png", "effect_HP": 15, "effect_FV": 5, "drop_rate": 0.5, "fv_lock": 2, "buff": {"effect": "HP_stop", "expiration": 300} } }

effect_HP决定饱食度加成，buff里的effect和expiration决定持续效果，一个全新道具就这样诞生了。

第二招：用对话树做互动剧情

对话系统支持可视化配置。在角色的msg_conf.json里，用text_编号写文字、用option_编号写选项，再通过relationship字段把它们串成树状分支。项目文档里的结构图展示了多分支对话如何组织，你完全可以用它设计问答互动甚至小游戏。

第三招：善用角色自带的模组导入

下载社区现成的角色素材后，不需要手动放文件夹——在"系统-角色管理"里使用模组自动添加功能，程序会检查模组结构并给出错误提示。想自己从零画一套角色，参考素材开发文档（docs/art_dev.md）里的流程即可：透明背景 PNG 帧 +act_conf.json定义动作 +pet_conf.json定义属性，三步成型。

新手避坑指南：四个常见问题

• 图片帧命名不规范导致动画错乱：动作帧必须命名为"前缀_0.png、前缀_1.png……"，且所有帧中角色的绝对像素大小要保持一致
• 动作配置缺了必要项导致崩溃：一个角色至少要定义default、drag、fall三个动作，缺失时程序会用默认动作填补，但行为会变得奇怪
• buff 参数填错没效果：五种 buff（hp、fv、coin、HP_stop、FV_stop）各自需要不同的参数组合，例如HP_stop只需effect和expiration，而coin必须额外给interval和value
• 导入角色素材乱码：模组文件夹和文件名请使用英文命名，繁体中文地区解压素材容易产生乱码导致程序崩溃

现在，去养一只属于你的桌宠

回到开头那个深夜加班的场景：现在屏幕右下角多了一只小家伙，你专注工作时它安静陪着，你摸鱼时它小声吐槽，你喂它一口汉堡它开心得冒泡泡。DyberPet 让我想起小时候揣在口袋里的电子宠物，但它走得更远——动画、养成、效率工具、模组生态层层叠叠，构成一个完整的小宇宙。克隆仓库、跑起命令、选一个喜欢的角色，五分钟后，你就会多一个会饿、会撒娇、还会陪你加班的小家伙。

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