Akagi麻将AI助手：终极免费工具实现雀魂实时分析与智能决策

Akagi麻将AI助手：终极免费工具实现雀魂实时分析与智能决策

【免费下载链接】Akagi支持雀魂、天鳳、麻雀一番街、天月麻將，能夠使用自定義的AI模型實時分析對局並給出建議，內建Mortal AI作為示例。 Supports Majsoul, Tenhou, Riichi City, Amatsuki, with the ability to use custom AI models to analyze games in real time and provide suggestions. Comes with Mortal AI as a built-in example.项目地址: https://gitcode.com/gh_mirrors/ak/Akagi

想要在雀魂、天鳳、麻雀一番街等主流麻将平台中提升自己的实战水平吗？Akagi麻将AI助手为您提供了一套完整的解决方案。这个开源项目能够实时分析您的对局，提供专业的决策建议，内置Mortal AI作为示例模型，帮助您从每场对局中学习和成长。通过简单的部署配置，您就能获得一个强大的麻将AI分析伙伴。

🚀 五分钟快速上手：从零到一的完整流程

环境准备与项目获取

在开始之前，请确保您的系统满足以下基本要求：

• 操作系统：Windows 10/11 64位或macOS 10.15以上版本
• Python环境：Python 3.8或更高版本
• 基础工具：Git版本控制工具

使用以下命令获取项目代码：

git clone https://gitcode.com/gh_mirrors/ak/Akagi cd Akagi

一键式安装配置

Akagi提供了便捷的安装脚本，根据您的操作系统选择合适的安装方式：

Windows用户：

# 以管理员权限运行PowerShell .\scripts\install_akagi.ps1

macOS/Linux用户：

# 给予执行权限并运行 chmod +x ./scripts/install_akagi.command ./scripts/install_akagi.command

AI模型配置与项目启动

安装完成后，您需要获取AI模型文件。将下载的mortal.pth文件放置到指定目录：

mjai/bot/mortal.pth

启动Akagi系统非常简单，只需运行：

python -m mhm

⚙️ 核心配置详解：个性化您的AI助手

基础配置文件解析

打开settings.json文件，您可以看到所有核心配置选项：

{ "Unlocker": false, "Autoplay": false, "Helper": false, "Autohu": false, "Port": { "MITM": 7878, "XMLRPC": 7879, "MJAI": 28680 } }

关键配置项说明：

• Helper：实时分析建议开关，建议设置为true以获得最佳学习体验
• Autohu：自动和牌功能，适合新手练习时开启
• Port.MITM：代理监听端口，如果端口冲突可修改为其他值

AI决策参数调整

在mjai/bot/bot.py中，您可以微调AI的行为模式：

# 风险偏好设置示例 class Bot: def __init__(self, player_id: int): self.player_id = player_id # 这里可以调整AI的决策风格

实战建议：

• 对于进攻型玩家，可以适当降低风险系数
• 对于防守型玩家，提高风险系数以获得更保守的建议
• 在关键局中，可以临时调整参数以获得更精准的分析

🎮 实战应用场景：从学习到提升

实时对局分析

Akagi最强大的功能之一是实时对局分析。当您进行游戏时，系统会自动：

1. 数据捕获：通过mhm/模块实时获取游戏状态
2. AI分析：mjai/模块处理数据并提供决策建议
3. 结果显示：在游戏界面中显示分析结果和建议

多平台支持

Akagi支持多个主流麻将平台，包括：

• 雀魂：通过mahjong_soul_api/实现完整支持
• 天鳳：专业的日本麻将平台适配
• 麻雀一番街：国内流行的竞技平台
• 天月麻将：新兴的在线麻将平台

学习模式与实战演练

新手学习阶段：

• 开启Helper功能，获取每一步的建议
• 使用Autohu功能辅助和牌判断
• 分析AI建议与实际决策的差异

进阶提升阶段：

• 关闭辅助功能，仅使用分析建议
• 对比不同AI模型的决策差异
• 通过convert.py分析历史对局数据

🔧 高级定制与扩展开发

自定义AI模型集成

如果您有自己的AI模型，可以轻松集成到Akagi中：

1. 模型准备：将训练好的模型文件放置在mjai/bot/目录
2. 接口适配：修改model.py中的模型加载逻辑
3. 参数调整：根据模型特性调整决策参数

协议扩展与平台适配

要为新的麻将平台添加支持，您需要：

1. 协议分析：研究新平台的通信协议
2. 模块开发：在mahjong_soul_api/下创建新的适配模块
3. 协议处理：参考liqi_proto/中的实现方式

数据分析与统计功能

Akagi内置了丰富的数据分析工具：

• 对局记录：自动保存每场对局的详细数据
• 统计报告：生成胜率、打点效率等关键指标
• 趋势分析：识别您的打牌习惯和改进空间

🛡️ 安全使用指南与最佳实践

合规使用原则

Akagi设计初衷是作为学习辅助工具，使用时请遵循：

1. 学习优先：将AI建议作为参考，而非完全依赖
2. 手动操作：保持手动操作习惯，避免全自动模式
3. 适度使用：在休闲对局中使用，避免影响游戏公平性

性能优化建议

网络配置：

• 确保代理端口（默认7878）未被其他程序占用
• 如果遇到连接问题，尝试修改sports.json中的端口设置

系统资源：

• 确保有足够的内存运行Python进程
• 定期清理临时文件，保持系统流畅

故障排除与支持

常见问题：

• 启动失败：检查Python版本和依赖包安装
• 无法连接：确认代理设置和端口配置
• AI无响应：验证模型文件路径和权限

获取帮助：

• 查看项目文档和示例代码
• 参考example.py中的使用示例
• 查阅在线社区和讨论区

📊 从工具到伙伴：Akagi的学习价值

Akagi不仅仅是一个技术工具，更是一个可以伴随您成长的麻将学习伙伴。通过持续使用和分析，您将能够：

1. 理解AI决策逻辑：学习专业麻将AI的思考方式
2. 识别个人弱点：发现并改进自己的打牌习惯
3. 提升决策质量：在关键时刻做出更明智的选择
4. 建立系统思维：从整体角度理解麻将的策略体系

无论您是麻将初学者希望快速入门，还是资深玩家寻求突破瓶颈，Akagi都能为您提供有价值的帮助。记住，最好的学习方式是实践与反思的结合，而Akagi正是连接这两者的桥梁。

开始您的麻将AI学习之旅吧，让每一次对局都成为提升的机会！

【免费下载链接】Akagi支持雀魂、天鳳、麻雀一番街、天月麻將，能夠使用自定義的AI模型實時分析對局並給出建議，內建Mortal AI作為示例。 Supports Majsoul, Tenhou, Riichi City, Amatsuki, with the ability to use custom AI models to analyze games in real time and provide suggestions. Comes with Mortal AI as a built-in example.项目地址: https://gitcode.com/gh_mirrors/ak/Akagi