Akagi雀魂助手：智能麻将分析与实战指南

2026-02-07 04:11:39作者：魏侃纯Zoe

Akagi雀魂助手是一款专为雀魂麻将游戏设计的智能辅助客户端，通过集成先进的AI分析模型，能够实时解析牌局并提供精准的操作建议。该项目旨在为玩家提供便捷的方式实时了解自己在雀魂游戏中的表现，并通过学习来不断提升麻将技巧。

项目概述

Akagi雀魂助手通过中间人代理技术捕获游戏数据流，将原始协议转换为标准的MJAI格式，再由AI模型进行分析决策，最终将建议反馈给玩家。整个系统包含多个核心模块：MITM数据捕获、协议转换、AI分析引擎和用户界面。

核心功能特性

智能决策分析

实时数据捕获：通过MITM技术自动获取游戏过程中的所有关键信息
AI策略推荐：基于当前牌局提供最优操作建议
多模型支持：支持多种AI模型配置，满足不同玩家的需求

自动化操作

自动和牌检测：智能识别可和牌型并提供提示
智能鸣牌判断：根据局势分析是否需要吃、碰、杠
自适应策略：根据对手风格和牌局演变调整推荐策略

用户界面设计

该界面采用深色主题设计，分为上下两个主要部分：

上半部分：显示雀魂麻将游戏的实际界面，包含手牌、场况和其他玩家信息
下半部分：Akagi辅助工具的控制面板，提供操作建议和系统设置

安装部署指南

Windows系统安装

下载安装脚本 install_akagi.ps1 到目标目录
以管理员身份打开PowerShell
切换到脚本所在目录
执行命令：Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
运行：install_akagi.ps1
首次使用需完成MITM代理证书安装

macOS系统安装

下载安装脚本 install_akagi.command 到目标目录
打开终端并切换到脚本目录
执行：bash install_akagi.command
安装完成后进入Akagi文件夹
双击 run_akagi.command 启动应用程序

模型文件配置

将AI模型文件 mortal.pth 放置在指定目录：

Windows：./Akagi/mjai/bot/
macOS：./Akagi/mjai/bot/

系统配置详解

settings.json配置文件

{
  "Unlocker": false,
  "v10": false,
  "Autoplay": false,
  "Helper": false,
  "Autohu": false,
  "Port": {
    "MITM": 8080,
    "XMLRPC": 41112,
    "MJAI": 41113
}

主要配置项说明：

Unlocker：是否启用MajsoulUnlocker功能
Autoplay：自动游戏模式开关
Helper：麻将助手功能启用
Autohu：自动和牌功能
Port：网络端口配置，包括MITM代理端口、XMLRPC端口和MJAI端口

使用操作流程

启动MITM代理

首次启动需点击"start mitm"按钮激活代理服务，确保数据捕获功能正常运行。

模型选择配置

在模型设置界面，用户可以选择不同的AI模型进行辅助分析，每个模型可能具有不同的策略特点和决策风格。

安全使用建议

为最大限度保护游戏账号安全，建议遵循以下原则：

优先使用网页版本：相比客户端版本风险更低
合理使用频率：避免长时间连续使用自动化功能
保持自然行为：适当使用游戏内表情和互动功能
适度参考建议：不完全依赖AI决策，保持个人判断

风险规避策略

避免在Steam平台使用辅助工具
合理设置自动化功能的使用频率
定期检查系统更新，获取最新的安全功能

故障排除与支持

常见问题解决

Q：启动时遇到证书错误怎么办？ A：请重新执行证书安装步骤，确保所有安全设置正确配置。

Q：如何获取AI模型文件？ A：需要从官方认证渠道下载合法的模型文件，放置于指定目录即可激活使用。

技术支持渠道

项目文档：docs/
问题反馈：issues/

项目架构说明

核心模块结构

Akagi/
├── scripts/Akagi/          # 主程序目录
├── mjai/                    # MJAI协议处理
├── mahjong_soul_api/        # 雀魂API接口
├── mitm/                    # MITM代理模块
└── players/                  # AI模型存放目录