# AI直播助手

**Repository Path**: ignoreall/AITools

## Basic Information

- **Project Name**: AI直播助手
- **Description**: https://reallcode.feishu.cn/docx/L9ILdkfiooc5LIxRSrKcHe7UnPd
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-03-29
- **Last Updated**: 2025-04-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 视频号直播监听助手

这是一个用于监听视频号直播评论并使用 AI 自动回复的桌面应用程序。

## 功能特点

- 连接视频号直播 WebSocket 服务，实时接收评论
- 使用 AI 分析评论并生成回复
- 文本转语音功能，将 AI 回复转换为语音
- 预设脚本管理，可以保存和使用常用回复
- 音频播放控制，支持播放、暂停、停止等操作

## 技术栈

- Python 3.8+
- PyQt5 用于 GUI 界面
- WebSocket 用于连接直播服务
- AI 服务用于生成回复
- 文本转语音服务用于生成语音

## 安装与运行

### 安装依赖

```bash
pip install -r requirements.txt
```

### 运行应用程序

```bash
# 安装依赖
pip install -r requirements.txt

# 运行应用程序
python main.py

# 仅运行GUI界面（用于测试和展示）
python run_gui.py
```

## 项目结构

```
tools-pc2/
├── app/                    # 应用程序代码
│   ├── config/             # 配置文件
│   ├── controllers/        # 控制器
│   ├── models/             # 数据模型
│   ├── services/           # 服务接口和实现
│   ├── ui/                 # 用户界面
│   │   ├── components/     # UI 组件
│   │   ├── windows/        # 窗口类
│   │   └── theme.py        # 主题定义
│   └── utils/              # 工具类
├── data/                   # 数据文件
├── logs/                   # 日志文件
├── output/                 # 输出文件
│   └── speech/             # 语音输出
├── resources/              # 资源文件
├── main.py                 # 主程序入口
├── run_gui.py              # GUI测试入口
├── setup_and_run.bat       # Windows运行脚本
├── setup_and_run.sh        # Linux/macOS运行脚本
└── README.md               # 项目说明
```

## 使用说明

1. 启动应用程序
2. 在连接控制面板输入 WebSocket URL 并点击连接
3. 连接成功后，评论列表将显示实时评论
4. 选择评论后，AI 将自动生成回复
5. 点击"朗读回复"按钮将回复转换为语音
6. 使用音频控制面板控制语音播放

## 重构版本说明

最近对项目进行了代码重构，主要改进如下：

### 设计模式

重构版本采用了MVC（模型-视图-控制器）设计模式：

- **模型（Model）**：负责数据管理和业务逻辑
- **视图（View）**：负责用户界面的显示
- **控制器（Controller）**：负责处理用户输入和更新模型

### 组件说明

#### 窗口组件

- **MainWindow**：主窗口框架，包含选项卡切换
- **ControlPanel**：中控面板，组合各个功能组件
- **ConfigPanel**：配置面板，包含各种配置选项

#### UI组件

- **StatusBar**：状态栏，显示各种状态信息
- **UserPanel**：用户面板，显示用户互动和用户进入信息
- **ContentPanel**：中央内容区域，包含插播音频和音画同步标签页
- **PlaylistPanel**：播放队列，显示待播放内容
- **LogPanel**：日志面板，显示播放日志和AI回复日志

### 运行重构版本

```bash
# 确保安装了所需依赖
pip install PyQt5

# 运行重构版本
python run_app.py
```

## 许可证

MIT