雀魂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

在麻将竞技中，精准的决策往往决定胜负。Akagi作为一款开源免费的雀魂AI辅助工具，通过本地化部署的智能分析系统，为玩家提供实时对局建议和深度分析。本文将系统介绍如何从零开始搭建这款强大的麻将AI助手，并提供实用的配置技巧和优化建议。

🎯 Akagi核心功能与架构解析

Akagi是一款支持雀魂、天鳳、麻雀一番街、天月麻将等多个平台的AI辅助工具，能够使用自定义的AI模型实时分析对局并给出建议。其内置Mortal AI作为示例模型，为玩家提供专业的麻将决策支持。

核心技术架构

Akagi采用分层架构设计，确保功能模块化与扩展性：

┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ 游戏协议解析层 │────▶│ AI分析核心层 │────▶│ 交互展示层 │ │ (mitm.py/liqi.py)│ │ (mjai/bot/model.py)│ │ (gui.py/client.py)│ └─────────────────┘ └─────────────────┘ └─────────────────┘

关键组件说明：

📦 快速安装与配置指南

系统环境要求

在开始安装前，请确保系统满足以下要求：

• 操作系统：Windows 10/11 或 macOS 10.15+
• Python版本：Python 3.8-3.10
• 内存要求：至少4GB可用内存
• 磁盘空间：1GB以上空闲空间
• 网络环境：支持HTTPS代理配置

三步快速安装流程

Windows平台安装

1. 下载安装脚本

   # 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/ak/Akagi cd Akagi

2. 运行安装脚本

   # 以管理员身份运行PowerShell Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass .\scripts\install_akagi.ps1

3. 配置证书和模型

   • 首次运行时启动mitmproxy
   • 安装mitmproxy CA证书到系统信任列表
   • 下载mortal.pth模型文件并放置到mjai/bot/目录

macOS平台安装

1. 获取安装文件

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

2. 执行安装命令

   chmod +x scripts/install_akagi.command ./scripts/install_akagi.command

3. 系统证书配置

   • 前往"系统偏好设置 > 安全性与隐私"
   • 信任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 // 浏览器高度 } }

🚀 实战使用技巧

启动与连接流程

1. 启动Akagi系统

   • Windows：双击run_akagi.bat
   • macOS：执行./run_akagi.command

2. 配置雀魂客户端

   • 设置HTTP代理：127.0.0.1:8080
   • 验证连接：查看Akagi控制台显示"Proxy started"

3. 开始对局分析

   • 进入雀魂匹配界面
   • Akagi自动开始捕获数据
   • 主界面上方显示实时分析结果

界面功能详解

Akagi主界面分为多个功能区，为玩家提供全面的对局信息：

进阶配置优化

AI模型参数调整

在config.json中可以优化AI模型的性能表现：

{ "model_enabled": true, "analysis_depth": 2, // 分析深度（1-3级） "response_delay": 1500, // 模拟人类思考延迟（毫秒） "log_level": "info", // 日志级别 "learning_mode": true // 学习模式，记录决策偏差 }

性能优化建议

1. 降低分析延迟

   • 将analysis_depth从3调整为2
   • 关闭不必要的日志输出
   • 确保系统有足够的内存

2. 提升稳定性

   • 定期清理logs/目录
   • 更新Python依赖包
   • 检查网络连接稳定性

🔧 常见问题解决方案

安装问题排查

使用中的问题

1. 数据捕获失败

   # 检查mitmproxy状态 netstat -an | grep 8080 # 重启Akagi服务 python client.py --reset

2. AI响应缓慢

   • 降低analysis_depth参数
   • 关闭其他占用CPU的程序
   • 检查系统内存使用情况

3. 界面显示异常

   • 使用Windows Terminal运行以获得最佳UI效果
   • 调整终端字体为等宽字体
   • 更新图形界面依赖包

🛡️ 账号安全最佳实践

Akagi采用本地数据处理架构，所有分析都在用户本地计算机上完成，但仍需注意以下安全事项：

安全使用指南

1. 客户端选择

   • 优先使用网页版雀魂
   • 避免使用Steam客户端
   • 不要使用修改过的客户端

2. 行为模拟设置

   { "human_like_delay": true, // 启用人类化延迟 "random_action_variation": 0.2, // 随机动作变异 "max_play_time": 7200 // 最大连续游戏时间（秒） }

3. 日常使用建议

   • 每天使用不超过2小时
   • 定期切换游戏账号
   • 使用贴图与对手交流
   • 不完全依赖AI建议，保持独立思考

风险控制清单

• 禁用Autoplay功能（设置为false）
• 启用human_like_delay随机延迟
• 设置合理的max_play_time限制
• 定期清理日志文件
• 不在公共网络环境下使用

🚀 高级功能与扩展

自定义AI模型集成

Akagi支持自定义AI模型，开发者可以通过以下步骤集成新模型：

1. 模型文件准备

   • 准备ONNX或PyTorch格式的模型文件
   • 确保模型输入输出格式符合mjai标准
   • 将模型文件放置在mjai/bot/目录

2. 配置文件更新

   # 在config.py中添加模型配置 CUSTOM_MODELS = { 'my_model': { 'path': 'mjai/bot/my_model.onnx', 'type': 'onnx', 'version': '1.0' } }

3. 模型切换脚本

   # 使用命令行切换模型 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

📊 性能优化与调优

系统资源优化

网络配置优化

1. 代理设置优化

   # 调整mitmproxy缓存大小 mitmproxy --set stream_large_bodies=1

2. 连接稳定性提升

   • 使用有线网络连接
   • 关闭不必要的后台程序
   • 定期重启路由器和客户端

🎯 总结与最佳实践

Akagi作为一款功能强大的开源麻将AI辅助工具，为玩家提供了专业的对局分析和学习平台。通过合理配置和使用，玩家可以在提升麻将水平的同时，享受游戏的乐趣。

使用建议总结

1. 学习为主，辅助为辅：将AI建议作为参考，逐步建立自己的分析能力
2. 循序渐进：从基础功能开始，逐步尝试高级功能
3. 定期复盘：使用数据分析工具回顾对局，总结经验
4. 社区交流：加入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