cardSrv/README.md

cardSrv
=====

An OTP application

Build
-----

    $ rebar3 compile

# 自动斗地主AI系统项目文档

## 项目概述

本项目是一个基于Erlang开发的智能斗地主游戏系统，集成了深度学习、并行计算、性能监控和可视化分析等先进功能。系统采用模块化设计，具有高可扩展性和可维护性。

## 系统架构
### 核心模块

1. **游戏核心模块**
    - cards.erl: 牌类操作
    - card_rules.erl: 游戏规则
    - game_server.erl: 游戏服务器
    - player.erl: 玩家管理
    - game_core.erl: 游戏核心逻辑
    - game_logic.erl: 游戏逻辑处理
    - card_checker.erl: 牌型检查

2. **AI系统模块**
    - ai_core.erl: AI核心引擎
    - ai_player.erl: AI玩家实现
    - ai_strategy.erl: AI策略基础
    - ai_optimizer.erl: AI优化器
    - doudizhu_ai_strategy.erl: 斗地主专用AI策略
    - auto_player.erl: 自动玩家

3. **系统支持模块**
    - room_manager.erl: 房间管理
    - game_manager.erl: 游戏管理
    - score_system.erl: 积分系统
    - optimizer.erl: 系统优化
    - system_supervisor.erl: 系统监督

## 功能特性
### 1. 基础游戏功能
- 完整的斗地主规则实现
- 多人游戏支持
- 房间管理系统
- 积分系统

### 2. AI系统
- 多级别AI玩家（简单、普通、困难）
- 深度学习策略
- 自适应游戏策略
- 多种AI性格特征

### 3. 系统性能
#### 3.1 并行计算
- 多核心利用
- 任务分发
- 负载均衡

#### 3.2 性能监控
- 实时性能指标收集
- 自动化性能分析
- 告警系统
- 性能报告生成

## 已实现功能列表
### 游戏核心功能
- [x] 完整的斗地主规则实现
  - 支持所有标准牌型（单牌、对子、三张、三带一、三带二、顺子、连对、飞机、炸弹、火箭等）
  - 牌型大小比较
  - 出牌规则验证
- [x] 多玩家支持
  - 支持3人标准斗地主
  - 玩家状态管理
  - 回合控制
- [x] 房间管理
  - 创建房间
  - 加入/离开房间
  - 房间状态管理
  - 房间列表查询
- [x] 积分系统
  - 玩家积分记录
  - 胜负统计
  - 排行榜功能
  - 积分奖惩机制

### AI功能
- [x] AI玩家实现
  - 基础AI行为
  - 多级别难度（简单、普通、困难）
  - 思考时间模拟
  - AI名称生成
- [x] 多种AI策略
  - 角色感知（地主/农民）
  - 局势评估
  - 手牌价值分析
  - 出牌决策
- [x] 自适应学习
  - 对手行为分析
  - 策略调整
  - 胜率预估
- [x] 策略优化
  - 手牌组合优化
  - 出牌时机控制
  - 关键牌保留

### 系统功能
- [x] 游戏服务器
  - 游戏创建
  - 玩家加入
  - 游戏流程控制
  - 游戏状态管理
- [x] 并行计算
  - AI决策并行化
  - 多游戏并行处理
  - 资源分配
- [x] 性能监控
  - 系统负载监控
  - 响应时间统计
  - 资源使用率监控
- [x] 可视化分析
  - 游戏数据统计
  - 玩家行为分析
  - AI性能评估

## 待优化功能

1. 分布式系统支持
2. 数据持久化
3. 更多AI算法
4. Web界面
5. 移动端支持
6. 安全性增强
7. 容错机制
8. 日志系统

## 错误处理

系统实现了基本的错误处理机制：
- 游戏异常处理
- AI系统容错
- 并行计算错误恢复
- 性能监控告警