qqpet

项目概述

QQPet 是一代人的桌面宠物 QQ 宠物的单机复刻版，基于 Arctic Penguin T800 逆向重建，原版 Flash 内容由 Ruffle 引擎播放，不依赖任何服务器，养成数据全部存在本地。

它覆盖六大平台：Windows、macOS、Linux 桌面版，Android 与鸿蒙以悬浮窗形式常驻，iOS 版则通过特殊安装器实现全局桌宠；另可接入任意 OpenAI 兼容接口，让宠物闲聊、点评剪贴板文字。

项目	内容
平台	Windows、macOS、Linux、Android、HarmonyOS、iOS
技术栈	Electron + TypeScript，Ruffle 播放 SWF
存档	本地 save.json，兼容原版 config.json
许可	GPL-3.0

把那只曾经准时喂饭清洁的 QQ 宠物装回电脑和手机，单机也能养。

主要功能

• 完整养成：选蛋领养、成长升级、饥饿清洁心情健康四维照料、生病就医、死亡复活与重生
• 日常玩法：打工、上学含升学考试、全国旅游奇遇与旅行相簿，关闭应用期间进度照常计时
• 商城背包：食物、清洁、药品、玩具分类齐全，支持购物车、限时物品与粉钻情侣玩法
• 任务邮件：今日任务按需求与节假日生成，节日、生日与旅行明信片邮件一应俱全
• 小游戏合集：池塘养鱼、QQFarm 农场、密室探险与 6 类 101 个独立小游戏
• AI 陪伴：接入 OpenAI 兼容接口后可闲聊、改写台词、点评或翻译剪贴板文字
• 桌面集成：透明度调节、开机自启、全屏应用前台自动隐藏、高清 2x 素材、多显示器记忆
• 跨平台适配：Android/鸿蒙悬浮窗与虚拟手柄、iOS 原生触摸分区与 HUD 输入

适用人群

• 怀念 QQ 宠物的老用户
• 想给桌面添一只电子宠物的上班族
• 想在手机或鸿蒙设备上养宠物的用户
• 想接 AI 做语音文字陪伴的玩家

快速上手

1. 从 Releases 下载对应平台的安装包（dmg、exe、AppImage、apk、deb、hap 均有）
2. 安装后启动，在选蛋页领养第一只宠物，也可直接导入旧存档
3. 桌面版右键宠物打开菜单，喂食、清洁、打工一键操作
4. Android/鸿蒙首次启动需允许悬浮窗与通知权限
5. 想开 AI 陪聊：在设置里填入任意 OpenAI 兼容接口地址与 Key

核心优势

• 单机完整：不依赖服务器，进度本地计时，关掉应用也在成长
• 平台最全：一套代码覆盖桌面、移动、鸿蒙与 iOS 六端
• 情怀还原：原版 SWF 与重绘 2x 素材兼备，高分屏也清晰
• AI 加持：可选接入大模型，让宠物真正能聊天

系统要求

项目	要求
桌面端	Windows、macOS、Linux
移动端	Android、HarmonyOS NEXT、iOS 14+
iOS 安装	需越狱安装器或 TrollStore

注意事项

• 版权归属：QQ 宠物美术与 SWF 版权归腾讯，仅供学习交流，请勿商用
• iOS 限制：全局桌宠依赖系统私有接口，普通开发者签名无法替代，重启后需手动开启
• 鸿蒙无自启：当前鸿蒙 SDK 没有可用的开机广播，宠物需手动启动
• 后台剪贴板：Android 与鸿蒙不允许后台读剪贴板，需通过分享菜单把文字交给宠物