AnkioTomas / qqpet

# QQPet
QQ 宠物跨平台复刻（Windows / macOS / Linux / Android / HarmonyOS / iOS），基于 Arctic Penguin T800 逆向重建。Flash 内容由 Ruffle 播放。
> **版权声明**：QQ 宠物的美术资源与 SWF 版权归腾讯所有；旅行照片素材版权归《旅行青蛙·中国之旅》所有。本项目仅供学习交流，请勿用于商业用途。
## 截图
 桌面宠物与右键菜单 
 商城与背包 
 宠物资料 
 图鉴与签到 
 今日任务 
 全国旅游 
 系统设置 
## 功能
- **养成**：选蛋领养、成长与升级、饥饿/清洁/心情/健康、生病就医、死亡与复活、重生（可换性别）。
- **日常**：打工、上学（含升学考试）、全国旅游（奇遇、纪念品、旅行相簿明信片），关闭应用期间的进度照常计时。
- **物品**：商城与购物车、背包、食物/清洁/药品/玩具、限时物品、粉钻与甜蜜情侣。
- **任务与邮件**：今日任务（按宠物需求和节假日生成）、逗逗我、学习打工、旅游任务；签到与图鉴；节日、生日、旅行明信片邮件。
- **活动**：池塘（养鱼）、农场（QQFarm，金币即元宝）、密室探险、6 类 101 个小游戏（独立窗口，按游戏时长奖励）。
- **AI（可选）**：接入任意 OpenAI 兼容接口，宠物闲聊、改写台词、点评或翻译剪贴板文字。
- **难度**：设置里可切换「标准难度」，打工、小游戏、钓鱼、农场、邮件礼物等元宝收入降为 40%（至少 1），物价不变；默认「轻松」保持原有收入。
- **Webhook（桌面版）**：设置里开启后，在本机 `127.0.0.1:17788` 提供接口，外部服务发来的消息由宠物念出来，可带链接，点「打开链接」跳转。默认关闭，仅本机可访问，必须带 token，免打扰时不弹。用法见下方「Webhook」。
- **其他**：天气播报、节日问候、免打扰、透明度、开机自启、全屏应用（看视频、玩游戏）在前台时自动隐藏宠物、高清画质（重绘的 @2x 素材，适配高分屏，重启后生效）、存档导入导出（兼容原版 `config.json`，首次启动的选蛋页也可直接导入）。
存档位于 `userData/save.json`，导入时旧存档备份为 `save.json.bak`。
桌面版支持将宠物拖到其他显示器（包括主屏左侧或上方、不同缩放比例的屏幕），重启后回到上次所在的显示器；该显示器断开时回到主屏幕。
### iOS
最低目标为 iOS 14.0。安装需使用保留所需权限的越狱 App 安装器或 TrollStore，后者的系统兼容范围以其上游说明为准。全局 HUD 依赖系统私有接口和所需权限，普通开发者签名不能替代这些权限。打开管理 App，点击「开始桌宠」，返回主屏幕后桌宠继续显示在其他应用上方。打开管理界面会暂时隐藏桌宠；「宠物菜单」「宠物状态」可显示相应界面，「返回管理」用于回到管理操作。
复用完整养成、界面和 SWF 内容，增加原生触摸分区、游戏展示和系统文件选择器导入导出。HUD 输入框通过前台管理器的原生编辑框提交文字。剪贴板文本由用户主动发送；后台剪贴板监听及前台应用观察暂不提供，因而也不提供其他 App 全屏时自动隐藏，设置会说明平台能力限制。此版本不安装 daemon，也不提供开机自启；完整重启后需手动开始。
iOS 常驻宠物、气泡及心情动画优先使用 WebGL 后端以降低渲染开销，阴影、发光及复杂混合等效果可能简化；小游戏保持原有渲染后端。
本地使用 Node 22.12 或以上版本、公开 iPhoneOS SDK 和本地 `ldid`（也支持 ad-hoc `codesign`）。资源准备是独立步骤，普通构建使用本地文件：
 [code] 
产物为 `out/ios-native/QQPetIOS.ipa`。安装器需保留 IPA 内的 entitlement。共用渲染代码以 Safari 14.0 能力为底线，构建会降级 Ruffle 回退 WASM 的符号扩展指令，并验证结果只依赖基础特性；Electron 外壳保留原有最低 macOS 版本要求。构建选项、存档路径、后台生命周期和平台限制见 iOS 使用说明。
### Android
宠物以悬浮窗形式显示在桌面和其他应用上方，功能与桌面版一致，另有以下适配：
- 首次打开需允许「显示在其他应用的上层」和通知权限；通知栏常驻的通知代替桌面版的托盘图标。
- 宽面板在竖屏手机上自动旋转并铺满屏幕；横竖屏切换后宠物保持在屏幕内。
- 小游戏和密室探险全屏横屏运行，并显示可改键的虚拟手柄。
- 系统不允许后台读取剪贴板：在其他应用里选中文字后，从选择菜单或分享面板选「QQ宠物」，交给宠物点评或翻译。
### HarmonyOS
纯血鸿蒙（HarmonyOS NEXT / 5 及以上）不能装 Android APK。宠物同样以悬浮窗显示，JS 桥和 Android 是同一份 `QQPetNative` 契约，原生壳在 `harmony/`，渲染层不改。
- 首次打开需允许「显示在其他应用的上层」和通知；通知栏通知代替桌面版的托盘图标。
- 小游戏和密室探险全屏横屏运行（`GameAbility`）。
- 系统不允许后台读剪贴板：在其他应用里分享文字给「QQ宠物」，交给宠物点评或翻译。
- 没有开机自启：当前 SDK 没有可用的开机广播扩展。
- 窗口按页面可见内容裁剪；拖动时会铺满屏幕，避免跟手错位。
本地打包：`npm run harmony`，需要本机 DevEco Studio（`harmony/hvigorw` 默认使用 `/Applications/DevEco-Studio.app`，可用 `DEVECO_SDK_HOME` / `NODE_HOME` / `JAVA_HOME` 覆盖）。产物在 `harmony/entry/build/default/outputs/default/`。
GitHub Actions 打 `v*` 标签时产出未签名 HAP 并放进 Release。和桌面包一样没有商店签名；用 hdc 装到模拟器或已开启调试的真机。上架或普通真机日常安装要在 DevEco 里配签名，目前仓库没有这份材料。
## 下载安装
从 Releases 下载对应平台的安装包：
| 平台 | 文件 |
|---|---|
| Windows | `QQPet.Setup. .exe` |
| macOS（Apple 芯片） | `QQPet- -arm64.dmg` |
| macOS（Intel） | `QQPet- .dmg` |
| Linux | `QQPet- .AppImage` 或 `qqpet_ _amd64.deb`（ARM64：`QQPet- -arm64.AppImage` 或 `qqpet_ _arm64.deb`） |
| Android（11 及以上） | `QQPet- .apk` |
| HarmonyOS（5 及以上） | `QQPet- .hap` |
| iOS（需 TrollStore 或越