DyberPet

<h1 align="center"> 呆啵宠物 | DyberPet </h1> <p align="center"> 呆啵宠物 (DyberPet) 是一个基于 PySide6 的桌面宠物开发框架，致力于为开发者提供创造桌面宠物的底层软件 </p> <p align="center"> <a> <img src="https://yellow-cdn.veclightyear.com/835a84d5/762d05e6-34d1-4dc1-b077-785b48dbaa8f.svg"> </a> <a style="text-decoration:none"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/a861e923-755b-434b-8a37-5aea87ea69bd.svg"/> </a> <a style="text-decoration:none"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/3149c40f-12f7-4d1c-bf92-738188a7339f.svg" /> </a> <a style="text-decoration:none"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/0cc43b99-512f-4987-ab66-147402533d9f.svg"/> </a> </p> <p align="center"> 简体中文 | <a href="README_EN.md">English</a> </p>

:octocat: 目前项目已处于相对稳定的阶段，但仍有许多功能在计划中。如果你有兴趣加入，请私信我或直接提交 PR。欢迎一同构建框架 🥰

（近期暂无大功能更新计划，会抽空修复 Bug 和整理代码。）

如果你喜欢这个桌宠程序，请点击右上角的 ⭐ STAR，这对我们有很大的鼓励！

:new: 2024-07-20: v0.4.9 程序已打包上传至 Release，如有任何问题欢迎向我反馈！

:new: 2024-06-26: CSDN 正大规模从 GitHub 搬运开源项目至其旗下 GitCode，包括 DyberPet。该仓库与我们没有任何关系。GitCode 上使用我名字的主页也并非我本人创建，请仔细甄别您在 GitCode 上看到的其他项目！

:new: 2024-04-06: v0.3.7 已适配至 PySide6-Fluent-Widgets v1.5.4。如果你在使用终端运行本程序，请用 pip 更新 PySide6-Fluent-Widgets。

快速体验 Demo

Windows 用户

将 Release 下载至本地，双击 run_DyberPet.exe 即可运行

Windows 终端

建议首先在本地创建新的 conda 环境

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 -i https://pypi.org/simple/
pip install pyside6==6.5.2
pip install tendo

将仓库下载至本地，之后运行 run_DyberPet.py 即可

MacOS 用户

建议首先在本地创建新的 conda 环境

conda create --name Dyber_pyside python=3.9.18
conda activate Dyber_pyside
conda install -c conda-forge apscheduler
pip install pynput==1.7.6
pip install PySide6-Fluent-Widgets==1.5.4 -i https://pypi.org/simple/
pip install pyside6==6.5.2
pip install tendo

将仓库下载至本地，之后运行 run_DyberPet.py 即可

素材与模组合集

这里收录了现有的角色、物品模组和迷你宠物，包括它们的介绍及下载链接。
欢迎下载并通过 App 导入！

用户手册

请参考用户手册，体验现有功能（正在编写中）

开发者文档

素材开发

如果你想在现有功能下开发一套新的宠物形象和动作，请参考素材开发文档

功能开发

如果你想在现有模块下开发新功能，请参考功能开发文档（正在编写中）

更新日志

<details> <summary>版本更新列表</summary>

v0.5.0 - 2024/08/16

在左键拖拽时锁定右键菜单
修复了右键点击事件的错误代码（虽然不影响使用）

v0.5.0 - 2024/08/14

改进了与游戏存档相关的各项功能，避免因存档文件问题导致的崩溃和闪退
替换了右键菜单中的更换角色图标

v0.5.0 - 2024/08/10

修复了当迷你宠物跟随主宠物时，因目标坐标设定低于水平线导致的抽搐现象

v0.5.0 - 2024/08/06

移除了物品掉落组件中我自己画的难看的气泡
检查新添加角色模组时，patpat 不再是必须属性
修复了导入新角色后，以同伴组件进行召唤时，因缺少数据初始化而导致程序崩溃的问题

v0.5.0 - 2024/08/05

