https://github.com/shuakami/qq-chat-exporter
🚀 QQ聊天记录、表情包导出工具 | 自动化提取图片/文字/图片消息，支持TXT/JSON导出，高效备份，支持NT QQ
https://github.com/shuakami/qq-chat-exporter
chat-exports electron export exporter javascript qq qq-expoter qq-nt qqnt
Last synced: 5 days ago
JSON representation
🚀 QQ聊天记录、表情包导出工具 | 自动化提取图片/文字/图片消息，支持TXT/JSON导出，高效备份，支持NT QQ
- Host: GitHub
- URL: https://github.com/shuakami/qq-chat-exporter
- Owner: shuakami
- License: gpl-3.0
- Created: 2024-07-10T01:46:05.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2026-07-22T07:04:09.000Z (5 days ago)
- Last Synced: 2026-07-22T07:12:00.197Z (5 days ago)
- Topics: chat-exports, electron, export, exporter, javascript, qq, qq-expoter, qq-nt, qqnt
- Language: Rust
- Homepage: https://shuakami.github.io/qq-chat-exporter/
- Size: 71 MB
- Stars: 4,276
- Watchers: 7
- Forks: 262
- Open Issues: 36
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
[![][image-banner]][releases-link]
这是一个帮你把 QQ 聊天记录导出到本地的工具。把它下载到你自己的电脑上，就能直接读取并保存好友和群聊的记录。
它不仅可以导出 HTML、JSON、TXT 和 Excel 等各种你需要的格式，还可以将聊天中发过的图片、视频和表情文件一并下载到本地保存。最最最重要的是，所有读取和解析都在你自己的电脑上完成，项目没有服务器或数据传输，绝对不会把你的聊天记录上传到任何地方。
**[使用文档][docs-link]** **[下载][releases-link]** **[Docker 部署][docker-doc]** **[反馈问题][issues-link]**
[![][github-release-shield]][releases-link]
[![][github-downloads-shield]][releases-link]
[![][github-stars-shield]][stars-link]
[![][github-license-shield]][license-link]
> \[!IMPORTANT]
>
> **Star 一下**，你将第一时间收到 GitHub 上的新版本发布通知
## 特性
## 快速开始
### Windows 一键安装（推荐）
1. 从 [Releases][releases-link] 下载一键安装包并运行
2. 用 QQ 扫码登录
3. 打开 `http://localhost:40653/qce`，开始导出
### Shell 模式（Windows / Linux）
1. 从 [Releases][releases-link] 下载对应平台的压缩包
2. 运行 `launcher-user.bat`（Windows）或 `./launcher-user.sh`（Linux）
3. 用 QQ 扫码登录，复制控制台输出的 Token
4. 打开 `http://localhost:40653/qce`
### Docker 一键部署
适用于 macOS（含 Apple Silicon）、Linux、Windows，无需安装 QQ 客户端：
```bash
git clone https://github.com/shuakami/qq-chat-exporter.git
cd qq-chat-exporter/docker
docker compose up -d
# 查看登录二维码与 Token
docker logs -f napcat-qce
```
> \[!NOTE]
> Apple Silicon (M1/M2/M3/M4) 通过 Rosetta 模拟运行，首次启动可能稍慢。详见 [Docker 部署指南][docker-doc]。
## 文档
[][docs-link]
## 相关项目
[](https://chatlab.fun/cn)
我们非常欢迎和 QCE 有关的社区项目！如果需要展示您的项目，可以在[这里](https://github.com/shuakami/qq-chat-exporter/issues/new)提一个 issue。
## 贡献者
感谢每一位让 QCE 变得更好的贡献者，也感谢 [NapCatQQ](https://github.com/NapNeko/NapCatQQ) 团队提供的框架支持。参与开发？请阅读[贡献指南](https://shuakami.github.io/qq-chat-exporter/docs/contributing.html)。
## 许可证
[GPL-3.0][license-link]
[image-banner]: docs/images/banner.png
[docs-link]: https://shuakami.github.io/qq-chat-exporter/
[releases-link]: https://github.com/shuakami/qq-chat-exporter/releases
[issues-link]: https://github.com/shuakami/qq-chat-exporter/issues
[stars-link]: https://github.com/shuakami/qq-chat-exporter/stargazers
[license-link]: LICENSE
[docker-doc]: https://shuakami.github.io/qq-chat-exporter/docs/docker-napcat-deployment.html
[github-release-shield]: https://img.shields.io/github/v/release/shuakami/qq-chat-exporter?color=317cfe&labelColor=black&logo=github&style=flat-square
[github-downloads-shield]: https://img.shields.io/github/downloads/shuakami/qq-chat-exporter/total?color=317cfe&labelColor=black&style=flat-square
[github-stars-shield]: https://img.shields.io/github/stars/shuakami/qq-chat-exporter?color=317cfe&labelColor=black&style=flat-square
[github-license-shield]: https://img.shields.io/badge/license-GPL--3.0-317cfe?labelColor=black&style=flat-square