# mineWechat

**Repository Path**: cdfmlr/mineWechat

## Basic Information

- **Project Name**: mineWechat
- **Description**: 一个简单的微信桌面GUI客户端
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-03-02
- **Last Updated**: 2022-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mineWeChat
```python
mineWeChat = itchat * tkinter * chatterbot;	# 一个简单的可视化微信桌面客户端
```
**mineWeChat** 是一个可以运行在`Mac OS`、`Linux`，甚至是`Microsoft Windows`上的微信客户端。我们采用了 ~`Python 3.7`~ 来实现这个客户端，并主要选取了以下库：
* 微信API：[ItChat](https://github.com/littlecodersh/ItChat)
* GUI：[tkinter](https://docs.python.org/3/library/tkinter.html)
* 自动回复：[ChatterBot](https://github.com/gunthercox/ChatterBot)

与原生客户端相比，该客户端实现了一部分拓展功能，但也有很多欠缺：
* 拓展：
	* 机器人自动回复
	* 消息刷屏
	* 查看好友信息词云
	* 查看微信好友性别比例

* 欠缺：
	* 暂时无法显示 PICTURE, RECORDING, ATTACHMENT, VIDEO, FRIENDS, VOICE 等种类的消息
	* 输入框暂时无法直接输入中文与emoji表情（但可以粘贴与发送中文文本）
	* 暂不支持群聊、公众号消息的接收

## Installation
1. **准备**
在使用mineWeChat前，应该先检查您的`python 3.x`环境与第三方库是否配置完全：
```bash
$ pip3 install chatterbot
$ pip3 install jieba
$ pip3 install itchat
$ pip3 install matplotlib
$ pip3 install numpy
$ pip3 install echarts-python
$ pip3 install Pillow
$ pip3 install requests
$ pip3 install wordcloud
```

2. **拷贝文件**
将该项目Clone or download到您的计算机；
或者，也可以[点击此处下载](htt)我们打包好的压缩文件，并解压缩到一个您记得住的位置 : )

3. **进入您Clone或解压得到的目录**
```bash
$ cd ~/mineWeChat/V0.0.0/
$ ls
LICENSE       font          mineWeChat.py
README.md     img           res
```

4. **运行`mineWeChat.py`**
```bash
$ python3 mineWeChat.py
```
然后按照图形界面中的提示完成登陆即可。

## 关于自动回复
mineWeChat提供了自动回复功能，这意味着您可以在与某些朋友的聊天页中勾选启用这个功能，这时若这些朋友发送消息给你（用中文或者英文），由chatterbot驱动的聊天机器人将自动回复他们。

mineWeChat的自动回复功能支持通过对方发送指定消息来关闭，这个消息默认是`[Q]`，当您开启了自动回复后，当您的朋友发送这个关闭消息时，自动回复功能就会得以关闭（或您自己从手机端发送）。
当然，如您所愿，这个关闭消息是可以定制的。如果您需要这么做，只需在`mineWeChat.py`所在的目录中添加一个名为`chatbot_quit.txt`的文件，然后把您喜欢的任意个‘退出指令’短语写入其中，一行一个，例如：
```bash
$ ls
LICENSE       font          mineWeChat.py
README.md     img           res
$ cat > chatbot_quit.txt
退出机器人
关闭自动回复
exit robot
$ # 这时，当您在此使用mineWeChat的机器人自动回复功能时，您的朋友给你发来“退出机器人”的消息时，自动回复功能将会关闭。
$ # 值得一提的时，当chatbot_quit.txt文件存在时，默认的`[Q]`指令将变得无效！哪怕您的chatbot_quit.txt为空（这样的话您的朋友将无法通过发送消息关闭您对他/她/它的自动回复）
```

注意，**自动回复的打开只能从mineWeChat界面中勾选“☑️机器人自动回复”**，暂不支持通过发送指定消息打开。

若您了解`chatterbot`，完全可以训练一个自己的机器人来代替默认的这个被我们称为“Little Zero”的ChatBot。
我们的 Little Zero 的 storage_adapter 采用的是'chatterbot.storage.SQLStorageAdapter'，您可以用您训练好的database替换`./res/chatbot_database.sqlite3`。

## 问题和建议
如果您有任何意见反馈，都可以在这个项目的GitHub上开issue与我们讨论，无论如何，我们都将感谢您的宝贵支持。🙏