# 微信群聊日报生成器

`微信` `日报生成` `AI摘要` `群聊分析` `可视化报告`

# 微信群聊日报生成工具

这是一个用于分析微信群聊天记录，结合 AI 生成内容，并最终输出为精美手机端长图（PNG）的工具。

## ✨ 功能特点

- **数据统计**：自动分析群聊记录，生成话唠榜、熬夜冠军、词云统计等数据。
- **AI 智能摘要**：利用 AI 识别讨论热点、提取有价值的资源/教程、捕捉有趣对话和问答。
- **可视化报告**：基于 HTML/CSS 模板渲染，自动生成适配手机屏幕（iPhone 14 Pro Max 分辨率）的日报图片。
- **风格化**：支持幽默、玩梗的报告风格，提升阅读乐趣。

## 🛠️ 依赖环境

- Python 3.8+
- Node.js（可选，仅用于开发调试模板）

### Python 库安装

```bash
pip install jieba jinja2 playwright
playwright install chromium
```

## 🚀 使用流程

### 第一步：安装技能

**自动安装（推荐）**：
```bash
npx skills add https://github.com/ADVISORYDZ/wechat-daily-report-skill
```

**手动安装**：
克隆本仓库到您的 Claude Skills 目录（如果目录不存在请先创建）：

```bash
cd ~/.claude/skills/
git clone https://github.com/ADVISORYDZ/wechat-daily-report-skill.git
```

### 第二步：获取聊天记录

使用 [WeFlow](https://github.com/hicccc77/WeFlow) 工具导出您想要分析的微信群聊天记录，选择 **ChatLab** 格式导出。

### 第三步：基本使用

在 Claude Code 中直接对 Claude 下达指令：

> **"生成 [群名称] 今日日报"**

Claude 将自动调用本项目中的脚本，分析聊天记录并渲染出精美的日报长图。

---

## 🛠️ 详细步骤（内部逻辑）

## 📂 数据格式

### 输入聊天记录 JSON 结构

```json
{
  "meta": {
    "name": "群名称",
    "platform": "wechat",
    "type": "group"
  },
  "members": [
    {"platformId": "wxid_xxxx", "accountName": "用户A"}
  ],
  "messages": [
    {
      "sender": "wxid_xxxx",
      "accountName": "用户A",
      "timestamp": 1700000000,
      "type": 0,
      "content": "消息内容"
    }
  ]
}
```
*注：目前仅支持分析 `type: 0`（文本消息）。*

## 📁 项目结构

- `scripts/`：核心 Python 脚本
    - `analyze_chat.py`：数据清洗与统计
    - `generate_report.py`：模板渲染与图片生成
- `assets/`：资源文件
    - `report_template.html`：Jinja2 报告模板
- `references/`：参考文档
    - `ai_prompt.md`：AI 提示词模板
- `SKILL.md`：技能详细说明

## 📝 许可证

MIT