Skip to content
callngPublic

About

一个针对QQ与TIM的多功能XPosed(Zygisk)模块

Topics

Resources

Stars

316 stars

Watchers

2 watching

Forks

Repository files navigation

TCQT

GitHub release main Telegram Telegram Discord

支持 LSPosed / Zygisk 的 QQ / TIM 消息防撤回多功能模块


环境

项目 说明
适配客户端 QQ / TIM Android(NT 架构)
系统版本 LSPosed:Android 8.1 ~ 17;Zygisk:Android 13 ~ 17
框架支持 LSPosed(默认);也可通过 Zygisk 注入运行(见下文)

Zygisk 模式(可选)

除 LSPosed 外,TCQT 也支持通过 Zygisk 直接注入 QQ / TIM 进程运行, 无需安装任何 Xposed 框架。

环境要求

项目 说明
Root 方案 Magisk(启用 Zygisk)、KernelSU 或 APatch(ZygiskNext)
架构 仅支持 arm64-v8a(与 QQ 全量包一致)
系统版本 Android 13–17(API 33–37);其他版本拒绝安装/注入,APK 的 minSdk 单独保留

安装

  1. 下载 TCQT-<版本>-release.apk(见下方编译产物,或到 CI 构建中获取)。
  2. 该文件是双格式包:直接安装即为 Xposed 模块 ; 如需 Zygisk 模式,把它改名为 .zip, 在 Magisk / KernelSU / APatch 应用中选择「从本地安装」刷入,然后重启。
  3. 在宿主 QQ/TIM 的设置中进入 TCQT 页面进行功能配置。 Zygisk 模式不要求安装 TCQT App;配置与 LSPosed 模式相同,存储在宿主数据目录。
  4. 完全结束后台 QQ / TIM 进程并重新启动,功能即生效。

更新与热安装

在支持 Hot install 的 KernelSU 中(安装器通过 KSU_HAS_HOT_INSTALL=true 声明支持,不能仅凭版本号判断), 若本次开机记录、已启用模块和新包的“原生实现标识”一致,安装脚本会请求 热安装:模块目录、版本信息和 WebUI 立即更新;完全结束 QQ / TIM 的所有后台 进程后重新打开,即可加载新版载荷,无需重启设备。安装不会自动关闭 QQ / TIM。

该标识由 CMake 自动计算并嵌入注入库,包含 Zygisk 原生源码、头文件、构建规则、 NDK/编译器版本与有效编译配置。Java/Kotlin、资源、应用版本号、提交数、 工作目录及 CRLF/LF 换行差异不参与标识;同一实现重新编译产生不同的 .so 哈希, 也可以热更新。SHA-256 仍用于校验包内容,不能代替原生实现标识。

首次安装、原生实现或工具链变化、缺少本次开机的标识记录、模块已停用或待卸载时, 新版载荷只会暂存,完整重启设备后才与新版注入库一起生效。 从旧版升级后需要先完整重启一次;强制停止 QQ / TIM 或清缓存不能替代重启。 这避免了旧注入库读取新版载荷,因 JNI 方法签名不一致导致宿主启动崩溃。 KernelSU 也可能因安全模式或模块目录替换失败等原因回退为重启安装, 以安装器最终输出和管理器提示为准;旧版 KernelSU、Magisk 和 APatch 不通过此接口热替换模块目录。通过上述标识检查时载荷仍可在重启 QQ / TIM 后加载, 模块目录和 WebUI 的更新则按管理器提示重启设备后生效。 若脚本提示安装器不支持,应更新 KernelSU 管理器及其配套的 ksud;仅导出 MODULE_HOT_INSTALL_REQUEST=true 无法让旧安装器支持热安装,也不应手动删除 update 标记或移动 modules_update 来伪装安装成功。

卸载

在 Magisk / KernelSU / APatch 中直接卸载 TCQT (Zygisk) 模块并重启即可;

注意事项

  • 不要同时启用 LSPosed 中的 TCQT 模块:两种模式共用同一份配置, 同时 hook 会造成冲突。使用 Zygisk 模式时请在 LSPosed 中停用 TCQT。
  • 当前只构建 arm64-v8a;Android 17 的设备回归不代表所有 ART/OEM 组合都已验证。
  • ART 源码基线、兼容处理与逐版本验证范围见 Android 13–17 兼容记录。
  • 功能范围与 LSPosed 模式一致(包括 DexKit 方法查找、设置页联动等)。

注入控制(WebUI)

在支持模块 WebUI 的 KernelSU / APatch 管理器(模块详情页)中可打开 TCQT WebUI,按应用(QQ / TIM)× 用户独立控制是否注入;同时提供 原生 Hook 开关(Zygisk 模式下的 PLT/GOT hook)

