Weport

轻量、本地化的微信聊天记录导出与分析工具（Windows）
一键导出全部私聊与群聊 · 10 种导出格式 · 新消息置顶弹窗 · 防撤回 · WeportAI 聊天历史分析助手

---

✨ 这是什么？

Weport 是一款 Windows 桌面应用，直接读取本机微信 4.x 的聊天数据，把全部联系人、群聊记录导出为文件，还能用 WeportAI 直接对聊天记录提问、总结、复盘——核心处理都在本机完成。

• 🔒 本地优先 — 微信数据不出本机，不上传任何内容
• 📦 一键导出 — 全部私聊 + 群聊，不用逐个选择
• 🎨 10 种格式 — TXT / JSON / HTML / XLSX / Markdown / ChatLab / SQL 等
• 🤖 WeportAI — 基于 DeepSeek V4 Flash 的聊天历史分析助手，带 17 个检索/分析工具与长期记忆
• 🔔 消息提醒 — 独立置顶弹窗，新消息与撤回即时通知（可按会话过滤）
• 🛡️ 防撤回 — 会话级 WCDB 触发器，撤回的消息在微信本地仍然可见
• 🚀 托盘常驻 — 开机自启、静默启动、关闭最小化到托盘

📸 截图

连接微信 —— 选择数据目录、扫描账号、一键提取解密密钥：

导出数据 —— 格式、目录结构、媒体与高级选项一目了然：

WeportAI —— 对聊天记录提问：工具调用、思考过程与 Markdown 结论，右侧为长期记忆与笔记：

通知弹窗 —— 液态玻璃风格，置顶显示、不抢焦点：

🚀 快速开始

1. 从 Releases 下载最新安装包并安装
2. 打开 Weport，在「连接微信」页选择数据目录（自动检测 xwechat_files 文件夹）
3. 按页面提示获取解密密钥（见下方说明）
4. 切到「导出数据」页，选择格式与输出文件夹，点击导出全部聊天记录

🔑 获取解密密钥（重要）

密钥在微信登录的瞬间被捕获，无法从已登录的会话中直接读取：

1. 打开微信电脑版，在「设置 → 通用」里关闭「自动登录」，然后退出当前登录
2. 点击 Weport 中的**「提取密钥」**，等待出现「已准备就绪」提示
3. 用手机扫码登录微信 —— 登录成功的瞬间密钥会自动捕获并填入
4. 也可以手动粘贴已有的 64 位十六进制密钥

🤖 WeportAI · 聊天历史分析助手

WeportAI 是 Weport 内置的聊天历史分析环境（v0.8 起）：把 DeepSeek V4 Flash 与 17 个本地检索工具组合成一个可推理的 agent，让你用自然语言问自己的聊天记录。

可以这样问：

提问	它能做什么
「分析我是什么人」	全量扫描所有会话与时间窗，输出人格画像
「8月8日发生了什么」	跨会话重建当天的完整时间线
「我和小明的聊天关系怎么样」	互动模式、话题分布与关系状态分析
「搜一下我们什么时候提过露营」	全文关键词搜索，带回原文上下文
「把发现写入 memory/events.md」	把结论沉淀为长期记忆，下次直接命中

工作方式：

• 工具链：会话列表、时间线重建、全文搜索、群成员、会话统计、联系人资料、关系筛选等 17 个工具，AI 按需调用并展示每一步的思考过程与调用结果
• 长期记忆：所有发现持续写入导出目录下的 WeportAI/memory/（跨对话共享）；单次分析的草稿笔记存于 notes/
• 成本透明：每次运行显示上下文窗口占用、DeepSeek 提示词缓存命中率与费用估算
• 完全可控：模型、API 地址、最大步数、快捷动作、可用工具都可在设置中调整

🔐 隐私：分析时仅把聊天文本发送给你配置的模型 API（默认 DeepSeek）。密钥、文件、头像、原始数据库均不会离开本机；调试日志对密钥等敏感内容做脱敏处理。

📦 导出格式

格式	说明
TXT / JSON	纯文本与完整消息详情，通用格式
HTML	网页格式，浏览器直接打开浏览
XLSX	电子表格，适合统计分析
Markdown	支持文本、图片与链接，适合 AI 场景
ChatLab / JSONL / Arkme JSON	标准聊天格式，可导入其他软件
WeClone CSV	WeClone 兼容字段
PostgreSQL SQL	数据库脚本，便于导入数据库

支持按会话分目录 / 按类型分目录两种组织方式，媒体文件（图片、视频、语音、表情包、文件）可选导出。

🛠️ 开发

环境要求：Node 20+，Windows。

npm install                       # 安装依赖 + 同步运行时 DLL
npm run dev                       # 开发模式（vite + electron）
npm run typecheck                 # 渲染进程 + 主进程类型检查
npm run build                     # 构建 NSIS 安装包（release/ 目录）
npm run build:dir                 # 免安装构建（迭代更快）
powershell -ExecutionPolicy Bypass -File scripts/capture-ui.ps1   # UI 冒烟测试（自动截屏 + 内容断言）
powershell -ExecutionPolicy Bypass -File scripts/capture-ui.ps1 -PublishToDocs   # 生成并发布 README 截图

capture-ui.ps1 以 WEPORT_SCREENSHOT_POPUP 模式启动应用：自动截图「连接 / 导出 / WeportAI / 通知弹窗」四个画面并断言非空。该模式全部使用脱敏演示数据（假路径、假密钥、演示账号），不会把真实个人信息截进 README。

架构速览

目录	说明
electron/appMain.ts	主进程：窗口、托盘、IPC、更新、导出、通知管线、QA 截图模式
electron/services/	引擎（WeFlow WCDB 栈的 TypeScript 移植）：会话、WCDB、密钥、导出、推送
electron/services/weportAiService.ts	WeportAI：agent 循环、工具调用、记忆/笔记工作区、脱敏日志
electron/wcdbHost.ts	WCDB 宿主子进程（以 WeFlow.exe --wcdb-host 运行，IPC 通信）
electron/windows/notificationWindow.ts	液态玻璃通知弹窗
src/	React 渲染层（主界面 + 通知窗口 + WeportAI 面板）
resources/	原生 DLL：wcdb / key / wedecrypt / runtime

🧭 行为约定

• 关闭窗口默认最小化到托盘，从托盘菜单「退出」才会完全退出
• 开机自启支持静默启动（--background，不显示主窗口）
• 通知弹窗为独立置顶窗口，不抢占焦点；点击弹窗可唤出主窗口
• 数据目录与密钥保存在本机，重启后自动恢复

🔐 隐私

所有处理都在本机完成。应用只读取你指定的微信数据目录，并在提取密钥时挂接微信进程捕获登录密钥；不会向任何服务器上传聊天内容。

WeportAI 例外：为了让模型回答问题，会把相关聊天文本发送到你在设置中配置的模型 API（默认 DeepSeek）。此功能默认关闭，只有当你填写 API 密钥后才启用；密钥仅保存在本机配置中，日志与截图均做脱敏处理。

⚠️ 免责声明

本工具仅供个人学习与本地数据归档使用。使用前请遵守微信《软件许可及服务协议》及所在国家/地区的法律法规，且仅允许处理本人账号的本地数据。因不当使用（包括但不限于侵犯他人隐私、违反微信服务条款、用于商业用途等）造成的一切后果由使用者自行承担，作者不对任何滥用行为负责。

📄 License

MIT — 自由使用、修改与分发。