本文档涵盖了系统的核心功能与架构。有关详细的安装和配置说明，请参阅安装与设置。有关完整的使用说明和操作指南，请查看快速入门指南。

1. 下载与解压 前往 GitHub Releases 页面下载适用于您操作系统的最新 V4 版本压缩包并解压。

2. 启动与登录

   • Windows: 双击运行 launcher-user.bat。
   • Linux: 将文件解压到 QQ 安装目录 (/opt/QQ) 后运行 ./launcher-user.sh。
   • macOS: 运行 ./launcher-user.sh（暂不支持，开发中）
   • 根据控制台提示，使用您的手机 QQ 扫描二维码完成登录。

3. 访问与使用

   • 在浏览器中打开：http://localhost:40653/qce-v4-tool。
   • 输入控制台中显示的访问令牌 (Access Token) 以完成身份验证。
   • 开始使用聊天记录导出功能。

• 多格式导出: 支持导出为交互式 HTML、机器可读的 JSON 和纯文本 TXT 格式，以满足不同场景的需求。
• 完整的消息类型支持: 支持导出文本、图片、文件、语音、视频、贴纸、回复和转发消息。
• 强大的资源管理: 自动下载聊天记录中引用的所有媒体文件（如图片、视频、文件），并进行本地缓存和 MD5 完整性校验。
• 表情包导出: 支持导出市场表情包、收藏表情和系统表情包，自动下载所有表情资源并生成结构化 JSON 文件，提供完整的表情包备份方案。
• 灵活的任务管理:
  • 支持创建多个并发导出任务。
  • 通过 Web 界面实时监控任务进度和完成状态。
  • 断点续传功能可在中断后恢复任务，无需重新下载已有数据。
• 定时自动备份: 内置强大的定时任务系统，支持使用标准 cron 表达式配置每日、每周或自定义周期的自动导出。
• 现代化 Web 界面: 基于 React 和 Next.js 构建的响应式 Web 仪表板，提供直观的图形化操作体验。

QCE V4.5 采用创新的 Overlay 插件架构设计，作为 NapCatQQ 框架的独立外部插件运行，通过双层代理机制实现了零业务代码修改的跨平台兼容。我们在此特别感谢 NapCatQQ 团队，没有其强大的插件生态和底层框架支持，V4 版本无法实现。

• Overlay 层: 创新的双层代理架构，编译期通过类型镜像提供 TypeScript 类型检查，运行期通过 JS 代理和 Bridge 机制委托宿主 NapCat 执行核心能力，彻底解决了原生模块依赖问题。
• 后端服务层: 基于 Express.js 和 WebSocket 构建，使用 tsx 即时编译 TypeScript，负责处理 API 请求、编排导出流程、管理任务调度和持久化数据存储。
• 前端应用层: 基于 Next.js 14 和 React 构建的现代化单页应用，为用户提供所有交互功能。
• 存储层: 采用基于 JSONL 的文件存储系统并辅以内存索引，实现高性能的读写与任务恢复。

请务必仔细阅读以下免责声明：

本项目仅供个人学习研究和数据备份使用，严禁用于任何商业用途和非法目的。本项目与腾讯公司无任何关联，属于非官方第三方工具。

使用本工具可能违反 QQ 用户协议。尽管 V4 版本通过优化请求策略显著降低了风险，但用户仍需自行承担使用本工具可能带来的一切风险，包括但不限于账号安全问题。

请严格遵守数据隐私原则，仅导出您本人拥有合法权利的聊天记录，不得用于侵犯他人隐私、诽谤、骚扰等任何违法行为。您导出的数据应妥善保管，防止泄露或被滥用。

开发者不对因使用本工具而导致的任何直接或间接损失负责，包括但不限于账号安全、数据丢失或潜在的法律风险。

如腾讯公司认为本项目存在不当之处，欢迎随时联系处理。

继续使用即表示您已充分理解并同意承担上述所有风险。如有任何疑虑，请立即停止使用。

本项目采用 GNU General Public License v3.0 (GPL-3.0) 开源。