Akagi雀魂智能助手：从零基础到实战精通的全流程技术指南

一、核心价值：重新定义麻将AI辅助体验

雀魂游戏辅助工具的进化之作，Akagi以三大核心优势重塑玩家体验：毫秒级AI决策响应（传统工具平均延迟的1/5）、全平台轻量化架构（占用内存不足同类产品60%）、高度可定制策略系统（支持12种策略模板与自定义规则）。相较于市面上功能单一的辅助工具，Akagi实现了从数据采集、实时分析到策略推荐的全流程闭环，既满足新手的基础辅助需求，也为进阶玩家提供专业级战术分析支持。

二、极速部署：三步完成全平台环境搭建

2.1 环境准备与代码获取

🔧 克隆项目仓库

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

执行成功后将看到包含mjai/、mahjong_soul_api/等核心目录的项目结构，建议通过ls -la命令验证目录完整性，确保关键文件夹无缺失。

2.2 跨平台安装流程

🔧 执行自动化安装脚本

• Windows系统：在管理员PowerShell中运行

  scripts\install_akagi.ps1
  

• macOS系统：在终端中执行

  bash scripts/install_akagi.command
  

⚠️ 安装过程中出现权限提示时需选择"允许"，网络不稳定可能导致依赖包下载失败，建议使用稳定网络环境。安装成功会显示"环境配置完成"的绿色提示文字。

2.3 核心资源配置

🔧 AI模型部署

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

   ls -l mjai/bot/mortal.pth
   

💡 新手提示：官方渠道获取的模型文件通常已包含必要的权重数据，第三方模型可能存在兼容性问题，建议初次使用选择官方推荐模型。

三、功能解析：五大模块构筑智能辅助体系

3.1 实时决策引擎

核心概括：基于深度强化学习的牌局分析系统，提供动态策略建议。

采用蒙特卡洛树搜索（MCTS）算法结合深度学习模型，实时分析当前手牌组合、剩余牌池与对手行为数据。在[config.json]中通过"risk_level"参数（取值1-5，推荐新手设为3）调节策略保守程度，数值越高越倾向于进攻型打法。

适用场景：竞技对局中的关键决策点，如听牌选择、防守判断等复杂场景。

3.2 数据采集与分析系统

核心概括：全量记录牌局数据，支持自定义分析维度。

通过协议解析技术捕获每局的打牌顺序、杠碰吃操作与分数变化，数据以JSON格式实时存储。开发人员可修改[mahjong_soul_api/ms/rpc.py]中的回调函数，自定义数据采集粒度（如增加玩家行为特征标记）。

适用场景：牌局复盘分析、个人技术统计、对手行为模式研究。

3.3 个性化配置中心

核心概括：通过配置文件实现功能定制，满足不同用户需求。

编辑项目根目录的[config.json]文件可调整：

• 雀魂账号绑定参数（"account"字段）
• AI分析频率（"analysis_interval"，建议设为200-500ms）
• 界面显示风格（"ui_theme"支持"minimal"、"professional"、"teaching"三种模式）

适用场景：根据硬件性能调整参数、适配个人使用习惯、满足不同场景下的界面需求。

3.4 多模式交互界面

核心概括：三种操作模式适配不同使用场景，平衡辅助强度与游戏体验。

• 极简模式：仅显示核心决策建议，适合追求流畅游戏体验的玩家
• 专业模式：展示完整概率分析图表，包含胡牌概率、危险牌评估等数据
• 教学模式：附带策略解释与牌理说明，帮助新手理解AI决策逻辑

适用场景：快速对局（极简模式）、技术提升（教学模式）、比赛分析（专业模式）。

3.5 协议适配与更新模块

核心概括：自动适配游戏版本更新，确保功能持续可用。

通过[liqi_proto/liqi.proto]定义的接口规范，实现对雀魂游戏协议的动态适配。当游戏版本更新时，系统会自动检测协议变化并加载兼容模块，无需用户手动升级。

适用场景：游戏版本更新后快速恢复功能、跨版本兼容性保障。

四、实战应用：从入门到精通的使用指南

4.1 基础使用流程

1. 启动程序：执行根目录的run_akagi.bat（Windows）或run_akagi.command（macOS）
2. 账号配置：首次启动将引导完成雀魂账号绑定
3. 模式选择：根据需求选择适合的交互模式
4. 开始游戏：进入雀魂游戏后，辅助功能将自动激活

💡 效率技巧：通过[settings.json]中的"hotkey"配置自定义快捷键，可快速切换辅助模式（默认F1-F3对应三种模式）。

4.2 进阶使用技巧

• 策略定制：在[mhm/config.py]中修改"strategy_weights"参数，调整不同牌型的优先级权重
• 数据分析：使用python convert.py命令将存储的JSON数据转换为Excel报表，进行深度分析
• 性能优化：降低[config.json]中的"analysis_depth"参数（推荐4-8）可提升低配置设备运行速度

4.3 安全使用规范

⚠️ 账号保护措施：

• 启用[settings.json]中的"anti_detection"功能（设为true）
• 设置随机操作延迟（"action_delay"推荐300-800ms）
• 避免连续使用超过2小时，降低账号风险

五、问题解决：常见故障排查指南

5.1 启动时证书错误

现象：程序启动后提示"SSL certificate verify failed"
原因：系统证书库缺少必要证书或安装脚本未正确执行证书导入
解决方案：

# 重新安装证书
python -m certifi

执行后重启程序，若问题依旧，检查系统时间是否同步。

5.2 AI分析无响应

现象：游戏中未显示决策建议，界面无分析结果
原因：模型文件缺失或权限不足、依赖库版本不兼容
解决方案：

1. 检查模型文件：ls -l mjai/bot/mortal.pth确认文件存在且大小正常
2. 修复依赖：pip install -r requirement.txt --upgrade
3. 验证模型加载：查看程序启动日志，确认包含"model loaded successfully"信息

5.3 网络连接失败

现象：提示"无法连接到游戏服务器"
原因：网络设置错误、代理配置不当或雀魂服务器维护
解决方案：

1. 检查网络连通性：curl -I https://majsoul.union-game.com
2. 验证配置文件：检查[config.json]中的"proxy"设置，留空表示不使用代理
3. 查看服务器状态：访问雀魂官方网站确认服务器是否正常运行

通过本指南的系统部署与功能解析，您已掌握Akagi雀魂助手的核心使用方法。合理使用辅助工具不仅能提升游戏体验，更能帮助理解麻将策略的深层逻辑。建议定期更新项目代码以获取最新功能与安全补丁，享受更智能的麻将竞技体验。