cinit/QAuxiliary：QNotified phoenix - 让 OICQ 再次伟

技术解读

以下内容由 GitRead 中文社区编辑团队基于项目 README 与官方资料整理，结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

QAuxiliary 深度技术分析：在封闭的 QQ 上做一场“热更新”式的功能注入

项目背景与痛点

OICQ（QQ/TIM）是典型的“大而不倒”的超级客户端：功能臃肿、界面僵硬，官方从未提供任何扩展机制。用户想要的防撤回、聊天记录导出、自定义主题、气泡美化等能力，在官方产品迭代中要么缺席，要么被产品经理的优先级永远压下去。

Xposed/LSPosed 生态长期填补这一空缺，但多数模块面临同一个死结：宿主混淆严重、版本迭代频繁、维护成本极高。QNotified 曾是这个领域的代表性项目，作者停更后，社区在 cinit/QAuxiliary 中以 “phoenix” 的名义重写重生。它真正要解决的，不是“加几个功能”，而是如何在不可控的宿主二进制上，构建一套可持续维护的运行时注入框架。

核心技术揭秘

QAuxiliary 本质是一个 LSPosed 模块，运行在 QQ/TIM 的宿主进程内。它的技术栈可以拆成三层，每一层都在对抗同一个敌人——混淆与版本漂移。

入口与适配层是命门。模块通过 xposed_init 注册后，在 handleLoadPackage 中读取宿主包名与版本号，做版本路由。由于 QQ 的类名、方法名几乎每个版本都会重排，项目引入了 DexKit 这一动态符号解析库：不依赖固定字符串，而是按方法签名、字符串常量、注解特征反向定位目标方法。这相当于把“硬编码 Hook 点”升级为“按语义查找 Hook 点”，显著延缓了每次版本升级带来的适配债。对无法动态解析的点，仍保留硬编码回退路径。

功能层则是一个可插拔的注册表：每个功能实现统一接口，携带一个持久化开关。模块启动时遍历启用项，逐个注册 Hook 与回调，运行期通过事件总线触发。设置面板本身也注入宿主 UI，让开关变更无需重启即可生效。

graph TD A[宿主进程启动] --> B[LSPosed 注入模块入口] B --> C[读取宿主包名与版本号] C --> D{"版本适配命中?"} D -->|"命中"| E[DexKit 符号解析] D -->|"未命中"| F[硬编码 Hook 回退] E --> G[功能注册表分发] F --> G G --> H[按开关注册 Hook] H --> I[设置面板 UI 注入] I --> J[功能回调与事件监听]

功能亮点与差异

相比同类竞品，QAuxiliary 的杀手锏不在单个功能，而在工程化程度。其一，功能粒度极细且互相隔离，单个 Hook 崩溃不会拖垮整个模块；其二，开关热生效，配合内置设置界面，体验上接近“原生插件”；其三，DexKit 动态适配让它对 QQ 版本升级的容忍度明显高于纯硬编码方案；其四，开源与活跃的社区维护，使它成为少数能跟上 QQ 高频发版的模块之一。

应用场景与落地建议

它并非为生产环境或企业分发设计，而是面向个人设备、技术爱好者的本地增强工具。落地时务必注意：注入后稳定性完全依附于宿主版本，QQ 一次更新就可能让部分功能失效甚至引发崩溃，建议锁定已验证的 QQ 版本并关闭自动更新；同时，修改客户端行为可能触及用户协议与合规边界，切勿用于商业分发或二次打包。若要借鉴其思路，DexKit 动态符号解析 + 功能开关注册表，是一套值得复用到其他“封闭宿主增强”场景的架构范式。

综合评价

优点：架构分层清晰，DexKit 适配思路先进，功能覆盖广且工程化程度高，社区活跃、迭代快。缺点：与宿主版本强耦合，维护成本始终高昂；依赖 root/LSPosed 环境，门槛不低；Hook 稳定性与崩溃风险无法彻底消除。一句话总结：它是 QQ 增强生态里少有的“认真做架构”的项目，但也注定是一场与官方发版节奏的长期拉锯战。