在 settings 中添加了 minipet_scale 来单独设置迷你宠物的大小
在迷你宠物菜单中添加了大小调节滑块
修复了召唤同伴或迷你宠物时拍拍动作的调用错误 v0.5.0 - 2024年3月8日
细化了"宠物大小"设置参数，现在每个角色都有独立的大小参数

v0.5.0 - 2024年7月21日

修复了在商店卖出最后一个物品时，背包内仍然显示该物品的问题

v0.4.9 - 2024年7月15日

修复了取消专注时间再次开始后程序崩溃的问题
初始化的动作会被自动勾选加入播放列表
修复了部分用户界面显示不全的问题
优化了对话框的出现位置
修复了宠物默认动作存在锚点时的正确初始位置

v0.4.8 - 2024年6月29日

统一参数"set_fall"为布尔值，并将其添加到settings.json文件中

v0.4.7 - 2024年6月15日

修复了系统界面一些对话框选项错误的问题
修复了缺少的语言类型初始化问题
添加了软件更新提醒通知
添加了相应更新的翻译

v0.4.6 - 2024年5月11日

"pet_conf.patpat"类型更改为"dict {0:"actname", 3:"actname2"}"，可以为每个饱食度等级单独定义拍拍动画
更新了交互模块拍拍动画的播放逻辑，会首先根据当前饱食度等级随机选取一个拍拍动画

v0.4.5 - 2024年5月10日

重构了所有数值条，解决了之前数值过小时条形超出圆角边界的问题

v0.4.4 - 2024年5月7日

添加了迷你宠物管理界面和功能
之前的"附属宠物/subpet"正式更名为"迷你宠物"
更新了系统面板的部分用户界面

v0.4.3 - 2024年5月5日

在基本设置中添加了自定义应用主题色功能
在基本设置中添加了检查更新功能

v0.4.2 - 2024年5月4日

简化了右键菜单结构
为宠物拖拽添加了反弹机制

v0.4.2 - 2024年5月3日

添加了"自定义动作"和"动作设计"功能
完善了动画面板的功能和用户界面
添加了动画面板相关的翻译

v0.4.1 - 2024年4月20日

"ActData"添加了"special_act"属性
如果你在4月18日至20日之间测试使用过新的终端版本程序，可能需要删除"data/act_data.json"并重新生成

v0.4.1 - 2024年4月18日

基于新的"ActData"结构：
- 更新了交互模块、附件模块的逻辑
为"act"、"acc"、"anchor"添加了"跳过"的配置数值
- 各模块判定为跳过动画时会按设定的逻辑执行
- 动画模块和交互模块：按跳过的配置，图像静止不动
- 附件模块：遇到跳过会暂时隐藏，直至下一个附件动画出现
下一步将开发动作模块用户界面，用于自定义动作

v0.4.0 - 2024年4月14日

重构了动画模块的配置数据结构"ActData"
基于新的数据结构：
- 更新了动画模块的逻辑
- 更新了动画选择菜单的功能逻辑
- 注意：交互模块尚未更新，可能会出现问题

v0.3.7 - 2024年4月9日

为角色面板添加了更多指南
如果角色包含"items"文件夹，会自动判定并导入其中的物品

v0.3.7 - 2024年4月6日

完成了通知栏剩余部分的翻译
采用Fluent-Widgets优化了通知栏用户界面
优化了缩放逻辑以避免在MacOS中的地面判断错误
适配到Fluent-Widgets 1.5.4版本；请尝试使用pip更新环境中的PySide6-Fluent-Widgets

v0.3.7 - 2024年3月31日

完成了待办事项用户界面和功能
角色面板的翻译全部完成

v0.3.6 - 2024年3月15日

更新了每日进度功能代码
存档数据新增了"task_data.json"
- 存档导出、快速存储时会被备份，但不会被导入
- "conf.py"中增加了"TaskData"的各种操作
- 应用启动时加载"settings.task_data"

v0.3.6 - 2024年3月5日

基本完成了专注任务功能代码
优化了番茄钟和专注时间倒计时用户界面的显示区域及其对主动画模块的影响

v0.3.5 - 2024年2月18日

完成日常任务用户界面设计
日常目标用户界面初始化

v0.3.5 - 2024年2月4日

日常任务用户界面初始化

