v1.5.4 MuMu 连接与组件自修复补丁 / Connection Self-Repair Patch

v1.5.4 MuMu 连接与组件自修复补丁

本补丁修复部分用户在独立启动 QQ 宠物助手时遇到的 MuMu ADB、Frida 启动及 Java 桥接问题。

主要修复

• 扩展 MuMu 12 安装目录识别，支持 D:\MUMU12\MuMu Player 12 等自定义位置及注册表安装信息。
• 一键启动页新增手动选择 adb.exe、手动填写模拟器连接地址和“恢复自动”按钮。
• adb root 超时后不再直接失败：等待模拟器重连并读取真实 Root 身份后再判定。
• frida-server --daemonize 超时后检查真实进程；组件已经运行时不再误报失败。
• Frida Java 桥接采用安装包双副本，并在连接 QQ 前主动检测可用性。
• Java 桥接缺失或损坏时自动从 Frida 官方 frida-tools 14.10.4 发布包补齐，校验发布包和目标文件 SHA-256 后缓存使用。
• 自动修复失败时返回具体错误，避免直接显示 Java is not defined 调用栈。

验证

• Python 3.13：156 项项目测试全部通过。
• Windows 独立 EXE 构建通过。
• 打包产物确认同时包含主 Java 桥接、备用 Java 桥接和 QQ 手机协议 Hook。
• 本机 MuMu ADB Root、Frida PID 与协议端口准备流程验证通过。

---

v1.5.4 MuMu Connection & Component Self-Repair Patch

This patch fixes standalone startup failures involving MuMu ADB, Frida startup, and the Java bridge.

Highlights

• Detects custom MuMu 12 locations such as D:\MUMU12\MuMu Player 12 and registry-provided install paths.
• Adds manual adb.exe selection, emulator address entry, and a restore-auto button to the launcher.
• Verifies the actual Root identity after an adb root timeout instead of failing immediately.
• Verifies the real frida-server PID after a daemonize timeout to avoid false failures.
• Packages redundant Java bridge copies and checks Java readiness before reading the QQ session.
• Automatically restores a missing or damaged bridge from the official Frida Tools 14.10.4 source package with package-level and file-level SHA-256 verification.
• Reports a specific repair error instead of exposing a raw Java is not defined stack trace.

Validation

• 156 project tests pass on Python 3.13.
• Windows standalone EXE build passes.
• The final package contains the primary bridge, fallback bridge, and mobile QQ Hook.

v1.5.3 多项稳定性修复补丁 / Multi-fix Stability Patch

v1.5.3 多项稳定性修复补丁

本次重新发布的 v1.5.3 汇总了近期多个已验证修复，重点提高手机协议调度、好友功能和动态收益优化的可靠性。

主要修复

• 修正动态收益优化的课程收益与金币费用解析，不再把 Markdown URL 或当前状态值误算为收益/费用。
• 课程与岗位按服务器目录中的具体项目逐项计算；界面明确标注摘要数值是目录中位数。
• 新增好友自动清洁，可配置清洁阈值、香皂片/沐浴球与单轮安全上限。
• 好友喂食、好友清洁均重新读取好友宠物状态验证，不使用本账号库存推断成功。
• 食物和洗护用品按状态缺口批量使用；洗护通过单个数量封包完成，喂食同批发送后统一验证。
• 修正好友访问与踩踩混合判定：访问成功后即使踩踩提示重复点赞，也不会被误记为访问失败。
• 自动迁移旧版 136202 不能重复点赞 误判记录，并保持每日防重复机制。
• PK 改为每日定时批次，不再随调度器启动立即执行；空响应通过状态变化安全确认且不会重复发送。
• 动态优化会预读取当前服务器课程、岗位、洗护目录和已验证的食物恢复数据。
• 完善前端好友照顾进度、设置项和运行状态说明。

验证

• 当前手机 QQ 服务器目录实测：短课程收益/费用 20/70，长课程 50/210，体力和清洁消耗解析一致。
• Python 3.13：149 项测试全部通过。
• Python 语法编译与 Windows 打包检查通过。

---

v1.5.3 Multi-fix Stability Patch

This refreshed v1.5.3 release consolidates multiple verified fixes for mobile-protocol scheduling, friend automation, and dynamic profit optimization.

Highlights

• Correctly parses course rewards and coin costs without consuming Markdown URL or current-state numbers.
• Calculates each selected course/job from its own live catalog fields; summary values are now labeled as catalog medians.
• Adds configurable automatic cleaning for friends with soap or bath balls.
• Verifies friend feeding and cleaning only from refreshed friend-pet state.
• Uses food and bath supplies in calculated batches based on the missing stamina/cleanliness.
• Separates friend-visit success from poke results and migrates legacy duplicate-poke misclassifications.
• Runs automatic PK as a daily scheduled batch and verifies empty responses without resending uncertain writes.
• Preloads current course, job, bath, inventory, and verified food-economy inputs for the optimizer.

