244 lines
5.1 KiB
Go
244 lines
5.1 KiB
Go
# ELO评级系统
|
||
|
||
## 概述
|
||
|
||
为匹配框架引入了ELO评级系统，为每个规则集单独维护ELO评级，提供更精确的玩家技能评估和匹配质量。
|
||
|
||
## 核心特性
|
||
|
||
### 🎯 规则集分离
|
||
- 每个规则集（如休闲模式、竞技模式）独立维护ELO评级
|
||
- 玩家在不同规则集下有不同的ELO分数
|
||
- 支持无限扩展新的规则集
|
||
|
||
### 📊 标准ELO算法
|
||
- 基于经典ELO评级系统
|
||
- 期望得分计算：`1 / (1 + 10^((对手ELO - 自己ELO) / 400))`
|
||
- 新ELO = 旧ELO + K * (实际得分 - 期望得分)
|
||
- 支持胜利(1分)、失败(0分)、平局(0.5分)
|
||
|
||
### ⚙️ 动态K因子
|
||
- **新手** (< 30场): K = 32 (快速调整)
|
||
- **普通** (30-100场): K = 24 (中等调整)
|
||
- **老手** (> 100场): K = 16 (稳定调整)
|
||
|
||
### 🛡️ 安全边界
|
||
- ELO范围：100 - 3000
|
||
- 初始ELO：1200
|
||
- 自动记录历史最高ELO
|
||
|
||
## 数据库设计
|
||
|
||
### player_elo_ratings 表
|
||
|
||
```sql
|
||
CREATE TABLE player_elo_ratings (
|
||
player_id TEXT NOT NULL, -- 玩家ID
|
||
rule_set_id TEXT NOT NULL, -- 规则集ID
|
||
elo_rating INTEGER DEFAULT 1200, -- 当前ELO评级
|
||
games_played INTEGER DEFAULT 0, -- 游戏场次
|
||
wins INTEGER DEFAULT 0, -- 胜利次数
|
||
losses INTEGER DEFAULT 0, -- 失败次数
|
||
draws INTEGER DEFAULT 0, -- 平局次数
|
||
highest_elo INTEGER DEFAULT 1200, -- 历史最高ELO
|
||
created_at TIMESTAMPTZ DEFAULT NOW(),
|
||
updated_at TIMESTAMPTZ DEFAULT NOW(),
|
||
|
||
PRIMARY KEY (player_id, rule_set_id)
|
||
);
|
||
```
|
||
|
||
### 核心函数
|
||
|
||
- `get_or_create_player_elo()` - 获取或创建ELO记录
|
||
- `update_player_elo()` - 更新单个玩家ELO
|
||
- `batch_update_player_elos()` - 批量更新ELO（战斗结束）
|
||
- `get_elo_leaderboard()` - 获取排行榜
|
||
|
||
## API端点
|
||
|
||
### 排行榜
|
||
```
|
||
GET /api/v1/elo/leaderboard/:ruleSetId?limit=50&offset=0
|
||
```
|
||
|
||
### 玩家ELO信息
|
||
```
|
||
GET /api/v1/elo/player/:playerId/:ruleSetId
|
||
GET /api/v1/elo/player/:playerId # 所有规则集
|
||
```
|
||
|
||
### 统计信息
|
||
```
|
||
GET /api/v1/elo/statistics/:ruleSetId
|
||
```
|
||
|
||
### 战斗预测
|
||
```
|
||
GET /api/v1/elo/predict/:playerAId/:playerBId/:ruleSetId
|
||
```
|
||
|
||
### 配置信息
|
||
```
|
||
GET /api/v1/elo/config
|
||
GET /api/v1/elo/win-rate/:eloDifference
|
||
```
|
||
|
||
## 系统集成
|
||
|
||
### 战斗结束自动更新
|
||
|
||
战斗结束时，`battleReportService` 会自动：
|
||
|
||
1. 获取两个玩家的当前ELO
|
||
2. 根据战斗结果计算新ELO
|
||
3. 原子性批量更新数据库
|
||
4. 记录详细日志
|
||
|
||
```typescript
|
||
// 在 battleReportService.ts 中
|
||
if (battleData.ruleSetId && battleResult !== 'abandoned') {
|
||
await eloService.processBattleEloUpdate(
|
||
battleData.playerAId,
|
||
battleData.playerBId,
|
||
winnerId,
|
||
battleData.ruleSetId
|
||
)
|
||
}
|
||
```
|
||
|
||
### 匹配系统集成
|
||
|
||
匹配系统已支持规则集分离，ELO系统可以：
|
||
|
||
- 基于ELO进行更精确的匹配
|
||
- 预测战斗结果概率
|
||
- 提供匹配质量评估
|
||
|
||
## 部署步骤
|
||
|
||
### 1. 数据库迁移
|
||
|
||
在Supabase SQL编辑器中执行：
|
||
|
||
```sql
|
||
-- 执行ELO系统迁移
|
||
\i packages/database/sql/06_add_elo_system.sql
|
||
```
|
||
|
||
### 2. 服务器更新
|
||
|
||
ELO系统已集成到现有服务器中，无需额外配置。
|
||
|
||
### 3. 测试验证
|
||
|
||
```bash
|
||
# 测试ELO计算逻辑
|
||
cd packages/server && npx tsx src/test-elo.ts
|
||
|
||
# 启动服务器测试API
|
||
node dist/cli.js server --port 8102
|
||
```
|
||
|
||
## 使用示例
|
||
|
||
### 获取排行榜
|
||
|
||
```bash
|
||
curl "http://localhost:8102/api/v1/elo/leaderboard/casual_standard_ruleset?limit=10"
|
||
```
|
||
|
||
### 查看玩家ELO
|
||
|
||
```bash
|
||
curl "http://localhost:8102/api/v1/elo/player/player123/casual_standard_ruleset"
|
||
```
|
||
|
||
### 预测战斗结果
|
||
|
||
```bash
|
||
curl "http://localhost:8102/api/v1/elo/predict/player1/player2/competitive_ruleset"
|
||
```
|
||
|
||
## 配置选项
|
||
|
||
ELO系统支持运行时配置调整：
|
||
|
||
```typescript
|
||
const eloService = new EloService(repository, calculationService)
|
||
|
||
// 更新配置
|
||
eloService.updateEloConfig({
|
||
initialElo: 1500,
|
||
kFactor: {
|
||
newbie: 40,
|
||
normal: 20,
|
||
veteran: 10
|
||
},
|
||
minElo: 200,
|
||
maxElo: 2800
|
||
})
|
||
```
|
||
|
||
## 监控和日志
|
||
|
||
### 日志记录
|
||
|
||
- ELO更新详细日志
|
||
- 计算过程追踪
|
||
- 错误处理和恢复
|
||
|
||
### 性能监控
|
||
|
||
- 数据库查询优化
|
||
- 批量更新性能
|
||
- API响应时间
|
||
|
||
## 未来扩展
|
||
|
||
### 可能的增强功能
|
||
|
||
1. **季度重置** - 定期重置ELO评级
|
||
2. **衰减机制** - 长期不活跃玩家ELO衰减
|
||
3. **匹配优化** - 基于ELO的智能匹配
|
||
4. **成就系统** - ELO里程碑奖励
|
||
5. **数据分析** - ELO分布统计和趋势分析
|
||
|
||
### 扩展新规则集
|
||
|
||
添加新规则集只需：
|
||
|
||
1. 在规则系统中定义新规则集
|
||
2. ELO系统自动支持（无需代码修改）
|
||
3. 玩家首次游戏时自动创建ELO记录
|
||
|
||
## 故障排除
|
||
|
||
### 常见问题
|
||
|
||
1. **ELO记录不存在**
|
||
- 系统会自动创建初始记录
|
||
- 检查规则集ID是否正确
|
||
|
||
2. **ELO更新失败**
|
||
- 检查数据库连接
|
||
- 查看服务器日志
|
||
- 验证战斗数据完整性
|
||
|
||
3. **API响应错误**
|
||
- 确认数据库迁移已执行
|
||
- 检查API路由注册
|
||
- 验证请求参数格式
|
||
|
||
### 调试工具
|
||
|
||
```bash
|
||
# 测试ELO计算
|
||
npx tsx packages/server/src/test-elo.ts
|
||
|
||
# 检查数据库表
|
||
SELECT * FROM player_elo_ratings LIMIT 10;
|
||
|
||
# 查看API状态
|
||
curl "http://localhost:8102/api/v1/elo/config"
|
||
``` |