https://github.com/iammm0/turing-test

在一场由两名人类和一名机器所组成的模仿游戏对局中，人类审讯者需要在五分钟的文字交谈中分辨出与自己所交流的哪一名证人才是真正的人类，机器人在对局中会表现得让人难以分辨，反之，则人类失败。
https://github.com/iammm0/turing-test

fastapi mui-material nextjs15 postgresql python3 redis typescript

Last synced: about 1 year ago
JSON representation

在一场由两名人类和一名机器所组成的模仿游戏对局中，人类审讯者需要在五分钟的文字交谈中分辨出与自己所交流的哪一名证人才是真正的人类，机器人在对局中会表现得让人难以分辨，反之，则人类失败。

• Host: GitHub
• URL: https://github.com/iammm0/turing-test
• Owner: iammm0
• Created: 2025-04-24T18:18:12.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2025-06-03T23:51:16.000Z (about 1 year ago)
• Last Synced: 2025-06-04T07:17:35.388Z (about 1 year ago)
• Topics: fastapi, mui-material, nextjs15, postgresql, python3, redis, typescript
• Language: Python
• Homepage:
• Size: 2.82 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# turing_test 开发文档

## 一、项目简介

- 背景与动机  

- 核心功能概览  

- 应用场景  

  

## 二、技术栈

- 后端：FastAPI / SQLAlchemy / asyncpg / Redis / OAuth2 / WebSocket  

- 前端：Next.js / React / MUI / React Query / WebSocket  

- 数据库：PostgreSQL  

- 缓存与消息：Redis  

- 部署：Uvicorn / Docker / Nginx  

## 三、项目结构

```bash

.

├── README.md

├── apps

│   ├── __init__.py

│   ├── api

│   │   ├── __init__.py

│   │   ├── alembic.ini

│   │   ├── core

│   │   ├── dto

│   │   ├── main.py

│   │   ├── migrations

│   │   ├── dao

│   │   ├── routers

│   │   ├── service

│   │   └── utils

│   └── web

│       ├── README.md

│       ├── components.json

│       ├── eslint.config.mjs

│       ├── next-env.d.ts

│       ├── next.config.ts

│       ├── package-lock.json

│       ├── package.json

│       ├── postcss.config.mjs

│       ├── public

│       ├── src

│       └── tsconfig.json

   └── prompts

        ├── system.json

├── docker

│   ├── api.Dockerfile

│   └── web.Dockerfile

├── docker-compose.yml

├── nginx

│   └── turingtest.conf

└── requirements.txt

```

## 四、本地数据库环境准备

启动 PostgreSQL 使用自定义端口：

```cmd

:: 启动 PostgreSQL（端口改为 15432）

docker run -d --name turing_postgres -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=iammm -e POSTGRES_DB=turing_test -p 15432:5432 postgres

```

启动 Redis 容器 使用自定义端口：

```cmd

:: 启动 Redis（端口改为 16379）

docker run -d --name turing_redis -p 16379:6379 redis

```

PostgreSQL 容器内登录：

```bash

docker exec -it turing_postgres bash

```

然后在容器里执行：

```bash

psql -U postgres -d turing_test

```

进入 Redis 容器内：

```cmd

docker exec -it turing_redis redis-cli

```

## 五、快速开始

1.克隆代码：

```bash

git clone https://.../turing-test.git

cd turing-test

```

2.环境变量：

在项目根目录创建 `.env`（或 `.env.local`），填写：

```bash

POSTGRES_HOST=…

POSTGRES_PORT=5432

POSTGRES_USER=…

POSTGRES_PASSWORD=…

POSTGRES_DB=…

REDIS_URL=redis://localhost:6379/0

NEXT_PUBLIC_WS_BASE=ws://localhost:8000/api

```

3. 后端依赖 & 启动

```bash

cd apps/api

pip install -r requirements.txt

alembic upgrade head

uvicorn main:app --reload

```

4.  前端依赖 & 启动

```bash

cd frontend

npm install

npm run dev

```

## 六、核心功能

1.  用户认证

- 注册 `/api/auth/register`

- 登录 `/api/auth/login`

- JWT 令牌管理 (有效期 30 天)

2. 匹配系统

- 握手：`ws://…/api/ws/match?token=…`

```bash

`join`→`match_found`→`accept/decline`→`matched

```

3. 游戏流程

- 玩家确认后创建 `Game`

- 不同状态：`WAITING`→`ACTIVE`→`CHAT`→`JUDGED`→`ENDED`

## 七、API 文档

1. ### HTTP Endpoints

| 方法 |        路径        |   描述   |           字段准备            |

| :--: | :----------------: | :------: | :---------------------------: |

| POST | /api/auth/register | 用户注册 | email, display_name, password |

| POST |  /api/auth/login   | 用户登录 |        email, password        |

2. ### WebSocket 消息格式

进入匹配队列 WebSocket 连接：

```

ws://127.0.0.1:8000/api/ws/match?token=

```

进入测试房间 WebSocket 连接

```

# 审讯者进入游戏

ws://127.0.0.1:8000/api/ws/rooms//I?token=

# 人类证人进入游戏

ws://127.0.0.1:8000/api/ws/rooms//H?token=

# AI证人进入游戏

ws://127.0.0.1:8000/api/ws/rooms//I

```

#### 客户端→服务端

- 加入匹配队列

```json

{ 

  "action": "join"

}

```

- 接受进入对局

```json

{ 

  "action": "accept",

  "match_id": "..."

}

```

- 拒绝进入对局

```json

{ 

  "action": "decline", 

  "match_id": "..."

}

```

- 向目标角色发送消息帧

```json

{

  "sender": "H | I",

  "recipient": "H | I | A",

  "body": "...",

  "ts": "datatime.now(UTC)"

}

```

#### 服务端→客户端

- 对局匹配成功，系统分配对局与游戏

```json

{ 

  "action": "match_found",

  "match_id": "...",

  "role": "I|W",

  "window": 60

}

```

- 系统已经为玩家匹配到对局，等待玩家确认后开始

```json

{ 

  "action": "matched",

  "game_id": "..."

}

```

- 对局等待玩家响应超时，玩家从匹配队列长链接中断开

```json

{ 

  "action": "error",

  "detail": "..."

}

```

- 对局双方同意接受对局，系统发出游戏准备状态中的提示

```json

{

  "action": "game_starting",

  "game_id": "...",

  "detail": "匹配成功，正在进入对局…"

}

```