Validation

• Live mobile catalog verified: short courses reward/cost 20/70; long courses 50/210.
• 149 tests pass on Python 3.13.
• Python compilation and Windows packaging checks pass.

v1.5.2 · Daily study/work limits / 学习打工每日次数限制

v1.5.2 补丁说明

本版本为普通调度新增独立的每日学习和打工次数限制。

新增

• 学习可选择“不限次数”或开启每日次数限制。
• 打工可选择“不限次数”或开启每日次数限制。
• 达到某项上限后自动跳过该项；另一项仍可执行时自动切换。
• 每日次数沿用 runs/daily_progress.json 持久化，重启继续计数，第二天自动清零。
• 动态数学调度同样遵守学习和打工的独立次数限制。

兼容性

• 旧版打工配置中 times_per_day > 0 会自动迁移为启用限制。
• 旧版学习继续保持不限次数，只有用户主动开启限制后才生效。

验证

• 本地完整测试：133 项通过。
• GitHub Actions Windows 构建与测试：通过。

---

v1.5.2 Patch Notes

This patch adds independent daily study and work run limits to the classic scheduler.

• Study and work can each be unlimited or use a configured daily maximum.
• A task is skipped after reaching its limit; the other task remains available.
• Counts persist across restarts and reset automatically the next day.
• The experimental mathematical scheduler respects the same limits.
• Existing positive work limits are migrated; study remains unlimited until explicitly enabled.

v1.5.1 · Hiring fallback & dual scheduler / 雇佣回退与双调度机制

v1.5.1 · Hiring fallback and scheduler modes / 雇佣降级与调度模式

中文

这是一个补丁版本，修复勾选“打工雇佣好友”后可能无法继续打工的问题，并正式说明两套学习/打工调度机制。

修复

• 好友返回“今天很累了”或今日不可继续被雇佣时，不再阻塞打工。
• 当前岗位会立即降级为无好友开工，不会错误切换岗位或持续重试同一好友。
• 不可雇佣好友写入当天跳过名单；后续优先尝试其他好友，全部不可用时正常独自打工。
• 当天跳过名单次日自动清零。

调度机制

• 保留原金币阈值调度并继续作为默认模式。
• 新增独立的“测试：启用动态数学模型调度”开关，默认关闭。
• 测试模式会综合课程学费与收益、岗位金币、时长、体力/清洁消耗、补给成本和疲劳区间，搜索学习收益最大的可持续方案。
• 课程、岗位或服务器奖励变化后重新计算，不使用写死的历史方案。

完整说明：调度机制说明

验证：133 项自动化测试通过；Windows x64 单文件版本构建成功。

安装包 SHA-256：AC2E51F278C4575FD3FED3206DF1FD49BB3E238C13E021347B179E92DCD90986

English

This patch prevents friend hiring from blocking work and documents the two independent school/work scheduler modes.

Fixes

• A friend reported as too tired or unavailable for further hiring no longer blocks work.
• The same job immediately falls back to solo work instead of repeatedly retrying the same friend.
• Unavailable friends are skipped for the rest of the day; other friends are tried later, and solo work remains available when all friends are exhausted.
• The daily skip list resets automatically on the next day.

Scheduler modes

• The classic coin-threshold scheduler remains available and stays the default.
• The dynamic mathematical scheduler is exposed as a separate experimental opt-in setting and is disabled by default.
• Experimental planning considers course tuition and rewards, job pay, duration, stamina/cleanliness costs, supply replacement costs, and shared fatigue bands.
• Plans are recalculated when courses, jobs, or server rewards change.

Full documentation: Scheduler Modes

Validation: 133 automated tests passed; the Windows x64 single-file build completed successfully.

Package SHA-256: AC2E51F278C4575FD3FED3206DF1FD49BB3E238C13E021347B179E92DCD90986

v1.5.0 · Login guard and automation update / 登录守卫与自动化更新

中文

v1.5.0 是 QQ 宠物接口助手的正式功能与稳定性更新。

主要更新

• 新增登录态守卫：每轮任务前检查 MuMu QQ 是否真实在线，并核对当前账号与配置账号
• 检测到 QQ 下线或账号切换时立即暂停所有宠物读写操作，避免向错误会话发送指令
• 正确账号重新登录后自动恢复调度，并支持恢复通知
• 修复手机协议重试时卸载 Frida 会话导致 MuMu QQ 闪退的问题
• 加入每日定时 PK、真实好友访问、打工雇佣好友与被雇佣召回测试
• 学习和打工自动选择服务器当前开放且时长较短的项目，课程或岗位升级后自动刷新
• 修正食物库存读取，支持选择饼干或虾仁、香皂片或沐浴球
• 开放手机协议鼓励写入通道

