智能麻将AI助手使用指南：从入门到精通的效率提升工具

在麻将游戏的策略决策中，实时分析与精准判断往往决定胜负。Akagi作为一款专为雀魂游戏设计的智能辅助工具，通过AI算法实时解析牌局动态，帮助玩家快速提升决策质量。本文将带你从零开始掌握这款工具的核心功能，通过简单配置即可解锁专业级麻将策略支持，让每一局游戏都成为技术提升的机会。

快速上手：3步完成智能助手部署 ⚡

环境准备与依赖安装

确保系统已安装Python 3.8+环境，执行以下命令检查版本：

python --version  # 验证Python版本
pip --version     # 验证包管理工具

项目获取与初始化

通过Git克隆项目仓库并进入工作目录：

git clone https://gitcode.com/gh_mirrors/ak/Akagi
cd Akagi  # 进入项目根目录

自动化安装流程

根据操作系统选择对应脚本执行：

• Windows系统（管理员PowerShell）：

.\scripts\install_akagi.ps1  # 自动安装依赖与证书

• macOS系统（终端）：

bash scripts/install_akagi.command  # 启动安装流程

小贴士：安装过程中若出现证书信任提示，请在系统安全设置中允许来自开发者的证书，这是确保网络代理正常工作的必要步骤。

核心功能探索：AI如何重塑麻将决策 🧠

实时牌局分析模块

Akagi的核心引擎位于mhm/main.py，通过以下机制实现毫秒级响应：

• 手牌组合自动识别（支持国标、日麻等多种规则）
• 动态胜率计算与可视化展示
• 对手行为模式实时追踪

配置文件路径：config.json（可调整分析深度与界面显示参数）

策略推荐系统

AI决策模块mjai/bot/bot.py提供多层次建议：

1. 基础策略：基于当前手牌的最优出牌推荐
2. 进阶分析：风险收益比量化评估
3. 局势预测：3步内可能出现的牌型变化模拟

数据记录与复盘工具

所有对局数据自动保存在mjai/online.json，支持：

• 历史对局回放
• 关键决策点标记
• 个人技术统计分析

典型应用场景：从新手到高手的进阶之路 🏆

场景一：新手入门引导

问题：刚接触日麻规则，对番型组合和役种计算不熟悉
解决方案：启用"新手模式"（在settings.json中设置"beginner_mode": true），系统会提供基础牌效分析和役种提示，帮助快速掌握基本策略。

场景二：关键局策略优化

问题：决赛局面对复杂局势，难以权衡进攻与防守
解决方案：通过action.py模块启用"深度分析"模式，AI将模拟1000种可能的后续发展，给出风险最低的最优解，配置路径：mhm/config.py中的analysis_depth参数。

场景三：技术瓶颈突破

问题：长期停留在同一水平，缺乏针对性提升方向
解决方案：使用convert.py导出30天对局数据，通过内置分析工具生成个人技术报告，重点改进libriichi_helper.py标记的高频失误点。

深度应用：自定义AI行为与性能调优 ⚙️

决策参数个性化

编辑config.json调整AI决策倾向：

{
  "ai_strategy": {
    "risk_tolerance": 0.7,  // 风险容忍度（0-1，越高越激进）
    "offense_weight": 0.6,  // 进攻权重
    "defense_weight": 0.4   // 防守权重
  }
}

性能优化实用技巧

1. 内存管理：在my_logger.py中调整日志级别为"INFO"，减少磁盘I/O
2. 启动加速：预加载模型到内存，修改run_akagi.bat添加--preload参数
3. 网络优化：在mitm.py中调整代理超时设置，建议值：timeout=15

高级功能扩展

通过mahjong_soul_api/模块开发自定义插件：

• 实现特定规则的战术库
• 添加个性化数据可视化
• 对接外部统计分析工具

常见问题解决：从安装到运行的全流程支持 ❓

Q：执行安装脚本时提示"权限不足"？
A：Windows用户需以管理员身份运行PowerShell，macOS用户在命令前添加sudo获取权限。

Q：AI模型加载失败，显示"mortal.pth文件缺失"？
A：需将模型文件放置在mjai/bot/目录下，确保文件名正确为"mortal.pth"。

Q：启动后无法捕获游戏窗口？
A：检查client.py中的窗口识别参数，或尝试切换游戏分辨率为1080p。

最佳实践：平衡辅助与游戏体验 🎮

合理使用建议

• 练习模式：开启全部提示功能，专注学习AI决策逻辑
• 实战模式：仅启用关键决策提示，保持游戏参与感
• 复盘模式：对比自己与AI的决策差异，重点分析分歧点

数据安全与隐私保护

所有对局数据仅存储在本地mjai/online.json文件中，建议定期备份该文件。如需清理历史记录，可直接删除该文件或使用scripts/clean_data.bat脚本。

功能投票：你希望Akagi添加哪些新特性？ 🗳️

1. □ 多语言支持（日语/英语界面）
2. □ 自定义主题皮肤系统
3. □ 手机端远程控制功能

欢迎在项目反馈渠道分享你的选择，帮助我们优先开发最受欢迎的功能！

通过本指南，你已掌握Akagi智能麻将助手的核心使用方法与进阶技巧。记住，工具的价值在于辅助思考而非替代决策，合理运用AI分析能力，结合自身判断，才能真正提升麻将水平。现在就启动run_akagi.bat（Windows）或run_akagi.command（macOS），开启智能麻将之旅吧！