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辅助工具，能够实时分析你的牌局，提供精准的向听数、听牌率、和牌率分析，帮助你从麻将新手快速成长为战术高手。这款工具支持雀魂、天凤、Riichi City等多个平台，无论是四麻还是三麻都能完美适配。

🎯 为什么你需要Akagi？麻将玩家的智能升级方案

麻将作为一门复杂的策略游戏，很多时候我们都会面临决策困境：该进攻还是防守？该听什么牌？Akagi通过先进的AI技术为你提供实时分析，让你在每一局中都能做出更明智的选择。

核心功能亮点

1. 实时HUD显示

• 向听数、听牌、和牌率、听牌率实时计算
• 对各家放铳风险评估
• 推荐进攻/防守切牌建议
• 可拖拽、可缩放的牌格布局

2. 双模式数据捕获

• MITM代理模式：系统级抓包，适合高级用户
• Chromium模式：内置浏览器，无需配置证书，开箱即用

3. 智能AI集成

• 内置Mortal AI模型作为示例
• 支持自定义mjai协议bot
• 四麻/三麻自动切换不同的bot

4. 完整对局记录

• 自动保存每一局完整对局
• 名次分布饼图分析
• 累计PT折线图，支持多种计分规则
• 详细统计数据：和牌率、放铳率、立直率等

🚀 五分钟快速上手指南

第一步：获取并运行Akagi

Akagi提供便携式zip包，无需复杂安装：

# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/ak/Akagi cd Akagi # 或者直接下载官方release包 # 从Releases页面下载对应平台的zip文件 # Windows: akagi-<version>-windows-x64.zip # macOS: akagi-<version>-macos-arm64.zip # Linux: akagi-<version>-linux-x64.zip

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

首次启动时，Akagi会引导你完成配置：

1. 选择语言：支持中文、英文、日文等多种语言
2. 选择平台：雀魂、天凤、Riichi City等
3. 选择捕获模式：推荐使用Chromium模式（无需证书配置）
4. 安装AI模型：一键安装Mortal AI模型

第三步：开始使用

配置完成后，Akagi会自动启动浏览器并连接到麻将游戏平台。你将在游戏界面上看到实时分析HUD，AI会在每巡为你提供建议。

🎮 实战应用场景：不同玩家的使用策略

新手玩家：建立基础认知

对于刚接触麻将的新手，Akagi能帮助你快速理解基本概念：

每日练习建议：

1. 完成2-3局实战，重点观察AI的决策逻辑
2. 记录与AI建议不同的关键决策点
3. 每周回顾对局历史，分析进步趋势

进阶玩家：提升战术水平

对于有一定基础的玩家，Akagi能帮助你优化策略：

实战技巧：

• 在南四局听牌阶段，Akagi会综合考虑点数状况、对手舍牌记录
• 提供"立直进攻"或"弃和防守"的明确建议
• 帮助你在关键局做出最优决策

高级玩家：深度数据分析

对于追求极致的高手，Akagi提供完整的对局分析：

⚙️ 个性化配置技巧

核心配置文件

Akagi的配置文件位于config.toml，支持实时热重载：

[general] language = "zh-CN" # 设置中文界面 [platform] kind = "Majsoul" # 游戏平台：Majsoul、Tenhou、RiichiCity [capture] mode = "chromium" # 捕获模式：mitm或chromium [bot] enabled = true active_4p = "mortal" # 四麻使用的bot active_3p = "mortal3p" # 三麻使用的bot

不同玩家配置推荐

新手友好配置：

[bot] active_4p = "mortal" active_3p = "mortal3p" auto_sync = true [capture.chromium] executable = "" # 自动检测浏览器 start_url = "https://game.maj-soul.com/1/"

进阶玩家配置：

[logging] level = "debug" # 更详细的日志 dir = "./logs" # 日志保存目录 [bot] enabled = true active_4p = "mortal" active_3p = "mortal3p" auto_sync = true

自定义AI模型

Akagi支持自定义mjai协议的AI模型：

