3分钟极速上手：免费开源麻将AI助手Akagi完整使用教程-尧图网络科技

3分钟极速上手：免费开源麻将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

你是否曾在雀魂、天凤等麻将平台对局时，渴望获得职业选手般的实时分析和策略指导？Akagi麻将AI助手正是为你量身打造的开源神器！这款基于Rust和Tauri构建的跨平台工具，能够实时分析你的麻将对局，提供精准的出牌建议，帮助你快速提升麻将技巧。无论你是新手想快速入门，还是高手寻求突破，Akagi都能成为你的智能麻将教练。

🎯 传统麻将vsAI辅助：你的麻将水平将如何飞跃？

传统的麻将学习方式往往依赖经验积累和直觉判断，而Akagi麻将AI助手通过数据驱动的智能分析，为你打开全新的学习维度。想象一下，每一手牌都有专业AI实时计算听牌数、和牌率、放铳风险，你的决策将从"凭感觉"升级到"靠数据"。

🚀 为什么Akagi能帮你快速提升？

Akagi的核心优势在于本地化智能分析——所有数据处理都在你的设备上完成，无需担心隐私泄露。它每秒处理200+牌局特征，提供多维度决策建议，包括：

听牌分析：精确显示当前手牌的听牌数和待牌
和牌率预测：基于牌山剩余牌张计算和牌概率
风险评估：分析每个对手的放铳风险等级
智能推荐：综合多种因素给出最佳出牌建议

Akagi麻将AI助手的专业标志，象征着智能与麻将文化的完美结合

📊 四大核心功能模块，全方位提升你的麻将技能

1. 实时HUD显示系统：你的专属麻将教练

Akagi最直观的功能就是实时HUD显示，它会在游戏界面上叠加显示关键信息，就像一位专业教练在你身边实时指导：

听牌状态可视化：一目了然的听牌数和待牌显示
风险预警系统：实时提示危险牌张，避免放铳
最佳决策推荐：AI计算的综合最优出牌选择
可拖拽界面：根据你的习惯调整显示位置和大小

2. 双模式抓包技术：零门槛快速上手

Akagi提供两种数据捕获模式，满足不同用户的技术需求：

🔧 Chromium模式（推荐新手）：内置浏览器控制，零配置即可使用，Akagi会自动启动浏览器并登录麻将平台。

🔒 MITM代理模式：系统级代理，需要一次性CA证书信任，适合需要多平台使用的进阶用户。

3. 智能AI机器人系统：你的私人策略顾问

Akagi内置强大的AI分析引擎，支持多种使用方式：

内置AI模型：无需额外安装，开箱即用
云端推理（可选）：连接到更强的云端模型获得更精准分析
自动模式切换：根据牌局人数自动选择4人或3人模式机器人
自定义机器人：支持导入自己的mjai_bot/脚本

4. 历史数据分析：你的麻将成长档案

所有对局数据自动保存，提供详细的统计分析：

排名分布饼图：了解你的整体表现水平
积分趋势折线图：跟踪技能进步曲线
胜率统计：量化攻防能力，发现提升空间
特殊牌型记录：识别机会把握能力

🛠️ 3分钟极速安装：从下载到实战

第一步：下载适合你的版本

Akagi提供跨平台便携版，下载对应系统的ZIP文件：

操作系统	文件格式	特别说明
Windows	`akagi-<version>-windows-x64.zip`	需要WebView2（Win10 1803+/Win11已预装）
macOS	`akagi-<version>-macos-arm64.zip`	Apple Silicon，首次运行需解除限制
Linux	`akagi-<version>-linux-x64.zip`	需要WebKit2GTK 4.1库支持

下载地址：从项目Release页面获取最新版本，解压到任意有写入权限的目录即可。

第二步：首次运行配置向导

首次启动时，Akagi会引导你完成简单设置：

选择语言：支持英文、日文、简体中文、繁体中文
选择平台：雀魂、天凤、Riichi City等主流平台
选择抓包模式：新手推荐Chromium模式
AI设置：配置内置AI参数，无需额外安装

第三步：开始你的AI辅助麻将之旅

完成配置后，按照以下步骤开始使用：

启动Akagi主程序
登录麻将平台：在Akagi控制的浏览器中登录
开始对局：AI助手会自动捕获游戏数据
查看实时分析：HUD显示会实时更新分析结果

