AnkioTomas/qqpet

选用指南

AI 根据 README 整理 · 2026/10/20 22:12:07

使用方式

桌面版提供安装包，支持Windows、macOS、Linux；Android版为APK；HarmonyOS版为HAP；iOS版需TrollStore或越狱安装。

查看 README 依据

GitHub Actions 打 `v*` 标签时产出未签名 HAP 并放进 Release。和桌面包一样没有商店签名；用 hdc 装到模拟器或已开启调试的真机。上架或普通真机日常安装要在 DevEco 里配签名，目前仓库没有这份材料。 ## 下载安装 从 [Releases](https://github.com/AnkioTomas/qqpet/releases/latest) 下载对应平台的安装包： | 平台 | 文件 | |---|---| | 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 或越狱） | `QQPet-<版本>-ios.ipa` |

部署要求

iOS版需Node 22.12+、公开iPhoneOS SDK和本地ldid；HarmonyOS打包需DevEco Studio；Android调试需Android SDK和JDK 17。

查看 README 依据

最低目标为 iOS 14.0。安装需使用保留所需权限的越狱 App 安装器或 TrollStore，后者的系统兼容范围以其上游说明为准。全局 HUD 依赖系统私有接口和所需权限，普通开发者签名不能替代这些权限。打开管理 App，点击「开始桌宠」，返回主屏幕后桌宠继续显示在其他应用上方。打开管理界面会暂时隐藏桌宠；「宠物菜单」「宠物状态」可显示相应界面，「返回管理」用于回到管理操作。 复用完整养成、界面和 SWF 内容，增加原生触摸分区、游戏展示和系统文件选择器导入导出。HUD 输入框通过前台管理器的原生编辑框提交文字。剪贴板文本由用户主动发送；后台剪贴板监听及前台应用观察暂不提供，因而也不提供其他 App 全屏时自动隐藏，设置会说明平台能力限制。此版本不安装 daemon，也不提供开机自启；完整重启后需手动开始。 iOS 常驻宠物、气泡及心情动画优先使用 WebGL 后端以降低渲染开销，阴影、发光及复杂混合等效果可能简化；小游戏保持原有渲染后端。 本地使用 Node 22.12 或以上版本、公开 iPhoneOS SDK 和本地 `ldid`（也支持 ad-hoc `codesign`）。资源准备是独立步骤，普通构建使用本地文件： ```sh ELECTRON_SKIP_BINARY_DOWNLOAD=1 npm ci --ignore-scripts

纯血鸿蒙（HarmonyOS NEXT / 5 及以上）不能装 Android APK。宠物同样以悬浮窗显示，JS 桥和 Android 是同一份 `QQPetNative` 契约，原生壳在 `harmony/`，渲染层不改。 - 首次打开需允许「显示在其他应用的上层」和通知；通知栏通知代替桌面版的托盘图标。 - 小游戏和密室探险全屏横屏运行（`GameAbility`）。 - 系统不允许后台读剪贴板：在其他应用里分享文字给「QQ宠物」，交给宠物点评或翻译。 - 没有开机自启：当前 SDK 没有可用的开机广播扩展。 - 窗口按页面可见内容裁剪；拖动时会铺满屏幕，避免跟手错位。 本地打包：`npm run harmony`，需要本机 [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/)（`harmony/hvigorw` 默认使用 `/Applications/DevEco-Studio.app`，可用 `DEVECO_SDK_HOME` / `NODE_HOME` / `JAVA_HOME` 覆盖）。产物在 `harmony/entry/build/default/outputs/default/`。

Android 版本地调试用 `npm run android`（debug 包，输出到 `android/app/build/outputs/apk/debug/`），需要 Android SDK 和 JDK 17（Gradle 8 不支持更新的 JDK，可用 `JAVA_HOME` 指定）。CI 打的 release 包需要在仓库 Secrets 中配置签名密钥： | Secret | 内容 | |---|---| | `ANDROID_KEYSTORE_BASE64` | keystore 文件的 base64（`base64 -i release.jks`） | | `ANDROID_KEYSTORE_PASSWORD` | keystore 密码 | | `ANDROID_KEY_ALIAS` | 密钥别名 | | `ANDROID_KEY_PASSWORD` | 密钥密码 | 每次发布都必须用同一个 keystore，否则已安装的用户无法覆盖升级。 ## 改过的 SWF 以下文件用 [JPEXS FFDec](https://github.com/jindrapetrik/jpexs-decompiler) 打过补丁，重新导入资源时不要覆盖： | 文件 | 改动 | |---|---|

已知限制

iOS版不提供后台剪贴板监听及前台应用观察，不安装daemon，无开机自启；HarmonyOS无开机自启；桌面版Webhook仅本机可用，手机版不提供。

查看 README 依据

最低目标为 iOS 14.0。安装需使用保留所需权限的越狱 App 安装器或 TrollStore，后者的系统兼容范围以其上游说明为准。全局 HUD 依赖系统私有接口和所需权限，普通开发者签名不能替代这些权限。打开管理 App，点击「开始桌宠」，返回主屏幕后桌宠继续显示在其他应用上方。打开管理界面会暂时隐藏桌宠；「宠物菜单」「宠物状态」可显示相应界面，「返回管理」用于回到管理操作。 复用完整养成、界面和 SWF 内容，增加原生触摸分区、游戏展示和系统文件选择器导入导出。HUD 输入框通过前台管理器的原生编辑框提交文字。剪贴板文本由用户主动发送；后台剪贴板监听及前台应用观察暂不提供，因而也不提供其他 App 全屏时自动隐藏，设置会说明平台能力限制。此版本不安装 daemon，也不提供开机自启；完整重启后需手动开始。 iOS 常驻宠物、气泡及心情动画优先使用 WebGL 后端以降低渲染开销，阴影、发光及复杂混合等效果可能简化；小游戏保持原有渲染后端。 本地使用 Node 22.12 或以上版本、公开 iPhoneOS SDK 和本地 `ldid`（也支持 ad-hoc `codesign`）。资源准备是独立步骤，普通构建使用本地文件： ```sh ELECTRON_SKIP_BINARY_DOWNLOAD=1 npm ci --ignore-scripts

