Akagi麻将AI助手：3分钟快速上手完整指南

Akagi麻将AI助手：3分钟快速上手完整指南

【免费下载链接】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

你是否想在雀魂对局中获得专业级的AI分析支持？Akagi麻将AI助手正是你需要的强大工具！这款开源AI助手能够实时分析你的雀魂对局，提供精准的出牌建议，帮助你快速提升麻将技巧。本文将为你详细介绍如何快速部署和使用这个强大的麻将AI助手，让你在短短3分钟内开始享受智能分析带来的优势。

🎯 为什么选择Akagi麻将AI助手？

Akagi是一款专为雀魂玩家设计的开源AI助手，通过本地化的智能分析系统，为你的每一手牌提供专业建议。它支持多种麻将平台，包括雀魂、天凤、麻雀一番街等，让你在对局中获得AI级别的决策支持。

核心优势一览

• 实时智能分析：每秒处理200+牌局特征，提供多维度决策建议
• 本地安全保障：所有数据在本地处理，不泄露任何账号信息
• 开源免费使用：完全开源，无需付费即可享受专业AI分析
• 多平台兼容：支持雀魂、天凤、麻雀一番街等多个麻将平台

📦 快速安装指南

准备工作

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

一键安装步骤

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

3. 配置证书：

   • 首次运行时会生成mitmproxy证书
   • 按照提示将证书添加到系统信任列表

macOS/Linux用户安装方法

1. 获取项目文件：

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

2. 执行安装命令：

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

3. 信任证书：

   • 打开系统安全设置
   • 找到mitmproxy证书并设置为"始终信任"

获取AI模型文件

安装完成后，你需要获取AI模型文件才能使用完整功能：

1. 访问Discord社区获取mortal.pth模型文件
2. 将文件放置在mjai/bot/目录下
3. 确保文件大小超过100MB（完整模型文件）

⚙️ 核心配置详解

主要配置文件

Akagi的核心配置集中在几个关键文件中：

推荐配置参数

打开config.json文件，设置以下推荐参数：

{ "model_enabled": true, "analysis_depth": 2, "response_delay": 1500, "log_level": "info", "human_like_delay": true }

💡配置建议：新手建议从analysis_depth: 1开始，熟悉后再逐步提升分析深度。

🎮 实战使用教程

第一步：启动Akagi助手

根据你的操作系统选择启动方式：

Windows启动方法：

• 双击run_akagi.bat文件
• 或在命令行中执行：python gui.py

macOS/Linux启动方法：

• 终端中执行：./run_akagi.command
• 或直接运行：python3 gui.py

第二步：配置雀魂代理

1. 打开雀魂游戏客户端
2. 进入网络设置
3. 配置HTTP代理为：127.0.0.1:8080
4. 保存设置并重新启动游戏

第三步：开始对局分析

1. 进入游戏大厅：Akagi会自动检测到连接
2. 开始匹配对局：AI助手会实时捕获游戏数据
3. 查看分析结果：在主界面查看AI给出的建议
4. 参考决策：将AI建议作为参考，结合自己的判断出牌

🔧 高级功能探索

AI模型切换技巧

Akagi支持多种AI模型，你可以根据需求切换：

切换方法：修改mjai/bot/目录下的模型文件配置。

数据记录与分析

每次对局结束后，Akagi都会生成详细的对局记录：

• 自动记录：所有对局数据保存在本地
• 格式转换：使用convert.py将记录转为CSV格式
• 深度分析：导入数据分析工具进行复盘学习

转换命令示例：

python convert.py -i replay.log -o analysis.csv

核心功能源码解析

了解Akagi的核心实现有助于更好地使用工具：

• 协议解析模块：mhm/protocol.py- 处理麻将游戏协议
• AI分析引擎：mjai/bot/bot.py- AI决策核心逻辑
• 图形界面：gui.py- 用户交互界面
• 配置文件：config.json- 全局配置管理

🛠️ 常见问题解决

问题排查指南

详细故障排除步骤

无法捕获游戏数据？

1. 检查代理设置：

   • 确认雀魂代理设置为127.0.0.1:8080
   • 检查防火墙是否阻止了连接

2. 验证证书状态：

   • 重新安装mitmproxy证书
   • 确保证书在系统信任列表中

3. 查看日志信息：

   • 检查Akagi控制台输出
   • 查看是否有错误信息提示

AI建议不显示？

1. 确认模型文件：

   • 检查mjai/bot/目录下是否有mortal.pth文件
   • 验证文件完整性（应大于100MB）

2. 检查配置参数：

   • 确认config.json中model_enabled为true
   • 检查analysis_depth设置是否合理

📈 提升游戏水平的技巧

结合AI建议与个人判断

Akagi的最佳使用方式是"参考而非依赖"：

1. 学习阶段：仔细观察AI的决策逻辑
2. 实践阶段：将AI建议与自己的判断结合
3. 提升阶段：分析AI建议与自己决策的差异

定期复盘分析

利用Akagi生成的对局数据进行复盘：

1. 导出数据：使用python convert.py -i replay.log -o analysis.csv
2. 分析关键决策：找出对局中的关键转折点
3. 总结经验：记录自己的决策失误和改进方向

安全使用建议

为了保护你的账号安全，请遵循以下原则：

✅推荐做法：

• 使用网页版雀魂而非Steam客户端
• 手动操作，不完全依赖AI建议
• 合理使用表情和贴纸
• 控制每日游戏时间

❌避免行为：

• 不要开启自动出牌功能
• 不要24小时不间断游戏
• 不要完全照搬AI的每一个建议

🚀 快速开始清单

5分钟快速上手步骤

1. ✅ 克隆项目：git clone https://gitcode.com/gh_mirrors/ak/Akagi
2. ✅ 运行安装脚本（根据系统选择）
3. ✅ 获取mortal.pth模型文件
4. ✅ 配置雀魂代理为127.0.0.1:8080
5. ✅ 启动Akagi：python gui.py
6. ✅ 开始雀魂对局并享受AI分析

进阶功能探索清单

• 尝试不同的AI模型
• 调整分析深度参数
• 导出对局数据进行分析
• 学习核心源码实现
• 参与社区交流分享经验

🔮 未来发展方向

Akagi项目持续更新，未来计划加入更多实用功能：

• 图像识别技术：减少对MITM的依赖
• 更多AI模型：提供不同风格的分析选项
• 移动端支持：开发手机版AI助手
• 数据分析工具：更强大的对局分析功能

🎯 总结

Akagi麻将AI助手为雀魂玩家提供了一个强大的学习工具。通过智能分析和实时建议，你可以快速提升麻将水平，理解更深的游戏策略。记住，AI助手只是辅助工具，真正的提升来自于你对游戏的理解和实践。

开始你的AI辅助麻将之旅吧！安装Akagi，体验智能分析带来的游戏提升，在雀魂的世界中享受更高水平的竞技乐趣。

温馨提示：合理使用AI助手，保持游戏乐趣，避免过度依赖。麻将的魅力在于人与人的智慧较量，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