feat: 支持中键双击并优化扫雷AI控制逻辑

Author: ljzloser

src/main.py

@@ -200,12 +200,12 @@ def cli_check_file(file_path: str) -> int:
         ui._plugin_process = plugin_process  # 保存引用，防止被 GC
 
         GameServerBridge.instance().start()
-        
+
         # 注册控制命令处理器（自动在主线程执行）
         def handle_new_game(cmd: NewGameCommand):
             """处理新游戏命令"""
             from lib_zmq_plugins.shared.base import CommandResponse
-            
+
             # 根据 level 确定参数
             if cmd.level == GameLevel.BEGINNER.value:
                 rows, cols, mines = 8, 8, 10
@@ -216,21 +216,24 @@ def handle_new_game(cmd: NewGameCommand):
             else:
                 # 自定义模式，使用传入的参数
                 rows, cols, mines = cmd.rows, cmd.cols, cmd.mines
-            
-            print(f"[NewGameCommand] level={cmd.level}, rows={rows}, cols={cols}, mines={mines}")
+
+            print(
+                f"[NewGameCommand] level={cmd.level}, rows={rows}, cols={cols}, mines={mines}")
             ui.setBoard_and_start(rows, cols, mines)
             return CommandResponse(request_id=cmd.request_id, success=True)
-        
+
         def handle_mouse_click(cmd: MouseClickCommand):
             """处理鼠标点击命令"""
             from lib_zmq_plugins.shared.base import CommandResponse
-            
-            print(f"[MouseClickCommand] row={cmd.row}, col={cmd.col}, button={cmd.button}")
+
+            print(
+                f"[MouseClickCommand] row={cmd.row}, col={cmd.col}, button={cmd.button}")
             success = ui.execute_cell_click(cmd.row, cmd.col, cmd.button)
             return CommandResponse(request_id=cmd.request_id, success=success)
-        
+
         GameServerBridge.instance().register_handler(NewGameCommand, handle_new_game)
-        GameServerBridge.instance().register_handler(MouseClickCommand, handle_mouse_click)
+        GameServerBridge.instance().register_handler(
+            MouseClickCommand, handle_mouse_click)
 
         # _translate = QtCore.QCoreApplication.translate
         hwnd = int(ui.mainWindow.winId())

src/mineSweeperGUI.py

@@ -37,6 +37,7 @@
 
 
 class MineSweeperGUI(MineSweeperVideoPlayer):
+
     def __init__(self, MainWindow: MainWindow, args):
         self.mainWindow = MainWindow
         self.checksum_guard = metaminesweeper_checksum.ChecksumGuard()
@@ -220,7 +221,7 @@ def game_state(self):
     def game_state(self, game_state: str):
         # print(self._game_state, " -> " ,game_state)
         last_state = self._game_state
-        
+
         match self._game_state:
             case "playing":
                 self.try_append_evfs(game_state)
@@ -254,9 +255,9 @@ def game_state(self, game_state: str):
                 self.label.paint_cursor = False
                 self.label.paintProbability = False
                 self.num_bar_ui.QWidget.close()
-        
+
         self._game_state = game_state
-        
+
         # 发送游戏状态变化事件
         state_map = {
             "ready": 1,
@@ -277,6 +278,7 @@ def game_state(self, game_state: str):
                 current_status=state_map.get(game_state, 0),
             )
             GameServerBridge.instance().send_event(event)
+            self._send_board_update_event()
 
     @property
     def row(self):
@@ -509,7 +511,7 @@ def _send_board_update_event(self):
             game_board_list = []
             for row in ms_board.game_board:
                 game_board_list.append(list(row))
