终极AI麻将助手完整指南：5步开启智能分析之旅

🚀 快速上手篇

环境准备与一键部署

系统要求检查

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

• Windows 10/11 或 macOS 10.15+
• 至少 8GB 内存
• 稳定的网络连接

一键安装流程

Windows系统：

1. 下载安装脚本 install_akagi.ps1
2. 以管理员身份运行PowerShell
3. 执行权限设置：Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
4. 运行安装脚本：.\install_akagi.ps1
5. 首次使用mitmproxy时，请先打开后关闭以生成必要文件

macOS系统：

1. 获取安装脚本 install_akagi.command
2. 在终端中执行：bash install_akagi.command
3. 安装完成后进入Akagi文件夹
4. 双击启动脚本运行程序

核心组件配置

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

• 将 mortal.pth 文件放置到 mjai/bot 目录
• 验证模型文件完整性

核心配置速览

主要功能开关

在 settings.json 文件中，您可以配置以下关键参数：

配置项	功能说明	推荐设置
Unlocker	启用游戏解锁功能	false
Autoplay	自动打牌模式	false
Helper	麻将助手集成	false
Autohu	自动和牌功能	false
Port.MITM	中间人代理端口	7878
Port.XMLRPC	XMLRPC通信端口	7879
Port.MJAI	AI机器人端口	28680

网络代理设置

为了确保程序正常运行，需要进行网络代理配置：

• 将雀魂游戏连接重定向到指定MITM端口
• 安装必要的SSL证书
• 验证代理连接状态

首次运行验证

启动流程检查

1. 运行启动脚本 run_akagi.command 或 run_akagi.bat
2. 观察程序初始化日志
3. 确认AI模型加载成功

功能测试步骤

完成启动后，按照以下顺序验证核心功能：

• 连接状态检测
• 数据流监控
• AI响应验证

🎯 实战应用篇

典型使用场景解析

实时对局分析

当您参与麻将对局时，Akagi会自动捕获游戏数据流并进行分析：

1. 数据捕获阶段：通过MITM技术实时获取游戏通信数据
2. 格式转换处理：将原始协议转换为标准mjai格式
3. AI智能分析：基于Mortal模型提供打牌建议
4. 可视化展示：在界面中清晰呈现分析结果

学习模式应用

利用AI分析提升个人技能：

• 观察AI的出牌策略
• 分析和牌时机判断
• 学习防守技巧
• 理解牌局形势评估

进阶功能探索

自定义AI行为

通过修改 mjai/bot/bot.py 可以调整：

• 出牌思考时间
• 风险评估参数
• 策略偏好设置

多模型集成

项目支持集成多种AI模型：

• 基础的Mortal模型
• 其他兼容的mjai格式模型
• 自定义训练模型

性能优化技巧

响应速度提升

• 调整AI模型的思考深度
• 优化网络连接配置
• 合理设置缓存策略

🛡️ 安全合规篇

风险规避策略

账号安全防护

为了最大限度降低账号风险，建议遵循以下原则：

1. 客户端选择：优先使用网页版而非Steam客户端
2. 操作模式：以手动操作为主，避免完全依赖自动功能
3. 行为模拟：适当使用游戏内表情和互动功能
4. 使用频率：避免24小时不间断使用

检测规避方法

• 混合使用AI建议与个人判断
• 设置合理的操作间隔时间
• 保持正常的游戏行为模式

最佳实践建议

日常使用规范

1. 适度使用原则：将Akagi作为学习工具而非取胜手段
2. 功能选择策略：根据实际需求选择性启用功能
3. 更新维护计划：定期检查程序更新和安全提示

生态工具整合

相关项目协同

Akagi可以与以下生态工具配合使用：

麻将分析工具：

• mahjong-helper.exe - 提供专业的牌局分析
• 协议处理模块 liqi.py - 处理游戏通信协议
• API接口组件 mahjong_soul_api - 提供数据接口服务

扩展功能开发

基于现有的代码架构，您可以：

• 开发新的AI模型接口
• 创建自定义分析插件
• 集成其他麻将游戏平台

通过遵循本指南，您将能够充分发挥Akagi在麻将学习和分析方面的价值，同时确保使用过程的安全性和合规性。记住，技术的正确使用才是提升技能的关键。