从零开始使用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辅助工具，能够实时分析雀魂、天鳳等主流麻将平台的游戏对局，为你提供专业的决策建议。无论你是麻将新手想要快速入门，还是资深玩家希望提升胜率，Akagi都能成为你的得力助手。

📋 核心功能概览：Akagi能为你做什么？

Akagi的核心功能可以概括为"实时分析+智能建议"，主要包含以下四个方面：

实时对局分析

• 自动解析游戏数据，分析当前局势
• 评估手牌价值，计算最优出牌选择
• 预测对手可能的牌型和打法

多平台支持

• 雀魂 (Majsoul) - 最受欢迎的在线麻将平台
• 天鳳 (Tenhou) - 日本专业麻将平台
• 麻雀一番街 (Riichi City) - 国际麻将平台
• 天月麻将 (Amatsuki) - 新兴麻将平台

智能决策辅助

• 内置Mortal AI模型作为示例
• 支持自定义AI模型扩展
• 提供弃和、立直、进攻等策略建议

安全学习模式

• 仅提供建议，不自动操作
• 保持手动打牌的真实体验
• 帮助理解AI的思考逻辑

🚀 快速部署：三步完成安装

环境准备检查清单

在开始安装前，请确保你的系统满足以下要求：

第一步：获取项目代码

打开终端或命令提示符，执行以下命令：

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

第二步：安装依赖包

根据你的操作系统选择对应的安装脚本：

Windows用户：

1. 以管理员身份打开PowerShell
2. 进入Akagi目录
3. 执行安装脚本：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass .\scripts\install_akagi.ps1

macOS用户：

1. 打开终端
2. 进入Akagi目录
3. 执行安装脚本：

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

第三步：配置AI模型

安装完成后，需要配置AI模型文件：

1. 获取mortal.pth模型文件（可从社区获取）
2. 将文件放置在正确位置：mjai/bot/mortal.pth
3. 如果需要自定义模型，可以放置在players/目录下

🎮 使用指南：从启动到实战

启动Akagi客户端

完成安装后，你可以通过以下方式启动：

Windows用户： 双击run_akagi.bat文件，或运行：

python client.py

macOS用户： 双击run_akagi.command文件，或运行：

python3 client.py

界面功能介绍

启动后你将看到Akagi的主界面，主要分为四个区域：

游戏监控区

• 显示当前捕获的游戏数据流
• 实时显示游戏状态和对手信息
• 监控网络连接状态

AI分析区

• 显示AI对当前局势的分析结果
• 提供多种可能的出牌选择
• 标注每种选择的胜率评估

手牌展示区

• 使用Unicode字符清晰展示你的手牌
• 标注听牌状态和有效牌
• 显示牌河和对手的弃牌

控制面板区

• 开关各种辅助功能
• 调整AI分析深度
• 设置操作延迟时间

实战操作流程

1. 启动游戏客户端：正常打开雀魂网页版或客户端
2. 配置网络代理：将游戏流量导向Akagi的MITM端口（默认7878）
3. 开始对局：Akagi会自动检测游戏开始
4. 接收AI建议：每回合AI会提供出牌建议
5. 自主决策：参考建议，但保持手动操作

⚙️ 个性化设置：打造专属AI助手

基础配置调整

打开settings.json文件，你可以调整以下参数：

