这份教程是什么
本站是一份面向跨平台 QQ 聊天数据库解密的参考资料，内容基于开源项目 qq-win-db-key 构建。教程并非面向完全没有基础的使用者，而是假设读者具备一定的逆向分析、动态调试和脚本修改能力。
教程中可能会提供完整脚本和较详细的操作步骤，但不同 QQ 版本、操作系统和本地环境之间可能存在差异。使用过程中仍需要具备自行修改和排查问题的能力。如果对 Python 或相关工具不熟悉，建议先通过 B 站、博客等资料学习 Python 基础。
特别感谢原作者 Young-Lord 以及其他开发者在相关项目中的开拓和维护；本站未来也会逐步扩展数据库解析方案。
使用前请阅读：风险与准备
请务必注意
教程中的部分操作可能会修改或破坏聊天数据库，甚至导致聊天记录无法恢复。无论教程是否标注“已验证”，都请先备份数据库文件，并在使用前自行审查代码、评估风险。
建议在执行操作前：
- 先用更保险的方式导出聊天记录，例如使用 PCQQ（Windows）自带的“导出消息记录（
mht格式）”功能。 - 备份原始数据：Android 设备可以使用系统备份功能，电脑端则建议备份相关文件或整个磁盘。
- 使用 QQ 官方的“迁移聊天记录”功能，将数据转移到不常用的设备或虚拟机后再进行实验。
- 优先选择不注入 QQ 进程、不修改 QQ 安装包的方案，例如使用 Android 系统备份功能导出数据库后再提取；尽量避免使用 QAuxiliary、Frida 或 GDB 等可能改变运行环境的方式。
本项目中的操作也可能带来封号风险。请在充分了解脚本行为和后果后再使用，并为不可逆操作预留可恢复的备份。
教程流程
整个流程分为三个阶段：
- 分平台提取：在 QQ 所在的平台上，仅提取原始数据库文件和对应的 key，不在源设备上改写数据库。
- 统一解密：将原始数据库和 key 复制到 Windows，使用指定脚本导出未加密的 SQLite 数据库。
- 读取数据库：解密完成后得到未加密的 SQLite 数据库。由于数据库表名和字段经过混淆，可以参考该章节提取感兴趣的信息。
教程所需的源脚本链接会直接回源到 qq-win-db-key 的 master 分支；本站不再维护这些脚本的副本。
当前验证状态
| 平台教程 | 状态 | 已确认版本 | 确认时间 |
|---|---|---|---|
| NTQQ (Windows) | 已确认可用 | 9.9.32-51246 | 2026-07-19 |
| Android、iOS、Linux、macOS、PCQQ (Windows) | 尚未确认 | — | — |
如果你验证了某个平台的教程，请通过 PR 或 issue 告知维护者，并注明 QQ 版本、操作系统版本、设备架构，以及是否成功提取原始数据库和 key。
项目规则与免责声明
本项目仅供学习交流使用。严禁将项目用于违反中国大陆法律法规、所在地法律法规或 QQ 软件许可及服务协议 的行为；开发者不承担相关行为导致的直接或间接责任。
本项目不对生成内容的完整性、准确性或可用性作任何担保。生成内容不可用于法律取证，也不应当用于学习交流以外的用途。
本项目基本遵循 LICENSE 中的开源协议，并要求标识项目地址、禁止商用；部分文件可能适用不同的授权协议，具体以文件内的声明为准。
反馈与参与贡献
脚本代码的使用问题、版本兼容性反馈和代码改进建议，请先阅读 qq-win-db-key 的历史 issue，并在该代码仓库的 issue 区 中讨论。
有关 QQNT 数据库解密、跨仓库协作以及其他较为宽泛的技术话题，请前往 QQBackup Discussions 讨论。
如果发现本教程错误、内容过时或需要改进，欢迎直接提交 QQDecrypt PR，并在需要时 @QQBackup 通知维护者。
欢迎能够实现数据库解析算法、适配其他平台或改进脚本的开发者参与本项目的开发。文档内容和写作风格不设严格限制，但建议为图片填写清晰的替代文本和文件名，也可以补充指向相关仓库或博客的链接。
隐私与部署
- 本站不收集或存储用户身份信息。
- 禁用 Cookie 不影响网站功能。
- 网站使用 GitHub Pages 进行静态部署。