Akagi麻将助手完整使用指南：从安装到实战分析

项目概述

Akagi是一款专为雀魂（Mahjong Soul）游戏设计的智能助手客户端，能够实时捕获游戏数据流，通过AI分析提供专业的麻将决策建议。该项目旨在帮助玩家深入了解对局表现，提升麻将技能。

系统环境要求

在开始安装前，请确保您的设备满足以下基本配置：

• 操作系统：Windows 10/11 或 macOS Big Sur 11.0+
• 内存容量：不低于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. 格式转换处理：将原始LiqiProto协议转换为标准mjai格式
3. AI智能分析：基于Mortal模型提供打牌建议
4. 可视化展示：在界面中清晰呈现分析结果

学习模式应用

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

• 观察AI的出牌策略和思路
• 分析和牌时机选择的判断逻辑
• 学习防守技巧和风险评估方法
• 理解牌局形势评估的决策过程

进阶功能探索

自定义AI行为

通过修改相关配置文件，可以调整以下参数：

• 出牌思考时间的设置
• 风险评估的权重配置
• 策略偏好的个性化定制

多模型集成支持

项目支持集成多种AI分析引擎：

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

安全使用指南

账号风险规避策略

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

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

检测规避方法

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

性能优化建议

响应速度提升技巧

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

生态工具整合

相关项目协同使用

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

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

扩展功能开发

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

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

最佳实践建议

日常使用规范

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

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