# crowdsensing

**Repository Path**: little_alone/crowdsensing

## Basic Information

- **Project Name**: crowdsensing
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 2
- **Created**: 2025-12-02
- **Last Updated**: 2025-12-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

README.md文件内容如下：

# 多智能体围捕系统

## 项目介绍
多智能体围捕系统成功实现了智能体协同围捕行为的模拟和可视化，为智能体算法研究和教学提供了有效工具。

## 技术架构
- **后端**：采用 Python 编写，使用 FastAPI 框架提供 RESTful 接口，通过 SQLAlchemy 进行数据库操作，支持模拟创建、启动、停止、重置等操作。
- **前端**：基于 Vue.js，使用 Babel、ESLint 等工具，提供用户界面用于与后端交互，支持实时模拟展示和控制。

## 主要功能
- **模拟服务**：支持创建、启动、停止、重置模拟，提供实时快照获取。
- **代理行为**：定义了猎人代理与目标代理的移动、交互策略，包括捕获、围捕、探索等行为。
- **数据库**：通过 ORM 模型管理模拟、代理、快照等数据，支持清理和导出旧模拟数据。
- **WebSocket**：提供实时通信，支持前端与后端同步模拟状态。

## 安装依赖
### 后端
1. 安装依赖：
   ```bash
   pip install -r backend/requirements.txt
   ```
2. 初始化数据库：
   ```bash
   python backend/create_db_standalone.py
   ```

### 前端
1. 安装 Node.js 依赖：
   ```bash
   cd frontend
   npm install
   ```

## 使用说明
### 后端
启动 FastAPI 应用：
```bash
cd backend
uvicorn app.main:app --reload
```

访问 `/docs` 获取 API 文档并进行操作。

### 前端
运行 Vue 项目：
```bash
cd frontend
npm run serve
```

访问 `http://localhost:8080` 使用 Crowdsensing 系统。

## 模块说明
- `backend/app/api/routes.py`：定义了 RESTful API 接口。
- `backend/app/models/agent.py`：定义了代理类及其行为。
- `backend/app/services/simulation_service.py`：模拟服务处理核心逻辑。
- `backend/app/database.py`：数据库连接与初始化。
- `frontend`：Vue 前端代码，用于模拟控制与展示。

## 许可证
该项目采用 MIT 许可证，详细信息请查看根目录下的 `LICENSE` 文件。

如需贡献代码或提出问题，请访问 [项目页面](https://gitee.com/little_alone/crowdsensing) 提交 issue 或 pull request。