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的核心技术架构基于中间人代理模式通过拦截游戏客户端与服务器之间的通信数据实现实时对局分析。系统主要包含三个核心组件MITM代理层、协议转换模块和AI决策引擎。MITM代理层运行在本地端口7878负责捕获游戏通信数据。捕获的数据以LiqiProto协议格式传输这是雀魂等平台使用的自定义二进制协议。协议转换模块将这些原始数据转换为标准的mjai格式mjai是麻将AI社区广泛使用的JSON格式协议便于不同AI模型进行统一处理。AI决策引擎接收mjai格式的对局信息调用预训练的Mortal模型进行分析。模型输出建议操作后系统通过GUI界面展示分析结果同时支持XMLRPC接口供外部程序调用。配置系统与模块化设计Akagi的配置系统采用分层设计通过多个配置文件实现功能模块的灵活组合。主配置文件settings.json控制核心行为参数{ Autoplay: false, Helper: false, Autohu: false, Port: { MITM: 7878, XMLRPC: 7879, MJAI: 28680 } }Autoplay参数决定是否启用自动打牌功能建议学习阶段设为false以观察AI决策过程。Helper参数控制是否集成mahjong-helper辅助工具该工具提供基础牌效计算功能。Port配置定义各服务监听的端口号用户可根据本地端口占用情况调整。模块配置文件mhmp.json管理扩展功能{ base: { skins: true, aider: false, chest: false } }skins模块负责游戏界面自定义aider提供额外辅助功能chest处理游戏内物品相关操作。这种模块化设计允许用户按需启用功能组件减少不必要的资源占用。实际应用场景分析对局实时分析场景在实战对局中Akagi能够提供多层次的决策支持。当用户面临复杂牌型时系统会分析当前手牌、场况、剩余牌山等信息给出打牌、吃碰杠、立直、和牌等操作的优先级建议。例如面对防守决策时AI会综合考虑对手的副露情况、立直状态、场供和点数差推荐安全度最高的舍牌。对于进攻局面模型会计算各种打法的期望得点帮助用户选择最优策略。牌谱研究学习场景通过majsoul2mjai.py脚本用户可以将历史牌谱转换为结构化数据进行分析。转换后的数据包含每一巡的手牌变化、玩家动作、得分变动等信息便于进行系统性复盘。牌谱分析功能特别适用于研究特定局面下的决策质量。用户可以对比自己的实际选择与AI推荐操作的差异分析决策偏差产生的原因。这种对比分析有助于识别个人打牌习惯中的系统性错误。训练数据生成场景对于希望开发自定义AI模型的进阶用户Akagi提供了数据采集基础设施。系统能够批量处理大量对局记录生成标注完整的训练数据集。数据集包含状态-动作对适合监督学习模型的训练。安装部署流程项目部署需要准备Python运行环境和必要的依赖包。首先克隆项目仓库git clone https://gitcode.com/gh_mirrors/ak/AkagiWindows系统使用PowerShell执行安装脚本Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass .\install_akagi.ps1macOS系统通过终端运行安装命令bash install_akagi.command安装完成后需要配置SSL证书。mitmproxy生成的CA证书位于用户目录的.mitmproxy文件夹中需将该证书导入系统信任存储。证书配置完成后将预训练的Mortal模型文件mortal.pth放置于mjai/bot目录下。安全使用注意事项使用游戏辅助工具需要平衡功能性与账号安全。建议优先使用网页版客户端而非Steam版本因为网页环境的行为检测相对宽松。适当使用游戏内置的贴图功能可以模拟真人玩家的交互模式减少异常行为特征。不建议长时间连续使用自动打牌功能间歇性的人工操作有助于维持账号行为模式的自然性。完全依赖AI建议可能导致决策模式过于规律容易被检测系统识别。性能优化与定制开发Akagi支持多种性能调优选项。RandomTime参数可以配置操作延迟时间模拟人类玩家的思考过程RandomTime: { new_min: 3.5, new_max: 4.5, min: 1.0, max: 3.2 }对于硬件资源有限的用户可以调整Playwright配置降低资源消耗Playwright: { enable: true, width: 1280, height: 720 }开发者可以通过替换mjai/bot目录下的模型文件来使用不同的AI引擎。项目采用模块化设计新的AI模型只需实现标准接口即可集成。协议处理模块位于mahjong_soul_api目录包含各平台的协议适配器。同类工具对比与技术定位与纯客户端修改工具不同Akagi采用中间人代理架构不直接修改游戏客户端文件降低了被检测的风险。相比基于图像识别的方案协议分析方式具有更高的准确性和实时性。相对于简单的牌效计算器Akagi集成了完整的深度学习模型能够处理复杂的局面评估和长期策略规划。系统支持多种麻将规则变体包括三人麻将等特殊模式。常见问题解决方案SSL证书错误通常由证书安装不当引起。需要确认系统已正确导入mitmproxy的CA证书并设置为受信任的根证书颁发机构。浏览器代理设置应指向本地7878端口。模型文件加载失败时检查mortal.pth文件是否位于正确路径且具有适当权限。文件大小异常可能表示下载不完整需要重新获取完整的模型文件。网络连接问题可能源于防火墙设置或端口冲突。确保本地7878、7879、28680端口未被其他程序占用防火墙规则允许相关端口的入站连接。进阶应用与社区资源Akagi的架构支持功能扩展开发者可以通过插件机制添加新的分析模块。hook目录包含现有的扩展实现如皮肤管理、辅助功能等。社区维护的Discord服务器提供最新的模型文件和技术支持。对于希望深入理解麻将AI技术的用户建议研究mjai协议规范和Mortal模型架构。协议规范定义了状态表示和动作空间模型架构展示了深度学习在麻将决策中的应用方式。项目采用AGPLv3许可证允许个人使用和研究目的的自由修改。商业使用需注意许可证中的附加条款限制。开发团队持续维护代码库定期更新协议适配以应对游戏客户端变更。【免费下载链接】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），仅供参考