# chat2wordcloud

**Repository Path**: Hilbert777/chat2wordcloud

## Basic Information

- **Project Name**: chat2wordcloud
- **Description**: A batch processing QQ chat log analysis of high-frequency words and generate word cloud tools
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-26
- **Last Updated**: 2026-02-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Chat2WordCloud 聊天记录词云生成器

这是一个简单好用的工具，可以把你的 QQ 聊天记录导出文件转换成词云图片，并统计群里的"大水怪"。

**声明**：无论使用何种提取 QQ 聊天记录的工具都有账号安全、隐私泄露和财产损失等风险，本项目对此概不负责。

## 准备工作

### 第一步：安装 Python
1.  访问 Python 官网下载页面：[https://www.python.org/downloads/](https://www.python.org/downloads/)
2.  下载最新版本的 Python (推荐 3.10 及以上版本)。
3.  在安装界面下方，**务必勾选 "Add Python to PATH" (将 Python 添加到环境变量)**。
4.  点击 "Install Now" 完成安装。

### 第二步：下载本项目
1.  点击页面右上角的 "Code" -> "Download ZIP" 下载本项目压缩包。
2.  解压到你喜欢的文件夹。

### 第三步：导出聊天记录

通过[qq-chat-exporter](https://github.com/shuakami/qq-chat-exporter)项目导出 QQ 聊天记录，该项目具体使用方法和注意事项请参考该项目的文档和README。也可以选择其他提取 QQ 聊天记录的工具。

本项目中内置了 qq-chat-exporter 的最新Windows版本，可以在 NapCat-QCE-Windows-x64 文件夹中运行 `launcher-user.bat`

**再次声明**：qq-chat-exporter 需要登陆 QQ 账户导出聊天记录，有一定风险。用户使用本项目默认自行承担风险，本项目开发者和 qq-chat-exporter 对用户自身的账号安全和隐私不负任何责任。

## 安装依赖库

为了让程序运行，我们需要安装一些必要的工具包。
我已经为你准备好了一键安装脚本。

1.  打开项目文件夹。
2.  双击运行 ``install_requirements.bat`。
3.  等待黑色窗口中出现 "安装完成" 或 "Successfully installed" 字样。

> **手动安装命令**：
> 如果脚本运行失败，你也可以打开终端，输入以下命令手动安装：
> `pip install pandas jieba wordcloud matplotlib imageio openpyxl -i https://pypi.tuna.tsinghua.edu.cn/simple`

## 开始使用

### 第一步：放入聊天记录
1.  在项目文件夹中找到 `source` 文件夹。
2.  将你导出的 Excel 聊天记录文件（.xls 或 .xlsx）放入该文件夹。

### 第二步：配置停用词（可选）
1.  打开 `stopwords.txt` 文件。
2.  你可以在这里添加你不想统计的词

### 第三步：生成词云
1.  双击运行 `run_chat2wordcloud.bat`。
2.  程序会自动读取 `source` 文件夹下的所有 Excel 文件。
3.  处理完成后，黑色窗口会提示 "任务处理完成"。

## 查看结果

打开 `result` 文件夹，你将看到：
*   **生成的词云图片**：(.png) - 展示群里大家最爱说的 30 个词。
*   **活跃成员统计图**：(.png) - 看看谁是群里的大水怪。
*   **高频词统计表**：(.txt) - 详细的词频排名数据。

---