如何高效使用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助手，能够实时分析雀魂、天鳳等平台的麻将对局，提供专业的出牌建议和数据分析。这款工具通过本地化的智能分析系统，帮助玩家从麻将新手快速成长为高手，特别适合想要提升雀魂技巧的玩家。

🚀 项目价值定位：为什么你需要麻将AI助手？

麻将作为一款策略性极强的游戏，新手玩家往往难以判断最佳出牌选择。Akagi麻将AI助手通过实时分析对局数据，为你提供专业的决策支持，让你在对局中获得AI级别的分析能力。

图：AI助手分析出的最佳和牌建议，帮助玩家识别胜利机会

核心优势对比

🎯 核心功能展示：Akagi能为你做什么？

实时HUD显示系统

Akagi提供可拖拽的实时HUD界面，显示关键麻将数据：

• 向听数：距离和牌还需要多少张牌
• 待牌：当前可以等待的和牌牌型
• 和牌率：当前手牌的和牌概率
• 听牌率：达到听牌状态的概率
• 放铳风险：针对每个对手的放铳风险评估
• 推荐切牌：AI建议的最佳出牌选择

图：AI建议的碰牌操作，优化手牌组合

双模式数据捕获

Akagi支持两种数据捕获方式，满足不同用户需求：

MITM代理模式：

• 系统级代理，一次性CA证书信任
• 支持所有麻将平台客户端
• 需要简单的网络配置

Chromium浏览器模式：

• 零配置，无需CA证书
• Akagi直接启动受控浏览器
• 通过Chrome DevTools协议拦截数据
• 最适合新手用户

可插拔AI模型系统

Akagi采用模块化的AI模型架构：

• 内置Mortal AI作为示例模型
• 支持自定义mjai协议bot
• 自动根据牌局人数切换模型（4人局/3人局）
• 配置路径：mjai_bot/

📦 快速上手体验：5分钟开始使用

系统要求检查

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

• 操作系统：Windows 10/11、macOS 10.15+、主流Linux发行版
• 内存：至少4GB可用内存
• 磁盘空间：1GB以上空闲空间
• 网络：稳定的网络连接

一键安装步骤

Windows用户：

1. 下载最新版本的安装包
2. 运行安装程序，按照向导完成安装
3. 首次运行时信任mitmproxy证书

macOS/Linux用户：

git clone https://gitcode.com/gh_mirrors/ak/Akagi cd Akagi # macOS用户执行 chmod +x scripts/install_akagi.command ./scripts/install_akagi.command # Linux用户执行 ./scripts/install_akagi.sh

AI模型获取与配置

安装完成后，需要获取AI模型文件：

1. 从社区获取完整的mortal.pth模型文件
2. 将文件放置在mjai_bot/目录下
3. 确保配置文件正确设置AI模型路径

🔧 深度应用场景：进阶使用技巧

游戏历史数据分析

Akagi自动记录所有完成的对局数据，提供深度分析功能：

数据存储结构：

<config_root>/history/ ├── index.jsonl # 游戏记录索引 └── games/ └── <ulid>.mjai.jsonl # 完整事件流数据

分析功能包括：

• 排名饼图分析（1st/2nd/3rd/4th分布）
• 累计PT折线图，支持多种计分规则
• 详细统计数据：和牌率、放铳率、立直率等
• 游戏列表筛选和详细查看

图：立直策略的AI分析结果，帮助玩家评估风险与收益

日志与诊断系统

Akagi提供完善的日志系统，帮助用户排查问题：

日志结构：

<log_dir>/<session>/ ├── all.log # 综合跟踪输出 ├── <target>.log # 按模块过滤的日志 ├── proxy.binlog # 原始二进制WS帧 ├── majsoul/<flow_id>.log # WebSocket流JSON日志 └── inspector.jsonl # 检查器帧数据

诊断工具：

• 可过滤的应用日志（按级别和模块）
• 实时日志尾部查看
• 协议级帧查看器
• 原始WebSocket帧分析

⚙️ 最佳实践分享：提升使用效率

推荐配置参数

编辑配置文件config.toml，优化使用体验：

[general] language = "zh-CN" # 支持中文界面 [bot] enabled = true active_4p = "mortal" # 4人局使用模型 active_3p = "mortal3p" # 3人局使用模型 [capture] mode = "chromium" # 推荐使用Chromium模式

安全使用建议

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

✅推荐做法：

• 使用网页版雀魂而非Steam客户端
• 手动操作，不完全依赖AI建议
• 合理控制每日游戏时间
• 定期更新AI模型和软件版本

❌避免行为：

• 不要开启自动出牌功能
• 不要24小时不间断游戏
• 不要完全照搬AI的每一个建议
• 不要在正式比赛中过度依赖AI

AI模型切换策略

根据你的游戏水平选择合适的AI模型：

图：自摸和牌的AI分析，帮助玩家识别自摸机会

🛠️ 常见问题解决指南

问题1：无法捕获游戏数据？

解决方案：

1. 检查代理设置是否正确配置
2. 确认防火墙是否阻止了连接
3. 重新安装mitmproxy证书（MITM模式）
4. 查看Akagi控制台输出是否有错误信息
5. 尝试切换到Chromium模式

问题2：AI建议不显示？

排查步骤：

1. 检查mjai_bot/目录下是否有模型文件
2. 验证模型文件完整性
3. 确认配置文件中model_enabled为true
4. 检查analysis_depth设置是否合理
5. 查看日志文件中的错误信息

问题3：程序运行缓慢？

优化建议：

1. 将analysis_depth从3改为2或1
2. 减少AI思考时间设置
3. 关闭不必要的后台程序
4. 确保有足够的内存可用
5. 更新到最新版本

📈 技术架构与扩展性

模块化架构设计

Akagi采用单Rust二进制架构，子系统通过事件总线通信：

游戏客户端 → 捕获模块 → 桥接模块 → Mjai事件总线 ↓ ↓ ↓ 游戏状态跟踪器 AI管理器 IPC转发器 ↓ 分析引擎 → IPC转发器 → Tauri前端

技术栈概览

• 后端：Rust + Tokio + Tauri 2
• 前端：React + TypeScript + Tailwind CSS
• AI运行时：Python 3.12 + uv（捆绑发布）
• 麻将引擎：riichienv-core
• UI组件：shadcn/ui + Radix Nova

开发者资源

• 核心源码：src/
• 配置文件：config/
• AI模型开发：mjai_bot/README.md
• 历史记录系统：src/history/README.md

🎯 总结与行动号召

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

立即行动：

1. 下载并安装Akagi麻将AI助手
2. 配置好你的游戏环境
3. 开始你的第一局AI辅助对局
4. 记录并分析你的进步过程

开始你的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