AI麻将辅助工具Akagi使用指南：提升雀魂水平的技术方案

AI麻将辅助工具Akagi使用指南：提升雀魂水平的技术方案

【免费下载链接】AkagiA helper client for Majsoul项目地址: https://gitcode.com/gh_mirrors/ak/Akagi

Akagi作为一款开源的AI麻将分析工具，专为雀魂游戏玩家设计，通过实时对局数据分析和智能决策建议，帮助用户提升麻将竞技水平。本文档将系统介绍该工具的安装配置、功能使用及优化技巧，适合有一定麻将基础并希望通过技术手段提升游戏理解的玩家。

如何安装Akagi AI麻将辅助工具

环境检查与准备

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

• Windows 10/11或macOS 10.15+操作系统
• Python 3.8+运行环境
• 至少2GB可用存储空间
• 稳定的网络连接

基础安装步骤

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

macOS系统安装

1. 克隆项目代码库

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

2. 执行安装脚本

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

[!NOTE] 安装过程中会自动下载并配置必要的依赖包，包括protobuf、mitmproxy等核心组件。请耐心等待安装完成，期间可能需要输入系统密码授权。

高级配置要点

AI模型部署

1. 获取Mortal模型文件（mortal.pth）
2. 将模型文件放置到指定目录：

   mjai/bot/mortal.pth

3. 验证模型配置：

   python -m mjai.bot.model --verify

网络代理设置

1. 启动中间人代理服务：

   python mitm.py

2. 配置系统代理：

   • 地址：127.0.0.1
   • 端口：7878

3. 安装SSL证书：

   • 证书位置：~/.mitmproxy/mitmproxy-ca-cert.pem
   • 按照系统提示完成证书信任配置

Akagi核心功能配置详解

配置文件结构

Akagi的主要配置文件为settings.json，位于项目根目录，采用JSON格式存储配置参数。以下是关键配置项说明：

功能用途与配置方法

实时分析功能

功能用途：实时捕获游戏数据并提供AI打牌建议

配置方法：

{ "Helper": true, "Analysis": { "Enabled": true, "SuggestionDisplay": "inline", "ConfidenceThreshold": 0.7 } }

使用场景：适用于想要逐步学习AI策略的玩家，在手动操作过程中获得实时指导。

数据记录功能

功能用途：记录完整对局数据用于赛后分析

配置方法：

{ "Recording": { "Enabled": true, "Format": "mjai", "SavePath": "./replays/", "AutoUpload": false } }

使用场景：适合希望通过复盘提升技术的玩家，可结合第三方工具进行深度分析。

实战技巧：如何有效使用Akagi提升雀魂水平

对局分析工作流程

1. 启动程序

   # 启动主程序 python gui.py # 或使用快捷脚本 ./run_akagi.command # macOS run_akagi.bat # Windows

2. 开始对局

   • 确保代理服务正常运行
   • 打开雀魂游戏客户端
   • 进入任意对局模式

3. 使用AI建议

   • 观察界面右侧AI建议区域
   • 结合自身判断选择打牌策略
   • 查看详细分析可点击"展开详情"

进阶使用策略

防守策略学习

利用Akagi的牌局分析功能，重点关注以下指标：

• 危险牌识别率
• 弃和决策时间点
• 防守型舍牌顺序

通过对比AI选择与个人决策的差异，逐步建立科学的防守思维。

进攻时机把握

关注AI在以下场景的决策逻辑：

• 立直判断与时机选择
• 听牌型选择策略
• 追立决策依据

建议在训练模式中反复模拟不同场景，培养进攻意识。

安全使用规范与风险防范

[!WARNING]账号安全警示

使用本工具时，请严格遵守游戏用户协议，过度依赖自动功能可能导致账号风险。建议：

• 禁用Autoplay功能，保持手动操作
• 避免连续长时间使用辅助功能
• 不要在竞技性较高的排位赛中使用

合规使用建议

1. 行为模拟设置

   { "HumanSimulation": { "Enabled": true, "ActionDelay": 1000-3000, // 随机操作延迟(毫秒) "RandomChoiceRate": 0.1 // 随机选择概率 } }

2. 功能使用原则

   • 以学习为主要目的
   • 逐步减少对AI建议的依赖
   • 将重点放在理解决策逻辑而非结果

性能优化：怎样提升Akagi的响应速度

系统资源配置

根据硬件条件调整以下参数：

网络优化建议

1. 确保代理服务器与游戏服务器之间的网络稳定
2. 对于网络延迟较高的用户，可调整：

   { "Network": { "Timeout": 5000, "RetryCount": 2, "CacheTTL": 300 } }

常见问题解决与技术支持

安装相关问题

Q: 安装脚本执行失败怎么办？

A: 尝试手动安装依赖：

pip install -r requirement.txt pip install -r mahjong_soul_api/requirements.txt

Q: 模型文件放置后仍提示"模型未找到"？

A: 检查文件路径和名称是否正确，确保文件名是"mortal.pth"且位于"mjai/bot/"目录下。

运行时问题

Q: 代理启动后游戏无法连接？

A: 检查端口是否被占用：

# Windows netstat -ano | findstr :7878 # macOS/Linux lsof -i :7878

如端口被占用，修改settings.json中的Port.MITM参数。

Q: AI分析结果延迟过高？

A: 尝试降低Model.ThinkDepth参数值，或关闭其他占用系统资源的程序。

获取技术支持

如遇到其他问题，可通过以下方式获取帮助：

• 查看项目文档：README.md
• 检查常见问题：docs/FAQ.md（如存在）
• 分析日志文件：logs/akagi.log

Akagi高级功能与扩展开发

现有工具整合

Akagi可与项目中的其他工具协同工作：

• 牌局深度分析：common/endless/mahjong-helper.exe
• 协议处理模块：liqi.py负责游戏通信协议解析
• API接口组件：mahjong_soul_api/提供数据服务接口

自定义开发指南

对于有开发能力的用户，可以：

1. 扩展AI模型接口

   • 参考mjai/bot/model.py实现新的模型适配器
   • 通过mjai/bot/bot.py集成自定义AI逻辑

2. 开发分析插件

   • 在mhm/hook/目录下创建新的钩子模块
   • 实现on_game_start、on_turn等事件处理函数

3. 协议扩展

   • 编辑liqi_proto/liqi.proto定义新协议结构
   • 重新生成Python协议文件：python -m grpc_tools.protoc -I. --python_out=. liqi_proto/liqi.proto

[!NOTE] 自定义开发前建议先熟悉项目架构，可参考mahjong_soul_api/example.py了解API使用方法。

总结与使用建议

Akagi作为一款AI麻将辅助工具，为雀魂玩家提供了科学的学习和分析手段。通过合理配置和使用，可以有效提升对麻将策略的理解和应用能力。建议用户：

1. 保持学习心态，将工具作为技术参考而非取胜捷径
2. 定期回顾分析记录，总结个人决策与AI建议的差异
3. 根据自身水平逐步调整AI辅助强度，从高建议频率过渡到低频率
4. 参与社区讨论，分享使用心得与策略理解

合理使用技术工具，结合持续练习，才能真正提升麻将水平，享受游戏乐趣。

【免费下载链接】AkagiA helper client for Majsoul项目地址: https://gitcode.com/gh_mirrors/ak/Akagi