Akagi 是一款专为雀魂(Mahjong Soul)游戏设计的智能助手客户端,能够实时捕获游戏数据流,通过 AI 分析提供专业的麻将决策建议。这款开源工具不仅能帮助玩家提升麻将技能,还能深入理解对局表现,是麻将爱好者必备的学习分析工具。
项目核心功能解析
Akagi 麻雀助手通过先进的技术架构实现了多维度麻将分析功能。核心功能包括:
实时数据捕获:通过中间人技术实时获取游戏通信数据,确保分析的准确性和及时性。
智能 AI 分析:基于先进的 Mortal 模型提供专业的打牌建议,帮助玩家做出更优决策。
可视化界面:通过清晰的用户界面展示分析结果,让复杂的数据变得直观易懂。
快速安装指南
Windows 系统一键安装
Windows 用户可以通过简单的 PowerShell 脚本完成快速安装:
- 下载安装脚本
scripts/install_akagi.ps1 - 以管理员身份运行 PowerShell
- 设置执行策略:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass - 执行安装命令:
.\install_akagi.ps1
macOS 系统便捷安装
macOS 用户同样可以轻松完成安装:
- 获取安装脚本
scripts/install_akagi.command - 在终端中执行:
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 会自动执行完整的分析流程:
数据捕获阶段:通过先进的中间人技术实时获取游戏通信数据,确保分析的准确性。

