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从麻将新手成长为战术高手，让每一局对局都成为你技术提升的宝贵经验。

🎯 为什么你需要Akagi？解决麻将学习三大难题

当你面对复杂的麻将局面时，是否经常感到困惑？Akagi就像一位24小时在线的专业教练，帮你解决麻将学习中的三大核心问题：

1. 决策困境：从"凭感觉"到"有依据"

传统学习方式中，你只能凭感觉打牌或事后看攻略。Akagi通过实时AI分析，在你每次出牌前提供精准建议，让你理解每个决策背后的逻辑。

2. 学习瓶颈：从"盲目练习"到"系统提升"

观看高手录像往往难以转化为自己的技能。Akagi的结构化学习系统记录关键决策点，让你在实战中快速积累经验。

3. 复盘困难：从"模糊记忆"到"精确分析"

手动记录对局细节既繁琐又容易遗漏。Akagi自动保存完整对局数据，支持多维度分析，让你的进步轨迹清晰可见。

🚀 快速启动：10分钟完成配置

环境准备清单

• ✅ Python 3.8-3.10环境
• ✅ 雀魂网页版账号
• ✅ 约500MB磁盘空间
• ✅ 网络连接

三步安装流程

第一步：获取项目代码

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

第二步：运行安装脚本

Windows用户：

• 以管理员身份运行scripts/install_akagi.ps1
• 或直接双击运行run_akagi.bat

macOS/Linux用户：

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

第三步：配置AI模型

1. 获取mortal.pth模型文件（可从Discord社区获取）
2. 放置于mjai/bot/目录下
3. 编辑settings.json进行个性化配置

基础配置示例

配置文件：settings.json

{ "Autoplay": false, "Helper": true, "Port": { "MITM": 7878, "XMLRPC": 7879, "MJAI": 28680 } }

新手建议：初次使用时将Autoplay设为false，先通过AI建议培养独立思考能力，逐步建立自己的战术体系。

🎮 核心功能深度解析

实时AI决策支持

Akagi的核心功能是实时分析你的对局，提供最优打牌建议。这不仅仅是简单的"该打哪张牌"，而是基于Mortal AI模型的深度分析。

四层技术架构

Akagi采用分层架构设计，确保系统稳定运行：

游戏数据捕获 → 协议解析 → AI分析 → 结果呈现 ↓ ↓ ↓ ↓ MITM技术 LiqiProto解析 Mortal模型 直观界面

• 数据捕获层：通过MITM技术实时获取雀魂游戏数据
• 协议解析层：将LiqiProto格式转换为标准mjai格式
• AI决策层：调用Mortal模型进行深度分析
• 结果呈现层：以直观界面展示决策建议

多平台兼容性

Akagi不仅支持雀魂，还兼容：

• 🎯 天鳳
• 🎯 麻雀一番街
• 🎯 天月麻將

🔧 实战应用场景

场景一：新手建立基础战术意识

用户故事：小明刚接触雀魂一个月，总是凭感觉打牌，胜率只有30%。使用Akagi后，他开始关注AI的颜色编码提示，快速理解了牌效率概念。

Akagi帮助：

• 每次出牌前提供3个最佳选择
• 用不同颜色标注牌的危险程度
• 记录与AI建议不同的决策，事后分析原因

效果：一个月后，小明的胜率提升到45%，开始形成自己的打牌风格。

场景二：进阶玩家突破瓶颈

用户故事：小美打到四段后遇到瓶颈，复杂局面处理能力不足。Akagi的役种概率计算功能帮她解决了这个问题。

南四局决策示例：

场况：亲家立直，你听牌但点数落后 Akagi分析： - 进攻胜率：42% - 防守安全度：78% - 推荐策略：弃和防守 决策依据：综合考虑点数差、对手舍牌记录、剩余牌山

效果：小美学会了在复杂局面下做出更理性的决策，成功突破到五段。

场景三：高手优化个性化战术

高级配置选项：

• 自定义评估参数调整
• 特殊场况模拟训练
• 多模型对比分析

专家级配置示例：

"Evaluation": { "YakuWeight": 1.2, "SafetyWeight": 0.8, "OffensePriority": 0.7 }

📊 数据分析与技能成长

牌谱转换与分析工具

Akagi内置强大的数据分析工具，帮助你从对局中提取价值：

# 基础转换 python majsoul2mjai.py --input logs/recent_game.json --output analysis/ # 生成统计报告 python convert.py --mode stat --input analysis/ --output report/

麻将技能成长图谱

与传统的线性提升路径不同，Akagi帮助你建立全面的技能树：

