# wecom-ai

**Repository Path**: luckythc/wecom-ai

## Basic Information

- **Project Name**: wecom-ai
- **Description**: 企微客服机器人
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-12
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 企业微信AI客服平台

## 项目简介

企业微信AI客服平台是一个基于Node.js和Vue.js开发的智能客服系统，集成了企业微信客服功能和AI对话能力，为企业提供智能、高效的客户服务解决方案。

## 核心功能

- **企业管理**：管理企业信息和配置
- **客服账号管理**：创建和管理企业微信客服账号
- **角色管理**：创建和管理客服角色，支持AI生成角色
- **知识库管理**：管理企业知识库条目
- **技能管理**：管理客服技能
- **企业微信回调**：处理企业微信消息回调，支持消息加密解密
- **AI对话**：基于企业配置的AI平台进行智能对话

## 技术栈

- **后端**：Node.js, Express, Sequelize (SQLite)
- **前端**：Vue.js, Bootstrap 5
- **企业微信API**：企业微信客服接口
- **AI接口**：支持多种AI平台接口

## 安装部署

### 环境要求

- Node.js 14+
- npm 6+

### 安装步骤

1. **克隆项目**

```bash
git clone <repository-url>
cd <project-directory>
```

2. **安装依赖**

```bash
npm install
```

3. **启动服务器**

```bash
node index.js
```

4. **访问系统**

打开浏览器访问：`http://localhost:3000`

## 项目结构

```
.
├── index.js                 # 应用入口文件
├── src/
│   ├── models/              # 数据模型
│   │   ├── Enterprise.js    # 企业模型
│   │   ├── ServiceAccount.js # 客服账号模型
│   │   ├── Role.js          # 角色模型
│   │   ├── KnowledgeBase.js # 知识库模型
│   │   └── Skill.js         # 技能模型
│   ├── services/            # 服务层
│   │   ├── wecomService.js  # 企业微信服务
│   │   ├── wecomKfService.js # 企业微信客服服务
│   │   ├── aiProxyService.js # AI代理服务
│   │   └── fileService.js   # 文件服务
│   └── routes/              # 路由
│       └── api.js           # API路由
├── public/                  # 前端静态文件
│   ├── index.html           # 前端入口页面
│   ├── css/                 # CSS文件
│   ├── js/                  # JavaScript文件
│   └── lib/                 # 第三方库
├── package.json             # 项目配置
└── .gitignore               # Git忽略文件
```

## API接口

### 企业管理

- `GET /api/enterprise` - 获取企业列表
- `POST /api/enterprise` - 添加企业
- `PUT /api/enterprise/:id` - 更新企业
- `DELETE /api/enterprise/:id` - 删除企业
- `POST /api/enterprise/:id/sync-wecom` - 同步企业微信客服账号

### 客服账号管理

- `GET /api/service-account` - 获取客服账号列表
- `POST /api/service-account` - 添加客服账号
- `PUT /api/service-account/:id` - 更新客服账号
- `DELETE /api/service-account/:id` - 删除客服账号
- `POST /api/service-account/:id/sync-wecom` - 同步到企业微信
- `GET /api/service-account/:id/qr-code` - 获取客服账号二维码

### 角色管理

- `GET /api/role` - 获取角色列表
- `POST /api/role` - 添加角色
- `PUT /api/role/:id` - 更新角色
- `DELETE /api/role/:id` - 删除角色
- `POST /api/role/generate` - AI生成角色

### 知识库管理

- `GET /api/knowledge-base` - 获取知识库列表
- `POST /api/knowledge-base` - 添加知识库条目
- `PUT /api/knowledge-base/:id` - 更新知识库条目
- `DELETE /api/knowledge-base/:id` - 删除知识库条目

### 技能管理

- `GET /api/skill` - 获取技能列表
- `POST /api/skill` - 添加技能
- `PUT /api/skill/:id` - 更新技能
- `DELETE /api/skill/:id` - 删除技能

### 企业微信回调

- `POST /wecom/callback` - 企业微信消息回调接口

## 企业微信配置

1. **在企业微信管理后台创建应用**
2. **获取CorpID、AgentID、AgentSecret**
3. **配置回调URL**：`http://your-server.com/wecom/callback`
4. **设置Token和EncodingAESKey**
5. **在系统中添加企业信息**，填写上述配置

## AI平台配置

在添加企业时，可以配置AI平台接口参数：

- **接入端点**：AI平台API地址
- **API密钥**：AI平台API密钥
- **模型名称**：使用的AI模型名称
- **模型Schema配置**：模型配置参数

## 注意事项

1. 确保服务器可以被企业微信服务器访问
2. 配置正确的Token和EncodingAESKey
3. 确保AI平台接口配置正确
4. 定期备份数据库

## 许可证

MIT License

## 联系方式

如有问题，请联系：
- 邮箱：contact@example.com
- 电话：12345678900