Akagi 雀魂 AI 辅助工具安装与配置指南

Akagi 雀魂 AI 辅助工具安装与配置指南

Akagi 是一款基于 AI 决策分析的麻将辅助系统，通过实时解析牌局提供操作建议。支持新手入门及进阶玩家数据分析。

核心功能特性

智能决策分析系统

实时捕获牌局数据，通过 AI 模型计算出当前最优打法，包括舍牌建议、听牌策略和风险评估。系统会自动标记高危险牌和安全牌。

个性化配置中心

通过 config.json 文件可自定义多项参数，包括：

• 雀魂账号绑定与数据同步
• AI 分析深度调节（基础/专业/大师模式）
• 界面显示风格与提示方式
• 网络代理与数据传输加密设置

牌谱记录与复盘功能

自动保存完整对局记录，支持导出为标准格式进行深度分析。通过 majsoul2mjai.py 工具可将雀魂牌局数据转换为可视化图表。

环境准备与安装

1. 安装系统依赖
   • Windows 用户：右键管理员身份运行 scripts/install_akagi.ps1
   • Mac 用户：终端执行 bash scripts/install_akagi.command
2. 配置 AI 模型 将下载的模型文件放入 mjai/bot/ 目录，确保文件名为 mortal.pth
3. 克隆项目仓库到本地

   git clone <repository_url>
   cd Akagi
   

首次启动与基础设置

1. 运行启动脚本
   • Windows：双击 run_akagi.bat
   • Mac：终端执行 bash run_akagi.command
2. 完成初始配置 在弹出的配置向导中输入雀魂账号信息，选择适合网络环境的代理设置

⚠️ 重要提示：首次使用需安装系统证书，否则可能导致游戏数据捕获失败。安装程序会自动引导完成证书配置，过程中请允许系统权限请求。

配置优化与故障排查

提升分析速度配置

1. 打开 settings.json 文件
2. 找到 "ai_performance" 配置项，将 "analysis_speed" 设为 "high"
3. 保存后重启程序，AI 响应速度提升

常见问题场景解决

场景一：启动时提示'模型文件缺失'

• 检查 mjai/bot/ 目录是否存在 mortal.pth 文件
• 从官方渠道获取最新模型文件，确保文件大小超过 200MB

场景二：游戏中无 AI 提示

• 确认雀魂客户端已启动并登录
• 检查 mitm.py 是否正常运行（任务管理器中查看 Python 进程）
• 重新安装系统证书：运行 scripts/install_cert.command

场景三：提示'网络连接失败'

• 打开 检查代理端口是否被占用