v0.3.5 - 2024年1月21日

动作管理用户界面初始化
将程序中几乎所有的"QImage"替换成了"QPixmap"，以节省内存，优化运行效率

v0.3.4 - 2024年1月21日

实装商店购买和出售功能

v0.3.4 - 2024年1月18日

商店用户界面同步角色属性进行刷新
- 物品增减
- 角色好感度变化
- 切换角色
- 导入存档
物品默认价格按星级提升

v0.3.4 - 2024年1月16日

完成商店用户界面代码
- 界面设计和代码完成
- 实装了按字符搜索
- 实装了按标签筛选
商店各项功能暂未完成

v0.3.4 - 2023年12月26日

高分辨率屏幕图片缩放优化
优化Avatar Label生成方法
将默认未知图标换成了空白图片 v0.3.4 - 2023年12月13日
BUFF系统初始化
- 物品（包括宠物）添加了 buff 属性，详见 buffModule
- 状态面板添加了 Buff 的运算和 UI，仍在开发中
薯条、汉堡、派蒙均添加了 buff 属性作为演示示例
HP 下降计时器缩短为1分钟

v0.3.3 - 2023年11月28日

宠物系统初始化
- 宠物是每个角色的宠物（宠物的宠物，哈哈哈），作为Item类，可被获取
- 宠物可跟随角色，或自由活动
- 宠物可对角色有Buff加成（未完成）
添加了 派蒙 作为宠物示例
声明：从v0.3.3起，桌宠将用角色指代，桌宠的宠物用宠物指代

v0.3.2 - 2023年11月24日

背包面板刷新机制
金币系统初始化

v0.3.2 - 2023年11月21日

背包面板基本完成
背包空白格背景颜色更改
切换宠物时的刷新尚未完成
删除了旧的背包UI
进行了少量的代码清理

v0.3.2 - 2023年11月16日

背包面板初始化

v0.3.2 - 2023年11月12日

状态信息构建完成
角色面板构建完成

v0.3.1b - 2023年11月10日

角色面板初始化
状态信息日志小部件初始化

v0.3.1b - 2023年11月5日

修复了设置界面圆角显示不全的问题
优化了菜单UI子菜单点击的行为逻辑
修复了屏幕缩放导致部分组件重叠的问题
MacOS的兼容性改进
- 修复附件模块无法正常显示的问题
- 修复"前往文件夹"无法运行的问题
- 优化窗口大小计算，但Mac仍然存在屏幕大小获取问题

v0.3.1b - 2023年10月27日

切换了打包方式

v0.3.1 - 2023年10月21日

切换至PySide6-Fluent-Widgets 1.3.3
修复了一些已报告和未报告的潜在bug
补充了一些缺失的翻译
近期更新的本地测试完成
release添加PySide6版本

v0.3.0a - 2023年10月21日

完成了物品模组功能
完成了物品模组的翻译

v0.3.0a - 2023年10月17日

框架main分支迁移至PySide6

v0.3.0a - 2023年10月8日

框架迁移至PySide6
添加了物品模组功能（未完成）

v0.3.0a - 2023年9月24日

添加了系统及UI
- 基本设置UI：替换了原本的设置，更贴近Windows11；增加了语言切换设置
- 存档管理UI：实装了存档系统，包括存档的导出、导入，快速存档功能
- 角色管理UI：显示角色列表，包含启动按钮、角色信息卡片
存档系统改动
- 存档改为每个角色独立
- 添加了新旧存档的自动转换代码
- 添加了存档文件的各种操作（详见[添加了系统及UI]）
语言切换
- 完成了语言切换功能
- 新增了语言切换相关的文件：langs.pro，res/language
- 部分完成了中英两种语言的翻译
重构了原有UI
- 利用PyQt5原生功能重新实现按分辨率和缩放改变大小
- 优化了菜单UI，替换为PyQt-Fluent-Widgets RoundMenu
- 将状态栏移动到了右键菜单中
- 开启计划任务时，进度条会持续出现在宠物上方
- 替换了通知窗口的关闭按钮
角色添加功能
- 角色管理UI基本完成
- 实现了角色添加的基本功能 v0.2.2 - 2023年3月14日
数据存储大约需要0.43毫秒，极小概率在此间隔内关闭软件导致数据丢失。本次优化在每次关闭前主动存储一次数据，并冻结数据，然后执行退出。

