news 2026/4/27 17:17:30

从零开始：Akagi AI麻将助手终极使用指南

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
从零开始：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？AI麻将助手的核心价值

在开始技术配置之前，让我们先了解Akagi能为你带来什么。想象一下，你正在打麻将，面对复杂的牌局，Akagi就像一位经验丰富的教练站在你身边，实时分析每一手牌，提供专业的建议。

三大核心优势

传统麻将学习痛点Akagi的智能解决方案你的收获
决策依据模糊基于Mortal AI模型的量化分析清晰的打牌逻辑和概率计算
实时判断困难MITM技术捕获实时对局数据即时反馈，边打边学
复盘分析不足完整对局数据记录与回溯深度复盘，发现自身问题

Akagi的强大之处在于它的实时性和专业性。通过观察AI的决策过程，你将逐渐培养职业选手般的牌局分析能力。

💡思考练习：回忆你最近一次麻将对局，最让你困惑的决策是什么？如果有一个AI助手，你希望它如何帮助你？

🚀 快速入门：三步搭建你的AI麻将助手

第一步：获取项目与基础环境搭建

就像搭建乐高积木一样，让我们从最基础的开始：

  1. 下载项目代码

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

  2. 一键安装（根据你的系统选择）

    Windows用户：

    # 以管理员身份打开PowerShell Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass .\scripts\install_akagi.ps1

    macOS用户：

    # 打开终端 bash scripts/install_akagi.command

  3. 验证安装成功安装完成后，检查以下关键目录是否创建成功：

    • mjai/bot/- AI模型的"大脑"存放处
    • mahjong_soul_api/- 连接游戏的"桥梁"
    • mhm/- 核心功能模块

    ✅验证检查点：在终端输入python -m mhm，如果看到Akagi版本信息，恭喜你，基础环境搭建成功！

第二步：为AI注入"智慧"——模型配置

