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辅助工具能够实时分析你的牌局，提供精准的决策建议，让你从麻将新手快速成长为战术高手。Akagi是一个实时麻将AI助手，支持雀魂、天凤、Riichi City等多种平台，通过智能分析帮助玩家做出最优决策。

🎯 为什么你需要Akagi？麻将玩家的三大困境

想象一下这样的场景：你正在玩雀魂，手牌看起来不错，但不知道该打哪张牌最安全。左边对手刚刚立直，右边对手一直在做清一色，你该怎么办？这就是Akagi要解决的问题！

常见困境与解决方案

困境一：决策困难症

• 传统方案：凭感觉打牌，经常后悔
• Akagi方案：实时AI分析，提供最优打法建议

困境二：学习瓶颈期

• 传统方案：看视频学习，效果有限
• Akagi方案：结构化学习，记录关键决策点

困境三：复盘无头绪

• 传统方案：手动记录，容易遗漏细节
• Akagi方案：自动保存对局，多维度分析

困境四：战术单一化

• 传统方案：固定打法，难以适应不同场况
• Akagi方案：个性化建议，智能调整策略

🛠️ Akagi智能工具箱：麻雀虽小，五脏俱全

Akagi就像你的私人麻将教练，配备了完整的工具箱：

游戏数据捕获 → 协议解析转换 → AI智能分析 → 实时建议呈现

数据捕获层：透明观察窗口

通过MITM（中间人）技术，Akagi能够实时获取雀魂游戏的网络数据流，就像在游戏服务器和你之间安装了一个透明的观察窗口，不干扰你的正常游戏体验。

协议转换层：语言翻译官

将雀魂专用的LiqiProto格式转换为标准的mjai格式，让不同的AI模型都能理解游戏状态，就像为不同国家的麻将玩家配备翻译官。

AI决策层：深度学习大脑

内置Mortal AI模型，基于深度学习算法分析当前局势，计算每张牌的打牌价值，综合考虑牌效率、安全度、役种概率等关键因素。

结果呈现层：直观可视化界面

以直观的界面展示AI建议，包括牌效率评估、安全度评分、役种概率等关键信息，让你一目了然。

Akagi智能麻将助手界面展示

🚀 十分钟快速上手：从下载到实战

准备工作清单

在开始安装前，请确保准备好以下内容：

• ✅ Python 3.8-3.10环境（Akagi已内置）
• ✅ 雀魂网页版账号（推荐使用网页版）
• ✅ 约500MB可用磁盘空间
• ✅ 稳定的网络连接

安装步骤详解

第一步：获取项目代码

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

第二步：运行安装脚本

Windows用户：

1. 以管理员身份打开PowerShell
2. 进入Akagi目录
3. 执行：Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
4. 运行：.\scripts\install_akagi.ps1

macOS用户：

1. 打开终端
2. 进入Akagi目录
3. 执行：chmod +x scripts/install_akagi.command
4. 运行：./scripts/install_akagi.command

第三步：获取AI模型文件

Akagi需要Mortal AI模型才能工作，获取方法：

1. 加入项目Discord社区
2. 完成身份验证
3. 下载bot.zip文件
4. 解压后将mortal.pth文件放入mjai/bot/目录

第四步：配置代理和证书

1. 首次运行后关闭mitmproxy
2. 进入~/.mitmproxy目录
3. 安装CA证书（具体步骤根据操作系统不同）
4. 配置浏览器代理为127.0.0.1:7878

验证安装是否成功

启动Akagi后，访问http://localhost:7878，如果能看到代理状态页面，恭喜你！安装成功了！

🎮 实战应用场景：Akagi在不同阶段的用法

阶段一：新手适应期（初段-三段）

核心目标：建立基础战术意识

每日练习计划：

1. 完成2局实战，每局后查看AI决策建议
2. 记录3个与AI决策不同的关键选择
3. 学习1个基础战术概念（如牌效率）

阶段二：技能提升期（四段-七段）

核心目标：掌握复杂局势处理

实战技巧：

• 在南四局听牌阶段，Akagi会综合考虑点数状况、对手舍牌记录和剩余牌山
• 提供"立直进攻"或"弃和防守"的明确建议
• 帮助你在关键局做出最优决策

阶段三：战术精通期（八段以上）

核心目标：形成个人战术风格

高级功能应用：

• 自定义评估参数，调整AI决策权重
• 针对特殊场景（亲家、追立）进行专项训练
• 多模型对比分析，理解不同AI的思考差异

📊 界面操作指南：快速掌握Akagi使用技巧

主界面布局解析

┌─────────────────┬─────────────────┐ │ LiqiProto消息 │ MJAI消息 │ │ (游戏原始数据) │ (AI返回数据) │ ├─────────────────┴─────────────────┤ │ 你的手牌显示区 │ ├───────────────────────────────────┤ │ 设置选项 │ AI动作建议 │ └───────────────────────────────────┘