验证

• 本机 117 项自动测试全部通过
• GitHub Actions 在 Python 3.11、3.12、3.13 上全部通过
• GitHub Windows 单文件打包任务成功
• 当前 MuMu QQ 登录态只读验证通过

English

v1.5.0 is a stable feature and reliability release for QQ Pet Interface Copilot.

Highlights

• Adds a login-session guard before every scheduler round and verifies the active MuMu QQ account
• Pauses all pet reads and writes immediately when QQ is logged out or the active account changes
• Resumes scheduling automatically after the configured account logs back in, with recovery notifications
• Fixes MuMu QQ crashes caused by unloading the live Frida session during protocol retries
• Adds scheduled daily PK, verified friend visits, friend hiring for work, and employed-pet recall tests
• Refreshes server-provided school courses and work jobs and prefers shorter eligible tasks
• Fixes food inventory decoding and supports selectable food and bath items
• Enables the verified mobile encouragement write path

Validation

• All 117 local tests passed
• GitHub Actions passed on Python 3.11, 3.12, and 3.13
• The GitHub Windows single-file packaging workflow completed successfully
• The current MuMu QQ session passed a live read-only login check

SHA-256: 52313B9811EF2373C58C53CD4EC0909A405858927EFB7E6365E999D449F2E031

v1.4.1 · Work eligibility hotfix / 打工资格热修复

中文

这是针对手机协议打工资格错误 135061 的热修复版本。

• 服务器拒绝某个职业或岗位时，自动尝试其他开放岗位
• 所有候选岗位都不满足条件时进入冷却，避免约每 20 秒重复报错
• 保留服务器数字错误码，便于后续准确识别和处理
• 当前手机 QQ 会话只读验证成功：已自动选择服务器允许的“小乞丐 / 深夜怪单”岗位
• 全量 93 项测试以及 GitHub Windows 打包测试均通过

PK 日志中“自身战力 10、对手战力 33，已开启仅挑战更弱对手”属于正常策略跳过，不是接口错误。如需挑战更强对手，可在设置中关闭“仅挑战更弱对手”。

English

This hotfix handles mobile-protocol work eligibility error 135061.

• Automatically tries another server-open job when a career or job is rejected
• Adds a cooldown when no eligible job remains, preventing repeated errors every scheduler cycle
• Preserves numeric server error codes for reliable handling
• Verified read-only against a live mobile QQ session; an eligible fallback job was selected
• All 93 tests and the GitHub Windows packaging workflow passed

The PK message that skips a stronger opponent while “only challenge weaker opponents” is enabled is expected behavior, not an API error.

SHA-256: EEAA0B6E8F350EB4D9A7A4082C75ECA033734E7AED5BBBDE661FE8A01C0D424D

v1.4.0 · MuMu mobile protocol replacement / MuMu 手机规则版替代

中文

重要：NapCat QQ 宠物接口已失效

NapCat/OneBot 本身仍能登录 QQ 和收发普通请求，但 QQ 宠物服务器现在会校验客户端 AppID/规则类型。修复 NapCat 的 Native 回包交接后，服务器真实返回：

errorCode=319
[oidb] rule type not match appid

这不是 petId 错误，也不是 OneBot 端口断开。传输修复只能显示真实错误，无法解除服务器对电脑版 QQ 会话的限制。本机最窄观测窗口为 2026-08-11 16:03:55—16:07:15（北京时间）；该时间仅代表已观测账号/线路，服务器可能采用灰度策略。

最新替代版本：MuMu 手机规则版

• QQ 宠物状态、库存及任务请求全部改走 MuMu 中的真实 Android QQ 会话
• 不再安装、启动或回退到 NapCat、OneBot、SnowLuma
• 自动发现 MuMu 12 自带 ADB 和当前在线的多开实例
• 自动识别 MuMu 中显示为“QQ”的主进程
• 首次运行自动从 Frida 官方 Release 下载固定组件，SHA-256 校验通过后才安装
• 手机 Hook 规则脚本已包含在安装包；读写命令使用严格白名单
• 写操作只发送一次；超时后查询服务器状态，不会盲目重发

使用前请安装并启动 MuMu 12，在模拟器设置中开启 Root 权限，并在模拟器里的手机 QQ 登录自己的账号。MuMu 和手机 QQ 需要保持运行。