mjai_bot/ ├── my_custom_bot/ │ ├── bot.py # 主程序文件 │ ├── pyproject.toml # Python依赖 │ ├── manifest.toml # 配置文件 │ └── README.md # 说明文档

开发指南：mjai_bot/README.md

🔒 安全使用建议

账号安全最佳实践

✅推荐做法：

• 使用网页版而非Steam客户端
• 关闭Autoplay功能，手动操作
• 经常使用表情贴纸，模拟真人行为
• 不完全遵循AI建议，加入个人判断

⚠️需要谨慎：

• 在比赛中表现过于完美
• 长时间连续使用
• 在多个设备上同时使用

❌绝对避免：

• 24小时不间断使用自动打牌
• 完全依赖AI决策，不加思考
• 在官方比赛中使用辅助工具

隐私保护设置

[logging] level = "info" # 避免记录过多敏感信息 dir = "./logs" # 日志保存在本地 [general] language = "zh-CN" # 使用中文界面，避免语言泄露

🔧 常见问题排查指南

安装与启动问题

使用中的常见问题

Q：AI建议总是和我的想法不同，该相信谁？A：Akagi是基于大量对局数据训练的，但麻将也有运气成分。建议先理解AI的思考逻辑，再结合场况做出最终决定。

Q：为什么有时候AI反应很慢？A：复杂局面需要更多计算时间。你可以在设置中调整响应速度参数来优化体验。

Q：如何保存和复盘对局记录？A：Akagi会自动保存对局数据，在History标签页中可以查看和分析历史对局。

故障排除流程

1. 检查日志文件：查看logs/目录下的日志文件
2. 重启Akagi：关闭所有相关进程后重新启动
3. 重置配置：备份后删除config.toml重新配置
4. 寻求帮助：访问Discord社区或GitHub Issues

📊 数据分析与进阶技巧

对局历史分析

Akagi自动记录每一局完整对局，你可以在History标签页中：

1. 查看名次分布：了解自己的排名分布情况
2. 分析累计PT：使用不同的计分规则分析进步趋势
3. 详细统计：查看各项技术指标的变化

技术指标说明

自定义训练计划

30天能力提升路径：

第1-7天：基础适应

• 目标：熟悉界面和基础功能
• 任务：每天2局实战，记录AI建议差异

第8-14天：功能探索

• 目标：掌握高级功能
• 任务：使用复盘工具，调整配置参数

第15-21天：战术实践

• 目标：将AI建议转化为能力
• 任务：先自己决策，再对比AI建议

第22-30天：独立应用

• 目标：形成个人战术体系
• 任务：减少AI依赖，总结个人风格

🌐 社区与资源

获取帮助的途径

1. Discord社区：实时交流，获取最新AI模型
2. GitHub Issues：报告bug，请求新功能
3. 项目文档：详细的使用说明和开发指南

贡献项目的方式

• 提交Pull Request改进代码
• 分享你的AI模型配置
• 报告使用中发现的bug
• 提供功能改进建议

相关资源链接

• 官方文档：README.md
• AI功能源码：mjai_bot/
• 核心分析模块：src/analysis/
• 游戏状态跟踪：src/game_state/

🎉 总结：智能辅助与麻将智慧的完美结合

Akagi不仅仅是一个工具，更是一位24小时在线的麻将教练。它通过实时分析、智能建议和数据记录，帮助你系统性提升麻将水平。但记住最重要的原则：技术是辅助，理解才是核心。

核心价值总结

1. 实时分析：每巡提供专业级决策建议
2. 数据驱动：完整记录对局历史，量化进步
3. 易于使用：开箱即用，无需复杂配置
4. 高度可定制：支持自定义AI模型和配置
5. 安全可靠：开源透明，尊重用户隐私

未来发展方向

Akagi团队正在不断改进产品，未来计划：

• 支持更多麻将平台
• 提供更丰富的AI模型选择
• 增强数据分析功能
• 优化用户体验

开始你的Akagi之旅

无论你是麻将新手想要快速入门，还是资深玩家希望突破瓶颈，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