这是一个帮你把 QQ 聊天记录导出到本地的工具。把它下载到你自己的电脑上，就能直接读取并保存好友和群聊的记录。

它不仅可以导出 HTML、JSON、TXT 和 Excel 等各种你需要的格式，还可以将聊天中发过的图片、视频和表情文件一并下载到本地保存。最最最重要的是，所有读取和解析都在你自己的电脑上完成，项目没有服务器或数据传输，绝对不会把你的聊天记录上传到任何地方。

使用文档 下载 Docker 部署 反馈问题

[!IMPORTANT]

Star 一下，你将第一时间收到 GitHub 上的新版本发布通知哟

特性

快速开始

Windows 一键安装（推荐）

1. 从 Releases 下载一键安装包并运行
2. 用 QQ 扫码登录
3. 打开 http://localhost:40653/qce，开始导出

Shell 模式（Windows / Linux / macOS Apple Silicon 预览）

1. 从 Releases 下载对应平台的压缩包
2. 运行 launcher-user.bat（Windows）或 ./launcher-user.sh（Linux / macOS）
3. 用 QQ 扫码登录，控制台会打印一键登录链接，打开即可
4. 也可手动访问 http://localhost:40653/qce，令牌见控制台输出；在「设置 → 启动」里可开启登录后自动打开浏览器

[!NOTE] macOS 当前仅提供 Apple Silicon（arm64）预览包，且启动前需要完全退出电脑上的 QQ，详见 macOS 使用指南。

Docker 一键部署

适用于 macOS（含 Apple Silicon）、Linux、Windows，无需安装 QQ 客户端：

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 部署指南。

文档

相关项目

我们非常欢迎和 QCE 有关的社区项目！如果需要展示您的项目，可以在这里提一个 issue。

贡献者

感谢每一位让 QCE 变得更好的贡献者，也感谢 NapCatQQ 团队提供的框架支持。参与开发？请阅读贡献指南。

许可证

GPL-3.0