# QwServer

**Repository Path**: fbinba3955/qw-server

## Basic Information

- **Project Name**: QwServer
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-13
- **Last Updated**: 2026-02-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QwServer - WorkTool Flask 后端服务

基于 Flask + Flask-SocketIO 的 WorkTool 后端服务，支持机器人连接管理和消息处理。

## 安装依赖

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

## 启动服务

```bash
python app.py
```

服务默认运行在 `http://0.0.0.0:8765`

## API 接口

### 机器人管理

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/robots` | 获取所有机器人列表 |
| GET | `/api/robots/online` | 获取在线机器人列表 |
| GET | `/api/robots/<id>/messages` | 获取指定机器人的聊天记录 |
| GET | `/api/robots/<id>/contacts` | 获取指定机器人的联系人列表 |
| POST | `/api/robots/<id>/send` | 通过指定机器人发送消息 |
| POST | `/api/robots/<id>/stop` | 停止机器人任务 |

### 兼容原有接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/robot/robotInfo/get` | 获取机器人配置 |
| GET | `/robot/robotInfo/update` | 更新机器人配置 |
| GET | `/appUpdate/checkUpdate` | 检查更新 |
| GET | `/test` | 测试接口 |

## WebSocket 命名空间

- `/wework` - WorkTool APP 连接
- `/web` - Web 前端连接

## 发送消息示例

```bash
curl -X POST http://localhost:8765/api/robots/robot001/send \
  -H "Content-Type: application/json" \
  -d '{"titleList": ["张三"], "content": "你好"}'
```

## 目录结构

```
QwServer/
├── app.py              # Flask 应用入口
├── config.py           # 配置文件
├── storage.py          # JSON 文件存储
├── requirements.txt    # 依赖
├── data/
│   └── messages/       # 聊天记录存储
└── routes/
    ├── __init__.py
    ├── robot_api.py    # HTTP API
    └── websocket.py    # WebSocket 处理
```