readme.md · 阿阿乔/WeChatMsg

<h1 align="center">我的数据我做主</h1>
<div align="center">
    <a href="https://github.com/LC044/WeChatMsg/stargazers">
        <img src="https://img.shields.io/github/stars/LC044/WeChatMsg.svg" />
    </a>
    <a href="https://memotrace.lc044.love/" target="_blank">
        <img alt="GitHub forks" src="https://img.shields.io/github/forks/LC044/WeChatMsg?color=eb6ea5">
    </a>
    <a href="https://memotrace.lc044.love/" target="_blank">
        <img src="https://img.shields.io/badge/WeChat-留痕-blue.svg">
    </a>
    <a target="_blank" href="https://memotrace.lc044.love/">
        <img alt="Hits" src="https://hits.b3log.org/LC044/memotrace.svg">
    </a>
    <a href="https://memotrace.lc044.love/" target="_blank">
        <img src="https://img.shields.io/github/license/LC044/WeChatMsg" />
    </a>
    <a href="https://github.com/LC044/WeChatMsg/releases" target="_blank">
        <img alt="GitHub release (with filter)" src="https://img.shields.io/github/v/release/LC044/WeChatMsg">
    </a>
    <a href="https://memotrace.lc044.love/" target="_blank">
        <img alt="GitHub all releases" src="https://img.shields.io/github/downloads/LC044/WeChatMsg/total?color=3eb370">
    </a>
</div>

<blockquote>
<div style="background-color: #eaf7ea; border-radius: 10px; padding: 20px; position: relative;">
  <div style="position: relative;">
    <div style="position: absolute;top: 0;bottom: 0;left: 0;width: 2px;background-color: #000000;"></div>
    <h2>前言</h2>
    <div style="text-indent: 2em;">
        <a align="center" href="https://memotrace.lc044.love/"><img src="./doc/images/logo99.png"/></a>
        <p style="text-indent:2em;">我深信有意义的不是微信，而是隐藏在对话框背后的一个个<strong>深刻故事</strong>。未来，每个人都能拥有AI的陪伴，而你的数据能够赋予它有关于你过去的珍贵记忆。我希望每个人都有将自己的生活痕迹👨‍👩‍👦👚🥗🏠️🚴🧋⛹️🛌🛀留存的权利，而不是遗忘💀。</p>
        <p style="text-indent:2em;">AI的发展不仅仅是技术的提升，更是情感💞的延续。每一个对话、每一个互动都是生活中独一无二的片段，是真实而动人的情感交流。因此，我希望AI工作者们能够<strong>善用这些自己的数据</strong>，用于培训独特的、属于个体的人工智能。让<strong>个人AI成为生活中的朋友</strong>，能够理解、记录并分享我们的欢笑、泪水和成长。</p>
        <p style="text-indent:2em;">那天，AI不再是高不可攀的存在，而是融入寻常百姓家的一部分。因为<strong>每个人能拥有自己的AI</strong>，将科技的力量融入生活的方方面面。这是一场关于真情实感的革命，一场让技术变得更加人性化的探索，让我们共同见证未来的美好。</p>
        <p align="center"><strong>所以《留痕》</strong></p>
    </div>
  </div>
</div>
</blockquote>