v0.2.2 - 2023年3月9日

现在可以自定义番茄钟了
修复了物品爆率过高的另一个重大漏洞

v0.2.2 - 2023年3月8日

由于Mac系统不兼容通知栏关闭按钮，因此优化了关闭按钮的用户界面

v0.2.2 - 2023年3月7日

附加动作的"follow_mouse"属性新增了"x"和"y"选项，可以单独跟随x轴或y轴

v0.2.2 - 2023年3月5日

修改了常驻动作的数据结构，修复了相关bug
同伴增加了常驻动作判定，需要在作为主宠物时进行设置

v0.2.2 - 2023年3月4日

新增了下落前的预备动作"prefall"，将在鼠标松开后执行
背包分为食物和收藏品两个分类

v0.2.2 - 2023年3月3日

右键菜单中新增了常驻动作选项，可以更改闲置时的默认动作，选中后将不再随机播放其他动作

v0.2.2 - 2023年3月2日

交互功能新增了水平跟随目标的功能
新增了跟随鼠标的功能
目标跟随需要在"pet_conf.json"中定义"left"（向左移动）和"right"（向右移动）的动作

v0.2.2 - 2023年3月1日

存档系统初步功能上线

v0.2.1 - 2023年2月25日

"fv_reward"属性可设置为列表，物品可出现在多个等级奖励中

v0.2.1 - 2023年2月23日

Windows系统新增了subwindow属性
禁用掉落时，缩放宠物不会闪回地面

v0.2.1 - 2023年2月22日

优化了缩放机制
物品数量为1时不显示数字
优化了主宠物列表判断和默认宠物的保存方式

v0.2.0 - 2023年2月21日

改进了MacOS兼容性代码
增加了好感度等级奖励的补偿系统

v0.2.0 - 2023年2月18日

设置中新增了启动默认角色的选择
切换角色时增加了问候通知
新增了NoDropShadowWindowHint（为MacOS准备）

v0.1.19 - 2023年2月16日

设置中可以静音了
新增了统计陪伴天数及显示铭牌的功能

v0.1.18 - 2023年2月12日

对话框自动添加上一步按钮
调整了对特殊中文字符的长度计算

v0.1.18 - 2023年2月11日

增加了附属宠物和主宠物的连接
确保收藏品在随机掉落中不重复出现
整理了可变更的系统数值

v0.1.18 - 2023年2月10日

新增了对话界面和功能（暂未实装素材）

v0.1.17 - 2023年2月5日

给通知系统语音添加了优先级"sound_priority"属性
增加了点击时的随机语音事件
增加了纳西妲的语音库

v0.1.16 - 2023年2月1日

实现了多屏之间转移（测试中）
规避了专注时间0分0秒相关的闪退bug
解决了不能言说的狂爆物品惊天大bug
停止按钮按下后会立刻失效，避免多次结算
修复了快速点击鼠标微小位移造成闪现的bug
修复了召唤同伴放大时显示不全的问题
修复了一定条件下缩放宠物派蒙位置问题

v0.1.15 - 2023年1月29日

取消屏幕缩放对图片大小的影响
重力加速度最小值变为0.01
数值栏字体固定为Times
设置内添加是否置顶的选项

v0.1.14 - 2023年1月28日

修复了禁用掉落时不会触发摸摸事件的bug
"pets.json"转移到了"res/role/"

v0.1.14 - 2023年1月23日

"item_config"更新
- 添加了"fv_reward": int，将物品设定为好感度升级奖励
- 修复了label anchor未随缩放比例改变的bug
- 重力加速度最小值变为0.01
- 取消屏幕缩放比例对图片大小的影响

v0.1.14 - 2023年1月22日

"pet_config['acc_act']"更新
- "timeout"：true/false 动画结束后关闭 / 不断循环
- "unique"：true/false 可否存在多个一样的附件
- "closable"：true/false 可否关闭（右键菜单关闭）
- "follow_main"：true/false 是否跟随主程序移动
- "speed_follow_main"：int 跟随主程序的移动速度

