跳到主要内容
项目档案应用项目

ycccccccy/echotrace 是什么?用途、安装与使用指南

EchoTrace 是基于 Flutter 的本地微信聊天记录管理工具,可解密数据库、导出 HTML/JSON/Excel 格式,并生成个性化年度报告。本页涵盖项目用途、安装步骤、使用方法和核心技术架构,适用于希望安全备份和分析聊天历史的用户。

3,812Star 于 2026年1月11日2026年9月20日 更新

AI 总结

EchoTrace 是一款完全本地运行的微信聊天记录导出、分析与年度报告生成工具,无需上传数据即可安全解密、查看、导出为多种格式,并生成个性化年度报告,帮助用户回顾聊天历史。

中文项目介绍

EchoTrace 是一款完全本地运行的微信聊天记录导出、分析与年度报告生成工具。它允许用户解密微信数据库并在离线环境下查看聊天记录,同时支持将记录导出为 HTML、JSON 或 Excel 格式与朋友分享,还能基于聊天内容生成个性化的年度报告,帮助用户回顾与好友的互动历程。 该项目解决了微信聊天记录难以导出、分析且涉及隐私安全的痛点。传统方法往往需要依赖第三方服务或复杂工具,而 EchoTrace 通过本地解密和处理,确保数据不会上传至网络,有效保护用户隐私。同时,它提供了从基础导出到深度分析(如词云、统计)的一站式解决方案。 适用场景包括:个人用户希望回顾与某位好友多年来的聊天历史,生成双人年度报告以发现互动模式;需要备份重要对话的用户,支持导出为 HTML/JSON/Excel 以便存档或分享;以及对微信数据格式和解密技术感兴趣的开发者,可参考其开源实现进行学习或扩展。 技术实现上,EchoTrace 基于 Flutter 框架开发,采用 Provider 进行全局状态管理。它支持两种数据读取模式:实时模式通过 WCDB DLL 直接读取加密数据库,备份模式则读取已解密的 SQLite 文件。解密核心使用 Go FFI 实现高性能处理,并辅以纯 Dart 备份方案。此外,项目包含 CLI 工具支持批量导出,所有数据均在本地处理,无任何网络请求。

详细信息与使用说明

1. 项目定位与用途

EchoTrace 定位为本地安全的微信聊天记录管理工具,核心用途包括导出聊天记录为多种格式(HTML、JSON、Excel)、分析聊天内容生成统计报告(如词云、时间分布)、以及创建年度或双人回顾报告。它强调完全本地运行,所有数据不上传网络,确保用户隐私安全,同时提供直观的界面和 CLI 工具满足不同使用需求。

2. 解决的问题

主要解决微信聊天记录无法直接导出、分析困难以及隐私泄露风险。用户常因微信数据加密而无法备份或深入分析,第三方工具可能上传数据或功能有限。EchoTrace 通过本地解密和离线处理,让用户自主掌控数据,同时提供丰富的分析维度,如消息频率、词频统计、年度报告等,满足深度回顾需求。

3. 适用场景

适用于希望回顾聊天历史的个人用户,可生成年度报告唤起回忆或创建双人报告分析互动模式;需要备份重要对话的用户,支持导出为通用格式以便长期存档或分享;以及对微信数据解密技术感兴趣的开发者,可参考其开源代码进行研究、学习或二次开发。项目已停止维护,但功能仍可使用。

4. 安装方式

最终用户可从 GitHub Releases 页面下载 Windows 版本的 zip 压缩包,解压后双击 EchoTrace.exe 即可运行,无需安装,但需注意应用路径不要包含中文字符。开发者需克隆仓库到本地,运行 flutter pub get 安装依赖,然后使用 flutter run 进行调试或 flutter build windows 打包生成可执行文件。仓库中未明确给出 macOS 或 Linux 的安装步骤。

5. 使用方式

使用流程分为配置、解密、分析/导出三步。首先在设置页填写解密密钥(支持自动获取、手动输入或使用密钥工具)、选择微信数据路径(自动检测或手动选择 xwechat_files 文件夹)、确认账号并保存配置。然后进入数据管理页点击批量解密数据库,等待完成。最后在分析页生成年度报告或双人报告,或在导出页选择会话、格式(HTML/JSON/Excel)与日期范围进行导出。CLI 模式支持通过命令行参数(如 -e、--format)批量导出,但需先在 UI 完成配置与解密。

6. 补充说明或实现特点

项目基于 Flutter 开发,使用 Provider 管理全局状态。核心服务分层清晰:数据库服务支持实时模式(调用 WCDB DLL)和备份模式(sqflite);解密服务以 Go FFI 为主,提供高性能,另有纯 Dart 备份实现;图片解密服务处理 XOR 和 AES 解密;分析服务生成统计报告;导出服务被 UI 和 CLI 共享。所有数据本地处理,无网络请求,日志统一管理。项目已停止维护,实时功能可参考 WeFlow,备份功能可参考密语项目。

思维导图

EchoTrace
核心服务
数据库服务 (DatabaseService)
解密服务 (DecryptServiceGo)
图片解密服务
分析服务 (AnalyticsService)
导出服务 (ChatExportService)
数据模式
实时模式 (WCDB DLL)
备份模式 (sqflite)
UI 与 CLI
Flutter UI 页面
CLI 导出工具
配置与工具
配置服务 (ConfigService)
日志服务 (LoggerService)
路径与字符串工具

常见问题

EchoTrace 是否安全?数据会上传到网络吗?

所有数据处理均在本地进行,应用无任何网络请求,确保您的聊天记录隐私安全。

支持哪些操作系统?

当前主要支持 Windows 10+ 系统,基于 Flutter 开发,理论上可扩展至 macOS 和 Linux,但仓库中未明确给出其他平台支持。

如何获取微信数据库解密密钥?

可在应用设置页点击“自动获取”跟随流程获取,或下载密钥获取工具,也支持手动输入密钥,并可通过“测试连接”验证。

导出的聊天记录支持哪些格式?

支持导出为 HTML、JSON 和 Excel 三种格式,便于离线查看、存档或分享给朋友。

项目是否还在维护?

README 中说明 EchoTrace 已停止维护,但相关功能可参考 WeFlow(实时功能)和密语(备份功能)项目继续使用。