QAuxiliary

QAuxiliary 是一个基于 QNotified 的开源 Xposed 模块

使用方法

激活本模块后，在 QQ 或者 TIM 自带设置中点击 QAuxiliary 即可进入设置页面

Android >= 7.0
QQ >= 8.2.0, TIM >= 2.2.0, QQLite >= 4.0, QQ HD >= 5.9.3
在没有 Xposed 环境的系统上，QAuxiliary 也可以通过 Frida 来加载 (需要 root)，参考 instruction-qauxv-frida.md.

一切开发旨在学习，请勿用于非法用途

本项目保证永久开源，欢迎提交 PR，但是请不要提交用于非法用途的功能。
如果某功能被大量运用于非法用途，或对其他用户的正常使用造成严重影响，那么该功能将会被移除。
本模块完全免费开源，没有任何收费，请勿二次贩卖。
鉴于项目的特殊性，开发团队可能在任何时间停止更新或删除项目

许可证

EULA

版权所有©2022 gao_cai_sheng <[email protected], qwq2333.top>

允许在遵守 CC BY-NC-SA 4.0 协议的同时，复制和分发此协议文档的逐字记录副本，
且允许对其进行更改，但必须保留其版权信息与原作者。如果您提出申请特殊权限，协议
作者可在其口头或书面授予任何人任何但不包括以盈利为目的的使用本协议的权利。

请务必仔细阅读和理解通用许可协议书中规定的所有权利和限制。在使用前，您需要仔细
阅读并决定接受或不接受本协议的条款。除非或直至您接受本协议的条款，否则本作品及
其相关副本、相关程序代码或相关资源不得在您的任何终端上下载、安装或使用。

您一旦下载、使用本作品及其相关副本、相关程序代码或相关资源，即表示您同意接受本
协议各项条款的约束。如您不同意本协议中的条款，您则应当立即删除本作品、附属资源
及其相关源代码。

本作品权利只许可使用，而不出售。

发行渠道说明

QAuxiliary 采用滚动更新方式发布新版本，我们总是推荐用户使用最新版 QAuxiliary，无论您的 QQ 或者 TIM 客户端是哪个版本。

QAuxiliary 将为分 CI 和 推荐的CI 两个版本

CI 版本为 commit 后自动触发更新，可能包含外围文档或 CI 流程更新，不会编写任何更新文档或说明，具体更新内容可在GitHub 自行查看，本更新由开源的流程自动编译发布，可能包含严重的功能及行为异常。
推荐的CI 版本为重大功能变更或长期积累更新，发布频率由开发组决定，包含上次CI 版至今的所有功能更新及 Bug 修复，但可能不包括尚未稳定或正在开发中的功能； 推荐的CI 版本是被挑选出的推荐用户更新的 CI 版本 (如：添加功能或者修复重要 Bug)

开发组不限制用户选择自己需要的版本，同时也不为任何版本产生的任何后果承担任何责任（详情请见QAuxiliary EULA），但希望各位用户各取所需，根据自己的能力范围选择适合自己的版本。

QAuxiliary 的版本号组成为major.minor.bugfix.rev.commit
其中 major 为主版本号，minor 为次版本号，bugfix 为修正版本号；
所有版本更新的rev为 commit 计数，commit 位都会是触发此次更新的 commit 的 hash 的前 7 位。

将只发布 推荐的CI 版更新。
发布 CI 版更新。
将只发布 推荐的CI 版更新。
将只发布 推荐的CI 版更新。
为什么没有上架 Google Play?
因为 Google Play 不允许 app 具有运行时动态加载外部代码的行为。而本模块为了能够在运行期动态继承宿主的类（类名被混淆，运行时才能确定），使用了 byte-buddy 库用于在运行时动态生成代码并使用 InMemoryDexClassLoader 实现 dex 不落地加载，这是 Google Play 不允许的行为。

