# agent-system

**Repository Path**: rocheryu/agent-system

## Basic Information

- **Project Name**: agent-system
- **Description**: 111
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-09-26
- **Last Updated**: 2025-09-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent Communication System

一个支持多角色协作通信的前后端系统，适用于侦查员、分析员、决策员、执行员四类角色之间的信息交换。

## 项目结构

```
agent-system/
├── frontend/       # Vue前端项目
├── backend/        # Python后端项目
└── README.md       # 项目说明文档
```

## 后端设置

### 安装依赖

```bash
# 进入后端目录
cd backend

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

### 运行后端服务

```bash
# 运行Flask服务器
python app.py

# 服务器将在 http://localhost:5000 启动
```

### 默认用户

系统初始化时会自动创建4个默认用户，密码均为 `password`：

- scout1（侦查员）
- analyst1（分析员）
- decision_maker1（决策员）
- executor1（执行员）

## 前端设置

### 安装依赖

```bash
# 进入前端目录
cd frontend

# 安装依赖
npm install
```

### 运行开发服务器

```bash
# 启动Vue开发服务器
npm run dev

# 服务器将在 http://localhost:3000 启动
```

### 构建生产版本

```bash
# 构建前端项目
npm run build

# 预览生产版本
npm run preview
```

## 系统功能

1. **用户认证**：支持登录和身份验证
2. **消息管理**：发送、接收、查看、标记已读消息
3. **角色区分**：根据用户角色提供不同的功能体验
4. **消息状态**：显示消息已读/未读状态
5. **搜索筛选**：支持消息搜索和类型筛选
6. **消息转发**：支持消息转发功能

## API接口

后端提供以下主要API接口：

- POST /api/login - 用户登录
- GET /api/users - 获取用户列表
- GET /api/users/:id - 获取单个用户信息
- POST /api/messages - 发送消息
- GET /api/messages/:id - 获取用户消息列表
- PUT /api/messages/:id/read - 标记消息为已读
- PUT /api/messages/batch/read - 批量标记消息为已读
- GET /api/messages/:id/unread - 获取未读消息数量
- POST /api/messages/:id/forward - 转发消息
- DELETE /api/messages/:id - 删除消息
- GET /api/system/status - 获取系统状态

## 技术栈

- **前端**：Vue 3、Element Plus、Vue Router、Axios
- **后端**：Flask、Flask-SQLAlchemy、SQLite
- **开发工具**：Vite、VS Code

## 注意事项

1. 开发环境下，后端服务运行在5000端口，前端运行在3000端口
2. 系统使用SQLite数据库，数据存储在backend目录下的agents.db文件中
3. 密码使用SHA-256哈希存储，确保安全性
4. 跨域请求已通过Flask-CORS配置允许

## 开发建议

1. 实际生产环境中，建议更换SECRET_KEY为更安全的随机字符串
2. 考虑添加HTTPS支持以增强安全性
3. 可以扩展用户权限系统，实现更精细的访问控制
4. 对于大数据量场景，建议优化数据库查询性能或考虑使用更强大的数据库系统