# vx-chat-ai

**Repository Path**: fhboss/vx-chat-ai

## Basic Information

- **Project Name**: vx-chat-ai
- **Description**: 微信公众号私人AI助手
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-11-15
- **Last Updated**: 2025-11-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VX-AI-Chat

## 项目介绍
VX-AI-Chat 是一个基于微信公众号的智能AI助手系统，支持知识库构建和智能问答。通过简单的配置，您可以快速搭建自己的专属AI助手，实现智能对话、知识检索等功能。

## 功能特性
- 🤖 智能对话：基于大语言模型的智能对话系统
- 📚 知识库管理：支持自定义知识库的构建和管理
- 🔍 RAG增强：检索增强生成，提供更准确的回答
- 📁 文件处理：支持多种格式文件的上传和处理
- 💬 微信集成：无缝对接微信公众号，提供便捷的交互界面

## 技术栈
- 🚀 Java 21
- ⚡ Spring Boot 3.2.0
- 📊 MyBatis-Plus 3.5.10.1
- 🗄️ MySQL 8.1
- 🗄️ Milvus 2.5.3
- 🤖 LangChain4j 1.0.0-beta2
- 🔄 MapStruct 1.5.5.Final
- 🛠️ Lombok 1.18.38
- 📱 WxJava 4.7.0


## 项目结构
```
vx-ai-chat/
├── vx-ai-chat-common/    # 公共模块
├── vx-ai-chat-start/     # 启动模块
├── vx-ai-chat-rag/       # RAG检索增强模块
├── vx-ai-chat-file/      # 文件处理模块
└── vx-ai-chat-wechat/    # 微信相关模块
└── vx-ai-chat-third/     # 其他第三方服务
└── vx-ai-chat-web/       # web服务
```


## 快速开始

### 环境要求
- JDK 21+
- Maven 3.8+
- MySQL 8.0+


### 配置步骤
1. 克隆项目
```bash
git clone https://gitee.com/sqdpt/vx-chat-ai.git
```

2. 配置数据库
- 创建MySQL数据库
- 修改 `application-xxx.yml` 中的数据库配置

3. 配置微信公众号
- 在微信公众平台注册测试号
- 配置服务器地址和Token
- 修改 `application-xxx.yml` 中的相关配置

4. 启动项目
```bash
mvn clean package
java -jar vx-ai-chat-start/target/vx-ai-chat-start.jar
```

## 配置说明
主要配置文件位于各模块的 `resources` 目录下：
- `application.yml`: 主配置文件
- `application-dev.yml`: 开发环境配置
- `application-prod.yml`: 生产环境配置

## 开发指南
1. 模块说明
   - `vx-ai-chat-common`: 包含公共工具类、通用配置等
   - `vx-ai-chat-start`: 应用程序入口，包含主配置
   - `vx-ai-chat-rag`: RAG相关功能实现
   - `vx-ai-chat-file`: 文件处理相关功能
   - `vx-ai-chat-wechat`: 微信公众号相关功能


## 贡献指南
1. Fork 本仓库
2. 创建新的功能分支
3. 提交代码
4. 创建 Pull Request

## 许可证
本项目采用 [Apache License 2.0](LICENSE) 许可证


## 联系方式
如有问题或建议，欢迎提交 Issue 或 Pull Request