没有模型的Akagi就像没有大脑的助手，让我们为它安装思考核心：

  1. 获取Mortal模型文件这是AI的"大脑"，你可以在Akagi社区（如Discord）找到分享的资源

  2. 放置模型文件将下载的mortal.pth文件放到正确位置：

    mjai/ └── bot/ └── mortal.pth <-- 模型文件放这里

  3. 配置AI启用打开settings.json文件，确保以下设置正确：

    { "ModelPath": "mjai/bot/mortal.pth", "AI.Enabled": true, "Autoplay": false // 新手建议先关闭自动打牌 }

    ✅验证检查点：运行python action.py，如果没有"模型文件缺失"的错误提示，说明模型配置成功！

第三步：建立连接——网络配置实战

现在需要让Akagi与游戏"对话"：

  1. 启动中间人代理

    python mitm.py

  2. 配置系统代理

    • 代理服务器：127.0.0.1
    • 端口：7878（默认设置，可在settings.json的Port.MITM修改）

  3. 安装SSL证书（首次使用必须）

    • 打开浏览器访问 http://mitm.it
    • 下载并安装对应你操作系统的证书
    • 重要：在系统中将证书设置为"始终信任"

    ✅验证检查点：启动雀魂游戏，如果终端显示"成功捕获对局数据"，恭喜你，连接建立成功！

⚙️ 个性化配置：打造专属AI麻将教练

Akagi的强大之处在于它的高度可定制性。通过调整settings.json，你可以让AI助手更符合你的学习需求。

核心配置参数详解

配置类别参数名称推荐设置适用场景
AI分析深度AI.ThinkDepth3（默认）平衡速度与深度，适合大多数玩家
自动操作Autoplay.Enabledfalse新手强烈建议关闭，手动操作学习效果更好
界面显示UI.ShowProbabilitytrue显示牌张概率，帮助理解AI决策
响应时间RandomTime.min/max1.0-3.2秒模拟人类思考时间，避免被检测

性能优化决策指南

遇到性能问题？按以下步骤排查： 1. AI响应太慢？ ↓ 降低`AI.ThinkDepth`值 ↓ 关闭`UI.ShowDetail`详细显示 ↓ 检查电脑资源占用 2. 数据捕获不完整？ ↓ 确认代理端口设置正确 ↓ 检查SSL证书是否安装成功 ↓ 重启代理服务

⚠️安全提示：使用任何第三方游戏辅助工具都存在一定风险。建议仅在私人练习环境中使用Akagi，避免在竞技性排位赛中使用，以保持游戏公平性和账号安全。

🚫 常见误区与避坑指南

误区一：过度依赖自动打牌

许多用户喜欢开启Autoplay功能，让AI完全接管操作。但这不仅失去了学习意义，还可能增加账号风险。

正确做法：保持Autoplay为false，将Akagi视为决策参考工具。对比自己与AI的决策差异，这才是真正的学习过程。

误区二：忽视模型更新

AI模型需要定期更新才能保持最佳性能。很多用户安装后就不再更新。

正确做法：每月检查社区是否有模型更新，关注项目的最新动态。

误区三：网络配置不当

代理设置错误是最常见的问题，特别是端口冲突和证书信任问题。

解决方案：

  • 使用默认端口7878时，确保没有其他程序占用
  • 证书安装后必须在系统中设置为"始终信任"
  • 遇到问题时先查看mitm.py的输出日志

🔧 进阶探索：解锁Akagi的隐藏潜力

自定义分析报告

通过修改action.py，你可以创建个性化的对局分析报告：

# 示例：添加自定义分析指标 def generate_custom_report(game_data): """生成包含个人关注指标的分析报告""" report = { "基础数据": { "胜率": calculate_win_rate(game_data), "听牌率": calculate_tenpai_rate(game_data), }, "进阶指标": { "防守成功率": calculate_defense_success(game_data), "进攻效率": calculate_offense_efficiency(game_data), "弃牌质量": calculate_discard_quality(game_data), } } return report

开发专属插件

Akagi的模块化设计允许你扩展功能。在mhm/hook/目录下，你可以：

  1. 创建新的插件文件
  2. 实现on_game_start、on_turn_end等钩子函数
  3. 在config.json中启用你的插件

利用现有模块

  • mahjong_soul_api/ms/- 雀魂游戏接口模块
  • mhm/proto/- 协议处理核心
  • mjai/bot/- AI模型与决策逻辑

💡思考练习：如果你要为Akagi开发一个新功能，会是什么？如何通过现有模块实现？

🌟 从工具到思维：AI辅助麻将学习路径

Akagi的真正价值不在于替你打牌，而在于培养你的麻将思维能力。我建议的学习路径是：

第一阶段：观察学习（1-2周）

  • 开启AI建议，但完全手动操作
  • 对比自己与AI的决策差异
  • 理解AI的思考逻辑

第二阶段：模仿实践（2-4周）

  • 尝试遵循AI建议进行决策
  • 记录决策正确率的变化
  • 分析AI决策背后的概率计算

第三阶段：批判思考（1个月后）

  • 对AI决策提出质疑
  • 思考是否存在更好的选择
  • 形成自己的决策风格

第四阶段：融合创新（长期）

  • 将AI建议作为参考而非标准答案
  • 结合个人经验与AI分析
  • 发展独特的麻将风格

📚 资源与支持

关键文件位置

  • 主配置文件：settings.json- 所有核心设置
  • AI模型目录：mjai/bot/- 放置mortal.pth的地方
  • 核心模块：mhm/- 主要功能实现
  • 游戏接口：mahjong_soul_api/- 连接不同麻将平台

学习建议

  1. 循序渐进：不要一开始就追求完美，从基础功能开始
  2. 记录成长：定期复盘自己的决策变化
  3. 参与社区：在Discord等社区交流学习心得
  4. 安全第一：始终将Akagi作为学习工具，而非作弊手段

🎉 开始你的AI麻将之旅

现在，你已经掌握了Akagi的完整使用指南。记住，最好的麻将AI不是替代你思考，而是启发你思考。通过Akagi，你不仅是在学习打麻将，更是在学习如何做出更好的决策。

每一次对局都是一次学习机会，每一次AI建议都是一次思维碰撞。从今天开始，让Akagi成为你麻将之路上的智能伙伴，一起探索麻将的无限可能！

探索者寄语：技术是工具，思维是核心。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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/4/27 17:17:27

告别自动生成！Vivado 2023.1手写Testbench保姆级模板（附SPI实例代码）

Vivado 2023.1手写Testbench实战指南&#xff1a;从原理到SPI案例解析 在FPGA开发领域&#xff0c;仿真验证环节的重要性不亚于设计本身。虽然Vivado提供了自动生成Testbench的工具&#xff0c;但许多资深工程师仍然坚持手写验证代码——这不仅是一种技术选择&#xff0c;更是一…

作者头像 李华
网站建设 2026/4/27 17:11:50

基于Easy-Vibe实现单目视频3D人体姿态估计与动作捕捉

1. 项目概述&#xff1a;从姿态估计到实时动作捕捉最近在搞一个基于视频的人体姿态与动作捕捉项目&#xff0c;核心需求是把一段普通的RGB视频&#xff0c;实时地转换成精准的3D人体骨骼动画。这玩意儿在虚拟主播、游戏动画生成、体育分析甚至影视预演里都有不小的应用潜力。市…

作者头像 李华
网站建设 2026/4/27 17:11:02

终极指南：3步轻松掌握Windows风扇控制软件配置

终极指南&#xff1a;3步轻松掌握Windows风扇控制软件配置 【免费下载链接】FanControl.Releases This is the release repository for Fan Control, a highly customizable fan controlling software for Windows. 项目地址: https://gitcode.com/GitHub_Trending/fa/FanCon…

作者头像 李华
网站建设 2026/4/27 17:11:04

OpenClaw安全仪表盘：7大维度实时监控Linux服务器安全

1. 项目概述&#xff1a;一个为OpenClaw量身定制的实时安全仪表盘如果你和我一样&#xff0c;在服务器上部署了OpenClaw&#xff0c;那么你肯定知道&#xff0c;它为我们提供了强大的网络代理和隧道能力。但能力越大&#xff0c;责任也越大。一个配置不当的OpenClaw实例&#x…

作者头像 李华
网站建设 2026/4/27 17:10:41

华硕笔记本性能管家：G-Helper如何让你的ROG笔记本重获新生？

华硕笔记本性能管家&#xff1a;G-Helper如何让你的ROG笔记本重获新生&#xff1f; 【免费下载链接】g-helper Lightweight, open-source control tool for ASUS laptops and ROG Ally. Manage performance modes, fans, GPU, battery, and RGB lighting across Zephyrus, Flow…

作者头像 李华