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模型和强大的数据分析能力，Akagi帮助玩家理解牌局动态，提升麻将技巧，成为你牌桌上的智能教练。

🎯 为什么选择Akagi？三大核心价值解析

在复杂的麻将对局中，每一手牌都可能影响最终胜负。Akagi通过先进的技术架构和智能算法，为不同水平的玩家提供精准的辅助支持。

实时数据分析，决策更科学

Akagi每秒分析超过200种可能的牌局发展方向，将复杂的麻将概率转化为直观建议。无论是向听数计算、听牌分析，还是放铳风险评估，Akagi都能提供数据驱动的决策依据。

个性化学习路径，成长更迅速

通过记录并分析你的决策习惯，Akagi能够逐步引导你形成个人化的战术体系。无论你是初学者还是进阶玩家，都能找到适合自己的学习路径。

零门槛上手，体验更流畅

无需专业编程知识，通过简单的配置即可启用强大的AI功能。Akagi提供两种捕获模式，满足不同用户的使用习惯。

🚀 快速上手：10分钟开启你的AI麻将之旅

第一步：下载与安装

Akagi提供跨平台支持，你可以根据操作系统选择对应的版本：

第二步：首次启动配置

首次运行Akagi时，设置向导会引导你完成以下步骤：

1. 语言选择：支持中文、英文、日文等多种语言界面
2. 平台选择：选择你常用的麻将平台（雀魂、天鳳等）
3. 捕获模式：推荐新手使用Chromium模式，无需证书配置
4. AI模型安装：一键安装Mortal AI模型

第三步：开始使用

配置完成后，Akagi会自动启动游戏浏览器，你可以直接登录麻将平台开始对局。AI分析面板会实时显示在你的游戏界面旁。

🎮 三大使用场景：从新手到高手的进阶之路

新手入门：基础功能快速掌握

如果你是麻将新手，Akagi的观察模式是你的最佳选择。在这个模式下，AI会分析牌局但不自动操作，让你对比自己的决策与AI建议的差异。

💡 新手建议：先专注于理解AI的"推荐切牌"和"危险牌判断"功能，逐步建立基本的麻将策略思维。

进阶提升：深度分析提升胜率

当你掌握了基本规则，Akagi的以下功能能帮助你突破瓶颈：

专业训练：个性化战术培养

Akagi提供完整的对局历史记录和数据分析功能：

1. 复盘分析：导入历史对局，AI逐手分析决策优劣
2. 统计报告：生成详细的胜率、放铳率、立直率等数据
3. 个性化改进建议：根据你的打牌习惯提供针对性训练方案

🔧 核心功能深度解析

实时HUD显示面板

Akagi的可拖拽HUD面板显示以下关键信息：

• 向听数：当前手牌距离听牌还需要多少张有效牌
• 听牌型：显示可能的和牌牌型组合
• 和牌率：基于剩余牌堆计算的胜率概率
• 放铳风险：对各家对手的放铳风险评估
• 推荐切牌：AI建议的最佳出牌选择

双模式数据捕获

Akagi提供两种数据捕获方式，满足不同用户需求：

Chromium模式（推荐新手）

• 无需配置代理或安装证书
• Akagi自动启动受控浏览器
• 通过Chrome DevTools Protocol拦截数据

MITM代理模式（高级用户）

• 系统级代理，支持所有游戏客户端
• 需要安装一次性的CA证书
• 提供更稳定的连接体验

可插拔AI模型系统

Akagi采用模块化设计，支持多种AI模型：

[bot] enabled = true active_4p = "mortal" # 四人麻将使用Mortal模型 active_3p = "mortal3p" # 三人麻将使用专用模型

你可以从GitHub Release安装官方模型，或自定义开发自己的AI模型。Akagi会自动根据对局人数切换对应的模型。

📊 数据分析与统计功能

对局历史记录

每场完整对局都会被自动记录，你可以在历史页面查看：

• 名次分布饼图：直观展示你的排名分布情况
• 累计PT折线图：支持多种计分规则切换
• 详细统计数据：包括和牌率、放铳率、立直率等关键指标

实时日志与诊断

Akagi提供完整的日志系统，帮助排查问题：

• 应用日志：按模块和级别过滤查看
• 协议分析：查看原始WebSocket帧和mjai事件
• AI响应跟踪：监控AI模型的决策过程

🛠️ 高级配置与自定义

配置文件详解

Akagi的配置文件采用TOML格式，位于可执行文件旁的config.toml：

[general] language = "zh-CN" # 界面语言设置 [logging] level = "info" # 日志级别控制 [capture] mode = "chromium" # 捕获模式选择 [bot] enabled = true # AI功能开关

自定义AI模型开发

如果你有Python开发经验，可以创建自己的AI模型：

# mjai_bot/custom_bot/bot.py import sys import json def main(): for line in sys.stdin: event = json.loads(line.strip()) # 处理mjai事件 response = {"type": "none"} print(json.dumps(response)) sys.stdout.flush() if __name__ == "__main__": main()

将你的模型放入mjai_bot/<名称>/目录，Akagi会自动识别并加载。

🔍 常见问题与解决方案

连接问题排查

问题：Akagi无法连接到游戏解决方案：

1. 检查捕获模式设置是否正确
2. 确保游戏客户端代理设置指向127.0.0.1:23410
3. 在MITM模式下确认CA证书已正确安装

AI模型加载失败

问题：AI模型显示"加载中"但无法启用解决方案：

1. 检查网络连接，确保能访问GitHub
2. 手动运行uv sync同步依赖
3. 查看日志文件中的详细错误信息

性能优化建议

场景：游戏运行卡顿优化方法：

1. 降低AI分析深度设置
2. 关闭不必要的日志记录
3. 确保系统有足够的内存资源

🌟 社区生态与未来展望

活跃的开发者社区

Akagi拥有活跃的Discord社区，你可以在这里：

• 获取最新的AI模型权重
• 分享使用经验和技巧
• 参与功能讨论和开发
• 获取技术支持和帮助

持续的功能演进

Akagi项目持续更新，未来计划包括：

• 更多平台支持：扩展对Amatsuki等平台的支持
• 主题自定义：提供界面主题定制功能
• 移动端适配：探索手机端麻将的AI辅助方案

开源贡献指南

如果你对开发感兴趣，可以参与以下方面：

1. 前端界面改进：基于React和Tailwind CSS的现代化界面
2. AI算法优化：麻将分析和决策算法的改进
3. 平台适配开发：支持更多麻将游戏平台

💡 最佳实践与使用技巧

学习路径建议

1. 第一周：使用观察模式，专注理解AI的决策逻辑
2. 第二周：尝试使用AI建议，对比自己的决策差异
3. 第三周：分析历史对局，找出自己的决策弱点
4. 第四周：形成个人战术风格，减少对AI的依赖

数据分析要点

• 关注趋势而非单点：不要过分关注单局胜负，关注长期数据趋势
• 对比不同场景：分析在不同局面下的决策表现
• 定期复盘：每周回顾一次历史对局，总结改进点

资源管理建议

• 定期清理日志：避免日志文件占用过多磁盘空间
• 备份配置文件：重要配置变更前进行备份
• 更新AI模型：定期检查并更新AI模型版本

🎉 开始你的AI麻将之旅

Akagi不仅仅是一个游戏辅助工具，更是一个麻将学习平台。通过AI技术与麻将战术的完美结合，它为不同水平的玩家提供了个性化的提升路径。

无论你是刚接触麻将的新手，还是希望突破瓶颈的进阶玩家，Akagi都能成为你的得力助手。记住，工具的价值在于辅助思考，而非替代思考。合理使用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