一键打开 Android 模拟器里的 QQ 宠物主页。
模拟器里的手机 QQ 搜索"QQ宠物"卡片不下发跳转地址（提示"请在手机端使用"）， 没法手动进宠物主页。本工具通过 ADB 用官方 scheme 让 QQ 自己打开宠物主页， 打不开时再按序走本地门禁补丁、frida 一次性初始化兜底。
从 Releases 下载 zip，解压出 exe，双击运行（或命令行运行）即可。提供两个版本：
-
qq-pet-opener：完整版，scheme/门禁补丁都失败时还有 frida 一次性初始化兜底； -
qq-pet-opener-nofrida：无 frida 兜底版。scheme 直开 + 本地门禁补丁已覆盖 绝大多数 QQ 版本，不打包 frida、体积明显更小，日常推荐用这个； 万一打不开再换完整版。 -
只连着 1 台设备时直接使用；多台在线时列出编号，输入序号选择。
-
exe 自带 adb（release 构建时打包 platform-tools），本机没装 adb 也能用。
命令行参数：
qq-pet-opener.exe # 扫描在线设备，多台时交互选择
qq-pet-opener.exe -s 127.0.0.1:7555 # 指定设备序列号，跳过选择
qq-pet-opener.exe --adb D:\path\adb.exe # 指定 adb 路径
qq-pet-opener.exe -m # 启用 MuMu 机型伪装（仅 MuMu，需 Root；默认关闭）
- Android 模拟器（MuMu / 雷电 / 夜神等），开启 ADB 连接，且
adb devices能看到设备 （远程模拟器先自己adb connect 127.0.0.1:<端口>，常见端口 5555 / 7555 / 16384， 本工具不主动扫端口）； - 模拟器里装好手机 QQ 并已登录；
- Root 按需：多数情况不需要 Root（scheme 直开零权限）。scheme 失败时会提示 在模拟器设置里临时开一次 Root 打门禁补丁——补丁写在 QQ 数据盘，持久生效， 打完后可以永久关闭 Root。
按隐身性优先分三级，全程不常驻注入 QQ 进程：
- scheme 直开：
am start -a VIEW -d "mqqapi://qpet/open?..."，由 QQ 自己的 JumpActivity 打开宠物主页（官方路径，零写盘零注入零权限）。 模拟器被 QQ 判成平板（TABLET）时宠物设备门禁会拦截该跳转——门禁已翻转过 （见第 2 级）或 MuMu 机型伪装过的设备直接成功。 - 本地门禁补丁（需 Root）：把 QQ 本地 MMKV 缓存里 UnitedConfig 107805 配置的
enable_tablet改成 1，门禁本地翻转后再走 scheme。补丁持久，之后每次运行 都走第 1 级。（MuMu 设备另有一层可选的机型伪装：加-m/--mumu-spoof时用 root mount --bind 把 MuMu 给 QQ 喂的模拟器机型映射换成真实手机 profile， 重启模拟器失效，每次运行自动重挂；默认关闭。） - frida 兜底（需 Root，仅门禁补丁失效时）：伪装名 frida-server + 随机端口， 一次性初始化宠物 SDK 后 am start 直开宠物页，几秒注入窗口，用完立即 解除注入、杀掉 server，设备上不常驻。
frida-server 不随 exe 打包：兜底触发且本地无缓存时，源码运行会自动联网下载；
exe 版本按提示把 frida-server-<版本>-android-<架构>.xz 放到 exe 旁
runs/resources/frida-server/ 即可（tools/fetch_frida_server.py 可下载）。
python -m venv .venv
.venv/Scripts/pip install -r requirements.txt
.venv/Scripts/python build.py
产出 dist/qq-pet-opener.exe（完整版）和 dist/qq-pet-opener-nofrida.exe
（无 frida 兜底版，体积更小），均为 PyInstaller onefile；只构建单个变体用
python build.py full 或 python build.py nofrida。
打包前把 adb 三件套（adb.exe + AdbWinApi.dll + AdbWinUsbApi.dll，来自
platform-tools）放到 resources/scrcpy-win64/ 即可让 exe 自带 adb。
打 tag（v*）推送会触发 GitHub Actions 自动打包并发布 Release。
本项目仅供学习交流使用，与腾讯公司无任何关联。使用时请遵守 QQ 相关用户协议， 由此产生的任何问题由使用者自行承担。