雀魂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在麻将竞技中精准的决策往往决定胜负。Akagi作为一款开源免费的雀魂AI辅助工具通过本地化部署的智能分析系统为玩家提供实时对局建议和深度分析。本文将系统介绍如何从零开始搭建这款强大的麻将AI助手并提供实用的配置技巧和优化建议。 Akagi核心功能与架构解析Akagi是一款支持雀魂、天鳳、麻雀一番街、天月麻将等多个平台的AI辅助工具能够使用自定义的AI模型实时分析对局并给出建议。其内置Mortal AI作为示例模型为玩家提供专业的麻将决策支持。核心技术架构Akagi采用分层架构设计确保功能模块化与扩展性┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ 游戏协议解析层 │────▶│ AI分析核心层 │────▶│ 交互展示层 │ │ (mitm.py/liqi.py)│ │ (mjai/bot/model.py)│ │ (gui.py/client.py)│ └─────────────────┘ └─────────────────┘ └─────────────────┘关键组件说明组件功能文件路径MITM代理捕获游戏通信数据mitm.pyLiqi协议解析解析雀魂通信协议liqi.pyAI推理引擎麻将AI模型推理mjai/bot/model.py图形界面用户交互界面gui.py, client.py 快速安装与配置指南系统环境要求在开始安装前请确保系统满足以下要求操作系统Windows 10/11 或 macOS 10.15Python版本Python 3.8-3.10内存要求至少4GB可用内存磁盘空间1GB以上空闲空间网络环境支持HTTPS代理配置三步快速安装流程Windows平台安装下载安装脚本# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/ak/Akagi cd Akagi运行安装脚本# 以管理员身份运行PowerShell Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass .\scripts\install_akagi.ps1配置证书和模型首次运行时启动mitmproxy安装mitmproxy CA证书到系统信任列表下载mortal.pth模型文件并放置到mjai/bot/目录macOS平台安装获取安装文件git clone https://gitcode.com/gh_mirrors/ak/Akagi cd Akagi执行安装命令chmod x scripts/install_akagi.command ./scripts/install_akagi.command系统证书配置前往系统偏好设置 安全性与隐私信任mitmproxy证书将mortal.pth模型放入mjai/bot/目录关键配置文件详解settings.json是Akagi的核心配置文件以下是主要配置项说明{ Unlocker: false, // 是否使用MajsoulUnlocker Autoplay: false, // 自动打牌功能谨慎使用 Helper: true, // 启用麻将助手功能 Autohu: false, // 自动和牌功能 Port: { MITM: 8080, // MITM代理端口 XMLRPC: 8000, // XMLRPC服务端口 MJAI: 8001 // MJAI机器人端口 }, Playwright: { enable: false, // 是否启用Playwright width: 1280, // 浏览器宽度 height: 720 // 浏览器高度 } } 实战使用技巧启动与连接流程启动Akagi系统Windows双击run_akagi.batmacOS执行./run_akagi.command配置雀魂客户端设置HTTP代理127.0.0.1:8080验证连接查看Akagi控制台显示Proxy started开始对局分析进入雀魂匹配界面Akagi自动开始捕获数据主界面上方显示实时分析结果界面功能详解Akagi主界面分为多个功能区为玩家提供全面的对局信息区域功能说明左上区LiqiProto消息捕获的游戏原始通信数据右上区MJAI消息AI返回的动作建议中部手牌显示Unicode字符显示当前手牌左下区设置面板实时调整分析参数右下区动作面板显示AI建议的具体动作进阶配置优化AI模型参数调整在config.json中可以优化AI模型的性能表现{ model_enabled: true, analysis_depth: 2, // 分析深度1-3级 response_delay: 1500, // 模拟人类思考延迟毫秒 log_level: info, // 日志级别 learning_mode: true // 学习模式记录决策偏差 }性能优化建议降低分析延迟将analysis_depth从3调整为2关闭不必要的日志输出确保系统有足够的内存提升稳定性定期清理logs/目录更新Python依赖包检查网络连接稳定性 常见问题解决方案安装问题排查问题现象可能原因解决方案证书不信任未正确安装CA证书手动将mitmproxy证书添加到系统信任列表无法连接游戏代理端口冲突检查端口8080是否被占用修改settings.json中的MITM端口AI模型不工作mortal.pth路径错误确认模型文件位于mjai/bot/mortal.pth启动失败Python环境问题重新安装Python 3.8-3.10并配置PATH使用中的问题数据捕获失败# 检查mitmproxy状态 netstat -an | grep 8080 # 重启Akagi服务 python client.py --resetAI响应缓慢降低analysis_depth参数关闭其他占用CPU的程序检查系统内存使用情况界面显示异常使用Windows Terminal运行以获得最佳UI效果调整终端字体为等宽字体更新图形界面依赖包️ 账号安全最佳实践Akagi采用本地数据处理架构所有分析都在用户本地计算机上完成但仍需注意以下安全事项安全使用指南客户端选择优先使用网页版雀魂避免使用Steam客户端不要使用修改过的客户端行为模拟设置{ human_like_delay: true, // 启用人类化延迟 random_action_variation: 0.2, // 随机动作变异 max_play_time: 7200 // 最大连续游戏时间秒 }日常使用建议每天使用不超过2小时定期切换游戏账号使用贴图与对手交流不完全依赖AI建议保持独立思考风险控制清单禁用Autoplay功能设置为false启用human_like_delay随机延迟设置合理的max_play_time限制定期清理日志文件不在公共网络环境下使用 高级功能与扩展自定义AI模型集成Akagi支持自定义AI模型开发者可以通过以下步骤集成新模型模型文件准备准备ONNX或PyTorch格式的模型文件确保模型输入输出格式符合mjai标准将模型文件放置在mjai/bot/目录配置文件更新# 在config.py中添加模型配置 CUSTOM_MODELS { my_model: { path: mjai/bot/my_model.onnx, type: onnx, version: 1.0 } }模型切换脚本# 使用命令行切换模型 python mjai/bot/switch_model.py --model my_model数据分析与导出Akagi提供强大的数据分析功能支持对局记录的导出和分析# 导出对局数据为CSV格式 python convert.py -i replay.log -o analysis.csv # 生成统计报告 python libriichi_helper.py --analyze analysis.csv --output report.html插件开发指南基于mhm/hook/框架开发者可以创建自定义插件# 示例自定义手牌分析插件 from mhm.hook import BaseHook class CustomHandAnalyzer(BaseHook): def on_hand_updated(self, hand_data): 手牌更新时的回调函数 # 自定义分析逻辑 shanten self.calculate_shanten(hand_data) self.logger.info(f当前向听数: {shanten}) def calculate_shanten(self, hand_data): 计算向听数 # 实现向听数计算逻辑 return shanten_value 性能优化与调优系统资源优化配置项推荐值说明分析深度2平衡准确性与性能思考延迟1000-3000ms模拟人类思考时间日志级别warning减少不必要的日志输出内存限制2GB控制内存使用量网络配置优化代理设置优化# 调整mitmproxy缓存大小 mitmproxy --set stream_large_bodies1连接稳定性提升使用有线网络连接关闭不必要的后台程序定期重启路由器和客户端 总结与最佳实践Akagi作为一款功能强大的开源麻将AI辅助工具为玩家提供了专业的对局分析和学习平台。通过合理配置和使用玩家可以在提升麻将水平的同时享受游戏的乐趣。使用建议总结学习为主辅助为辅将AI建议作为参考逐步建立自己的分析能力循序渐进从基础功能开始逐步尝试高级功能定期复盘使用数据分析工具回顾对局总结经验社区交流加入Discord社区与其他玩家交流使用心得未来发展展望Akagi项目持续更新未来计划包括图像识别技术的集成更多AI模型的兼容更智能的行为模拟跨平台性能优化通过本文的详细指南相信您已经掌握了Akagi的安装、配置和使用技巧。现在就开始您的智能麻将之旅在AI的辅助下提升麻将水平享受竞技麻将的策略乐趣重要提示请合理使用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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考