WebUI 使用轻量 HTML/CSS/JS,采用白底细边框卡片和柔和绿色控件,支持跟随系统浅色/深色; 离线资源总量限制为 64 KiB,不捆绑 Compose/Skiko、WASM 或字体。Android 设置页仍使用 Miuix 0.9.4。 「日志与诊断」默认记录启动、加载和异常;ART Hook 明细由「详细调试日志」控制, 与关键事件分开保存,开启/关闭后需重新启动宿主应用。 点击「导出并分享日志」会收集各 Android 用户的 QQ/TIM 日志和设备环境, 直接打开系统分享面板,可选择任意支持文本附件的应用,无需手动查找文件。 报告通过 MediaStore 提供 content:// 附件及读取授权,不要求安装 TCQT APK; 分享失败会显示错误,可直接重试。系统媒体库中的报告保存在 Download/TCQT。


设置

从 v2.7 版本 起,模块支持通过宿主 APP 的设置页面控制功能状态:

宿主设置页面 → TCQT

如果宿主设置中没有看到模块入口,也可以通过以下方式打开模块设置页面:

在聊天界面发送消息:tcqt.qq.com
点击该消息中的链接,即可进入模块设置界面。


功能

模块功能持续更新中,
请前往 模块设置页面 查看详细的功能列表与开关说明。

DexKit 缓存分区、扫描及清空规则见 DexKit 缓存说明。


编译

环境要求

依赖 说明
JDK 21 (由项目 toolchain 强制要求)
Android SDK compileSdk 37、minSdk 27
Git 用于生成版本号(提交数 + 短哈希)

请确保 local.properties 中的 sdk.dir 指向有效的 Android SDK 路径。
以下命令在 Windows 下请使用 gradlew.bat,macOS / Linux 下使用 ./gradlew。

编译调试版本

调试版本自动使用调试证书,可直接编译:

./gradlew :app:assembleDebug

编译发布版本

发布版本需要签名配置,可通过环境变量指定签名信息:

Windows(PowerShell):

$env:KEYSTORE_PATH = "path\to\keystore.jks"
$env:KEYSTORE_PASSWORD = "your_store_password"
$env:KEY_ALIAS = "your_key_alias"
$env:KEY_PASSWORD = "your_key_password"
.\gradlew.bat :app:assembleRelease

macOS / Linux(bash):

KEYSTORE_PATH=/path/to/keystore.jks \
KEYSTORE_PASSWORD=your_store_password \
KEY_ALIAS=your_key_alias \
KEY_PASSWORD=your_key_password \
./gradlew :app:assembleRelease

未配置发布签名时,双格式 Release 使用本机调试证书,仅供本地验证;正式发布需提供签名配置。CI 环境通过以上变量注入证书。

编译 Zygisk 模块(可选)

assembleDebug / assembleRelease 产出的 APK 本身就是双格式 APK: 既是可安装的 APK,也是 Magisk / KernelSU 可刷入的模块 ZIP(改名 .zip 即可刷入), Android Studio 里直接 Build / Generate Signed APK 也会得到同样的双格式产物。

如需额外的 .zip 文件,可执行:

./gradlew :app:packageZygiskModule

它会复制 release 双格式 APK 到:

app/build/outputs/zygisk/TCQT-zygisk-<版本>.zip   # 双格式 APK 的 .zip 副本

Zygisk 原生回归测试

Windows 下可使用项目指定的 NDK,在明确指定的 Android 测试设备或模拟器上运行:

./tools/test-zygisk-companion.ps1 -Serial emulator-5556

覆盖配置隔离、权限拒绝、companion 文件描述符传递与异常清理。 注入流程及用户设备验证步骤见 Zygisk companion。

产物输出

编译完成后,APK 输出到以下目录:

app/build/outputs/apk/debug/    # 调试版本(TCQT-<版本>-debug.apk,双格式)
app/build/outputs/apk/release/  # 发布版本(TCQT-<版本>-release.apk,双格式)

清理构建

设置页、宿主弹窗和 WebUI 的开发约定见 界面设计规范。

模块边界与运行时序见 架构文档;新增功能、自动化检查、双格式包校验和互斥设备测试见 开发指南。功能示例 会随 Debug 构建实际编译,默认不注册。

./gradlew clean :app:assembleDebug

声明

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

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

不会增加的功能

  • 抢红包及其他金钱相关功能
  • 可能被恶意利用的功能
  • 群发消息
  • 可能干扰正常使用的功能(如闪退)

致谢

本项目的一些代码借鉴了一些开源项目,特别感谢有这样一群可爱的开发和贡献者,向他们致敬!

Name Source
QAuxiliary QAuxiliary
XAutoDaily XAutoDaily
TimTool TimTool

本项目的开发动力和灵感来源于 QwQ 项目,感谢 fuqiuluo !

Name Source
QwQ QwQ

其他

本模块已发布到 LSPosed 模块仓库,也可到本仓库下载实时构建(CI)版本。

Type Source
LSPosed Module Repo TCQT
Here TCQT

额外说明

  • 不建议与其他 QQ / TIM 模块一同使用,避免功能冲突。
  • 请始终在 LSPosed 仓库或本项目以及 CI 频道 下载本模块。

Made with ❤️ by owo233

About

一个针对QQ与TIM的多功能XPosed(Zygisk)模块

Topics

Resources

Stars

316 stars

Watchers

2 watching

Forks

Releases

Used by

Contributors

Languages