Akagi 雀魂助手使用指南：AI 麻将分析

Akagi 是一款专为雀魂（Mahjong Soul）游戏设计的智能助手客户端，能够实时捕获游戏数据流，通过 AI 分析提供专业的麻将决策建议。这款开源工具不仅能帮助玩家提升麻将技能，还能深入理解对局表现，是麻将爱好者必备的学习分析工具。

项目核心功能解析

Akagi 麻雀助手通过先进的技术架构实现了多维度麻将分析功能。核心功能包括：

实时数据捕获：通过中间人技术实时获取游戏通信数据，确保分析的准确性和及时性。

智能 AI 分析：基于先进的 Mortal 模型提供专业的打牌建议，帮助玩家做出更优决策。

可视化界面：通过清晰的用户界面展示分析结果，让复杂的数据变得直观易懂。

快速安装指南

Windows 系统一键安装

Windows 用户可以通过简单的 PowerShell 脚本完成快速安装：

1. 下载安装脚本 scripts/install_akagi.ps1
2. 以管理员身份运行 PowerShell
3. 设置执行策略：

   Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
   

4. 执行安装命令：

   .\install_akagi.ps1
   

macOS 系统便捷安装

macOS 用户同样可以轻松完成安装：

1. 获取安装脚本 scripts/install_akagi.command
2. 在终端中执行：

   bash install_akagi.command
   

核心模型配置要点

完成基础安装后，需要配置 AI 分析模型：

• 将 mortal.pth 模型文件放置到 mjai/bot 目录
• 验证模型文件完整性，确保 AI 功能正常运行

关键配置参数详解

在 settings.json 配置文件中，您可以调整以下关键参数来优化使用体验：

配置项	功能说明	推荐设置
Helper	麻将助手集成开关	false
Autoplay	自动打牌模式	false
Port.MITM	中间人代理端口	7878
Port.MJAI	AI 机器人端口	28680

网络代理设置技巧

为确保 Akagi 正常运行，必须完成网络代理配置：

• 将雀魂游戏连接重定向到指定的中间人端口
• 安装必要的 SSL 安全证书
• 验证代理连接状态，确保数据传输畅通

实战应用操作流程

实时对局分析全流程

当您参与麻将对局时，Akagi 会自动执行完整的分析流程：

数据捕获阶段：通过先进的中间人技术实时获取游戏通信数据，确保分析的准确性。