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助手。这款开源工具支持雀魂、天鳳等主流在线麻将平台，能够使用自定义的AI模型实时分析对局并提供专业建议，让你在每一局麻将中都有"智囊团"相伴。
🎯 为什么你需要这个麻将AI助手？
麻将不仅是运气游戏，更是策略与计算的博弈。Akagi就像一位24小时在线的专业教练，为你提供三大核心价值：
实时决策支持：在对手出牌后毫秒级响应，立即显示听牌数、有效进张、和了率、放铳风险等关键数据，让你在关键时刻做出最佳选择。
智能学习平台：通过内置的Mortal AI示例模型，你可以学习AI的思考方式，理解每一手牌背后的策略逻辑，逐步提升自己的麻将水平。
跨平台兼容：无论你玩的是雀魂（Mahjong Soul）、天鳳（Tenhou）、麻雀一番街（Riichi City）还是天月麻将（Amatsuki），Akagi都能完美适配，让你在不同平台享受一致的AI辅助体验。
🚀 5分钟快速上手：零基础安装指南
第一步：下载与解压
Akagi采用便携式设计，无需复杂的安装过程。根据你的操作系统选择合适的版本：
- Windows用户：下载
akagi-<版本号>-windows-x64.zip - macOS用户：下载
akagi-<版本号>-macos-arm64.zip - Linux用户：下载
akagi-<版本号>-linux-x64.zip
将压缩包解压到任意可写目录（如桌面或~/Apps/文件夹），整个应用就准备就绪了。
第二步：首次运行配置向导
双击运行解压后的可执行文件，首次启动时会自动弹出设置向导，只需按照提示完成几个简单步骤：
- 选择语言：支持简体中文、繁体中文、日语和英语
- 选择游戏平台：根据你常玩的麻将平台选择
- 选择捕获模式：推荐新手使用"Chromium模式"
- 安装AI模型：一键安装Mortal AI作为你的初始"智囊团"
第三步：开始你的第一局分析
配置完成后，Akagi会自动启动浏览器（Chromium模式）或设置系统代理（MITM模式），登录你的麻将账号开始游戏。对局开始后，你会看到一个可拖拽的HUD界面实时显示分析结果。
💡 场景化应用指南：不同玩家的最佳配置
新手玩家：学习模式配置
如果你是麻将新手，建议使用以下配置快速入门：
[bot] active_4p = "mortal_balanced" # 平衡型AI，攻守兼备 [analysis] focus_mode = "learning" # 学习模式，显示详细解释 hint_level = "beginner" # 新手级提示 [ui] dashboard_layout = "detailed" # 详细布局，显示所有信息实用技巧：开始时重点关注"有效进张"和"听牌数"这两个指标，它们是判断手牌好坏的基础。
进阶玩家：竞技模式配置
对于有一定经验的玩家，可以切换到竞技模式：
[bot] active_4p = "mortal_aggressive" # 进攻型AI，适合优势局面 [analysis] focus_mode = "competitive" # 竞技模式，仅显示关键信息 hint_level = "expert" # 专家级提示 [ui] dashboard_layout = "compact" # 紧凑布局，减少干扰 auto_hide = true # 空闲时自动隐藏实战建议：在比赛关键时刻，可以临时切换到"防守模式"的AI配置，降低放铳风险。
观战学习：分析模式配置
即使不亲自对局，你也可以用Akagi分析他人的牌谱：
[capture] mode = "mitm" # 使用MITM模式观看他人对局 [analysis] show_details = true # 显示所有分析细节 record_history = true # 记录历史对局 [bot] enabled = false # 关闭AI建议，专注学习🔧 进阶定制与扩展：打造个性化AI助手
自定义AI模型开发
Akagi支持自定义AI模型，你可以基于标准的mjai协议创建自己的"智囊团"。创建一个简单的规则型AI只需要几个文件：
mjai_bot/my_custom_bot/ ├── bot.py # 主逻辑文件 ├── pyproject.toml # Python依赖声明 └── manifest.toml # 配置元数据bot.py基础模板：
import sys import json def main(): while True: line = sys.stdin.readline() if not line: break events = json.loads(line.strip()) # 你的AI逻辑在这里 # 分析当前局面，返回推荐动作 response = {"type": "dahai", "pai": "1m"} print(json.dumps(response), flush=True) if __name__ == "__main__": main()个性化界面定制
Akagi的界面完全可定制，你可以：
- 调整布局：拖拽各个信息卡片到合适位置
- 隐藏不需要的信息：点击卡片右上角的"×"按钮隐藏不常用的信息
- 恢复默认布局：随时通过"重置布局"功能回到初始状态
- 多语言切换：在侧边栏随时切换界面语言
性能优化技巧
如果你的电脑配置有限，可以通过以下设置提升性能：
[logging] level = "warn" # 减少日志输出，降低IO压力 all_level = "error" [analysis] cache_size = 500 # 减小缓存大小，节省内存 batch_size = 5 # 减小批处理大小，降低延迟📊 效果评估与持续提升
如何评估你的进步
Akagi内置了完整的历史记录和统计功能，帮助你客观评估自己的进步：
关键指标追踪：
- 胜率变化：观察不同时期的胜率趋势
- 放铳率分析：找出防守薄弱环节
- 立直成功率：评估进攻时机的把握
- 平均得点：衡量得分效率
历史对局回顾： 每局完整的对局都会被自动记录在<配置目录>/history/文件夹中，你可以随时回放分析，找出关键决策点。
常见问题快速解决
问题1：捕获模式无法正常工作
- Chromium模式：检查浏览器是否被正确检测，或手动设置
capture.chromium.executable路径 - MITM模式：确认CA证书
./ca/akagi-ca.crt已添加到系统信任存储
问题2：AI模型加载缓慢
- 首次运行需要同步依赖，耐心等待几分钟
- 如卡住，删除
mjai_bot/<模型名>/.akagi/synced.stamp后重试
问题3：界面显示异常
- 检查显卡驱动是否最新
- 尝试重启应用或清除浏览器缓存
持续学习路径建议
- 第一阶段（1-2周）：熟悉基本功能，重点关注听牌分析和有效进张
- 第二阶段（3-4周）：学习AI的攻守平衡策略，理解不同局面下的最优选择
- 第三阶段（1-2个月）：分析历史对局，找出自己的决策模式和改进空间
- 长期提升：尝试开发或调整自定义AI模型，深入理解麻将算法
Akagi不仅是一个工具，更是一个学习平台。通过它，你可以在实战中快速提升麻将水平，从新手成长为高手。无论是休闲娱乐还是竞技比赛，这个开源AI助手都能成为你最可靠的"智囊团"。
立即开始你的麻将提升之旅：从GitCode克隆项目仓库https://gitcode.com/gh_mirrors/ak/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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考