# ws-test-server

**Repository Path**: clynn_dev/ws-test-server

## Basic Information

- **Project Name**: ws-test-server
- **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-03-23
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WebSocket 测试服务器

用于接收 reporter 发送的推理结果并保存到文件。

## 功能

- WebSocket 服务端，监听 `/ws/results` 路径
- 接收 reporter 批量上报的推理结果
- 发送 ACK 确认消息
- 按日期保存数据到 `data/results_YYYYMMDD.jsonl` 文件（JSONL 格式）

## 消息协议

### 接收消息 (reporter -> server)

```json
{
  "msg_id": "uuid",
  "type": "results",
  "stream_id": "default",
  "payload": [
    {
      "result_id": "uuid",
      "frame_id": 123,
      "timestamp": 1234567890.123,
      "source_id": "camera-01",
      "data": { ... }
    }
  ],
  "timestamp": 1234567890.123
}
```

### ACK 响应 (server -> reporter)

```json
{
  "type": "ack",
  "msg_id": "uuid",
  "status": "ok",
  "received_at": 1234567890.123
}
```

## 运行方式

### 使用脚本（推荐）

```bash
cd ws_client_test

# 启动服务
./start.sh

# 查看状态
./status.sh

# 停止服务
./stop.sh
```

### 手动运行

```bash
cd ws_client_test

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate

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

# 创建数据目录
mkdir -p data

# 运行服务
python main.py
```

## 环境变量

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `WS_HOST` | `0.0.0.0` | 监听地址 |
| `WS_PORT` | `8000` | 监听端口 |
| `WS_PATH` | `/ws/results` | WebSocket 路径 |
| `DATA_DIR` | `data` | 数据保存目录 |

## 目录结构

```
ws_client_test/
├── main.py              # 主程序
├── requirements.txt     # Python 依赖
├── start.sh            # 启动脚本
├── stop.sh             # 停止脚本
├── status.sh           # 状态查看脚本
├── README.md           # 本文档
├── venv/               # 虚拟环境（自动创建）
├── data/               # 数据保存目录（自动创建）
├── server.log          # 运行日志
└── server.pid          # PID 文件
```

## 数据文件

数据按日期分割，保存在 `data/` 目录下：

```
data/
├── results_20260320.jsonl
├── results_20260321.jsonl
└── ...
```

文件格式为 JSONL，每行一条完整消息记录。