┌─────────────────────────────────────────────┐ │ 麻将技能成长图谱 │ ├─────────────────────────────────────────────┤ │ 基础技能 (1-3段) │ │ ├─ 牌效率理解 │ │ ├─ 基本役种识别 │ │ └─ 安全牌判断 │ │ │ │ 进阶技能 (4-7段) │ │ ├─ 复杂局面处理 │ │ ├─ 对手读牌 │ │ └─ 攻守平衡 │ │ │ │ 高级技能 (8段以上) │ │ ├─ 个性化战术 │ │ ├─ 心理博弈 │ │ └─ 长期策略 │ └─────────────────────────────────────────────┘

个性化学习路径

Akagi不提供固定的"30天速成"方案，而是根据你的实际情况：

1. 诊断阶段：分析你的对局数据，识别薄弱环节
2. 定制训练：针对性地提供练习建议
3. 进度跟踪：可视化展示你的进步轨迹
4. 调整优化：根据学习效果动态调整训练内容

⚡ 技术架构与核心模块

关键文件说明

了解Akagi的核心文件，让你更好地使用这个工具：

协议处理流程详解

Akagi的技术核心在于高效的数据处理流程：

雀魂游戏数据 → MITM捕获 → LiqiProto解析 → mjai格式转换 → AI分析 → 决策建议 │ │ │ │ │ │ 原始数据流 实时拦截 协议解码 标准化处理 深度学习 可视化输出

❓ 快速问答：解决你的疑惑

Q1: Akagi会被雀魂官方检测到吗？

A: Akagi设计初衷是教育工具，通过MITM技术分析数据而非修改游戏。但任何第三方工具都有风险，建议：

• 使用网页版而非Steam版
• 不要使用Autoplay功能
• 适当使用贴图交流
• 不完全依赖AI建议

Q2: 我需要多强的电脑配置？

A: Akagi对配置要求不高：

• 普通笔记本电脑即可运行
• 不需要独立显卡
• 内存建议8GB以上
• 稳定的网络连接更重要

Q3: 如何获取mortal.pth模型文件？

A: 可以通过以下方式：

1. 加入项目Discord社区获取
2. 使用社区分享的模型
3. 自己训练模型（需要一定技术能力）

Q4: Akagi支持哪些麻将平台？

A: 目前支持：

• 雀魂 (Majsoul)
• 天鳳 (Tenhou)
• 麻雀一番街 (Riichi City)
• 天月麻將 (Amatsuki)

🛠️ 常见问题排查指南

🎯 你的麻将提升路线图

第一阶段：熟悉工具（1-2周）

• 目标：掌握Akagi的基本使用方法
• 行动：
  1. 完成安装配置
  2. 进行3-5局实战体验
  3. 记录初次使用感受
  4. 加入Discord社区交流

第二阶段：技能培养（3-4周）

• 目标：将AI建议转化为个人能力
• 行动：
  1. 每天进行"思考练习"：先自己决策再对比AI
  2. 分析10个与AI决策不同的关键案例
  3. 建立个人战术笔记库
  4. 尝试调整1-2项配置参数

第三阶段：独立应用（5-8周）

• 目标：形成个人战术体系
• 行动：
  1. 进行"半独立"游戏：只在复杂局面参考AI
  2. 总结个人战术风格特点
  3. 完成5局完全不使用AI的实战
  4. 分享使用经验和技巧

第四阶段：持续优化（长期）

• 目标：成为真正的麻将高手
• 行动：
  1. 每周使用复盘工具分析对局
  2. 关注社区最新的AI模型更新
  3. 参与项目贡献，分享改进建议
  4. 帮助其他新手快速上手

💡 智能辅助与麻将智慧的完美结合

Akagi雀魂AI辅助工具不仅仅是一个技术工具，它是一位24小时在线的个性化麻将教练。通过实时分析、智能建议和数据记录，它帮助你在实战中快速成长，在复盘中深刻反思，在思考中形成自己的麻将哲学。

记住，真正的麻将高手不是靠工具取胜，而是借助工具更好地理解游戏、提升自己。Akagi的价值在于它能够放大你的学习效果，缩短你的成长周期，但最终的麻将智慧仍需你自己去探索和积累。

现在就开始使用Akagi，让智能辅助带你进入麻将的新境界，在雀魂的舞台上展现真正的技术实力！无论你是刚接触麻将的新手，还是希望突破瓶颈的高手，Akagi都能为你提供最适合的学习路径和成长支持。

立即开始：克隆项目仓库，完成基础配置，开始你的麻将提升之旅！每一步的进步，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