为了照顾普通用户，我准备在[![](https://img.shields.io/badge/Gitee-red.svg)](https://gitee.com/lc044/WeChatMsg)上同步创建一个发行版，但是普通[![](https://img.shields.io/badge/Gitee-red.svg)](https://gitee.com/lc044/WeChatMsg)项目附件不能超过100M，大家可以去[![](https://img.shields.io/badge/Gitee-red.svg)](https://gitee.com/lc044/WeChatMsg)上点点star，项目活跃起来之后我看看能不能申请GVP，把附件大小提升至200M，这样大家就能高速下载了。[https://gitee.com/lc044/WeChatMsg](https://gitee.com/lc044/WeChatMsg)

## 🍉功能
- [![](https://img.shields.io/badge/MemoTrace-官网-blue)](https://memotrace.lc044.love/) 
[![](https://img.shields.io/badge/GitHub-black.svg)](https://github.com/LC044/WeChatMsg)
[![](https://img.shields.io/badge/Gitee-red.svg)](https://gitee.com/lc044/WeChatMsg)
- 🔒️🔑🔓️Windows本地微信数据库
- 还原微信聊天界面
    - 🗨文本✅
    - 🏝图片✅
    - 🐻‍❄️表情包✅ 
    - 拍一拍等系统消息✅ 
- 导出聊天记录
    - sqlite数据库✅ 
    - HTML(文本、图片、视频、表情包、语音、文件、系统消息)✅ 
    - CSV文档✅ 
    - TXT文档✅ 
    - Word文档✅ 
- 分析聊天数据，做成可视化年报[点击预览](https://memotrace.lc044.love/demo.html)
- 🔥**项目持续更新中**
- 开发计划
  - 自主选择年度报告年份
  - 一键导出全部表情包、文件、图片、视频、语音
  - 合并多个备份数据
  - 批量导出数据
  - 个人年度报告
  - 群组年度报告
  - 按日期、关键词索引
  - 支持企业微信好友
- 小伙伴们想要其他功能可以留言哦📬
- 🔥项目正处于并将长期处于发展阶段，给我一些时间♾️，你所期望的未来都会实现（养成系开发者），可关注文末公众号持续获取项目更新动态

## 🥤效果

![image-20230520235351749](./doc/images/20231227211149.png)

![image-20230520235351749](./doc/images/20231227211215.png)

![image-20230520235351749](./doc/images/20231227211228.png)

![image-20230520235400772](./doc/images/20231227211240.png)

![image-20230520235409112](./doc/images/20231227211250.png)

![image-20230520235422128](./doc/images/image-20230520235338305.png)

![image-20230520235431091](./doc/images/image-20230520235351749.png)

</details>

# ⌛使用

网络有问题可移步国内网站Gitee:[https://gitee.com/lc044/WeChatMsg](https://gitee.com/lc044/WeChatMsg)

小白可以先点个star⭐(💘项目不断更新中),然后去旁边[Release](https://github.com/LC044/WeChatMsg/releases)
下载打包好的exe可执行文件，双击即可运行

**⚠️注意：若出现闪退情况请右击选择用管理员身份运行exe程序，该程序不存在任何病毒，若杀毒软件提示有风险选择略过即可，key为none可重启电脑**

**不懂编程的请移步[Release](https://github.com/LC044/WeChatMsg/releases)，下面的东西看了可能要长脑子啦🐶**

## PC版微信

### 1. 安装

```shell
# Python>=3.10
git clone https://github.com/LC044/WeChatMsg
cd WeChatMsg
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```

### 2. 使用

1. 登录微信

手机端使用聊天记录迁移功能将聊天数据迁移到电脑上

操作步骤：
- 安卓： 手机微信->我->设置->聊天->聊天记录迁移与备份->迁移-> 迁移到电脑微信（迁移完成后重启微信）[否则](https://github.com/LC044/WeChatMsg/issues/27)
- iOS： 手机微信->我->设置->通用->聊天记录迁移与备份->迁移-> 迁移到电脑微信（迁移完成后重启微信）[否则](https://github.com/LC044/WeChatMsg/issues/27)

2. 运行程序

```shell
python main.py
```

3. 点击获取信息

![](./doc/images/pc_decrypt_info.png)

4. 设置微信安装路径(如果自动设置好了就**不用管**了)

可以到微信->设置->文件管理查看

![](./doc/images/setting.png)

点击**设置微信路径**按钮，选择该文件夹路径下的带有wxid_xxx的路径(没有wxid的话先选择其中一个文件夹不对的话换其他文件夹)

![](./doc/images/path_select.png)

5. 获取到key和微信路径之后点击开始启动
6. 数据库文件保存在./app/DataBase/Msg路径下

### 3. 查看

随便下载一个SQLite数据库查看软件就能打开数据库，例如[DB Browser for SQLite](https://sqlitebrowser.org/dl/)
（不懂SQL的稍微学下SQL咱再来，或者自动跳过该步骤直接往下看最终效果）

* [数据库功能介绍](./doc/数据库介绍.md)
* [更多功能介绍](./doc/电脑端使用教程.md)

显示效果

### 4. pc端功能展示

#### 4.1 最上方导航栏

可以点击获取教程，相关信息，导出全部信息的csv文件。

![](./doc/images/main_window.png)

#### 4.2 聊天界面

点击**左侧导航栏——>聊天**
，会随机跳转到某一个好友的界面，滚轮滚动，可以向上翻看更早的聊天记录。目前聊天记录中文字、图片基本可以正常显示~

![](./doc/images/chat_window1.png)

当你想要查找某一位好友的信息时，可以在图中红框输入信息，点击Enter回车键，进行检索

![](./doc/images/chat_window2.png)

#### 4.3 好友界面

点击**左侧导航栏——>好友**，会跳转到好友的界面，同样可以选择好友，右上方导航栏中有（1）统计信息（2）情感分析（3）年度报告（4）退出（5）导出聊天记录：可选择导出为word、csv、html、txt格式。

![](./doc/images/contact_window.png)

**功能部分未集成或开发，请您耐心等待呀~**

</details>

## PC端使用过程中部分问题解决（可参考）

#### 🤔如果您在pc端使用的时候出现问题，可以先参考以下方面，如果仍未解决，可以在群里交流~

* 不支持Win7(可自行下载代码构建可执行程序)
* 不支持Mac(未来或许会实现)
* 遇到问题四大法宝
  * 重启微信
  * 重启exe程序
  * 重启电脑
  * 换电脑

如果您遇到下图所示的问题，是由于没有在电脑端登录微信

![](./doc/images/login_wx.png)

如果您在运行可执行程序的时候出现闪退的现象，请右击软件使用管理员权限运行。

![](./doc/images/exe_file.png)

如果您在获取信息的时候，`wxid`
显示none，但是key是存在的，需要在微信文件保存的路径中选择该文件夹路径下的带有wxid_xxx的名字，填到wxid位置并继续点击`开始启动`

![](./doc/images/with_wxid_name.png)

如果出现如图所示的报错信息，将`app/database/msg`文件夹删除，重新运行`main.py`。

![](./doc/images/err_log.png)

导出数据成功之后，该文件位置与exe文件位置相同（或者在源码.data文件下）

![](./doc/images/message.png)

</details>

# 🏆致谢

* PC微信工具:[https://github.com/xaoyaoo/PyWxDump](https://github.com/xaoyaoo/PyWxDump)
* PyQt组件库:[https://github.com/PyQt5/CustomWidgets](https://github.com/PyQt5/CustomWidgets)
* 我的得力助手:[ChatGPT](https://chat.openai.com/)

---
> \[!IMPORTANT]
> 
> 声明：该项目有且仅有一个目的：“留痕”——我的数据我做主，前提是“我的数据”其次才是“我做主”，禁止任何人以任何形式将其用于任何非法用途，对于使用该程序所造成的任何后果，所有创作者不承担任何责任🙄<br>
> 该软件不会对您使用的微信造成任何影响，更不会对他人的微信造成任何影响，不能找回删除的聊天记录，任何企图篡改微信聊天数据的想法都是无稽之谈。本项目所有功能均建立在”前言“的基础之上，基于该项目的所有开发者均不能接受任何有悖于”前言“的功能需求，违者后果自负。
> <br>该软件不存在任何收费，谨防上当受骗
> <br>软件贩子勿扰，违规违法勿扰，二次开发请务必遵守开源协议

[![Star History Chart](https://api.star-history.com/svg?repos=LC044/WeChatMsg&type=Date)](https://star-history.com/?utm_source=bestxtools.com#LC044/WeChatMsg&Date)

# 贡献者

# 支持该项目

感谢您对这个项目的兴趣和支持！如果您发现这个项目对您有帮助，并且您愿意提供赞助以维持项目的发展和改进，我将非常感激。

## 赞助方式

您可以通过以下方式提供赞助：

- [爱发电](https://afdian.net/a/lc044)
- [博客主页](https://blog.lc044.love/about)

## 赞助者名单

感谢以下赞助者的慷慨支持：

- [STDquantum](https://github.com/STDquantum)
- [xuanli](https://github.com/xuanli)
- [无名路人](https://github.com/wumingluren)

如果您提供赞助并希望出现在赞助者名单中，请在提交赞助时提供您的 GitHub 用户名或其他相关信息。

您也可以在赞助时备注您的诉求，我将提前开发合理的功能需求。

## 感谢

再次感谢您的支持，这对项目的持续发展至关重要！

# 🎄温馨提示

如果您在使用该软件的过程中

* 发现新的bug
* 有新的功能诉求
* 操作比较繁琐
* 觉得UI不够美观
* 等其他给您造成困扰的地方

请提起[issue](https://github.com/LC044/WeChatMsg/issues)，我将尽快为您解决问题

如果您是一名开发者，有新的想法或建议，欢迎[fork](https://github.com/LC044/WeChatMsg/forks)
该项目并发起[PR](https://github.com/LC044/WeChatMsg/pulls)，我将把您的名字写入贡献者名单中

# 联系方式

如果您遇到了问题，可以添加QQ群寻求帮助，由于精力有限，不能回答所有问题，所以还请您仔细阅读文档之后再考虑是否入群

## 加群方式

1. 关注官方公众号，回复：联系方式
2. QQ扫码入群

后续更新将会在公众号同步发布
<div>
  <img src="./doc/images/weixin.png">
  <img src="./doc/images/qq1.jpg" height="200">
</div>

## AI交流

欢迎对“前言”中AI感兴趣的加入QQ群（不负责任何答疑），让我们一起探讨新技术，钻研新方案，将科技的力量融入生活，打造出一个真正具有情感的个人AI

# License

WeChatMsg is licensed under [GPLv3](./LICENSE).

阿阿乔/WeChatMsg

简介

发行版

贡献者

近期动态

阿阿乔/WeChatMsg .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

阿阿乔/WeChatMsg