Mac：从 NapCat 切回原版 QQ 时热更新包仍指向 loadNapCat.js，导致 installPathPkgJson undefined 崩溃

[y4ho0]

问题描述

在 macOS 上使用 NapCat Mac Installer 接管 QQ 后，尝试切回原版 QQ 时，原版 QQ 仍然会加载 loadNapCat.js，并在 Electron 主进程中崩溃：

A JavaScript error occurred in the main process
Uncaught Exception:
TypeError: Cannot read properties of undefined (reading 'installPathPkgJson')
at Immediate.<anonymous> (~/Library/Containers/com.tencent.qq/Data/Documents/loadNapCat.js:10:25)

这看起来不是业务代码问题，而是 Mac 版 QQ 热更新包的启动入口没有一起恢复，导致“看起来打开的是原版 QQ”，实际仍然进入了 NapCat loader。

环境

• 系统：macOS 26.0
• 架构：arm64
• NapCat：4.18.9
• 安装方式：NapCat Mac Installer
• QQ 基础包：6.9.82-40990
• QQ 热更新包：6.9.96-49738

基础包入口：

/Applications/QQ.app/Contents/Resources/app/package.json
main = ./application.asar/app_launcher/index.js

但实际运行时 QQ 会加载热更新包：

~/Library/Containers/com.tencent.qq/Data/Library/Application Support/QQ/versions/6.9.96-49738/QQUpdate.app/Contents/Resources/app/package.json

该热更新包的 main 仍然是：

../../../../../../../../../Documents/loadNapCat.js

复现路径

1. 在 macOS 上通过 NapCat Mac Installer 接管 QQ。
2. 使用一段时间后尝试切回原版 QQ。
3. 恢复了 /Applications/QQ.app/Contents/Resources/app/package.json 的 main 为原版入口。
4. 启动 QQ。
5. QQ 仍然崩溃，并提示 installPathPkgJson undefined。

实际结果

虽然基础包入口已经恢复为原版，但 QQ 启动器会走热更新目录中的 QQUpdate.app。如果热更新包的 package.json 仍指向 Documents/loadNapCat.js，原版 QQ 启动时还是会进入 NapCat loader。

当前本地的 loadNapCat.js 中有类似逻辑：

global.launcher.installPathPkgJson.main = ...

但在这个 QQ 热更新版本的原版启动环境里，global.launcher 可能是 undefined，于是主进程直接崩溃。

期望结果

从 NapCat 切回原版 QQ 时，应该满足至少一个条件：

1. 同时恢复基础包和当前热更新包的 package.json 入口；
2. 或者 loadNapCat.js 的原版 QQ fallback 分支对 global.launcher / installPathPkgJson 做判空，避免直接崩溃；
3. 或者在 Mac Installer / 文档中明确说明 QQ 热更新包也需要恢复。

本地临时解决方式

本地通过以下方式恢复：

1. 备份热更新包当前 package.json；
2. 将热更新包入口恢复为：

./application.asar/app_launcher/index.js

3. 同时给 loadNapCat.js 中的 global.launcher.installPathPkgJson 访问加判空保护。

恢复后，QQ 不再进入 loadNapCat.js，能以原版入口启动。

可能的修复方向

• Mac Installer 在“恢复原版 QQ / 取消接管”时，读取：

~/Library/Containers/com.tencent.qq/Data/Library/Application Support/QQ/versions/config.json

找到当前 curVersion，并同步恢复：

~/Library/Containers/com.tencent.qq/Data/Library/Application Support/QQ/versions/<curVersion>/QQUpdate.app/Contents/Resources/app/package.json

• loadNapCat.js 对 global.launcher 做保护，例如：

const launcher = global.launcher;
if (!launcher || !launcher.installPathPkgJson) {
  return;
}

English summary

On macOS, after switching back from NapCat to original QQ, the base QQ app package.json may be restored, but the QQ hot-update package under ~/Library/Containers/com.tencent.qq/Data/Library/Application Support/QQ/versions/<curVersion>/QQUpdate.app/.../package.json can still point to Documents/loadNapCat.js.

As a result, original QQ still loads NapCat's loader and crashes because global.launcher.installPathPkgJson is undefined. Restoring the hot-update package.json main back to ./application.asar/app_launcher/index.js fixes the local issue.