v0.1.13 - 2023年1月21日

优化了widget size的动态变化逻辑
修复了没有随机动作或随机动作概率为零时的报错
通知栏边框变为圆弧
饱食度下降间隔变为2分钟
"pet_config" 更新
- 添加了"subpet"，用来定义宠物的附属宠物
- "item_favorite", "item_dislike" 变更为dict, 增加了物品好感度倍率数值
"item_config"更新
增加了"type"属性，可添加"consumable"（消耗品）和"collection"（收藏品）两类物品，收藏品不可使用
"act_config"更新
- 添加了"anchor"属性，将根据锚点自动移动动画
开始进行语言切换工作

v0.1.12 - 2023年1月15日

待机动作（默认）将持续进行
更改了数值模块的逻辑，目前所有宠物共用一套数值
- 删除了"pet_config"中的"gravity"、"hp_interval"和"fv_interval"
禁止进程多开，以防数据存储混乱
在多开禁止的情况下，为了能够让多个宠物同时出现在屏幕上，增加了"召唤同伴"功能
增加了鼠标点击触发的"摸摸事件"，宠物可定义摸摸时的动作，并且大概率触发向上浮动的心心，小概率获得物品掉落
增加了物品掉落的动画，掉落物品呈抛物线落在底部任务栏 v0.1.11 - 2023年1月7日
添加了设置界面，可以调整大小、重力、拖拽速度、音量
添加了组件动作：现在支持动作包含另一个动画的功能（详见素材开发文档）
物品使用添加了宠物喜爱度分级，可设置不同的声音和动作
支持宠物自定义通知图标和声音，在res/role/NAME/note/中添加（详见素材开发文档）
宠物移动行为增加了屏幕边界限制

v0.1.10 - 2022年12月28日

通知栏的图标和声音与note_type关联，可在res/role/PETNAME/note/note_config.json中自定义

v0.1.10 - 2022年12月27日

更新了提醒事项的用户界面
更新了饱食度随时间下降的计算逻辑，每分钟都会变化，但只显示百分比，与用户定义的hp_interval相关

v0.1.9 - 2022年12月25日

更新了番茄钟和专注时间的用户界面
番茄钟和专注时间的开始和取消功能移至各自界面内，不再使用菜单操作
专注时间现在可以暂停
取消专注时间也会根据已进行的时长获得物品奖励

v0.1.8 - 2022年12月21日

界面大小现在考虑了屏幕缩放比例
用户界面尚未全部完成
加入了圣诞限定小猫角色

v0.1.8 - 2022年12月19日

交互模块的QTimer更换为更精确的Timer

v0.1.8 - 2022年12月18日

数值系统更新：健康值和心情值替换为饱食度、好感度，并更新了数值系统及其用户界面
增加了更多模块连接
- 数值变化将影响随机动作的触发概率及每个动作的具体概率
- 动作和物品将随好感度提升而解锁
- 更多细节将在用户手册和素材开发文档中更新
下落动作细分为"下落中"和"落地"两个部分
更新了背包系统的用户界面，后续将逐步更新所有用户界面

v0.1.7 - 2022年12月11日

添加了计划任务完成后的物品掉落事件

v0.1.7 - 2022年12月10日

添加了背包系统，可以使用宠物获得的物品（目前仅为功能测试阶段，用户界面极其简陋，甚至不统一）
- 在settings中增加了pet_data，用于存储宠物数值和物品数据
- 添加了item_data和res/items/item_config.json，用于在素材开发中设定物品属性（素材开发文档待更新）
- 完善了背包交互的一系列可能行为的系统反馈，尽可能考虑了各种情况（可能仍存在bug）
- 连接了物品使用与数值变化、动画播放
添加了通知系统，将取代旧版本中的对话框
- 定义了QToaster类及目前定义的通知类型字段
- 通知消息会伴随喵叫声
- 为物品使用和数值变化添加了通知
- 为计划任务添加了通知，删除了对话框显示（代码仍保留）