# qianfen

**Repository Path**: games_9/qianfen

## Basic Information

- **Project Name**: qianfen
- **Description**: 这是一个小圈子玩的特殊的扑克游戏叫千分。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-06
- **Last Updated**: 2026-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 千分游戏 Web 版本

6人扑克牌对战游戏，使用4副牌。

## 🎮 游戏规则

- **人数**: 6人，分为两队（每队3人）
- **牌数**: 4副扑克牌（216张），每人36张
- **分牌**: 5(5分)、10(10分)、K(10分)，共400分
- **目标**: 累积得分超过1000分获胜

## 🚀 快速开始

### 数据库配置

在项目根目录 `.env` 中配置 PostgreSQL 连接信息，服务启动后会自动把对局和回放事件写入数据库。
需要的字段：
- `SMARTWRITER_DB_HOST`
- `SMARTWRITER_DB_PORT`
- `SMARTWRITER_DB_USER`
- `SMARTWRITER_DB_NAME`
- `SMARTWRITER_DB_PASSWORD`
可选字段：
- `SMARTWRITER_DB_SSLMODE`

复盘接口：
- `GET /api/replays`
- `GET /api/replays/{replay_id}`

### 复盘方式

先通过 `GET /api/replays` 找到目标 `replay_id`，再调用 `GET /api/replays/{replay_id}` 获取完整开局快照和事件序列，用于回看整局对战过程。

### 安装依赖

```bash
cd qianfen-web
pip3 install -r requirements.txt --break-system-packages
```

### 启动服务器

```bash
cd backend
python3 main.py
```

访问 http://localhost:8001

## 📁 项目结构


```text
qianfen-web/
├── backend/
│   └── main.py          # FastAPI 后端
├── frontend/
│   ├── index.html       # 主页面
│   ├── css/
│   │   └── style.css    # 样式表
│   └── js/
│       └── game.js      # 游戏逻辑
└── requirements.txt     # 依赖
```

## 🎯 功能特性

- ✅ 6人在线对战
- ✅ WebSocket 实时同步
- ✅ PostgreSQL 对局记录与复盘查询
- ✅ 自动发牌
- ✅ 基本牌型判断
- ✅ 队伍计分
- ✅ 响应式设计