Akagi雀魂AI助手：从零开始的完整使用指南

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

Akagi是一款功能强大的开源麻将AI辅助工具，专为雀魂玩家设计。它能实时分析对局情况，提供科学的决策建议，帮助玩家提升麻将水平。这款工具支持本地化部署，所有数据处理都在您的电脑上完成，确保账号安全与隐私。无论您是麻将新手还是想要进阶的玩家，Akagi都能为您提供专业的辅助分析。

项目核心价值与优势

Akagi的独特之处在于它不仅仅是一个简单的辅助工具，而是一个完整的麻将学习系统。以下是它的主要优势：

快速安装指南：5分钟完成部署

系统要求检查

在开始安装前，请确认您的系统满足以下条件：

• ✅ Python 3.8-3.10环境
• ✅ 至少4GB可用内存
• ✅ 1GB空闲磁盘空间
• ✅ 稳定的网络连接

一键安装步骤

Windows用户：

1. 打开命令提示符或PowerShell
2. 执行以下命令：

   git clone https://gitcode.com/gh_mirrors/ak/Akagi cd Akagi .\scripts\install_akagi.ps1

macOS/Linux用户：

1. 打开终端
2. 执行以下命令：

   git clone https://gitcode.com/gh_mirrors/ak/Akagi cd Akagi chmod +x scripts/install_akagi.command ./scripts/install_akagi.command

重要配置步骤

安装完成后，需要进行关键配置：

1. 获取AI模型文件

   • 下载mortal.pth模型文件
   • 将文件放置在mjai/bot/目录下

2. 配置代理设置

   • 打开雀魂客户端设置
   • 设置HTTP代理为：127.0.0.1:8080
   • 保存设置并重启游戏

3. 信任证书（首次使用）

   • Windows：运行certutil -addstore root .\mitmproxy-ca-cert.cer
   • macOS：在系统偏好设置 > 安全性与隐私中添加证书

核心功能详解：AI如何帮助您提升牌技

实时牌局分析系统

Akagi的AI引擎会在您游戏的每个回合提供智能建议：

🔍 手牌分析功能：

• 向听数计算：准确评估当前手牌距离听牌的距离
• 危险牌识别：自动标记可能放铳的危险牌
• 最佳出牌建议：基于概率计算推荐最优出牌选择
• 番种概率预测：预测可能形成的役种和番数

📊 对局数据统计：

• 和牌率分析
• 放铳率统计
• 听牌效率评估
• 防守成功率计算

智能配置优化

为了让AI建议更符合您的游戏风格，可以调整以下配置参数：

// 配置文件位置：settings.json { "Unlocker": false, // 解锁功能（建议保持false） "Autoplay": false, // 自动出牌（建议保持false） "Helper": true, // 启用辅助功能 "RandomTime": { "min": 1.0, // 最小思考时间 "max": 3.2 // 最大思考时间 } }

实战应用技巧：从新手到高手的进阶之路

基础使用流程

1. 启动Akagi系统

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

2. 开始游戏分析

   • 正常登录雀魂客户端
   • Akagi会自动捕获游戏数据
   • 主界面显示实时分析结果

3. 理解AI建议

   • 绿色标记：安全牌或好牌
   • 红色标记：危险牌或差牌
   • 数字显示：预期得点或损失

进阶使用技巧

🎯 针对性训练模式：

• 专注于特定场景训练（如防守、听牌选择）
• 使用config.json中的学习模式记录决策偏差
• 定期复盘分析错误决策

📈 数据分析方法：

• 使用convert.py工具导出对局记录
• 将数据转为CSV格式进行深度分析
• 识别自己的游戏模式和弱点

⚙️ 性能优化建议：

• 如果分析延迟过高，降低analysis_depth设置
• 关闭不必要的后台程序
• 确保Python环境是最新版本

安全使用指南：保护您的游戏账号

安全配置清单

为确保安全使用Akagi，请务必完成以下检查：

• 已禁用Autoplay功能（设置为false）
• 启用RandomTime随机延迟（模拟人类思考）
• log_level设置为"warning"或更高
• 定期清理logs/目录下的记录文件
• 不在公共网络环境下使用

行为模拟技术

Akagi内置多项行为模拟技术，让AI建议更自然：

1. 随机化思考延迟：1-3秒的随机等待时间
2. 人类出牌模式：模仿真实玩家的犹豫特征
3. 行为模式变异：避免固定的出牌模式

常见问题与解决方案

安装问题排查

❌ 问题：无法捕获游戏数据

• 检查代理端口是否被占用
• 确认防火墙没有阻止连接
• 验证证书是否已正确安装

❌ 问题：AI建议不显示

• 确认mortal.pth文件已正确放置
• 检查Python依赖是否完整安装
• 查看日志文件获取错误信息

❌ 问题：游戏连接失败

• 确认雀魂客户端代理设置正确
• 尝试重启Akagi和游戏客户端
• 检查网络连接是否稳定

性能优化建议

如果遇到性能问题，可以尝试以下优化：

1. 降低分析深度：在config.json中将analysis_depth从3改为2
2. 关闭可视化界面：使用命令行模式减少资源占用
3. 升级硬件：增加内存或使用更快的CPU

扩展与定制：打造专属AI助手

插件开发基础

Akagi支持自定义插件开发，您可以在mhm/hook/目录下创建自己的插件：

# 示例：简单的手牌分析插件 from mhm.hook import BaseHook class CustomAnalyzer(BaseHook): def on_hand_updated(self, hand_data): # 在这里添加您的自定义分析逻辑 self.logger.info(f"手牌已更新: {hand_data}")

模型集成方法

如果您有自己的AI模型，可以通过以下方式集成：

1. 将模型文件放置在mjai/bot/目录
2. 修改bot.py中的模型加载逻辑
3. 在model.py中实现预测函数

最佳实践与学习建议

合理使用原则

1. 辅助而非依赖：将AI建议作为参考，而非绝对命令
2. 循序渐进学习：初期重点关注基础决策，逐步理解复杂局面
3. 定期自我复盘：对比AI建议与自己的决策，找出差异原因
4. 控制使用时间：建议每天使用不超过2小时，保持健康游戏习惯

学习路径规划

新手阶段（1-2周）：

• 重点关注向听数计算
• 学习基本的安全牌识别
• 理解AI的出牌逻辑

进阶阶段（3-4周）：

• 研究防守策略和危险牌判断
• 分析不同局面下的最优选择
• 学习役种形成概率

高手阶段（1-2个月）：

• 理解AI的深层决策逻辑
• 发展自己的游戏风格
• 参与社区讨论和分享经验

总结与展望

Akagi作为一款开源麻将AI辅助工具，其真正价值在于帮助玩家建立科学的麻将思维体系。通过合理使用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