-            
+
             event = BoardUpdateEvent(
                 rows=self.row,
                 cols=self.column,
@@ -521,79 +523,33 @@ def _send_board_update_event(self):
         except Exception:
             pass  # 忽略发送失败
 
-    def execute_cell_click(self, row: int, col: int, button: int) -> bool:
+    def execute_cell_click(self, row: int, col: int, button: int):
         """
         执行格子点击（供外部命令调用）
-        
+
         Args:
             row: 行索引（从 0 开始）
             col: 列索引（从 0 开始）
-            button: 鼠标按钮（0=左键, 2=右键）
-        
-        Returns:
-            True 表示成功执行
+            button: 鼠标按钮（0=左键, 1=中键, 2=右键）
         """
-        # 检查游戏状态
-        if self.game_state not in ('ready', 'playing', 'joking'):
-            return False
-        
-        # 检查坐标有效性
         if row < 0 or row >= self.row or col < 0 or col >= self.column:
             return False
-        
-        # 转换为像素坐标（中心点）
-        i = row * self.pixSize + self.pixSize // 2
-        j = col * self.pixSize + self.pixSize // 2
-        
-        try:
-            if button == 0:  # 左键
-                # 模拟点击流程：按下 -> 抬起
-                self.label.ms_board.step('lc', (i, j))
-                
-                # 处理第一次点击埋雷
-                if self.game_state == 'ready':
-                    if self.label.ms_board.mouse_state == 4:
-                        if self.board_constraint:
-                            self.game_state = 'joking'
-                        else:
-                            self.game_state = 'playing'
-                        if self.player_identifier[:6] != "[live]":
-                            self.disable_screenshot()
-                        if self.cursor_limit:
-                            self.limit_cursor()
-                        self.start_time_unix_2 = QtCore.QDateTime.currentDateTime().toMSecsSinceEpoch()
-                        self.timer_10ms.start()
-                        self.score_board_manager.editing_row = -2
-                        # 埋雷
-                        self.layMine(row, col)
-                
-                self.label.ms_board.step('lr', (i, j))
-                
-                # 检查游戏结束
-                if self.label.ms_board.game_board_state == 3:
-                    self.gameWin()
-                elif self.label.ms_board.game_board_state == 4:
-                    self.gameFailed()
-                    
-            elif button == 2:  # 右键
-                # 更新剩余雷数
-                cell_state = self.label.ms_board.game_board[row][col]
-                if cell_state == 11:  # 已标旗，取消标旗
-                    self.mineUnFlagedNum += 1
-                    self.showMineNum(self.mineUnFlagedNum)
-                elif cell_state == 10:  # 未揭开，标旗
-                    self.mineUnFlagedNum -= 1
-                    self.showMineNum(self.mineUnFlagedNum)
-                
-                self.label.ms_board.step('rc', (i, j))
-                self.label.ms_board.step('rr', (i, j))
-            
-            self.label.update()
-            self._send_board_update_event()
-            return True
-            
-        except Exception:
-            return False
+        x = row * self.pixSize
+        y = col * self.pixSize
+        if button == 0:
+            self.mineAreaLeftPressed(x, y)
+            self.mineAreaLeftRelease(x, y)
+        elif button == 1:
+            self.mineAreaLeftPressed(x, y)
+            self.mineAreaLeftAndRightPressed(x, y)
+            self.mineAreaRightRelease(x, y)
+            self.mineAreaLeftRelease(x, y)
+        else:
+            self.mineAreaRightPressed(x, y)
+            self.mineAreaRightRelease(x, y)
+
+        self._send_board_update_event()
+        return True
 
     def gameStart(self):
         # 画界面，但是不埋雷。等价于点脸、f2、设置确定后的效果
@@ -688,7 +644,7 @@ def gameFinished(self):
                     data[key] = getattr(ms_board, key)
             event = VideoSaveEvent(**data)
             GameServerBridge.instance().send_event(event)
-        
+
         # 发送棋盘更新事件，让插件知道最终状态
         self._send_board_update_event()
 

src/plugins/llm_minesweeper_controller/config.py

@@ -49,52 +49,71 @@ class LlmMinesweeperControllerConfig(OtherInfoBase):
 
     # 提示词设置
     system_prompt = LongTextConfig(
-        default="""你是一个顶级扫雷AI。你的任务是通过逻辑推理，输出工具调用指令来赢下游戏。
-
-# 一、 棋盘与状态定义
+        default="""你是一个扫雷AI。你只能通过调用工具来操作游戏。
+
+# 绝对规则
+每次回复只允许调用1个工具函数。
+所有推理在你的"内部思考"中完成，不要输出到回复里。
+
+# 推理策略
+- 基础：数字=周围未揭开数 → 全是雷；数字=周围旗子数 → 全安全
+- 进阶：用相邻数字的差值与非共享未知格做减法约束
+- 盲猜（仅无逻辑解时）：选长连续边界中段，绝对禁止猜边角
+
+# 决策树（每次操作前必须按此顺序检查！）
+
+## 检查1：能标旗吗？→ 右键 `"right"`
+```
+对于每个数字N：
+  未揭开格子数 = N ？
+  → 是：这N个格子必定是雷 → `click_cell(..., "right")` 标旗
+  → 继续检查其他数字
+```
+**标旗不会死！遇到确定的雷必须标旗！**
+
+## 标旗的修正
+如果发现之前标错了旗（数字逻辑矛盾），可以再次 `click_cell(..., "right")` 取消标旗。
+右键点击已标旗(F)的格子 = 取消标旗。
+
+## 检查2：能中键吗？→ 中键 `"middle"`
+```
+对于每个数字N：
+  周围已标旗数 = N ？
+  → 是：周围剩余格子全部安全 → `click_cell(..., "middle")` 批量揭开
+  → 继续检查其他数字
+```
+**这是最常用的批量揭开操作，必须优先使用！**
+
+## 检查3：能左键吗？→ 左键 `"left"`
+```
+不属于以上两种情况，但确定安全？
+→ 是：`click_cell(..., "left")` 揭开（通常是数字0）
+```
+
+## 强制规则
+- 检查顺序：标旗 → 中键 → 左键，**不能跳过**
+
+# 游戏状态判断
+- 棋盘出现 M → 调用 start_new_game
+- cells 为空 → 调用 start_new_game
+- 否则 → 分析推理后调用 click_cell 或 get_local_board
+
+# 操作流程
+1. 先调用 get_board_state 获取全局
+2. 若有确定操作，直接调用 click_cell
+3. 若需要细节，调用 get_local_board(radius=4)
+4. 循环直到胜利
+
+# 棋盘与状态定义
 - 格子状态：`-1`(未揭开)、`0-8`(周围雷数)、`F`(已标旗)、`M`(踩到的红雷)、`m`(未踩的白雷)
-- 游戏状态容错：若棋盘出现 `M` 必为失败；若非雷格全揭开必为胜利；以棋盘实际画面为准，忽略错误的状态参数。
+- 游戏状态容错：若棋盘出现 `M` 必为失败；若非雷格全揭开必为胜利；以棋盘实际画面为准。
 
-# 二、 可用工具
+# 可用工具
 - `get_board_state()`：获取全局视图。
-- `get_local_board(col, row, radius)`：获取局部细节，建议 radius=4。
-- `click_cell(col, row, button)`：执行操作，button仅限 `"left"`(揭开) 或 `"right"`(标旗)。
-- `start_new_game()`：失败或未初始化时调用。
-
-# 三、 核心推理策略（按优先级排序）
-1. **基础定式**：
-   - 数字 = 周围未揭开数 → 未揭开格全是雷（右键标旗）。
-   - 数字 = 周围旗子数 → 剩余未揭开格全安全（左键揭开）。
-2. **减法逻辑（核心）**：
-   - 对比边界上相邻的两个数字，利用它们的差值与非共享未知格的数量，推断特定格子是雷还是安全。
-3. **盲猜原则（仅限无任何逻辑解时）**：
-   - **绝对禁止猜边角！**
-   - 必须选择**长连续未揭开边界的中段**点击，以最大化获取信息量。
-
-# 四、 操作铁律
-1. **100%确定原则**：没有绝对把握不操作，宁可不动也不犯错。
-2. **单次限量**：每次推理后，只执行 1-3 个确定格子的操作。
-3. **标旗优先**：在既可标旗又可揭开的场景下，优先标旗（标旗不会触发死亡，且能降低后续推理复杂度）。
-4. **禁止重复操作**：绝不能点击 0-8 的格子或 F 的格子。
-
-# 五、 输出格式要求（严格遵守）
-不要输出任何解释性文本、问候语或分析过程。你的输出必须且只能是以下两种格式之一：
-
-【格式1：执行操作】
-<action>
-工具名称(参数)
-</action>
-<reason>
-一句理由，不超过15字，如：减法逻辑(5,4)安全
-</reason>
-
-【格式2：需要更多信息】
-<action>
-get_board_state()
-</action>
-<reason>
-初始化/查看全局
-</reason>""",
+- `get_local_board(col, row, radius=4)`：获取局部细节，返回(2*radius+1)x(2*radius+1)的区域。
+- `click_cell(col, row, button)`：执行操作，button可为 `"left"`(揭开)、`"right"`(标旗) 或 `"middle"`(快速揭开周围格子)。
+- `start_new_game(difficulty)`：开始新游戏，difficulty为 `"easy"`(8x8)、`"medium"`(16x16) 或 `"hard"`(16x30)。
+""",
         label="系统提示词",
     )