[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82095":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":14,"forks30d":14,"starsTrendScore":18,"compositeScore":19,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":9,"pushedAt":9,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":14,"starSnapshotCount":14,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},82095,"pc_wechat_exp","sunhanaix\u002Fpc_wechat_exp","sunhanaix","找到微信的key，导出聊天记录，进行分析",null,"HTML",160,52,1,0,3,23,117,18,5.17,false,"main",true,[],"2026-06-12 02:04:23","# WeChat EXP 使用手册\n\n> 版本：2.0 | 更新日期：2026-05-28 | 适用 WeChat 4.x | Windows 10\u002F11\n\n---\n\n## ⚠️ 重要警告 — 请务必阅读\n\n**本工具仅供个人学习、研究和技术交流使用。使用者必须遵守以下规定：**\n\n1. **仅限个人数据**：您只能备份、查看和分析**您自己的**微信聊天记录。未经他人明确同意，**严禁**获取、查看、分析他人的微信数据。\n2. **禁止非法用途**：严禁将本工具用于任何侵犯他人隐私、窃取商业秘密、进行网络监控等违法违规活动。\n3. **自行承担责任**：使用者对自身行为负全部法律责任。本工具的开发者不对任何滥用行为承担责任。\n4. **遵守法律法规**：请遵守您所在地区的法律法规。在中国境内，未经授权的个人信息收集和处理违反《个人信息保护法》。\n5. **数据安全**：本工具在本地运行，不会将您的任何数据上传到互联网。但解密后的数据存储在您的电脑上，请妥善保管。\n\n> **如果您不同意上述条款，请立即删除本工具及其所有相关文件。**\n\n---\n\n## 目录\n\n1. [快速开始（只需 2 步）](#1-快速开始只需-2-步)\n2. [系统要求](#2-系统要求)\n3. [Web 界面功能详解](#3-web-界面功能详解)\n   - [3.1 仪表盘首页](#31-仪表盘首页)\n   - [3.2 数据采集 — 一键备份](#32-数据采集--一键备份)\n   - [3.3 浏览与分析 — 聊天查看器](#33-浏览与分析--聊天查看器)\n   - [3.4 浏览与分析 — 年度报告](#34-浏览与分析--年度报告)\n   - [3.5 浏览与分析 — 词云分析](#35-浏览与分析--词云分析)\n   - [3.6 导出 — 聊天记录导出](#36-导出--聊天记录导出)\n   - [3.7 导出 — 综合报告](#37-导出--综合报告)\n   - [3.8 导出 — 员工报表](#38-导出--员工报表)\n   - [3.9 工具 — 提取密钥与解密数据库](#39-工具--提取密钥与解密数据库)\n4. [聊天查看器使用详解](#4-聊天查看器使用详解)\n   - [4.1 界面布局](#41-界面布局)\n   - [4.2 搜索联系人](#42-搜索联系人)\n   - [4.3 消息筛选](#43-消息筛选)\n   - [4.4 消息类型展示](#44-消息类型展示)\n   - [4.5 语音转文字](#45-语音转文字)\n   - [4.6 群组信息查看](#46-群组信息查看)\n5. [V2 图片显示问题](#5-v2-图片显示问题)\n6. [常见问题 (FAQ)](#6-常见问题-faq)\n7. [附录：命令行参考（高级用户）](#7-附录命令行参考高级用户)\n\n---\n\n## 1. 快速开始（只需 2 步）\n\nWeChat EXP 是一款 Windows 平台下的微信聊天记录**备份、查看与分析**工具。下载后双击即可使用，无需安装 Python 环境。\n\n**主要功能一览：**\n\n| 功能 | 说明 | 在哪里操作 |\n|------|------|-----------|\n| 一键备份 | 自动备份微信聊天记录（含图片、视频、文件、语音） | Web 仪表盘 → 数据采集 |\n| 聊天查看 | 像微信一样浏览聊天记录，支持搜索、筛选 | Web 仪表盘 → 聊天查看器 |\n| 图片查看 | 查看微信中的图片（含 V2 新版加密图片） | 聊天查看器中自动显示 |\n| 导出聊天 | 将聊天记录导出为 TXT\u002FHTML 文件 | Web 仪表盘 → 聊天导出 |\n| 词云分析 | 生成聊天高频词汇的视觉化词云 | Web 仪表盘 → 词云分析 |\n| 综合报告 | 生成包含统计图表的 HTML 分析报告 | Web 仪表盘 → 综合报告 |\n| 年度报告 | Spotify-Wrapped 风格的个人年度聊天总结 | Web 仪表盘 → 年度报告 |\n\n**只需两步，即可开始使用：**\n\n```\n第一步：双击 wechat_exp.exe 启动程序\n第二步：在自动打开的网页中，点击\"一键备份\"\n```\n\n启动后，程序会自动在浏览器中打开 Web 操作界面（地址为 `http:\u002F\u002F127.0.0.1:5000`）。如果没有自动打开，请手动打开浏览器并访问该地址。\n\n![程序启动截图](screenshots\u002F01-startup.png)\n*图 1：程序启动后自动打开的 Web 仪表盘首页*\n\n> **提示**：首次使用时，微信必须正在运行且已登录，程序才能自动提取密钥并完成备份。之后的日常使用无需微信运行。\n\n---\n\n## 2. 系统要求\n\n| 要求 | 说明 |\n|------|------|\n| 操作系统 | Windows 10 \u002F Windows 11（64 位） |\n| 微信版本 | WeChat 4.0.x \u002F 4.1.x |\n| 磁盘空间 | 需要与微信数据目录大小相近的可用空间（通常 2-10 GB） |\n| 其他 | 首次备份需要微信正在运行并已登录 |\n\n> **注意**：本程序为独立可执行文件（.exe），**不需要**安装 Python 或其他运行环境。下载后直接双击即可使用。\n\n---\n\n## 3. Web 界面功能详解\n\n启动程序后，所有操作都在 Web 网页中进行。以下按 Web 界面的四个功能模块逐一说明。\n\n### 3.1 仪表盘首页\n\n打开程序后看到的第一个页面就是仪表盘首页。页面分为**四个功能模块**：\n\n| 模块 | 位置 | 包含的功能按钮 |\n|------|------|--------------|\n| **数据采集** | 左上方 | 「一键备份」 |\n| **浏览与分析** | 右上方 | 「聊天查看器」「年度报告」「词云分析」 |\n| **导出** | 左下方 | 「聊天导出」「员工报表」「综合报告」 |\n| **工具** | 右下方 | 「提取密钥」「解密数据库」 |\n\n![仪表盘截图](screenshots\u002F02-dashboard.png)\n*图 2：仪表盘首页 — 四个功能模块*\n\n每个模块包含一个或多个**按钮**，点击按钮即可进入对应的功能页面。下面按模块逐一介绍。\n\n---\n\n### 3.2 数据采集 — 一键备份\n\n这是您首次使用时的**第一步操作**。\n\n**操作步骤：**\n\n1. 确保微信正在运行且已登录\n2. 在仪表盘首页，找到「**数据采集**」模块\n3. 点击「**一键备份**」按钮\n4. 进入备份页面后，可以选择备份的日期范围（默认最近 30 天）\n5. 点击「**开始备份**」按钮\n6. 页面底部会出现进度条，实时显示备份进度\n7. 等待四个阶段依次完成：扫描账号 → 解密数据库 → 迁移媒体 → 构建索引\n\n![备份页面截图](screenshots\u002F03-backup-page.png)\n*图 3：Web 备份页面 — 设置日期范围后点击\"开始备份\"*\n\n**备份过程分四个阶段：**\n\n| 阶段 | 显示文字 | 说明 | 大约耗时 |\n|------|---------|------|---------|\n| ① 扫描 | \"正在扫描账号...\" | 自动查找微信数据目录 | 几秒 |\n| ② 解密 | \"正在解密数据库...\" | 解密微信加密的数据库文件 | 10-60 秒 |\n| ③ 迁移 | \"正在迁移媒体文件...\" | 复制图片、视频、语音、文件 | 1-5 分钟 |\n| ④ 索引 | \"正在构建索引...\" | 建立聊天记录统一索引 | 10-30 秒 |\n\n> **提示**：整个备份过程通常需要 2-5 分钟，具体时间取决于微信数据量的大小。\n\n![备份进度截图](screenshots\u002F04-backup-progress.png)\n*图 4：备份进行中 — 实时进度条和日志输出*\n\n**备份完成后**，页面会显示\"操作完成\"。此时您可以：\n- 点击「返回仪表盘」→ 进入「聊天查看器」浏览聊天记录\n- 或直接使用其他功能\n\n**备份结果保存在**：`wechat_exp.exe` 所在目录下的 `backup\\` 文件夹中。\n\n> **日常使用提示**：首次备份后，如果只是查看聊天记录，不需要再次备份。只有当微信中有新的聊天记录需要更新时，再运行备份即可。\n\n---\n\n### 3.3 浏览与分析 — 聊天查看器\n\n点击仪表盘中的「**聊天查看器**」按钮，进入聊天浏览界面。\n\n**界面左侧**是联系人列表，显示所有聊天对象（联系人、群聊），按最新消息时间排序。\n\n**界面右侧**是消息显示区域，点击左侧任意联系人或群聊，即可查看对应的聊天记录。\n\n![聊天查看器截图](screenshots\u002F05-chat-viewer.png)\n*图 5：聊天查看器 — 左侧联系人列表，右侧消息区域*\n\n聊天查看器的详细操作指南见[第 4 章](#4-聊天查看器使用详解)。\n\n---\n\n### 3.4 浏览与分析 — 年度报告\n\n点击仪表盘中的「**年度报告**」按钮，自动生成一份精美的年度聊天数据报告。\n\n报告包含 7 张卡片：\n- 全局概览（消息总数、活跃天数等）\n- 作息时间表（24小时 × 7天 热力图）\n- 消息字数统计\n- 回复速度分析\n- 表情使用排行（表情宇宙）\n- 月度挚友榜\n- 关键词词云\n\n![年度报告截图](screenshots\u002F06-wrapped-report.png)\n*图 6：年度报告 — 数据卡片展示*\n\n---\n\n### 3.5 浏览与分析 — 词云分析\n\n点击仪表盘中的「**词云分析**」按钮，进入词云生成页面。\n\n**操作步骤：**\n\n1. 在「**聊天对象**」输入框中，输入联系人或群聊的名称（支持模糊输入，如输入\"张\"）\n2. 点击「**开始分析**」按钮\n3. 如果匹配到多个结果，系统会弹出选择列表，点击想要分析的对象\n4. 系统开始提取文本、分析词频\n5. 完成后点击链接，在新标签页中查看交互式词云\n\n![词云分析截图](screenshots\u002F07-wordcloud.png)\n*图 7：词云分析 — 智能匹配后生成的可交互词云*\n\n---\n\n### 3.6 导出 — 聊天记录导出\n\n点击仪表盘中的「**聊天导出**」按钮，进入导出页面。\n\n**操作步骤：**\n\n1. 在「**联系人\u002F群聊标识**」输入框中，输入联系人或群聊的名称\n   - 支持模糊输入，只输入部分名称即可（如输入\"中望\"）\n2. （可选）选择「**开始日期**」和「**结束日期**」，限定导出范围\n3. （可选）选择导出格式：「TXT 文本」或「HTML」\n4. 点击「**开始导出**」按钮\n5. 系统自动扫描匹配：\n   - **只有 1 个匹配**：直接开始导出\n   - **多个匹配**：弹出选择列表，显示每个对象的名称和消息数量，**点击选择**后再导出\n   - **无匹配**：显示\"未找到联系人\"\n6. 导出完成后，点击「📥 下载导出文件」按钮，保存到本地\n\n![导出页面截图](screenshots\u002F08-export-page.png)\n*图 8：聊天导出页面 — 输入名称后可选择日期和格式*\n\n![导出选择截图](screenshots\u002F09-export-select.png)\n*图 9：智能匹配选择列表 — 多个匹配时弹出供用户选择*\n\n---\n\n### 3.7 导出 — 综合报告\n\n点击仪表盘中的「**综合报告**」按钮，自动生成包含统计图表的 HTML 分析报告。\n\n报告内容涵盖：\n- 消息总量趋势（按月统计的柱状图）\n- 消息类型分布（饼图：文本、图片、视频、语音等占比）\n- 最活跃时段（一天 24 小时的分布柱状图）\n- 最活跃星期（一周 7 天的分布）\n- 联系人消息排名\n- 媒体文件统计\n\n![综合报告截图](screenshots\u002F10-report.png)\n*图 10：综合报告 — 包含 ECharts 交互式图表*\n\n**图表标注说明：**\n\n报告中所有饼图和柱状图**默认显示数据标签**（类别名、百分比、具体数值），无需鼠标悬停即可查看完整信息。\n\n页面右上角有「**隐藏数据标签**」按钮，点击后所有图表标注消失，再次点击恢复显示。您可以根据需要切换。\n\n---\n\n### 3.8 导出 — 员工报表\n\n点击仪表盘中的「**员工报表**」按钮，进入员工报表生成页面。\n\n此功能用于**批量导出**：上传一份包含员工姓名或微信号的 Excel 表格，系统会自动匹配微信联系人并批量导出每个人的聊天记录。\n\n**操作步骤：**\n\n1. 准备一份 Excel 文件（.xlsx），包含员工姓名或微信号列\n2. 点击「**选择文件**」上传 Excel\n3. 点击「**开始导出**」\n4. 系统自动匹配并批量导出，完成后显示结果\n\n---\n\n### 3.9 工具 — 提取密钥与解密数据库\n\n这两个功能位于仪表盘底部的「**工具**」模块，用于处理特殊情况。\n\n**提取密钥：**\n\n当备份时提示\"密钥不足\"无法解密数据库时使用。点击该按钮后，程序从微信进程内存中提取数据库密钥并保存。\n\n> 此操作需要微信正在运行。\n\n**解密数据库：**\n\n如果您已有备份的原始数据库文件但尚未解密，可以使用此功能单独解密。\n\n---\n\n## 4. 聊天查看器使用详解\n\n聊天查看器是本工具最核心的功能，以下逐一介绍界面的各个部分和操作方法。\n\n### 4.1 界面布局\n\n进入聊天查看器后，界面分为三个区域：\n\n| 区域 | 位置 | 内容 |\n|------|------|------|\n| **联系人列表** | 左侧 | 所有联系人\u002F群聊，含头像和最新消息预览 |\n| **消息区域** | 中间偏右 | 当前选中聊天的消息记录 |\n| **搜索\u002F筛选栏** | 顶部 | 联系人搜索框和消息筛选按钮 |\n\n![聊天查看器布局截图](screenshots\u002F11-chat-viewer-layout.png)\n*图 11：聊天查看器界面布局 — 三个功能区域*\n\n---\n\n### 4.2 搜索联系人\n\n在顶部**搜索框**中输入姓名、备注名或微信号，联系人列表会自动过滤，只显示匹配的结果。\n\n**操作技巧：**\n- 输入单个汉字（如\"张\"）即可过滤所有姓张的联系人\n- 支持拼音模糊匹配\n- 清除搜索框内容即可恢复完整列表\n- 群聊名称同样支持搜索\n\n---\n\n### 4.3 消息筛选\n\n点击消息区域顶部的「**筛选**」按钮，展开筛选面板。您可以通过以下条件精确定位消息：\n\n| 筛选项 | 说明 | 示例 |\n|--------|------|------|\n| **日期范围** | 选择起始和结束日期 | 只看 2026 年 5 月的消息 |\n| **消息类型** | 按类型筛选 | 只看图片，或只看文件 |\n| **发送者** | 群聊中按发送者筛选 | 只看某个人发的消息 |\n| **关键词** | 全文搜索 | 搜索包含\"会议\"的消息 |\n\n![筛选面板截图](screenshots\u002F12-filter-panel.png)\n*图 12：消息筛选面板 — 多维度组合筛选*\n\n设置好筛选条件后点击「**应用**」，消息区域只显示符合条件的结果。点击「**清除**」可恢复显示全部消息。\n\n---\n\n### 4.4 消息类型展示\n\n聊天查看器支持所有微信消息类型的展示：\n\n| 消息类型 | 界面显示 | 操作方式 |\n|---------|---------|---------|\n| **文字消息** | 气泡样式，支持 emoji 表情 | 直接阅读 |\n| **图片** | 缩略图显示 | **点击缩略图**可放大查看原图 |\n| **视频** | 视频播放器 | 点击播放按钮观看 |\n| **语音** | 播放条 + 时长 | 点击播放按钮收听 |\n| **文件** | 文件名 + 大小 | 点击下载文件 |\n| **表情\u002F贴纸** | 表情图片 | 直接查看 |\n| **引用回复** | 引用卡片 | 显示被引用的原始消息 |\n| **系统消息** | 灰色居中文字 | 如\"XXX 加入了群聊\" |\n\n![消息展示截图](screenshots\u002F13-message-types.png)\n*图 13：各类消息在查看器中的展示效果*\n\n---\n\n### 4.5 语音转文字\n\n语音消息右侧有一个「**转文字**」按钮。\n\n点击该按钮后，系统使用 Whisper AI 模型将语音内容转为文字显示。首次使用时会自动下载模型文件（约 140MB），之后的转换在本地离线完成。\n\n**操作步骤：**\n1. 找到语音消息（显示播放条的消息）\n2. 点击消息右侧的「**转文字**」按钮\n3. 等待几秒钟，转换结果会显示在语音消息下方\n\n![语音转文字截图](screenshots\u002F14-voice-transcribe.png)\n*图 14：语音转文字功能 — 点击按钮后显示识别结果*\n\n---\n\n### 4.6 群组信息查看\n\n在群聊中，点击聊天窗口顶部的**群名**，可以展开群组信息面板。\n\n面板显示：\n- 群成员列表（含头像和显示名称）\n- 群主标识\n- 成员数量\n\n---\n\n## 5. V2 图片显示问题\n\n### 5.1 什么是 V2 图片\n\n微信 4.x 版本使用了新的图片加密方式（称为\"V2 加密\"）。每张加密图片有一个**唯一的密钥**，这个密钥只存在于微信程序运行时内存中，不会保存到硬盘。\n\n### 5.2 为什么有些图片无法显示\n\n当您在聊天查看器中看到提示\"**V2加密图片，暂不支持解码**\"时，说明该图片的密钥尚未被程序获取到。\n\n### 5.3 如何让图片正常显示\n\n**解决方法：**\n\n1. 启动微信并登录\n2. 在微信中**找到包含这些图片的聊天记录**\n3. **滚动浏览这些聊天**（让图片出现在微信界面上）\n4. 点击仪表盘「**工具**」模块中的「**提取密钥**」\n5. 程序会自动扫描微信内存，获取已加载图片的密钥\n6. 刷新聊天查看器页面，图片即可正常显示\n\n> **原理**：只有微信加载到内存中的图片，其密钥才能被程序提取。因此需要先在微信中浏览这些图片。\n\n### 5.4 减少图片无法显示的情况\n\n- 备份前，先在微信中浏览一遍有图片的重要聊天\n- 备份完成后，使用「提取密钥」功能\n- 定期更新密钥缓存\n\n---\n\n## 6. 常见问题 (FAQ)\n\n### Q1：双击 exe 后没有反应\n\n**可能原因**：杀毒软件拦截\n\n**解决方法**：\n1. 检查 Windows Defender 或第三方杀毒软件是否拦截了程序\n2. 将 `wechat_exp.exe` 添加到杀毒软件的信任列表（白名单）\n3. 以管理员身份运行试试\n\n### Q2：双击后弹出命令行窗口\n\n**这是正常现象。** 程序包含一个命令行服务窗口，它会自动在浏览器中打开操作页面。**请不要关闭这个命令行窗口**，关闭它程序就会停止运行。\n\n![运行窗口截图](screenshots\u002F15-console-window.png)\n*图 15：程序运行时的命令行窗口 — 请勿关闭*\n\n### Q3：浏览器没有自动打开\n\n**解决方法**：\n1. 手动打开浏览器（建议使用 Chrome、Edge 或 Firefox）\n2. 在地址栏输入 `http:\u002F\u002F127.0.0.1:5000`\n3. 按回车键访问\n\n### Q4：网页打开了但显示\"无法连接到后端\"\n\n**可能原因**：端口被占用\n\n**解决方法**：\n1. 确认命令行窗口没有关闭\n2. 检查 5000 端口是否被其他程序占用\n3. 如果是高级用户，可通过命令行指定其他端口（见附录）\n\n### Q5：备份时提示\"未找到微信数据目录\"\n\n**原因**：微信未安装或从未在此电脑上登录。\n\n**解决方法**：\n1. 确认微信已安装\n2. 确认至少登录过一次微信（登录后微信会创建数据目录）\n3. 重新运行程序\n\n### Q6：备份时提示\"密钥不足\"\n\n**原因**：程序未能自动获取数据库解密密钥。\n\n**解决方法**：\n1. 确保微信正在运行且已登录\n2. 点击仪表盘「工具」模块中的「**提取密钥**」按钮\n3. 等待提取完成后，重新点击「一键备份」\n\n### Q7：图片显示\"V2加密图片，暂不支持解码\"\n\n详见[第 5 章](#5-v2-图片显示问题)的完整说明。\n\n### Q8：页面显示空白或点击按钮没反应\n\n**解决方法**：\n1. 按 `Ctrl+F5` 强制刷新页面\n2. 尝试更换浏览器（建议使用 Chrome 或 Edge）\n3. 关闭并重新运行 `wechat_exp.exe`\n\n### Q9：如何备份多个微信账号\n\n程序会自动检测第一个微信账号。如需切换账号：\n1. 在微信中登录目标账号\n2. 重新运行程序\n3. 点击「一键备份」\n\n### Q10：备份的文件存在哪里\n\n所有备份文件保存在 `wechat_exp.exe` 所在目录下的 `backup\\` 文件夹中。每次备份会创建一个以日期命名的子文件夹（如 `backup\\2026-05-28\\`）。\n\n### Q11：备份会占用多少空间\n\n与微信数据目录的大小相近。通常首次备份需要 2-10 GB。后续增量备份（只备份新增数据）占用空间较小。\n\n### Q12：程序会联网上传我的数据吗\n\n**不会。** 本程序完全在本地运行，不会将您的任何聊天数据、个人信息上传到互联网。所有数据保留在您的电脑上。\n\n---\n\n## 7. 附录：命令行参考（高级用户）\n\n以下内容适用于熟悉命令行的**高级用户**。普通用户无需了解此部分，直接双击 exe 使用即可。\n\n### 7.1 全局选项\n\n```bash\nwechat_exp.exe --help           # 显示所有命令\nwechat_exp.exe \u003C命令> --help    # 显示特定命令的帮助\n\n# 快速测试模式（无需子命令）\nwechat_exp.exe -q               # 快速打开聊天查看器\nwechat_exp.exe -q -c 联系人     # 快速打开指定聊天\n```\n\n| 选项 | 简写 | 说明 |\n|------|------|------|\n| `--quick` | `-q` | 快速测试：跳过备份，直接打开聊天查看器（使用已有备份数据） |\n| `--contact` | `-c` | 配合 `--quick`，自动打开指定联系人的聊天（支持名称模糊匹配） |\n\n### 7.2 backup 命令\n\n```\nwechat_exp.exe backup [选项]\n\n选项：\n  --db-dir PATH         微信 db_storage 目录路径\n  --output, -o PATH     备份输出目录\n  --key-file PATH       密钥文件路径（可选，默认自动检测）\n  --days N              备份最近 N 天 (默认: 30, 0=全部)\n  --date-from DATE      起始日期 YYYY-MM-DD\n  --date-to DATE        截止日期 YYYY-MM-DD\n```\n\n### 7.3 serve 命令\n\n```\nwechat_exp.exe serve [选项]\n\n选项：\n  --decrypted-dir PATH  备份数据目录（如已备份则自动检测）\n  --host HOST           监听地址 (默认: 127.0.0.1)\n  --port PORT           监听端口 (默认: 5000)\n```\n\n### 7.4 export 命令\n\n```\nwechat_exp.exe export -m \u003C模式> [选项]\n\n模式：chat \u002F wordcloud \u002F report \u002F employee \u002F list \u002F keys \u002F decrypt\n\n选项：\n  --chat NAME           指定聊天对象 (wordcloud 模式)\n  --output, -o PATH     输出路径\n  --excel PATH          员工 Excel 文件路径 (employee 模式)\n  --decrypted-dir PATH  备份数据目录\n```\n\n### 7.5 harvest-keys 命令\n\n```\nwechat_exp.exe harvest-keys [选项]\n\n选项：\n  --decrypted-dir PATH  备份数据目录\n  --wxid WXID           微信用户 ID (自动检测)\n  --interval SECONDS    扫描间隔秒数 (默认: 2.0)\n  --max-rounds N        最大扫描轮次 (默认: 无限)\n```\n\n### 7.6 典型工作流（命令行）\n\n```bash\n# 首次使用：备份 → 收割密钥 → 启动查看\nwechat_exp.exe backup --days 30\nwechat_exp.exe harvest-keys\nwechat_exp.exe serve\n\n# 日常快速查看（跳过备份，直接用已有数据）\nwechat_exp.exe -q                  # 打开聊天查看器\nwechat_exp.exe -q -c 张三          # 直接打开张三的聊天\n\n# 仅更新最近一周数据\nwechat_exp.exe backup --days 7 --output \"backup\\latest\"\nwechat_exp.exe serve --decrypted-dir \"backup\\latest\"\n\n# 导出分析报告\nwechat_exp.exe export -m wordcloud\nwechat_exp.exe export -m report\n```\n\n### 7.7 从源码运行（开发者）\n\n如果您下载的是源代码版本（而非打包好的 .exe），需要先安装 Python 依赖：\n\n```bash\npip install -r requirements.txt\npython main.py backup\npython main.py serve\n```\n\n源代码版本的使用方式与 .exe 版本完全一致，只需将命令中的 `wechat_exp.exe` 替换为 `python main.py`。\n\n---\n\n> **技术支持**：如遇到问题，请查看 `docs\u002F开发手册.md` 了解技术细节，或提交 Issue 反馈。  \n> **最后更新**：2026-05-28\n","WeChat EXP 是一款用于备份、查看和分析微信聊天记录的工具。它支持一键备份微信聊天记录（包括图片、视频、文件和语音），并提供多种分析功能，如词云生成、年度报告和综合统计报告等。该工具基于Python开发，但提供了独立的可执行文件，用户无需安装额外的运行环境即可在Windows 10\u002F11系统上直接使用。WeChat EXP适用于个人用户希望对自己微信聊天记录进行备份或数据分析的场景，比如回顾一年中的聊天内容趋势、提取重要信息等。需要注意的是，使用本工具时必须遵守相关法律法规，不得侵犯他人隐私。",2,"2026-06-11 04:07:44","CREATED_QUERY"]