【免费下载链接】echotraceEchoTrace 是一个本地、安全的微信聊天记录导出、分析与年度报告生成工具 | EchoTrace is a local, secure tool for exporting, analyzing, and generating annual reports of WeChat chat records项目地址https://gitcode.com/gh_mirrors/ec/echotrace点击查看免费下载本文以 docs/development.md 为骨架系统拆解 EchoTrace——一个本地、安全的微信聊天记录导出、分析与年度报告生成工具——的运行时启动流程、DatabaseService的实时/备份双模式数据读取、Go FFI 解密链路、业务服务分层与 Windows 平台 CLI 批量导出实现并给出从源码构建到调试的完整操作路径。读完本文你可以理解该项目的模块边界与调用关系并独立完成flutter build打包与命令行导出脚本的编写。1. 项目定位与技术栈EchoTrace 的核心目标是完全本地地处理微信 PC 端Windows聊天数据解密本地数据库、离线查看记录、生成可视化年度报告并将聊天数据导出为 HTML/Excel/JSON 等格式全程数据不出本机。项目基于Flutter 桌面端构建状态管理采用Provider全局AppState数据库读取同时覆盖两条技术路线备份模式通过 sqflite 只读连接“已解密落地”的 SQLite 数据库实时模式通过 Dart FFI 直接调用 Windows DLLwcdb_api.dll读取仍处于加密状态的 WCDB 数据库。这一“双模式”设计是整个架构中最核心的工程决策也是理解后续所有模块的前提。项目文档体系可配合阅读架构总览见 docs/development.md实时模式 WCDB 接口详解见 docs/wcdb_realtime.md面向最终用户的操作与 CLI 用法见 docs/beginner_guide.md数据库底层机制分析见 report.md。2. 运行时流程从入口到页面路由根据开发者指引应用的启动链路如下入口与 CLI 分流lib/main.dart是应用与 CLI 的共用启动入口。启动时先检测命令行参数——若存在导出参数则走 CLI 分支详见第 6 节否则继续以 UI 模式启动全局状态初始化创建全局AppState以 Provider 注入由它负责初始化日志、配置、数据库连接实时/备份二选一、错误与加载状态、解密进度、头像缓存等横切关注点页面渲染渲染EchoTraceAppUI 层通过ConsumerAppState订阅全局状态变化实现响应式刷新。布局层面HomePage搭配Sidebar组件实现主框架依据AppState.currentPage字段在以下业务页面间切换欢迎页、聊天页、数据分析、群聊分析、导出、数据管理、设置。这种“单一 currentPage 枚举 侧边栏切换”的路由方式使得每个业务页都是独立 Widget便于单独开发与测试也意味着新增功能页只需扩展AppState.currentPage的取值并在HomePage中增加分支。从源码职责划分看对应文档“主要文件和目录”一节文件职责lib/main.dart应用与 CLI 启动入口构建主题与全局 Providerlib/providers/app_state.dart全局状态、数据库重连、解密进度、头像缓存lib/services/database_service.dart数据库连接、实时 DLL 访问、跨库消息查询与统计lib/services/analytics_service.dart/advanced_analytics_service.dart统计分析lib/services/chat_export_service.dart导出实现供 UI/CLI 复用lib/services/decrypt_service_go.dart/go_decrypt_ffi.dart数据库解密lib/services/config_service.dart配置持久化lib/services/wechat_wcdb_native.dartWCDB DLL FFI 封装lib/pages/各业务页面与布局lib/widgets/可复用组件侧边栏、气泡、进度遮罩等lib/utils/通用工具3. 数据读取层DatabaseService 的双模式设计数据库读取统一由DatabaseService承载对外屏蔽两种模式的差异这是理解 EchoTrace 数据通道的关键。3.1 备份模式sqflite 只读连接备份模式面向“已经解密落地”的数据用户先在数据管理页执行批量解密将微信的加密数据库解密为普通 SQLite 文件后DatabaseService通过sqflite 只读连接访问其中的 session / message / contact 三类数据。只读连接的定位很明确——该工具只消费数据绝不回写微信目录这与“本地、安全”的产品原则一致。3.2 实时模式FFI 调用 Windows DLL 直读加密库实时模式无需预先解密通过wechat_wcdb_native.dart中的 Dart FFI 封装调用 Windows DLLwcdb_api.dll并依赖WCDB.dll直接读取仍处加密状态的 WCDB 数据库。docs/wcdb_realtime.md 给出了该 DLL 的完整接口约定开发时应重点掌握三条规则状态码所有接口返回整型wcdb_status0表示成功 0表示失败如参数错误、解密失败-2特指密钥错误内存管理凡 DLL 通过char**指针返回的字符串包括日志字符串用毕必须调用wcdb_free_string释放否则会造成严重内存泄漏数据格式会话列表、消息列表、联系人等复杂结构一律以UTF-8 JSON 字符串返回便于 Dart 侧跨语言解析。接口生命周期为wcdb_init()全局初始化 →wcdb_open_account(session_db_path, hex_key, handle)打开账号传入核心数据库路径与 64 位十六进制密钥→ 业务查询wcdb_get_sessions、wcdb_get_messages、wcdb_get_message_count、wcdb_get_display_names/wcdb_get_avatar_urls、群聊的wcdb_get_group_member_count/wcdb_get_group_members→wcdb_close_account(handle)→ 进程退出前wcdb_shutdown()。其中wcdb_open_account具备智能查找能力DLL 会自动在同级目录挂载关联的message_*.db分库与contact*.db调用方无需手动指定wcdb_get_messages内部自动扫描所有分库按sort_seq或时间戳降序排序并分页返回且附带computed_is_send是否发送方等辅助字段。3.3 底层数据布局分库、分表与智能定位实时模式能“智能查找”的前提是微信 PC 端的数据库按固定规则分布。仓库中的 report.md 对该布局有系统性梳理可作为阅读DatabaseService时的对照背景数据库类型命名规则典型路径功能会话索引Session.dbdb_storage/session/联系人列表、会话列表及基础元数据消息分库message_{N}.dbdb_storage/message/实际聊天消息N 通常为 0–199媒体索引media_{N}.dbdb_storage/message/语音、视频等附件索引与元数据文件映射hardlink.dbdb_storage/hardlink/加密图片.dat与会话路径的映射消息分库按会话 ID 哈希路由到特定分库分库内的消息表命名遵循Msg_{MD5}MD5 为会话 ID 的哈希值。这也解释了实时模式下“找不到消息”这一类故障的排查方向需确认session_db_path所在目录下存在message_1.db等文件DLL 依赖相对路径查找分库见 docs/wcdb_realtime.md 的常见问题一节。另外该 DLL 目前仅支持Windows x64部署时wcdb_api.dll与WCDB.dll需放在应用可加载目录下推荐与可执行文件同级或置于data/flutter_assets/assets/dll/等资源目录。4. 解密链路Go FFI 为主、Dart 为备解密子系统由三个服务协作完成默认与兜底分工明确DecryptServiceGo→GoDecryptFFI默认解密实现。数据库解密通过 Go 编译产物 Dart FFI 调用执行另有Dart 备份实现作为降级路径保证在 FFI 环境不可用时仍可走纯 Dart 通道ImageDecryptService图片解密独立成服务。结合 report.md 的逆向结论可理解其必要性——微信图片存在多种加密版本版本 0 使用 XORdecryptDatV3利用 JPG/PNG 尾部特征倒推密钥版本 1/2 的文件头分别为07 08 56 31 08 07与07 08 56 32 08 07采用 AES-128-ECBdecryptDatV4其中 V4 的 15 字节 Header 中[6-10]为 AES 段长度、[10-14]为 XOR 段长度先解密 AES 段16 字节对齐并去 PKCS7 填充再对 XOR 段做异或。版本 2 需要运行时获取的用户 AES 密钥这正是设置页中 XOR/AES 图片密钥配置项由ConfigService持久化存在的意义ConfigService统一持久化解密密钥、数据库路径、实时/备份模式选择、图片密钥、调试开关等全部用户配置是 UI 设置页与各服务之间的唯一配置源。图片物理路径的还原依赖hardlink.db中的image_hardlink_info表以图片 MD5 查得dir1/dir2/file_name再将整数索引经dir2id表解析为目录名最终还原为类似msg/attach/{user_hash}/{path_hash}/Img/{filename}的路径。若配置中未填写图片密钥文字记录导出不受影响但应用内无法渲染图片、导出也不附带图片。5. 业务服务层分析、导出与群聊能力在数据层之上业务服务按职责分层AnalyticsService与高级分析/缓存后台服务负责私聊与全局统计、时间分布、词频统计、年度报告与双人报告等计算。计算结果通过缓存后台服务复用避免每次进入分析页重复全量扫描ChatExportServiceJSON/HTML/Excel 导出实现UI 导出页与 CLI 共用同一服务保证两条出口的字段与筛选逻辑完全一致。导出页面同时支持按会话多选、日期范围筛选或“导出全部时间”大消息量下页面会先完成索引与排序期间短暂卡顿属正常现象GroupChatService群聊专项能力活跃度、成员、媒体统计等配合群聊分析页面系列与实时模式的wcdb_get_group_members等接口LoggerService统一封装 info / debug / warning / error 四级日志CLI 模式额外将日志输出到系统临时目录的echotrace_cli.log是排查导出失败的第一手现场。6. CLI 批量导出与 UI 同源的无界面工作流CLI 是面向脚本化备份的无界面通道实现位于lib/cli/cli_export_runner.dart仅支持 Windows。其工作流程为拦截命令行参数 → 初始化AppState与数据库连接沿用第 3 节的双模式→ 批量导出会话筛选与时间范围的语义与 UI 保持一致因为二者复用同一个ChatExportService。使用前需先在 UI 中完成配置密钥、数据路径、账号选择与解密。参数与示例摘自 docs/beginner_guide.md# 场景 1导出所有会话为 HTML 网页 .\echotrace.exe -e C:\MyBackup --format html --all # 场景 2仅导出 2024 年的数据默认格式为 JSON .\echotrace.exe -e C:\MyBackup --start 2024-01-01 --end 2024-12-31参数说明-e 目录必填指定导出路径--format可选json/html/excel--all导出所有已解密的数据--start/--end指定日期范围YYYY-MM-DD若 CLI 执行结果异常应优先查看临时目录下的echotrace_cli.log其次实时模式下可调用 DLL 的wcdb_get_logs获取内部路径检查、解密尝试与 SQL 错误日志——后者是实时模式故障排查的首选工具。7. 模型与工具层核心模型lib/models/ChatSession会话、Message消息、Contact联系人、AnalyticsData分析结果等是数据库层、服务层与 UI 层之间的通用数据结构工具类lib/utils/path_utils.dart路径与特殊字符兼容处理。注意官方安装提示明确不要将应用放在包含中文的目录下该工具类是对此约束在运行期的兜底string_utils.dart文本处理xml_message_parser.dart消息 XML 解析用于还原结构化消息内容batch_processor.dart批处理节流控制解密/导出等大批量任务对事件循环与内存的冲击批量解密耗时从一分钟到数十分钟不等节流是其体验设计的一部分。8. 构建与调试从源码构建的完整流程与 README.md “面向开发者”一节一致# 1. 克隆项目到本地 git clone https://gitcode.com/gh_mirrors/ec/echotrace.git cd echotrace # 2. 安装项目依赖 flutter pub get # 3. 运行应用调试模式桌面端需已启用目标平台支持 flutter run # 4. 打包可执行文件以 Windows 为例也支持 macos/linux flutter build windows构建与调试的要点依赖flutter pub get拉取 Dart 依赖后即可开发平台应用可构建到windows/macos/linux但实时模式与 CLI 导出仅 Windows前者依赖 Windows DLL后者入口明确限定 Windows备份模式不依赖 DLL是跨平台可用的数据通路CLI 日志App 内统一走LoggerServiceCLI 模式附加输出系统临时目录的echotrace_cli.log故障定位顺序设置页“测试连接”验证密钥 →echotrace_cli.log/LoggerService日志 → 实时模式下wcdb_get_logs的 DLL 内部日志 → 核对db_storage目录层级选择xwechat_files层级而非其下的all_users或wxid_xx文件夹。9. 小结EchoTrace 的架构可以概括为一条清晰的主线main.dart双入口分流UI / CLI→AppState统一状态 →ConfigService统一配置 →DatabaseService双模式读取sqflite 备份 / WCDB DLL 实时→ Go FFI 解密链路 → 分析与导出服务 → 业务页面。实时模式将分库扫描、多库聚合与密钥解密下沉到 C 层 DLL并以 UTF-8 JSON 作为跨语言契约备份模式则以只读 sqflite 换取跨平台可用性。两条通路共用同一套模型、工具与导出服务保证了 UI 与 CLI 输出的一致性——这正是其“既能在界面里浏览年度报告也能用一行命令完成脚本化备份”的工程基础。赞分享【免费下载链接】echotraceEchoTrace 是一个本地、安全的微信聊天记录导出、分析与年度报告生成工具 | EchoTrace is a local, secure tool for exporting, analyzing, and generating annual reports of WeChat chat records项目地址https://gitcode.com/gh_mirrors/ec/echotrace点击查看免费下载相关推荐Flutter桌面开发实战跨平台应用架构设计与实现Flutter桌面开发实战跨平台应用架构设计与实现 Flutter桌面开发作为构建跨平台应用架构的重要技术路径正在改变传统桌面应用开发的格局。本文将通过问前端后端企业应用内容协同知识管理AI 应用Flutter桌面开发新范式flutter-rs深度架构解析与实战指南Flutter桌面开发新范式flutter rs深度架构解析与实战指南 引言跨平台开发的痛点与解决方案 你是否还在为Flutter桌面应用的性能优化而烦恼Flutter 桌面应用开发指南Flutter 桌面应用开发指南 项目介绍 awesome flutter desktop 是一个精心策划的列表汇集了与 Flutter 桌面开发相关的最佳资上一篇Tectonic现代化TeX/LaTeX引擎的5个核心优势下一篇3个步骤快速完成SolidWorks到URDF转换机械设计到机器人仿真的终极指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考