不会支持的功能

抢红包及其他金钱相关功能
修改聊天记录等可能被恶意利用的功能
群发消息
可能干扰其他用户正常使用的功能（如闪退）

编译

安装 git, Ninja 1.11+, JDK 17+, Android SDK, 以及可选的 ccache;
- Android SDK 和 NDK 及 CMake 版本请参考 Version.kt;
- JDK 版本最低 17, 当然使用 21 也是可以的。
- Ninja 请使用 1.11 或更高版本。因为 Ninja 从 1.11 开始支持 C++ 20 module, 你可以从 Ninja Release 下载 Ninja 二进制文件, 并在 local.properties 中指定 qauxv.override.ninja.path 为 Ninja 的路径 (如 qauxv.override.ninja.path=/usr/bin/ninja).
- Ccache 是可选的，不装也可以，但它可以让编译更快，如果您的 ccache 版本低于 4.8，建议给 gradle daemon 加上环境变量 CCACHE_NOHASHDIR=true (推荐) 或者配置 ccache -o hash_dir=false (警告：这是全局持久化配置) 。
  注意: 编译脚本会自动寻找 ccache 并使用，而 Windows 平台下 msys2 的 ccache 存在问题会卡在 sync 阶段，建议 Windows 用户使用从 ccache 官网下载的 ccache 而不是 msys2 的 ccache;
  另外你也可以选择不使用 ccache (如果你已经安装了 ccache 但不想使用，可以修改 build.gradle.kts 中的 ccacheExecutablePath 为 null)

将本仓库 clone 至本地；由于本项目使用的 submodule 含有一些不需要的以及非公开的二级 submodule, 请参考以下命令 clone 本项目以跳过这些 submodule:

git clone https://github.com/cinit/QAuxiliary
cd QAuxiliary
git submodule update --init
git -C "libs/LSPlant" config "submodule.test/src/main/jni/external/lsprism.update" none
git -C "libs/LSPlant" config "submodule.test/src/main/jni/external/lsparself.update" none
git -C "libs/LSPlant" config "submodule.docs/doxygen-awesome-css.update" none
git -C "libs/mmkv/MMKV" config "submodule.Python/pybind11.update" none
git submodule foreach git submodule update --init --recursive

去除不使用的 submodule 后，一共有 14 个 submodule, 如果 clone 了很久也没有完成，请检查您的网络以及代理是否配置正确。

使用 Gradle 编译安装包: ./gradlew :app:assembleDebug 或者 ./gradlew :app:synthesizeDistReleaseApksCI;

本项目编译环境配置可能比较复杂，如果您在配置环境或者编译过程中遇到任何问题，您可以直接在交流群或 GitHub Issue 中提出，我们会尽快回复。

赞助

由于项目的特殊性，我们不接受任何形式的捐赠，但是我们希望有更多的人能够参与本项目的开发
如果您有兴趣参与本项目的开发，您可以参考贡献指南，其中包含了一些可以帮助您快速上手的信息

QAuxiliary

技术解读

QAuxiliary 深度技术分析：在封闭的 QQ 上做一场“热更新”式的功能注入

项目背景与痛点

核心技术揭秘

功能亮点与差异

应用场景与落地建议

综合评价

关于

简要分析

语言占比

Release

贡献者

QAuxiliary

使用方法

一切开发旨在学习，请勿用于非法用途

许可证

发行渠道说明

不会支持的功能

编译

赞助

通用许可协议

评论

QAuxiliary

技术解读

QAuxiliary 深度技术分析：在封闭的 QQ 上做一场“热更新”式的功能注入

项目背景与痛点

核心技术揭秘

功能亮点与差异

应用场景与落地建议

综合评价

相关仓库

关于

简要分析

语言占比

Release

贡献者

QAuxiliary

使用方法

一切开发旨在学习，请勿用于非法用途

许可证

发行渠道说明

不会支持的功能

编译

赞助

通用许可协议

评论