JokerDetector

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 12 Open GitHub ↗

The joker detector project

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🃏 Joker Detector Pro - 聊天记录小丑检测器

> 工程学导论课程项目 | 用算法 + AI 双维度分析你的聊天模式，量化"小丑指数"

![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)
![License](https://img.shields.io/badge/License-MIT-green.svg)
![Status](https://img.shields.io/badge/Status-Fun%20%26%20WIP-orange.svg)

---

## 📖 项目简介

你是不是在感情中付出太多却得不到回应？你是不是那个永远在主动的"小丑"？

**Joker Detector Pro** 是一款专为工程学导论课程设计的聊天记录分析工具。它能够：
- 📊 从微信聊天记录 Excel 文件中提取数据
- 🧮 使用多维度算法量化你的"小丑指数"
- 🤖 结合 AI 大模型进行情感关系深度分析
- 💌 生成个性化情感疏导建议
- 🎮 提供"恋爱冷静期"干预弹窗

> ⚠️ 本项目仅供课程学习和娱乐目的，请勿用于实际情感决策。

---

## ✨ 核心功能

### 1. 数据解析与统计
| 统计维度 | 说明 |
|---------|------|
| 消息数量 | 统计双方消息总数，计算发送比例 |
| 表情包数量 | 检测 `[emoji]` 格式表情 |
| 图片数量 | 检测 `[图片]` 标记 |
| 连续消息数 | 分析消息连续发送的最大 streak |
| 语音/通话记录 | 检测通话行为并施加惩罚系数 |

### 2. 算法评估系统
采用五维度比率综合评分：

```
r1 = 自己的消息数 / 对方消息数
r2 = 自己的表情包数 / 对方表情包数
r3 = 自己的最大连续消息数 / 对方的最大连续消息数
r4 = 自己的总字数 / 对方总字数
r5 = 自己的图片数 / 对方的图片数

jokernum_alg = (r1 + r2 + r3 + r4 + r5) / 5
```

### 3. AI 双重评估
- **小丑指数 AI**：调用大模型分析对话内容，给出 0-1 的小丑评分
- **最终指数** = 算法评分 × AI 评分

### 4. 情感人格类型 (MBTI 风格)

```
dim1: I/P - 主动发起型 / 被动回应型
dim2: E/R - 表达丰富型 / 含蓄克制型
dim3: D/S - 深度表达型 / 浅层交流型
dim4: T/F - 执着纠缠型 / 随性洒脱型
```

典型组合示例：
- 🃏 **IEDT** → 『深情表演家』
- 🃏 **IRDF** → 『沉默的守望者』
- 🃏 **PESF** → 『气氛组选手』

### 5. 情感疏导 AI
基于聊天记录生成 200-300 字的温柔情感疏导，包含：
1. 情绪安抚与认可
2. 问题分析与指出
3. 2-3 条可执行建议

### 6. 恋爱冷静期弹窗 🆕
当检测到高风险小丑行为时，触发全屏红色警告：
- 要求用户输入"我不是小丑" 5 次
- 每次输入错误都会弹出"错误"提示
- 冷静成功后解除警告

---

## 🚀 快速开始

### 环境要求
- Python 3.8+
- pandas
- openai
- httpx
- tkinter (Python 内置)

### 安装依赖

```bash
pip install pandas openai httpx
```

### 使用步骤

#### 准备聊天记录
1. 在微信电脑端打开目标聊天
2. 设置 → 导出聊天记录 → 选择 Excel 格式
3. 保存为 `chat.xlsx`

#### 运行分析

```bash
python final_v1.py
```

程序会提示：
```
请输入 Excel 文件路径（例如：chat.xlsx）：
请输入你是哪一个（0 或 1）：
```

#### 冷静期弹窗（可选）

```bash
python jokerTset.py
```

---

## 📁 项目结构

```
📦 project/
├── 📄 final_v1.py          # 主程序：Joker Detector Pro
├── 📄 jokerTset.py         # 冷静期弹窗模块
├── 📄 README.md            # 项目说明文档
└── 📄 requirements.txt     # 依赖列表
```

---

## 🎯 判定标准

| jokernum 范围 | 判定结果 | 含义 |
|-------------|---------|------|
| > 2.0 | 🤡 确诊纯小丑 | 情感投入严重失衡，请立即清醒！ |
| 1.0 ~ 2.0 | 😬 高度疑似小丑 | 比对方主动太多，存在自我感动风险 |
| 0.5 ~ 1.0 | 😐 轻度小丑倾向 | 偶尔失衡，但总体可控 |
| 0.2 ~ 0.5 | 🙂 健康社交模式 | 关系基本对等，继续保持 |
| < 0.2 | 😎 绝对理性人 | 可能是这段关系里的冰冷主宰 |

---

## ⚙️ 配置说明

### AI API 配置

编辑 `final_v1.py` 中的配置项：

```python
API_KEY = "your-api-key-here"      # 填入你的 API Key
BASE_URL = "https://api.example.com"  # API 地址
MODEL = "gpt-4"                     # 使用的模型
```

> 💡 如果未配置 API_KEY，程序将仅使用算法评估，跳过 AI 功能。

---

## 🎓 课程学习收获

通过本项目，我们学习并实践了：

- ✅ **数据结构**：列表、元组、字典的操作
- ✅ **文件 I/O**：Excel 文件读取 (pandas)
- ✅ **网络请求**：HTTP 客户端调用 AI API
- ✅ **GUI 编程**：Tkinter 窗口与事件处理
- ✅ **算法设计**：多维度评分体系构建
- ✅ **用户体验**：交互式 CLI 程序设计

---

## 📝 示例输出

```
============================================================
                     📊 聊天统计结果
============================================================
小明（自己）消息数: 156 | 小红（对方）消息数: 89
小明（自己）表情包数: 42 | 小红（对方）表情包数: 15
小明（自己）图片数: 23 | 小红（对方）图片数: 8
小明（自己）最大连续消息: 12 | 小红（对方）最大连续消息: 3
小明（自己）总字数: 4521 | 小红（对方）总字数: 1876
语音/通话: 自己 2 次, 对方 0 次

🧮 算法评分 (jokernum_alg): 1.8423
🤖 AI 评分：0.7800
🌟 最终 jokernum (算法 × AI): 1.4370

🔍 小丑判定结果：😬 高度疑似小丑 —— 你比对方主动太多，存在自我感动风险。

============================================================
              🃏 你的情感人格类型：IEDT
============================================================
💬 主动发起型 | 🎨 表达丰富型 | 📝 深度表达型 | 🔗 执着纠缠型

📌 情感投入核心问题：
  • 你在对话中属于主动发起方，掌握话语权但也容易过度投入。
  • 你热衷发表情/图片，情感外放。
  • 你习惯于长篇大论，追求深度沟通。
  • 你有执着纠缠的倾向，容易忽略对方边界。

✨ 针对性建议：
  ▶ 偶尔把话题抛给对方，观察 Ta 的反应，避免独角戏。
  ▶ 注意对方是否同频，避免热情泼在冰面上。
  ▶ 把长文拆成短句，给对方插话的空间。
  ▶ 紧追不舍不如以退为进，神秘感也是一种吸引。

🎭 典型画像：『深情表演家』—— 用尽全力展示爱，小心只是感动了自己。

============================================================
                   💌 AI 情感疏导
============================================================
[AI 生成的温柔疏导文本...]
============================================================
```

---

## 🤝 贡献与反馈

欢迎提交 Issue 或 Pull Request！

---

## 📜 许可证

本项目仅用于课程学习交流，如有不妥请联系删除。

---

**Made with ❤️ for Engineering 101 Course**

*小丑指数仅供参考，感情问题还需真诚沟通*

</div>
>

JokerDetector

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README