Akagi：打造智能化麻将辅助体验的开源解决方案

一、价值主张：直击麻将辅助三大核心痛点

1.1 决策困境破解

传统麻将辅助工具普遍存在决策延迟问题，Akagi通过优化的模型推理（AI对牌局数据的实时计算过程）机制，将响应时间压缩至200毫秒以内，确保玩家在复杂牌局中能获得即时策略支持。

1.2 跨平台适配难题

针对不同操作系统环境配置复杂的痛点，Akagi提供全平台统一的自动化安装流程，无论是Windows、macOS还是Linux系统，都能通过标准化脚本完成环境部署。

1.3 个性化需求满足

打破传统辅助工具"一刀切"的策略模式，Akagi设计了灵活的配置系统，允许用户根据自身风格调整AI决策参数，实现真正个性化的辅助体验。

二、场景化部署：三步闭环安装流程

2.1 环境准备

目标：获取项目源码并确认基础环境 方法：

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

验证标准：执行后应看到包含mjai/、mahjong_soul_api/等核心目录的项目结构

2.2 系统安装

Windows平台：

scripts\install_akagi.ps1

⚠️ 注意：请使用管理员权限运行PowerShell，出现权限提示时选择"是"

macOS平台：

bash scripts/install_akagi.command

验证标准：安装脚本执行完成后显示"环境配置成功"提示

2.3 核心资源配置

目标：完成AI模型部署 方法：

1. 将下载的模型文件放置于mjai/bot/目录
2. 重命名为"mortal.pth"
3. 执行权限检查命令：

ls -l mjai/bot/mortal.pth

验证标准：命令输出显示文件存在且具有读权限

三、核心功能图谱：五大能力模块解析

3.1 牌局智能分析系统

核心价值：实时解析牌局数据，提供科学决策支持 应用场景：在复杂牌局中快速评估最佳出牌策略，提升胡牌概率 配置入口：通过修改config.json中的"analysis_strategy"参数调整分析模式

3.2 游戏数据采集引擎

核心价值：全面记录游戏过程，为策略优化提供数据基础 应用场景：赛后复盘分析、个人技术统计、对手行为模式研究 配置入口：编辑mahjong_soul_api/ms/rpc.py中的数据回调函数

3.3 个性化配置中心

核心价值：自定义辅助功能，打造专属使用体验 应用场景：根据个人游戏风格调整AI风险偏好、界面显示方式 配置入口：主配置文件config.json与设置文件settings.json

3.4 多模式交互界面

核心价值：适应不同使用场景，提供多样化信息展示 应用场景：比赛时使用极简模式保持专注，学习时切换教学模式获取详细解释 配置入口：通过gui.py中的界面控制函数切换显示模式

3.5 协议动态适配模块

核心价值：自动适应游戏版本更新，保障工具持续可用 应用场景：游戏客户端更新后无需手动调整即可继续使用 配置入口：协议定义文件liqi_proto/liqi.proto

四、实战安全策略：高效使用指南

4.1 账号安全保护

启用settings.json中的"anti_detection"功能，设置300-800ms的随机操作延迟，降低账号风险。

4.2 效率提升技巧

💡 技巧一：通过修改mhm/config.py中的"log_level"参数开启精简日志模式，提升运行效率 💡 技巧二：在config.json中将"analysis_frequency"设置为200ms，平衡响应速度与资源占用 💡 技巧三：使用命令行参数快速启动特定模式：

python main.py --mode professional

4.3 合规使用原则

• 仅供个人学习研究使用，不得用于商业用途
• 遵守游戏平台用户协议，合理使用辅助功能
• 定期通过git pull更新项目，获取安全补丁

五、问题诊疗库：常见故障解决方案

5.1 证书错误

现象：启动时提示"SSL certificate verify failed" 解决方案：

python -m certifi

验证：重新启动程序后不再出现证书相关错误

5.2 AI无响应

现象：游戏中未显示决策建议 排查步骤：

1. 检查模型文件是否存在：ls mjai/bot/mortal.pth
2. 验证依赖是否完整：pip install -r requirement.txt
3. 查看启动日志确认模型加载状态

5.3 网络连接问题

现象：提示"无法连接到游戏服务器" 解决方案：检查config.json中的网络设置，执行网络测试命令：

curl -I https://majsoul.union-game.com

验证：命令返回200 OK状态码表示网络通畅

通过本指南，您已掌握Akagi的核心部署与使用方法。合理利用这款工具，不仅能提升游戏体验，更能加深对麻将策略的理解。建议定期关注项目更新，获取更多高级功能与安全优化。