Windows 包 SHA-256：B12FB4BE25C75B13442A827FC705F846D2DA53DD7297D64F279EC8C46978F1D5

完整原因：NapCat QQ 宠物接口失效说明

English

Important: the NapCat QQ Pet path is no longer accepted

NapCat/OneBot can still log in to QQ, but the QQ Pet backend now validates the client AppID and rule type. After fixing NapCat's Native response handoff, the real server reply is errorCode=319: [oidb] rule type not match appid. This is not a bad petId or a disconnected OneBot port; the desktop QQ session itself is rejected for these pet OIDB rules.

Current replacement: MuMu mobile-protocol edition

• All QQ Pet reads and actions use the authenticated Android QQ session inside MuMu 12.
• NapCat, OneBot and SnowLuma are no longer installed, started or used as fallbacks.
• The launcher discovers MuMu ADB and active instances automatically.
• The pinned Frida runtime is downloaded only from the official release and verified with SHA-256.
• The mobile hook rules are included in the Windows package and enforce strict command allow-lists.

Before launching, start MuMu 12, enable Root access in MuMu settings, and sign in to mobile QQ inside the emulator. MuMu and QQ must remain running.

v1.3.0 · Server pet ID & reliable QR login / 服务器宠物 ID 与可靠扫码登录

中文

• 首次登录可直接从 QQ 宠物服务器读取并保存本人 petId，无需手机或 ADB。
• 修复新电脑二维码文件尚未写完就被打开的问题。
• 二维码现在直接显示在助手窗口中，不再依赖 Windows 图片查看器。
• NapCat 提前退出时会显示退出码并保存启动日志，便于判断 VC++ 运行库、QQ 版本或安全软件问题。
• 修复 Windows 打包程序缺少 IDNA 编码导致的“无法连接接口”。
• 更新控制台布局、连接状态和好友访问协议提示。

English

• Discover and save the logged-in account petId directly from the QQ pet server without ADB.
• Wait for a complete QR PNG before displaying it on fresh computers.
• Display the login QR code inside the assistant instead of relying on Windows Photos.
• Surface NapCat exit codes and preserve startup logs for troubleshooting.
• Include the IDNA codec required by the packaged Windows client.
• Refresh the console layout and friend-visit protocol status.

验证 / Validation: 66 local tests passed; GitHub compatibility checks passed on Python 3.11, 3.12 and 3.13; the Windows package workflow completed successfully.

v1.2.1 · True one-click installer / 真正一键安装

中文

修复 Windows 一键启动包只安装 NapCatQQ Desktop、仍需用户二次安装 NapCat 的问题。

• 助手现在直接从 NapCat 官方 GitHub Release 下载完整 Windows 运行环境。
• 下载后验证官方 SHA-256，安全解压 NapCat、Node 与所需 QQ 运行组件。
• 自动启动登录；首次登录时自动打开二维码，成功后进入 QQ 宠物助手。
• 不再安装或弹出 NapCatQQ Desktop 管理器。
• SnowLuma 是与 NapCat 并列的框架，并非本助手的必需依赖，因此不会重复安装。

下载 QQ-Pet-Interface-Copilot-Windows-x64.zip，解压后双击 QQ宠物助手.exe。

SHA-256: B8334AE41969E2C99E7E575B90C425454E15D28F11DB38FB1F81A6668338A428

English

Fixes the Windows one-click package stopping after installing the NapCatQQ Desktop manager.

• Downloads the complete official NapCat Windows runtime directly from GitHub Releases.
• Verifies the official SHA-256 and safely extracts NapCat, Node, and the required QQ runtime components.
• Starts login automatically, opens the QR code for first-time login, and then launches QQ Pet Copilot.
• NapCatQQ Desktop is no longer installed or opened.
• SnowLuma is an alternative framework, not a required NapCat dependency, so it is not installed redundantly.

Download QQ-Pet-Interface-Copilot-Windows-x64.zip, extract it, and run QQ宠物助手.exe.

v1.2.0

中文

完整变更记录: v1.1.0...v1.2.0

• 新增 NapCat 接口超时自动重连。
• 默认从 3 秒开始指数退避，最长 60 秒，可在设置页修改。
• 连接恢复后继续下一轮，不自动重发可能已经送达的写指令。
• 使用 get_login_info 同时验证接口与 QQ 登录会话。

English

Full Changelog: v1.1.0...v1.2.0

• Added automatic reconnection after a NapCat API timeout.
• Uses exponential backoff from 3 seconds up to 60 seconds by default; configurable in Settings.
• Resumes from the next cycle without replaying a write request that may already have reached the server.
• Verifies both the API and the logged-in QQ session through get_login_info.