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/AkagiAkagi是一个开源麻将AI分析工具支持雀魂、天鳳、麻雀一番街、天月麻将等多个平台。该项目通过实时AI分析帮助玩家理解对局策略内置Mortal AI作为示例模型为麻将爱好者提供科学的学习工具。项目架构与核心技术核心组件解析Akagi采用模块化设计主要组件包括模块功能描述核心文件协议解析处理麻将游戏通信协议liqi.py,liqi_proto/AI引擎提供实时分析建议mjai/bot/,model.py用户界面图形化交互界面client.py,gui.py代理中间件MITM数据捕获mitm.py配置管理系统参数配置settings.json,config.json数据流处理流程Akagi的数据处理流程遵循以下步骤数据捕获通过MITM代理截获雀魂游戏通信协议解析将LiqiProto协议转换为MJAI标准格式AI分析Mortal AI模型实时分析牌局状态建议生成基于分析结果提供打牌建议界面展示在TUI界面中显示分析结果安装与配置指南环境准备首先克隆项目仓库git clone https://gitcode.com/gh_mirrors/ak/Akagi cd Akagi安装Python依赖pip install -r requirement.txt核心文件配置模型文件准备从Discord社区获取mortal.pth模型文件将文件放置在mjai/bot/目录中主要配置文件settings.json- 系统核心配置{ Autoplay: false, Helper: true, Port: { MITM: 7878, XMLRPC: 7879, MJAI: 28680 } }mhm/config.py- AI行为参数定制# 风险控制参数 risk_tolerance 0.6 offensive_weight 0.7 defensive_weight 0.3启动与运行启动代理服务python mitm.py启动主客户端python client.py功能特性详解实时分析能力Akagi的核心功能是在游戏过程中提供即时分析牌效率评估分析当前手牌的进张效率安全牌识别计算每张牌的放铳风险听牌判断评估听牌价值和改良可能性攻防平衡根据局势调整进攻与防守策略三种运行模式学习模式推荐新手详细展示AI决策过程提供多种打法的对比分析记录关键决策点供复盘使用实战模式适合有经验玩家精简输出专注核心建议快速响应不影响游戏节奏仅显示最重要的策略提示复盘模式用于赛后分析导入历史对局数据生成详细统计数据图表识别决策模式和改进空间支持的麻将平台平台支持状态特殊要求雀魂网页版✅ 完全支持推荐使用天鳳✅ 完全支持需要配置代理麻雀一番街✅ 基本支持部分功能受限天月麻将✅ 基本支持需要手动适配技术实现细节协议转换机制Akagi的核心技术之一是协议转换层转换流程雀魂协议 (LiqiProto) → 中间格式 → MJAI标准格式 → AI分析 → 用户建议关键转换文件majsoul2mjai.py- 主要转换逻辑liqi_proto/liqi.proto- 协议定义文件liqi_pb2.py- 生成的协议处理代码AI模型集成项目使用Mortal AI作为默认模型模型位置mjai/bot/mortal.pth推理引擎mjai/bot/bot.py模型管理mjai/bot/model.py模型特性基于深度强化学习训练支持实时推理100ms延迟可替换为自定义AI模型使用场景与最佳实践新手学习路径对于麻将初学者建议按以下步骤使用Akagi观察阶段1-2周仅使用学习模式观察AI建议记录不理解的建议并研究原因关注牌效率分析功能实践阶段2-4周尝试理解AI的决策逻辑对比自己的判断与AI建议重点关注中盘攻防策略自主阶段1个月后减少对AI的依赖仅在复杂局面寻求建议建立自己的决策框架中高级玩家进阶有经验的玩家可以重点关注复杂局面分析如多面听选择、攻防转换时机特殊牌型处理国士无双、七对子等特殊牌型策略对手风格应对针对不同对手调整策略安全使用建议为保护账号安全请遵循以下原则✅推荐做法使用网页版而非Steam客户端手动操作禁用Autoplay功能经常使用表情贴纸模拟人类行为控制使用时间避免长时间连续使用❌避免行为完全依赖AI自动打牌24小时不间断使用在重要比赛或高段位对局中过度依赖违反游戏平台使用条款的行为性能优化与故障排除系统资源优化如果遇到性能问题可以调整以下参数降低分析深度settings.json{ analysis_depth: 3, enable_visualization: false }关闭非核心功能禁用实时可视化界面仅保留文本建议输出减少历史数据缓存大小常见问题解决问题1无法连接到雀魂服务器检查MITM代理设置是否正确确认防火墙未阻止连接尝试使用不同网络环境问题2AI建议延迟过高降低analysis_depth参数值关闭部分可视化功能检查系统资源使用情况问题3模型文件缺失确认mortal.pth文件已放置在正确目录检查文件权限和完整性从Discord社区重新下载模型文件自定义与扩展开发自定义AIAkagi支持集成自定义AI模型模型接口实现mjai/player.py中的Player接口数据格式遵循MJAI协议标准集成测试使用mjai/http_server/server.py进行测试协议扩展支持如需支持新平台需要协议分析分析目标平台的通信协议转换器开发编写对应的协议转换器集成测试确保数据流正确转换项目维护与贡献代码结构概览Akagi/ ├── client.py # 主用户界面 ├── mitm.py # MITM代理服务 ├── mjai/ # AI核心模块 │ ├── bot/ # AI模型相关 │ └── http_server/ # HTTP服务接口 ├── mhm/ # 辅助功能模块 ├── liqi_proto/ # 协议定义文件 └── settings.json # 主配置文件贡献指南欢迎通过以下方式参与项目问题反馈在GitHub Issues报告bug或建议功能开发实现新功能或改进现有功能文档完善改进使用文档或添加教程测试验证测试新功能并提供反馈技术价值与学习意义教育价值Akagi不仅是一个游戏辅助工具更是学习麻将策略的优秀平台决策透明化展示AI的思考过程和评估标准数据驱动学习基于统计和概率的决策方法渐进式提升从基础到高级的完整学习路径技术实现亮点实时性在100ms内完成完整分析流程准确性基于大规模对局数据训练的AI模型可扩展性模块化设计支持多种麻将平台开源透明完整代码可供学习和改进总结Akagi为麻将爱好者提供了一个强大的学习工具通过AI技术帮助玩家深入理解麻将策略。项目采用开源模式支持多种麻将平台具有高度的可定制性。核心建议将Akagi作为学习工具而非替代工具结合自身思考使用AI建议遵循安全使用原则保护账号参与社区贡献促进项目发展通过合理使用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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考