纯血鸿蒙（HarmonyOS NEXT / 5 及以上）不能装 Android APK。宠物同样以悬浮窗显示，JS 桥和 Android 是同一份 `QQPetNative` 契约，原生壳在 `harmony/`，渲染层不改。 - 首次打开需允许「显示在其他应用的上层」和通知；通知栏通知代替桌面版的托盘图标。 - 小游戏和密室探险全屏横屏运行（`GameAbility`）。 - 系统不允许后台读剪贴板：在其他应用里分享文字给「QQ宠物」，交给宠物点评或翻译。 - 没有开机自启：当前 SDK 没有可用的开机广播扩展。 - 窗口按页面可见内容裁剪；拖动时会铺满屏幕，避免跟手错位。 本地打包：`npm run harmony`，需要本机 [DevEco Studio](https://developer.huawei.com/consumer/cn/deveco-studio/)（`harmony/hvigorw` 默认使用 `/Applications/DevEco-Studio.app`，可用 `DEVECO_SDK_HOME` / `NODE_HOME` / `JAVA_HOME` 覆盖）。产物在 `harmony/entry/build/default/outputs/default/`。

- 也可用 GET / 表单 / 纯文本请求体；token 还可放在 `Authorization: Bearer` 或 `X-Token` 头里。 - 只监听本机；请求体最大 16 KB，每分钟最多 30 次；多条消息排队，后一条最多 10 秒后接替前一条；免打扰时丢弃。 - 手机版不提供。 ## 征集素材 社区里能找到的 QQ 宠物原版资料很少，大量游戏画面和素材已经缺失，复刻时只能靠猜。如果你手上有下面这些东西，欢迎提供： - **老版本客户端**：QQ 宠物的安装包或安装目录，以及老版本 QQ 留下的宠物缓存目录（里面的 SWF、图片、音效、配置文件都有用）。 - **游戏画面**：当年的截图、录屏、视频，尤其是打工、上学、旅游、小游戏、商城、节日活动等界面。 - **其他资料**：物品与宠物数据、台词文本、活动说明，或者你记得的玩法细节。 ### 目前确认缺少的素材 对照 issue #25 提供的素材包逐一比对后，下面这些仍然没有找到： | 类别 | 缺少的内容 | |---|---| | 社区场景 | 瓦里步行街、企鹅镇整张场景贴图；风语广场最下面一行贴图；粉钻雪山约一半装饰物；新版夏帕海岸、新版粉钻雪山；所有场景的小地图和大地图图片 |