Akagi麻将AI助手：5分钟从零开始打造你的智能牌局分析系统

Akagi麻将AI助手：5分钟从零开始打造你的智能牌局分析系统

【免费下载链接】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助手来帮你！这是一个开源项目，专为雀魂、天鳳、麻雀一番街、天月麻將等主流日本麻将平台设计，能够实时分析对局并提供AI建议。今天，我将带你从零开始，5分钟内搭建起这个强大的智能辅助系统！

你知道吗？Akagi采用了创新的MITM（中间人）代理技术，可以实时截获游戏通信，将复杂的麻将决策过程转化为数据驱动的科学分析。✨ 这可不是简单的屏幕识别工具，而是真正理解游戏协议的智能系统！

第一章：痛点分析 - 传统麻将工具的三大困扰

1.1 延迟问题：为什么你的AI总是慢半拍？

传统麻将AI工具通常采用离线复盘或屏幕识别方案，这导致了响应延迟高的问题。想象一下，当你需要快速决策时，AI还在分析上一手牌的情况，这种延迟会让你错过最佳时机。

1.2 准确率问题：识别错误带来的灾难

屏幕识别方案存在识别准确率低的痛点。牌面识别错误、对手动作误判，这些都会导致AI给出错误的建议。Akagi通过直接解析游戏协议，实现了100%的牌局信息准确性。

1.3 学习成本：复杂的配置让你望而却步

很多AI工具需要复杂的配置和环境搭建，对于普通玩家来说门槛太高。Akagi的设计哲学是简单易用，即使是技术小白也能快速上手。

第二章：解决方案 - Akagi的三层智能架构

2.1 通信拦截层：游戏协议的"翻译官"

Akagi的核心在于它的mitm.py模块。这个模块建立了一个中间人代理，能够实时捕获雀魂的WebSocket通信。就像在游戏服务器和你的客户端之间安装了一个"翻译器"，它能理解游戏的所有对话。

小技巧：这个层不仅支持雀魂，还通过mahjong_soul_api/目录下的协议适配层，实现了对多个麻将平台的兼容。

2.2 协议解析层：从游戏数据到AI语言

游戏协议是复杂的二进制数据，AI无法直接理解。Akagi的liqi.py和majsoul2mjai.py模块负责将雀魂专有协议转换为通用的mjai格式。

你知道吗？这种设计使得系统能够支持多种麻将AI模型，而不仅限于内置的Mortal AI。你可以轻松集成自己喜欢的模型！

2.3 AI决策层：80MB模型带来的智能革命

最令人惊叹的是，Akagi内置的Mortal AI模型仅需80MB存储空间！在普通消费级硬件上即可实现100ms以内的推理延迟，完全不影响游戏体验。

mjai/bot/model.py中的轻量化AI集成，让每个人都能享受到专业级的麻将分析。

第三章：实战演示 - 手把手教你搭建Akagi

3.1 环境准备：三步搞定基础配置

第一步：克隆项目仓库

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

第二步：安装依赖

pip install -r requirement.txt

第三步：获取AI模型从Discord社区获取mortal.pth模型文件，放置于mjai/bot/目录

3.2 快速配置：修改关键参数

打开settings.json文件，调整以下参数：

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

🚀重要提示：请务必保持Autoplay为false，这是为了教育目的而非自动游戏！

3.3 启动运行：选择适合你的模式

Akagi支持三种运行模式：

1. 学习模式：详细展示决策依据和概率计算过程
2. 实战模式：精简输出，专注于实时建议
3. 复盘模式：导入历史对局数据进行深度分析

启动命令很简单：

python client.py

第四章：核心功能深度体验

4.1 实时牌局状态分析

当你开始一局游戏时，Akagi会实时解析游戏状态。libriichi_helper.py中的算法会将雀魂的内部游戏状态转换为AI可理解的格式。

牌效率计算是Akagi的强项。它基于进张数最大化原则推荐最优的切牌选择，不仅考虑当前听牌概率，还计算未来3-5巡的期望进张数。

4.2 风险评估系统：对手立直时的救命稻草

当对手立直时，Akagi的风险评估系统自动启动。系统通过概率计算模块，分析每张剩余牌的放铳概率：

