Akagi 雀魂 AI 辅助工具安装与配置指南
Akagi 是一款基于 AI 决策分析的麻将辅助系统,通过实时解析牌局提供操作建议。支持新手入门及进阶玩家数据分析。
核心功能特性
智能决策分析系统
实时捕获牌局数据,通过 AI 模型计算出当前最优打法,包括舍牌建议、听牌策略和风险评估。系统会自动标记高危险牌和安全牌。
个性化配置中心
通过 config.json 文件可自定义多项参数,包括:
- 雀魂账号绑定与数据同步
- AI 分析深度调节(基础/专业/大师模式)
- 界面显示风格与提示方式
- 网络代理与数据传输加密设置
牌谱记录与复盘功能
自动保存完整对局记录,支持导出为标准格式进行深度分析。通过 majsoul2mjai.py 工具可将雀魂牌局数据转换为可视化图表。
环境准备与安装
- 安装系统依赖
- Windows 用户:右键管理员身份运行
scripts/install_akagi.ps1 - Mac 用户:终端执行
bash scripts/install_akagi.command
- Windows 用户:右键管理员身份运行
- 配置 AI 模型
将下载的模型文件放入
mjai/bot/目录,确保文件名为mortal.pth - 克隆项目仓库到本地
git clone <repository_url> cd Akagi
首次启动与基础设置
- 运行启动脚本
- Windows:双击
run_akagi.bat - Mac:终端执行
bash run_akagi.command
- Windows:双击
- 完成初始配置 在弹出的配置向导中输入雀魂账号信息,选择适合网络环境的代理设置
⚠️ 重要提示:首次使用需安装系统证书,否则可能导致游戏数据捕获失败。安装程序会自动引导完成证书配置,过程中请允许系统权限请求。
配置优化与故障排查
提升分析速度配置
- 打开
settings.json文件 - 找到
"ai_performance"配置项,将"analysis_speed"设为"high" - 保存后重启程序,AI 响应速度提升
常见问题场景解决
场景一:启动时提示'模型文件缺失'
- 检查
mjai/bot/目录是否存在mortal.pth文件 - 从官方渠道获取最新模型文件,确保文件大小超过 200MB
场景二:游戏中无 AI 提示
- 确认雀魂客户端已启动并登录
- 检查
mitm.py是否正常运行(任务管理器中查看 Python 进程) - 重新安装系统证书:运行
scripts/install_cert.command
场景三:提示'网络连接失败'
- 打开 检查代理端口是否被占用

