针对设计一个用于梦幻西游畅玩服的本地部署自动化登录程序，并带有图形控制界面和扩展接口的需求，以下是详细的设计与实现方案。该方案整合了本地GUI控制、后台自动化操作、账号管理及模块化设计思想[ref_1][ref_4][ref_5]。 ### 1. 项目架构与核心模块设计 本项目采用模块化设计，核心目标是将控制逻辑、业务逻辑和界面分离，便于后续维护和功能扩展。主要分为以下四个模块： | 模块名称 | 主要职责 | 关键技术/库 | 与其他模块关系 | | :--- | :--- | :--- | :--- | | **主控制模块** (`main_controller.py`) | 程序入口，负责调度其他模块，协调整体流程。 | `import` 其他模块 | 调用所有模块 | | **图形界面模块** (`gui_interface.py`) | 提供用户交互窗口，实现程序的启动、停止和状态监控。 | `PySimpleGUI` | 被主控模块调用，向业务模块发送指令 | | **业务逻辑模块** (`auto_login.py`) | 执行具体的游戏登录自动化操作，是核心功能实现。 | `pywin32`, `PyUserInput`/`pynput` | 被主控模块调用，接收界面指令 | | **账号管理模块** (`account_manager.py`) | 负责本地安全存储、读取和验证账号密码信息。 | `hashlib`, `json`/`sqlite3` | 被业务逻辑模块调用 | ### 2. 具体实现代码 #### 2.1 图形界面模块 (`gui_interface.py`) 此模块创建一个简单的控制面板，包含启动、停止按钮以及状态显示区域。使用 PySimpleGUI 实现，因其简单易用，适合快速构建桌面应用[ref_1]。 ```python # gui_interface.py import PySimpleGUI as sg import threading import time class LoginGUI: def __init__(self, controller): """ 初始化GUI界面 :param controller: 主控制器实例，用于回调 """ self.controller = controller self.window = None self.is_running = False self.layout = self._create_layout() self._create_window() def _create_layout(self): """创建界面布局""" layout = [ [sg.Text('梦幻西游畅玩服自动登录控制器', font=('微软雅黑', 16), justification='center')], [sg.HorizontalSeparator()], [sg.Text('当前状态:'), sg.Text('待命', key='-STATUS-', text_color='orange', size=(20,1))], [sg.Button('开始登录', key='-START-', size=(10,1), button_color=('white', 'green')), sg.Button('停止程序', key='-STOP-', size=(10,1), button_color=('white', 'red'), disabled=True), sg.Button('账号管理', key='-ACCOUNT-', size=(10,1))], [sg.Multiline(default_text='日志信息将在此显示...\n', size=(50, 15), key='-LOG-', autoscroll=True, disabled=True)], [sg.Button('退出', key='-EXIT-', size=(10,1))] ] return layout def _create_window(self): """创建窗口""" self.window = sg.Window('梦幻西游自动登录程序', self.layout, finalize=True) def update_log(self, message): """更新日志显示""" current_time = time.strftime('%H:%M:%S') log_entry = f'[{current_time}] {message}\n' self.window['-LOG-'].update(log_entry, append=True) def update_status(self, status, color='green'): """更新状态显示""" self.window['-STATUS-'].update(status, text_color=color) def run(self): """运行GUI事件循环""" while True: event, values = self.window.read(timeout=100) # 设置超时以便后台任务运行 if event == sg.WINDOW_CLOSED or event == '-EXIT-': # 退出前确保停止所有任务 if self.is_running: self.controller.stop_auto_login() break elif event == '-START-': self.controller.start_auto_login() self.window['-START-'].update(disabled=True) self.window['-STOP-'].update(disabled=False) self.is_running = True self.update_status('运行中', 'green') elif event == '-STOP-': self.controller.stop_auto_login() self.window['-START-'].update(disabled=False) self.window['-STOP-'].update(disabled=True) self.is_running = False self.update_status('已停止', 'red') elif event == '-ACCOUNT-': # 预留接口：未来可跳转至账号管理界面 self.update_log('账号管理功能开发中...') # 可以在此处处理其他自定义事件 self.window.close() if __name__ == '__main__': # 单独测试GUI gui = LoginGUI(None) gui.run() ``` #### 2.2 业务逻辑模块 (`auto_login.py`) 此模块是自动化的核心，利用 `pywin32` 库获取游戏窗口句柄并模拟后台点击操作[ref_4]。这里以点击“进入游戏”按钮为例。 ```python # auto_login.py import win32gui import win32con import win32api import time import random from account_manager import AccountManager # 导入账号管理模块 class GameAutoLogin: def __init__(self, gui_callback=None): """ 初始化自动登录器 :param gui_callback: GUI回调函数，用于更新日志 """ self.gui_callback = gui_callback self.is_running = False self.game_window_handle = None self.account_manager = AccountManager() def _log(self, message): """内部日志记录，如果提供了GUI回调则使用之""" print(f"[AutoLogin] {message}") if self.gui_callback: self.gui_callback(message) def find_game_window(self, window_title_part="梦幻西游"): """ 查找游戏客户端窗口 :param window_title_part: 窗口标题包含的关键词 :return: 窗口句柄，未找到返回None """ def callback(hwnd, extra): if win32gui.IsWindowVisible(hwnd) and window_title_part in win32gui.GetWindowText(hwnd): extra.append(hwnd) return True handles = [] win32gui.EnumWindows(callback, handles) return handles[0] if handles else None def _click_background(self, x, y): """ 在后台窗口的指定坐标模拟鼠标点击 :param x: 相对于窗口客户区的x坐标 :param y: 相对于窗口客户区的y坐标 """ if not self.game_window_handle: self._log("错误：未找到游戏窗口句柄") return False # 将客户区坐标转换为屏幕坐标 client_rect = win32gui.GetClientRect(self.game_window_handle) left, top = win32gui.ClientToScreen(self.game_window_handle, (0, 0)) target_x = left + x target_y = top + y # 模拟鼠标移动和点击 (使用SendMessage实现后台点击) l_param = win32api.MAKELONG(x, y) # 构造坐标参数 win32gui.SendMessage(self.game_window_handle, win32con.WM_MOUSEMOVE, 0, l_param) time.sleep(0.1) win32gui.SendMessage(self.game_window_handle, win32con.WM_LBUTTONDOWN, win32con.MK_LBUTTON, l_param) win32gui.SendMessage(self.game_window_handle, win32con.WM_LBUTTONUP, 0, l_param) return True def login_procedure(self, account_info): """ 执行登录流程（示例，需根据实际游戏界面调整坐标和步骤） :param account_info: 字典，包含‘username’和‘password’ """ self._log(f"开始为账号 {account_info['username']} 执行登录流程...") # 步骤1: 点击“进入游戏”按钮 (假设坐标位于(400, 300)) self._log("步骤1: 点击进入游戏") self._click_background(400, 300) time.sleep(2 + random.uniform(0, 0.5)) # 等待界面加载 # 步骤2: 在账号输入框点击并输入 (假设坐标位于(300, 200)) self._log("步骤2: 输入账号") self._click_background(300, 200) time.sleep(0.5) # 这里可以集成类似PyUserInput的键盘输入[ref_2]，或使用SendMessage发送字符消息 # 简化演示：仅记录 self._log(f" 输入: {account_info['username']}") # 步骤3: 在密码输入框点击并输入 (假设坐标位于(300, 250)) self._log("步骤3: 输入密码") self._click_background(300, 250) time.sleep(0.5) self._log(" 输入: [密码已隐藏]") # 步骤4: 点击登录按钮 (假设坐标位于(400, 350)) self._log("步骤4: 点击登录按钮") self._click_background(400, 350) time.sleep(3 + random.uniform(0, 1)) # 等待登录结果 self._log("登录流程执行完毕。") # 此处可添加登录成功与否的验证逻辑 def start(self): """启动自动登录任务""" self.is_running = True self._log("自动登录器启动...") self.game_window_handle = self.find_game_window() if not self.game_window_handle: self._log("未找到梦幻西游游戏窗口，请确保客户端已启动。") self.is_running = False return # 从账号管理器获取一个账号（示例：获取第一个） accounts = self.account_manager.load_accounts() if not accounts: self._log("未找到可用账号，请先添加账号。") self.is_running = False return # 模拟循环登录（实际项目可能根据需求调整，如多开） while self.is_running: for acc in accounts: if not self.is_running: break self.login_procedure(acc) # 登录间隔 time.sleep(5) # 单次循环后暂停一段时间，避免无限快速循环 if self.is_running: time.sleep(30) def stop(self): """停止自动登录任务""" self._log("正在停止自动登录器...") self.is_running = False ``` #### 2.3 账号管理模块 (`account_manager.py`) 此模块负责账号信息的加密存储与读取，确保本地数据安全。使用 `hashlib` 进行密码哈希处理，`json` 进行文件存储[ref_5]。 ```python # account_manager.py import json import hashlib import os from typing import List, Dict class AccountManager: def __init__(self, data_file='accounts.dat'): self.data_file = data_file self.salt = "MHY_CWF_SALT_2024" # 固定的盐值，用于增强哈希安全性 def _hash_password(self, password: str) -> str: """对密码进行加盐哈希""" salted_password = password + self.salt return hashlib.sha256(salted_password.encode()).hexdigest() def save_account(self, username: str, password: str) -> bool: """ 保存一个新账号（密码会被哈希存储） :return: 成功返回True，用户名已存在返回False """ accounts = self.load_accounts() # 检查用户名是否已存在 if any(acc['username'] == username for acc in accounts): return False new_account = { 'username': username, 'password_hash': self._hash_password(password) # 存储哈希值，而非明文 } accounts.append(new_account) try: with open(self.data_file, 'w', encoding='utf-8') as f: json.dump(accounts, f, ensure_ascii=False, indent=4) return True except Exception as e: print(f"保存账号时出错: {e}") return False def load_accounts(self) -> List[Dict]: """从文件加载所有账号信息""" if not os.path.exists(self.data_file): return [] try: with open(self.data_file, 'r', encoding='utf-8') as f: accounts = json.load(f) return accounts except Exception as e: print(f"加载账号时出错: {e}") return [] def verify_account(self, username: str, password: str) -> bool: """验证账号密码是否正确""" accounts = self.load_accounts() target_hash = self._hash_password(password) for acc in accounts: if acc['username'] == username and acc['password_hash'] == target_hash: return True return False # 示例：添加账号的独立函数（可作为未来GUI扩展的接口） def add_account_via_cli(): """命令行方式添加账号（预留接口）""" manager = AccountManager() username = input("请输入账号: ") password = input("请输入密码: ") if manager.save_account(username, password): print("账号添加成功！") else: print("账号已存在或添加失败！") ``` #### 2.4 主控制模块 (`main_controller.py`) 此模块作为程序的“大脑”，整合所有部分，并处理线程和事件。 ```python # main_controller.py import threading from gui_interface import LoginGUI from auto_login import GameAutoLogin class MainController: def __init__(self): self.gui = None self.auto_login_engine = None self.login_thread = None def start_auto_login(self): """启动自动登录线程""" if self.auto_login_engine and self.auto_login_engine.is_running: print("自动登录已在运行中。") return # 创建业务逻辑实例，并传入GUI的日志更新方法作为回调 self.auto_login_engine = GameAutoLogin(gui_callback=self.gui.update_log) self.login_thread = threading.Thread(target=self.auto_login_engine.start, daemon=True) self.login_thread.start() def stop_auto_login(self): """停止自动登录""" if self.auto_login_engine: self.auto_login_engine.stop() if self.login_thread: self.login_thread.join(timeout=5.0) # 等待线程结束，最多5秒 self.gui.update_log("自动登录任务已终止。") def run(self): """启动程序主循环""" # 初始化GUI，传入自身实例以便GUI调用控制器方法 self.gui = LoginGUI(self) # 运行GUI事件循环 (这是阻塞的，直到窗口关闭) self.gui.run() if __name__ == '__main__': # 程序入口 app = MainController() app.run() ``` ### 3. 项目接口预留与扩展设计 为满足未来功能扩展，本设计在以下方面预留了接口： 1. **账号管理功能**：GUI中的“账号管理”按钮 (`-ACCOUNT-`) 目前仅打印日志。未来可在此事件下创建一个新的账号管理窗口，集成 `AccountManager` 类的增删改查功能，实现可视化账号管理。 2. **登录策略抽象**：`GameAutoLogin.login_procedure` 方法目前是硬编码的点击流程。未来可将其抽象为一个 `LoginStrategy` 接口或基类，针对不同游戏版本或服务器（如正式服、测试服）派生不同的策略类，实现流程的动态配置。 3. **多开与队列管理**：当前 `start` 方法简单遍历账号列表。可扩展为 `AccountScheduler` 类，支持配置登录顺序、间隔时间、多实例并行启动（需更复杂的窗口查找和句柄管理）等功能[ref_2]。 4. **状态上报与网络接口**：在 `_log` 方法中，除了更新GUI，未来可以增加向远程服务器发送状态报告的功能，实现云端监控。 5. **配置文件**：可增加 `config.yaml` 文件，用于管理窗口标题关键词、点击坐标、延迟时间、是否启用加密等参数，使程序更灵活。 ### 4. 部署与运行步骤 1. **环境准备**：确保安装 Python (推荐3.7+)。使用以下命令安装依赖库： ```bash pip install PySimpleGUI pywin32 pynput ``` （注：`pynput` 可作为 `PyUserInput` 的现代替代品用于前台键盘输入，本例为简化使用后台消息模拟。） 2. **文件组织**：将上述四个 `.py` 文件 (`main_controller.py`, `gui_interface.py`, `auto_login.py`, `account_manager.py`) 放在同一目录下。 3. **初始化账号**：可以先运行一个简单的脚本或直接调用 `AccountManager.save_account` 来添加你的游戏账号密码。 4. **启动程序**：运行 `python main_controller.py`。此时将弹出控制窗口。 5. **操作流程**： * 确保梦幻西游客户端已启动。 * 在GUI窗口中点击 **“开始登录”**，程序将自动查找游戏窗口并执行预设的登录点击流程。 * 观察日志区域查看运行状态。 * 点击 **“停止程序”** 终止自动化任务。 * 点击 **“退出”** 关闭程序。 **重要提醒**：本程序提供的点击坐标 (`(400, 300)` 等) 仅为示例，在实际使用前**必须**使用 Spy++ 或其他工具获取您本地游戏客户端窗口内**目标按钮的真实客户区坐标**，并修改 `auto_login.py` 中的相应坐标[ref_4]。自动化操作应仅用于个人学习和效率提升，请严格遵守游戏用户协议。