Akagi麻将AI助手支持自摸分析，帮助你把握和牌时机

🎮 实战应用场景：从新手到高手的成长路径

场景一：新手入门阶段（1-2周）

目标：掌握基本规则和牌效计算

Akagi辅助策略：

观察AI的决策逻辑，理解牌效优先原则
学习基础听牌形状和待牌计算
培养风险意识，避免无谓放铳

小技巧：从观察模式开始，先看AI建议再自己做决定，对比差异并思考原因。

场景二：中级提升阶段（2-4周）

目标：优化攻防策略和局势判断

Akagi辅助策略：

学习防守时机选择，避免危险牌张
掌握进攻节奏，把握最佳和牌时机
培养全局观，理解场况对决策的影响

小技巧：使用历史数据分析功能，找出自己的弱点进行针对性训练。

场景三：高级竞技阶段（1-2个月）

目标：形成个性化策略体系

Akagi辅助策略：

深度复盘分析，导出数据进行统计研究
对比不同AI模型的决策差异
开发个性化策略，针对特定对手制定战术

小技巧：尝试自定义AI机器人，根据个人风格调整决策参数。

🔧 高级配置与优化技巧

配置文件详解

Akagi的配置存储在config.toml文件中，主要参数包括：

[general] language = "zh-CN" # 界面语言 [platform] kind = "Majsoul" # 游戏平台 [capture] mode = "chromium" # 抓包模式 [bot] enabled = true # 启用AI分析 active_4p = "builtin" # 4人模式AI active_3p = "builtin3p" # 3人模式AI

性能优化建议

硬件要求：确保有至少4GB可用内存
分析深度：新手建议从深度1开始，熟练后逐步提高
响应延迟：设置为1500-2000ms更自然，避免被平台检测
日志级别：正常使用设为"info"，调试时设为"debug"

自定义AI机器人开发

Akagi支持自定义mjai协议机器人开发：

def react(events): """处理mjai事件并返回动作""" # 分析当前局面 # 计算最佳动作 # 返回动作决策 return {"type": "discard", "tile": "1m"}

开发指南详见官方文档，包含完整的协议规范和使用示例。

Akagi麻将AI助手的立直状态分析，帮助你做出关键决策

📈 数据驱动的麻将学习：你的成长看得见

对局历史分析系统

Akagi会自动记录所有完成的对局，提供多维度的数据分析：

统计维度	分析内容	提升价值
排名分布	1-4位分布饼图	了解整体表现水平
积分趋势	累计PT折线图	跟踪技能进步曲线
胜率统计	和牌率、放铳率	量化攻防能力
特殊牌型	役满、流局满贯	识别机会把握能力

实时诊断与优化

通过深度分析引擎，Akagi能够：

听牌分析：精确计算当前手牌的听牌数和待牌
和牌率预测：基于牌山剩余牌张计算和牌概率
风险评估：分析每个对手的放铳风险等级
推荐系统：综合多种因素给出最佳出牌建议

🛡️ 安全使用与最佳实践

安全使用原则

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

✅推荐做法：

使用网页版而非Steam客户端
合理设置AI响应延迟（1500-2000ms）
结合自身判断使用AI建议
控制每日游戏时间，避免过度依赖

❌避免行为：

不要开启自动出牌功能
不要完全依赖AI决策
不要24小时不间断使用
不要使用过于激进的AI模型

隐私保护机制

Akagi采用完全本地化处理架构：

数据本地存储：所有对局数据保存在本地
无网络传输：AI分析在本地完成，不依赖云端
开源透明：代码完全开源，可自行审查

🔍 常见问题与解决方案

安装与启动问题

问题	可能原因	解决方案
无法启动程序	缺少运行库	安装WebView2或WebKit2GTK
证书错误	CA证书未信任	重新信任证书或使用Chromium模式
游戏数据无法捕获	代理设置错误	检查代理配置为127.0.0.1:23410

使用过程中的问题

问题	可能原因	解决方案
AI建议不显示	机器人未启用	检查bot.enabled设置
程序运行缓慢	分析深度设置过高	降低analysis_depth参数
HUD位置不合适	界面被遮挡	拖拽HUD到合适位置