1

1

src/engine/chengdu_mahjong_engine.py

@@ -1,31 +1,42 @@
-from .game_state import ChengduMahjongState
-from .utils import get_suit, get_tile_name
+import random
+
 from loguru import logger
 
+from .game_state import ChengduMahjongState
+
+
 class ChengduMahjongEngine:
     def __init__(self):
         self.state = ChengduMahjongState()  # 创建游戏状态
         self.game_over = False
+        self.game_started = False  # 游戏是否已开始
         self.deal_tiles()  # 发牌
 
     def deal_tiles(self):
         """ 发牌，每个玩家发13张牌，并设置缺门 """
         logger.info("发牌中...")
+
+        # 洗牌（随机打乱牌堆）
+        random.shuffle(self.state.deck)
+
         # 随机发牌给每个玩家
         for player in range(4):
             for _ in range(13):  # 每个玩家13张牌
-                tile = self.state.deck.pop()
+                tile = self.state.deck.pop()  # 从牌堆抽取一张牌
                 self.state.hands[player][tile] += 1  # 增加玩家手牌的计数
 
-        # 设置缺门：每个玩家定缺
+        # 设置缺门：每个玩家定缺（这里假设我们让每个玩家的缺门都为“条”）
         for player in range(4):
+            missing_suit = "条"  # 这里可以通过其他方式设置缺门，比如随机选择
             self.state.set_missing_suit(player, missing_suit)
 
     def start_game(self):
         """ 开始游戏 """
-        # 游戏开始时初始化状态等
-        self.game_over = False
-        logger.info("游戏开始！")
+        if not self.game_started:
+            self.game_started = True
+            logger.info("游戏开始！")
+        else:
+            logger.warning("游戏已经开始，不能重复启动！")
 
     def check_game_over(self):
         """ 检查游戏是否结束 """
@@ -33,3 +44,4 @@ class ChengduMahjongEngine:
         if len(self.state.deck) == 0:
             self.game_over = True
             logger.info("游戏结束！")
+

src/engine/game_state.py

@@ -4,7 +4,7 @@ from loguru import logger
 
 class ChengduMahjongState:
     def __init__(self):
-        # 每个玩家的手牌
+        # 每个玩家的手牌，使用108个索引表示
         self.hands = [[0] * 108 for _ in range(4)]  # 每个玩家108张牌的计数
         # 每个玩家的打出的牌
         self.discards = [[] for _ in range(4)]  # 每个玩家的弃牌列表

src/engine/hand.py

@@ -0,0 +1,37 @@
+from collections import defaultdict
+
+class Hand:
+    def __init__(self):
+        # 存储所有的牌
+        self.tiles = []
+        # 存储每种牌的数量，默认值为 0
+        self.tile_count = defaultdict(int)
+
+    def add_tile(self, tile):
+        """ 向手牌中添加一张牌 """
+        self.tiles.append(tile)  # 将牌添加到手牌中
+        self.tile_count[tile] += 1  # 增加牌的数量
+
+    def remove_tile(self, tile):
+        """ 从手牌中移除一张牌 """
+        if self.tile_count[tile] > 0:
+            self.tiles.remove(tile)
+            self.tile_count[tile] -= 1
+        else:
+            raise ValueError(f"手牌中没有该牌: {tile}")
+
+    def get_tile_count(self, tile):
+        """ 获取手牌中某张牌的数量 """
+        return self.tile_count[tile]
+
+    def can_pong(self, tile):
+        """ 判断是否可以碰（即是否有3张相同的牌） """
+        return self.tile_count[tile] >= 2
+
+    def can_gang(self, tile):
+        """ 判断是否可以杠（即是否有4张相同的牌） """
+        return self.tile_count[tile] >= 3
+
+    def __repr__(self):
+        """ 返回手牌的字符串表示 """
+        return f"手牌: {self.tiles}, 牌的数量: {dict(self.tile_count)}"

src/engine/mahjong_tile.py

@@ -0,0 +1,20 @@
+class MahjongTile:
+    SUITS = ['条', '筒', '万']
+
+    def __init__(self, suit, value):
+        if suit not in self.SUITS or not (1 <= value <= 9):
+            raise ValueError("Invalid tile")
+        self.suit = suit
+        self.value = value
+
+    def __repr__(self):
+        return f"{self.value}{self.suit}"
+
+    def __eq__(self, other):
+        return self.suit == other.suit and self.value == other.value
+
+    def __hash__(self):
+        return hash((self.suit, self.value))
+
+
+

src/engine/utils.py

@@ -1,29 +1,19 @@
 def get_suit(tile_index):
     """
     根据牌的索引返回花色。
-    条：索引 0-35，筒：索引 36-71，万：索引 72-107
-
-    参数:
-    - tile_index: 牌的索引（0-107）。
-
-    返回:
-    - 花色字符串: "条"、"筒" 或 "万"。
     """
-    suits = ["条", "筒", "万"]
-    return suits[tile_index // 36]
-
+    if 0 <= tile_index <= 35:
+        return "条"
+    elif 36 <= tile_index <= 71:
+        return "筒"
+    elif 72 <= tile_index <= 107:
+        return "万"
+    else:
+        raise ValueError(f"无效的牌索引: {tile_index}")
 
 def get_tile_name(tile_index):
     """
-    根据牌的索引返回具体的牌（花色和数字）。
-
-    参数:
-    - tile_index: 牌的索引（0-107）。
-
-    返回:
-    - 具体牌的字符串: 例如 "1条"、"9筒"、"5万"。
+    根据牌的索引返回牌名（例如：1条，2筒等）。
     """
-    suits = ["条", "筒", "万"]
-    suit = suits[tile_index // 36]  # 根据索引获取花色
-    number = (tile_index % 36) // 4 + 1  # 计算具体数字（1-9）
-    return f"{number}{suit}"
+    suit = get_suit(tile_index)
+    return f"{tile_index % 36 + 1}{suit}"