{ "Helper": true, // 启用实时分析助手 "Autohu": false, // 禁用自动和牌（建议） "RandomTime": { "min": 1.0, // 最小操作延迟（秒） "max": 3.2 // 最大操作延迟（秒） } }

AI行为定制

如果你想要调整AI的决策风格，可以修改mjai/bot/bot.py中的参数：

# 风险偏好设置（0.0-1.0） RISK_FACTOR = 0.6 # 默认中等风险 # 思考时间控制（秒） THINKING_DELAY = 1.2 # AI思考时间

保守型玩家：将RISK_FACTOR设为0.8，减少高风险操作进攻型玩家：将RISK_FACTOR设为0.3，增加进攻性打法

功能模块扩展

Akagi采用模块化设计，你可以根据需要添加或修改功能：

• 添加新平台支持：在mahjong_soul_api/目录下创建适配模块
• 自定义分析算法：修改mhm/目录下的数据处理逻辑
• 界面美化：调整client.py中的UI组件

🛡️ 安全使用指南：保护你的账号

风险评估与应对

使用AI辅助工具需要平衡学习效果与账号安全：

最佳实践建议

安全操作习惯

1. 使用网页版客户端：相比Steam客户端更安全
2. 添加随机延迟：设置1-3秒的操作间隔，模拟人类思考
3. 不完全跟随AI：混合自己的判断和AI建议
4. 使用表情贴纸：在对局中正常使用游戏内表情功能
5. 控制游戏时长：避免24小时不间断游戏

账号保护措施

1. 启用双重认证：为游戏账号开启额外的安全保护
2. 定期更换密码：每1-2个月更新一次密码
3. 避免共享账号：不要与他人共享使用AI辅助的账号
4. 关注官方公告：留意游戏官方的反作弊政策变化

🔧 故障排除：常见问题解决

安装问题

问题：Python依赖安装失败

解决方案：手动安装依赖包 pip install -r requirement.txt

问题：端口被占用

解决方案：修改settings.json中的端口配置 "Port": { "MITM": 7879, // 改为其他可用端口 "MJAI": 28681 }

问题：模型文件缺失

解决方案：确认mortal.pth文件位置 正确路径：./mjai/bot/mortal.pth

运行问题

问题：AI无响应

1. 检查模型文件是否正确放置
2. 确认Python版本为3.8+
3. 查看日志文件中的错误信息

问题：游戏连接失败

1. 确认网络代理设置正确
2. 检查防火墙是否阻止了MITM端口
3. 尝试重启游戏客户端和Akagi

问题：界面显示异常

1. 确保使用Windows Terminal或兼容的终端
2. 检查终端字体是否支持Unicode字符
3. 尝试调整终端窗口大小

性能优化

如果遇到性能问题，可以尝试以下优化：

降低资源占用

{ "Playwright": { "enable": false, // 禁用Playwright功能 "width": 800, // 减小界面宽度 "height": 600 // 减小界面高度 } }

调整AI思考深度在mjai/bot/model.py中减少搜索深度参数，可以提升响应速度。

📚 学习进阶：从AI建议到自主提升

理解AI的思考逻辑

Akagi不仅提供出牌建议，更重要的是帮助你理解麻将的策略：

牌效分析学习

• 观察AI如何评估手牌价值
• 学习有效牌的计算方法
• 理解向听数减少的策略

防守技巧提升

• 分析AI的危险牌判断逻辑
• 学习读牌和防守时机
• 掌握安全牌的选择标准

进攻策略优化

• 理解立直时机的选择
• 学习染手和门清的平衡
• 掌握役种组合的优化

训练计划建议

第一周：基础观察

• 使用Akagi但不完全跟随
• 记录AI建议与自己选择的差异
• 分析差异背后的逻辑

第二周：模式识别

• 识别常见的牌型模式
• 学习AI的固定应对策略
• 建立自己的决策框架

第三周：实战应用

• 减少对AI的依赖
• 尝试预测AI的建议
• 验证自己的判断准确性

第四周：自主提升

• 仅在有疑问时参考AI
• 建立个人打牌风格
• 分享学习心得和经验

🌟 社区与资源

获取帮助与支持

遇到问题时，你可以通过以下方式获取帮助：

1. 查阅文档：仔细阅读项目中的README文件
2. 社区讨论：加入相关麻将爱好者的讨论群组
3. 问题反馈：在项目页面提交Issue时，提供详细的错误信息

进阶学习资源

想要深入了解麻将AI技术？以下资源可能对你有帮助：

• 麻将AI研究论文：了解最新的AI麻将算法
• 开源麻将项目：学习其他麻将AI的实现
• 麻将理论书籍：夯实麻将基础知识

贡献与分享

如果你对Akagi有改进建议或发现了bug：

1. Fork项目到自己的仓库
2. 创建新的功能分支
3. 提交Pull Request
4. 参与代码审查和讨论

🎯 总结：智能辅助，自主提升

Akagi作为一个开源的麻将AI辅助工具，为麻将爱好者提供了一个强大的学习平台。通过实时分析、智能建议和安全的辅助模式，它能够帮助你：

✅快速入门：理解麻将的基本策略和技巧 ✅提升水平：从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