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 会自动执行完整的分析流程：
数据捕获阶段：通过先进的中间人技术实时获取游戏通信数据，确保分析的准确性。