4.3 多平台兼容性：一劳永逸的解决方案

Akagi支持的主流麻将平台：

• ✅雀魂：Web版和Steam版完整支持
• ✅天鳳：通过协议转换完美支持
• 🚧麻雀一番街：适配中
• ✅天月麻將：基础支持已实现

第五章：进阶技巧与优化指南

5.1 性能优化：让老电脑也能流畅运行

如果你的设备性能有限，可以通过修改mhm/config.py调整系统参数：

# 性能优化配置示例 config = { "analysis_depth": 3, # 减少分析深度 "enable_visualization": False, # 关闭可视化 "cache_size": 100, # 减少缓存大小 "batch_size": 1 # 单批次推理 }

5.2 自定义AI模型：打造专属智能助手

Akagi设计了灵活的AI模型接口，开发者可以轻松集成自定义模型：

# 自定义AI模型集成示例 class CustomAIBot: def __init__(self, model_path: str): self.model = load_custom_model(model_path) def react(self, mjai_events: str) -> str: # 实现自定义推理逻辑 return self.model.predict(mjai_events)

5.3 网络连接优化：稳定流畅的游戏体验

Akagi的网络模块支持多种代理配置：

1. 直连模式：最低延迟，适合稳定网络环境
2. 代理模式：通过proxinject支持Steam客户端
3. 混合模式：Web版直连，Steam版代理

第六章：使用场景对比表

第七章：常见问题FAQ

Q1：Akagi会被雀魂检测到吗？

A：Akagi设计为教育工具，通过MITM代理分析游戏数据，不修改游戏客户端。但任何第三方工具都有风险，建议适度使用。

Q2：需要什么样的电脑配置？

A：最低配置：Python 3.8+，4GB RAM。推荐配置：支持CUDA的GPU，可以加速AI推理。

Q3：支持哪些麻将平台？

A：目前完整支持雀魂、天鳳、天月麻將，麻雀一番街正在适配中。

Q4：如何获取mortal.pth模型？

A：加入Akagi的Discord社区，在相关频道中获取。

Q5：Akagi会影响游戏流畅度吗？

A：优化良好的配置下，AI推理延迟在100ms以内，基本不影响游戏体验。

第八章：版本特性对比

第九章：快速开始流程图

开始 ↓ 克隆项目仓库 ↓ 安装Python依赖 ↓ 获取AI模型文件 ↓ 修改配置文件 ↓ 启动MITM代理 ↓ 配置游戏网络 ↓ 启动Akagi客户端 ↓ 开始游戏分析 ↓ 实时接收AI建议

第十章：安全使用指南与最佳实践

10.1 账号安全第一原则

为确保账号安全，建议遵循以下准则：

1. 平台选择：优先使用网页版而非Steam客户端
2. 功能限制：禁用Autoplay功能，手动操作
3. 行为模拟：经常使用表情贴纸，模拟人类行为
4. 使用频率：避免24小时连续使用，设置合理休息时间

10.2 学习与提升的正确姿势

Akagi不仅是游戏辅助工具，更是麻将策略学习平台。通过分析AI的决策过程，你可以：

• 理解牌效率的数学基础
• 掌握防守理论的概率计算
• 学习局势判断的综合分析方法
• 培养长期策略的思维框架

10.3 社区参与：与高手一起进步

加入Akagi的Discord社区，你可以：

• 分享使用经验和进阶技巧
• 获取最新的模型和配置
• 参与项目开发和功能建议
• 与其他麻将爱好者交流学习

结语：从依赖直觉到数据驱动的转变

Akagi代表了麻将AI辅助工具的技术前沿，通过创新的MITM架构和深度学习模型集成，为麻将爱好者提供了前所未有的学习工具。💡

这个项目的核心价值在于教育导向而非替代玩家。正如开发者所说："这个项目的目的是为了提供人们一种方便的方式，能够即时了解他们在游戏对局中的表现，并从中学习和进步。"

通过科学的数据分析和AI建议，Akagi不仅能够帮助你提升游戏水平，更能深入理解麻将的策略本质，实现从经验驱动到数据驱动的思维转变。

现在就开始你的Akagi之旅吧！5分钟的配置，带来的可能是麻将水平的质的飞跃。🚀

【免费下载链接】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