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辅助工具能够实时分析你的牌局,提供精准的决策建议,让你从麻将新手快速成长为战术高手。Akagi麻将AI辅助工具支持雀魂、天鳳、Riichi City等多个平台,通过智能算法为你提供实时分析和建议。
🎯 为什么你需要Akagi?麻将玩家的三大困境
在开始技术细节之前,先问问自己是否遇到过这些问题:
决策困难:凭感觉打牌 vs AI精准分析
传统打牌方式往往依赖经验和直觉,而Akagi麻将AI辅助工具能够实时分析局势,提供数据驱动的决策支持。
学习瓶颈:看视频学习 vs 结构化学习
Akagi不仅提供实时建议,还能记录你的对局历史,帮助你系统性地分析自己的打牌习惯和进步空间。
复盘困难:手动记录 vs 自动分析
传统复盘需要手动记录,而Akagi自动保存对局数据,提供多维度统计分析,让你的学习更加高效。
🚀 Akagi核心功能架构:三分钟搞懂工作原理
Akagi的工作流程就像一位专业的麻将教练,全程陪伴你的每一局游戏:
1. 数据捕获层 - 实时监听游戏数据
通过两种方式捕获游戏数据:
- MITM代理模式:系统级代理,支持所有麻将游戏客户端
- Chromium模式:内置浏览器,无需安装证书,开箱即用
2. 协议转换层 - 统一格式处理
将不同平台的专用协议转换为标准mjai格式,让AI模型能够理解游戏状态。
3. AI决策层 - 智能算法分析
内置Mortal AI模型,基于深度学习算法分析当前局势,计算每张牌的打牌价值。
4. 结果呈现层 - 直观界面展示
以可拖拽的HUD界面展示AI建议,包括向听数、听牌、和牌率、听牌率、放铳风险等关键信息。
📦 十分钟快速上手:从零开始配置Akagi
准备工作清单
在开始安装前,请确保准备好以下内容:
- ✅ 操作系统支持:Windows、macOS或Linux
- ✅ 雀魂网页版账号(推荐使用网页版)
- ✅ 约500MB可用磁盘空间
- ✅ 稳定的网络连接
安装步骤详解
第一步:获取项目代码
git clone https://gitcode.com/gh_mirrors/ak/Akagi cd Akagi第二步:运行应用程序
Akagi提供便携式zip包,解压即可使用:
Windows用户:
- 下载
akagi-<version>-windows-x64.zip - 解压到任意目录
- 运行
akagi.exe
macOS用户:
- 下载
akagi-<version>-macos-arm64.zip - 解压后运行:
xattr -cr Akagi.app - 双击运行应用程序
Linux用户:
- 下载
akagi-<version>-linux-x64.zip - 解压到任意目录
- 运行
./akagi
第三步:首次运行配置向导
首次启动Akagi时,设置向导会引导你完成以下步骤:
- 选择语言:支持中文、英文、日文
- 选择平台:雀魂、天鳳或Riichi City
- 选择抓包模式:推荐Chromium模式(无需证书)
- 安装AI模型:一键安装Mortal AI
- 完成设置:开始使用!
⚙️ 核心配置文件详解:定制你的AI助手
Akagi的强大之处在于它的高度可定制性。配置文件位于config.toml:
基础配置示例
[general] language = "zh-CN" [platform] kind = "Majsoul" [capture] mode = "chromium" [bot] enabled = true active_4p = "mortal" active_3p = "mortal3p"个性化配置推荐
新手友好型配置:
[capture.chromium] start_url = "https://game.maj-soul.com/1/" executable = "" # 自动检测浏览器 [bot] auto_sync = true进阶玩家配置:
[logging] level = "debug" dir = "./logs" [proxy] enabled = true addr = "127.0.0.1:23410"🎮 实战应用场景:Akagi在不同阶段的用法
阶段一:新手适应期(初段-三段)
核心目标:建立基础战术意识
应用场景:
- 起手配牌:牌效率评估,理解牌型整理优先级
- 安全牌判断:安全度评分,降低放铳率
- 基本听牌:和牌概率计算,学习听牌选择
每日练习计划:
- 完成2局实战,每局后查看AI决策建议
- 记录3个与AI决策不同的关键选择
- 学习1个基础战术概念(如牌效率)
阶段二:技能提升期(四段-七段)
核心目标:掌握复杂局势处理
应用场景:
- 攻守判断:场况分析,根据点数调整策略
- 对手分析:行为记录,识别对手打牌习惯
- 特殊役种:役种概率,学习复合役种组合
实战技巧:
- 在南四局听牌阶段,Akagi会综合考虑点数状况、对手舍牌记录和剩余牌山
- 提供"立直进攻"或"弃和防守"的明确建议
- 帮助你在关键局做出最优决策
阶段三:战术精通期(八段以上)
核心目标:形成个人战术风格
高级功能应用:
- 自定义评估参数,调整AI决策权重
- 针对特殊场景(亲家、追立)进行专项训练
- 多模型对比分析,理解不同AI的思考差异
🖥️ 界面操作指南:快速掌握Akagi使用技巧
主界面布局解析
Akagi界面采用现代化设计,主要分为以下几个区域:
┌─────────────────┬─────────────────┐ │ 侧边栏导航 │ 主内容区域 │ │ - 游戏仪表盘 │ - 实时HUD显示 │ │ - 对局历史 │ - 手牌分析 │ │ - Bot管理 │ - AI建议 │ │ - 日志诊断 │ - 对手信息 │ │ - 设置 │ │ └─────────────────┴─────────────────┘核心功能区域
- 游戏仪表盘:实时显示对局状态
- 手牌显示区:可视化你的手牌和副露
- AI建议面板:显示推荐切牌和风险评估
- 对手信息:显示其他玩家的舍牌和状态
- 统计面板:实时计算向听数、和牌率等数据
操作流程说明
- 启动Akagi:运行应用程序
- 选择模式:在设置中选择抓包模式
- 开始游戏:启动麻将游戏
- 查看建议:AI会在右侧显示推荐动作
- 手动操作:根据建议在游戏中打牌
重要提示:Akagi仅为辅助工具,最终决策仍需结合个人判断。
🔒 安全使用指南:保护你的雀魂账号
使用第三方工具总是存在风险,以下措施可以最大程度保护你的账号安全:
安全等级清单
✅强烈推荐的做法:
- 使用网页版而非Steam客户端
- 关闭Autoplay功能,手动操作
- 经常使用表情贴纸,模拟真人行为
- 不完全遵循AI建议,加入个人判断
⚠️需要谨慎的做法:
- 长时间连续游戏(超过4小时)
- 在比赛中表现过于完美
❌绝对避免的做法:
- 24小时不间断使用自动打牌
- 完全依赖AI决策,不加思考
- 在官方比赛中使用辅助工具
账号安全配置参考
[bot] enabled = true # 使用分析功能但不完全依赖AI # 保持手动操作,加入个人思考🛠️ 常见问题解决:遇到问题怎么办?
安装问题排查表
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 无法启动 | 系统环境问题 | 检查系统要求,确保满足运行条件 |
| 代理连接失败 | 证书未安装 | 重新安装mitmproxy证书 |
| AI无响应 | mortal.pth缺失 | 确认AI模型文件正确安装 |
| 游戏数据无法捕获 | 代理设置错误 | 检查浏览器代理配置 |
使用中的常见问题
Q:AI建议总是和我的想法不同,该相信谁?A:Akagi是基于大量对局数据训练的,但麻将也有运气成分。建议先理解AI的思考逻辑,再结合场况做出最终决定。
Q:为什么有时候AI反应很慢?A:复杂局面需要更多计算时间。你可以在设置中调整响应速度参数来优化体验。
Q:如何保存和复盘对局记录?A:Akagi会自动保存对局数据,你可以在历史记录中查看和复盘。
📊 数据分析与复盘:从工具使用者到战术专家
历史记录功能
Akagi的对局历史功能是你提升麻将水平的最佳助手:
- 名次饼图:直观显示你的排名分布
- 累计PT折线图:追踪你的段位变化
- 详细统计:分析和牌率、放铳率、立直率等关键指标
- 对局列表:按平台、人数、日期过滤查看
数据分析工具
基础复盘:
- 查看每局详细数据
- 分析关键决策点
- 对比AI建议与实际选择
深度分析:
- 统计长期表现趋势
- 识别个人打牌习惯
- 制定针对性改进计划
🧩 项目架构深度解析
核心模块说明
Akagi采用现代化的技术架构:
Akagi/ ├── src/ # Rust后端核心 │ ├── analysis/ # 麻将分析引擎 │ ├── bot/ # AI模型管理 │ ├── bridge/ # 平台协议转换 │ ├── capture/ # 数据捕获 │ └── game_state/ # 游戏状态跟踪 ├── frontend/ # React前端界面 │ ├── routes/ # 页面路由 │ ├── tiles/ # 仪表板组件 │ └── stores/ # 状态管理 ├── mjai_bot/ # AI模型目录 └── capabilities/ # Tauri权限配置关键技术亮点
- 实时数据捕获:MITM/CDP技术实现无延迟游戏数据获取
- 协议转换:多平台协议到mjai格式的高效转换
- AI集成:支持多种麻将AI模型,默认使用Mortal
- 用户界面:简洁直观的现代化界面,实时显示建议
🤝 社区支持与资源
获取帮助的途径
- Discord社区:实时交流,获取最新模型
- GitHub Issues:报告bug,请求新功能
- 项目文档:详细的使用和开发指南
贡献项目的方式
- 提交Pull Request改进代码
- 分享你的使用经验和技巧
- 报告使用中发现的bug
- 提供功能改进建议
官方文档资源
- AI功能源码:src/bot/
- 麻将分析引擎:src/analysis/
- 前端界面源码:frontend/src/
🎯 总结:智能辅助与麻将智慧的完美结合
Akagi不仅仅是一个工具,更是一位24小时在线的麻将教练。它通过实时分析、智能建议和数据记录,帮助你系统性提升麻将水平。但记住最重要的原则:技术是辅助,理解才是核心。
通过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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考