操作流程说明

1. 开始游戏：点击底部的"Game" websocket流
2. 等待加载：可能需要几秒钟时间，请耐心等待
3. 查看建议：AI会在右侧显示推荐动作
4. 手动操作：根据建议在游戏中打牌

重要提示：点击一次后等待，不要多次点击，避免程序卡顿。

🔒 安全使用指南：保护你的雀魂账号

使用第三方工具总是存在风险，以下措施可以最大程度保护你的账号安全：

安全等级清单

✅强烈推荐的做法：

• 使用网页版而非Steam客户端
• 关闭Autoplay功能，手动操作
• 经常使用表情贴纸，模拟真人行为
• 不完全遵循AI建议，加入个人判断

⚠️需要谨慎的做法：

• 使用MajsoulUnlocker功能（修改websocket）
• 长时间连续游戏（超过4小时）
• 在比赛中表现过于完美

❌绝对避免的做法：

• 24小时不间断使用自动打牌
• 完全依赖AI决策，不加思考
• 在官方比赛中使用辅助工具

账号安全配置参考

{ "Unlocker": false, // 禁用MajsoulUnlocker "Autoplay": false, // 禁用自动打牌 "RandomTime": { "new_min": 3.5, // 新牌思考时间 "new_max": 4.5, "min": 1.0, // 常规思考时间 "max": 3.2, "moqiedelay": true // 模拟真人延迟 } }

🆘 常见问题解决：遇到问题怎么办？

安装问题排查表

使用中的常见问题

Q：AI建议总是和我的想法不同，该相信谁？A：Akagi是基于大量对局数据训练的，但麻将也有运气成分。建议先理解AI的思考逻辑，再结合场况做出最终决定。

Q：为什么有时候AI反应很慢？A：复杂局面需要更多计算时间。你可以在settings.json中调整RandomTime参数来优化响应速度。

Q：如何保存和复盘对局记录？A：Akagi会自动保存对局数据，使用majsoul2mjai.py工具可以将记录转换为可分析的格式。

📈 进阶技巧：从工具使用者到战术专家

数据分析与复盘

基础复盘：

python majsoul2mjai.py --input logs/recent_game.json --output analysis/

深度分析：

python convert.py --mode stat --input analysis/ --output report/

对比学习：

python compare_games.py --game1 game1.json --game2 game2.json --focus defense

个性化训练计划

30天能力提升路径：

第1-7天：基础适应

• 目标：熟悉界面和基础功能
• 任务：每天2局实战，记录AI建议差异

第8-14天：功能探索

• 目标：掌握高级功能
• 任务：使用复盘工具，调整配置参数

第15-21天：战术实践

• 目标：将AI建议转化为能力
• 任务：先自己决策，再对比AI建议

第22-30天：独立应用

• 目标：形成个人战术体系
• 任务：减少AI依赖，总结个人风格

🏗️ 项目架构深度解析

核心模块说明

Akagi/ ├── mjai/ # AI核心模块 │ ├── bot/ # AI模型目录 │ ├── http_server/ # HTTP服务 │ └── player.py # 玩家接口 ├── mhm/ # 主程序模块 │ ├── hook/ # 钩子函数 │ ├── proto/ # 协议定义 │ └── main.py # 主程序 ├── mahjong_soul_api/ # 雀魂API │ ├── ms/ # 主游戏API │ └── ms_tournament/ # 比赛API └── scripts/ # 安装脚本

关键技术亮点

1. 实时数据捕获：MITM技术实现无延迟游戏数据获取
2. 协议转换：LiqiProto到mjai格式的高效转换
3. AI集成：支持多种麻将AI模型，默认使用Mortal
4. 用户界面：简洁直观的TUI界面，实时显示建议

🤝 社区支持与资源

获取帮助的途径

1. Discord社区：实时交流，获取最新模型
2. GitHub Issues：报告bug，请求新功能
3. YouTube教程：视频指导安装和使用

贡献项目的方式

• 提交Pull Request改进代码
• 分享你的bot.zip文件
• 报告使用中发现的bug
• 提供功能改进建议

🎉 总结：智能辅助与麻将智慧的完美结合

Akagi不仅仅是一个工具，更是一位24小时在线的麻将教练。它通过实时分析、智能建议和数据记录，帮助你系统性提升麻将水平。但记住最重要的原则：技术是辅助，理解才是核心。

通过Akagi的辅助，结合持续的学习和实践，你将不仅提升雀魂游戏水平，更能培养战略思维和决策能力。这些能力将伴随你在麻将之外的生活中持续发挥价值。

现在就开始你的Akagi之旅，让智能辅助带你进入麻将的新境界！记住，最好的学习方式是在实战中应用，在思考中进步。祝你在雀魂的世界中不断突破自我，享受麻将带来的乐趣与挑战。

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