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

作为一款开源的多平台麻雀AI辅助工具，Akagi通过实时分析牌局数据、提供精准决策建议，帮助玩家在雀魂、天鳳、麻雀一番街等主流平台提升竞技水平。本文将全面解析Akagi的核心功能、安装配置、高级特性以及技术架构，为您提供从入门到精通的完整路径。

核心理念：数据驱动的麻雀决策革命

传统麻雀游戏依赖经验和直觉，而Akagi带来了数据驱动的科学决策方法。项目名称源自经典动漫《斗牌传说》中的主角赤木茂，象征着对麻雀游戏的深度理解和战略思维。Akagi的核心价值在于将复杂的概率计算、牌效分析和风险评估转化为直观的可视化建议，让普通玩家也能获得职业级的决策支持。

三大核心技术支柱

1. 实时分析引擎：基于Rust重写的分析模块每秒可处理超过200种牌局变化，计算向听数、有效牌、和牌概率等关键指标

2. 多平台兼容性：支持雀魂、天鳳、麻雀一番街、天月麻雀等主流平台，无论是四人麻将还是三人麻雀都能完美适配

3. 模块化AI系统：采用mjai协议标准，支持任意兼容该协议的AI模型，内置Mortal AI作为示例模型

快速上手：十分钟完成部署与配置

环境准备与安装

Akagi采用单文件便携式设计，无需复杂的安装过程。根据您的操作系统选择对应的版本：

安装步骤：

1. 从官方仓库下载对应平台的压缩包
2. 解压到任意具有写入权限的目录（如~/Apps/或桌面）
3. 直接运行可执行文件，配置文件和日志将保存在同一目录下

首次启动配置向导

首次启动Akagi时，系统会引导您完成五个关键配置步骤：

1. 语言选择：支持英语、日语、简体中文、繁体中文四种界面语言
2. 游戏平台选择：根据您常玩的平台选择雀魂、天鳳或麻雀一番街
3. 捕获模式配置：选择MITM代理模式或Chromium浏览器模式
4. 证书信任（仅MITM模式需要）：安装自签名CA证书
5. AI模型安装：一键安装内置的Mortal AI模型

两种捕获模式对比

Akagi提供两种数据捕获方式，适应不同用户需求：

推荐新手使用Chromium模式，只需在设置中选择"Chromium"并点击"检测"按钮，Akagi会自动启动浏览器并创建独立配置文件，无需任何代理或证书配置。

核心功能深度解析

实时HUD显示系统

Akagi的界面设计遵循"信息密度适中，关键数据突出"的原则，主要显示区域包括：

• 手牌分析区：显示当前手牌的向听数、有效牌、改良方向
• 推荐出牌区：基于AI分析给出最佳出牌建议，附带期望值评分
• 风险评估图：可视化展示每张牌对各个对手的放铳风险
• 对手信息面板：显示其他玩家的立直状态、副露情况、打牌习惯
• 牌局事件流：实时记录吃、碰、杠、立直等重要事件

AI模型集成机制

Akagi采用独特的进程隔离架构，确保AI模型与主程序之间的安全边界：

Akagi主进程 (Rust) ↓ JSONL标准协议 mjai AI子进程 (Python) ↓ 模型推理 决策输出 → HUD显示

这种设计带来三大优势：

1. 许可证兼容性：AGPL协议的AI模型（如Mortal）不会影响主程序的Apache 2.0许可证
2. 稳定性隔离：AI进程崩溃不会导致主程序异常
3. 热插拔支持：可随时更换或更新AI模型而无需重启主程序

双模式AI路由系统

Akagi智能识别牌局类型，自动切换对应的AI模型：

• 四人麻将模式：使用bot.active_4p配置的模型
• 三人麻雀模式：使用bot.active_3p配置的模型
• 分析模式：如未配置对应模型，仅显示分析数据而不提供AI建议

历史记录与统计分析

每次完整对局都会被自动记录，存储在<配置目录>/history/路径下。历史系统提供：

1. 排名分布饼图：直观展示1st/2nd/3rd/4th的分布比例
2. 累计PT曲线图：支持多种计分规则切换：
   • 雀魂段位系统（铜/银/金/玉/王座）
   • 天鳳段位系统（新人→天鳳位）
   • 自定义规则（可编辑uma和段位奖励）
3. 详细统计数据：
   • 和牌率、放铳率、立直率
   • 副露率、流局率
   • 平均和牌点数、平均放铳点数
   • 平均和牌巡目
   • 役满、流局满贯次数

高级功能与定制化

自定义AI模型集成

除了内置的Mortal AI，Akagi支持集成任何符合mjai协议的AI模型。集成步骤：

1. 准备模型文件：将AI模型放置在mjai_bot/<模型名称>/目录下
2. 配置manifest文件：创建manifest.toml定义模型参数
3. 安装依赖环境：通过界面点击"安装环境"按钮自动配置Python环境
4. 激活模型：在设置中选择对应模型并启用

配置系统详解

Akagi的配置采用TOML格式，存储在config.toml文件中。主要配置区块：

[general] language = "zh-CN" # 界面语言 [platform] kind = "Majsoul" # 游戏平台 [capture] mode = "chromium" # 捕获模式 [capture.chromium] executable = "" # 自动检测浏览器 user_data_dir = "" # 独立浏览器配置文件 [bot] enabled = true active_4p = "mortal" # 四人麻将AI active_3p = "mortal3p" # 三人麻雀AI

调试与诊断工具

Akagi内置完整的调试系统，帮助用户排查问题：

1. 诊断日志：按模块和级别过滤的应用日志，支持实时追踪
2. 协议检查器：原始WebSocket帧、mjai事件、AI响应的三层查看
3. 会话保存：完整对局数据可导出用于问题报告

故障排查黄金法则：遇到问题时，首先保存当前会话文件夹（包含所有日志和原始数据），然后前往Discord社区或GitHub Issues寻求帮助。

技术架构与开发指南

现代化技术栈

Akagi v3采用前沿技术栈构建，确保性能与可维护性：

模块化架构设计

项目采用清晰的分层架构，各模块职责明确：

src/ ├── analysis/ # 麻雀分析引擎（向听数、有效牌、风险评估） ├── bot/ # AI模型管理器与运行时 ├── bridge/ # 平台协议适配器（雀魂、天鳳等） ├── capture/ # 数据捕获层（MITM/CDP） ├── game_state/ # 游戏状态跟踪与转换 ├── history/ # 对局历史记录系统 ├── inspector/ # 调试与协议检查 └── ipc/ # 前后端通信接口

开发者扩展指南

如需为Akagi添加新功能，可参考以下扩展点：

1. 添加新游戏平台：在src/bridge/目录下创建新的协议解析器
2. 扩展分析功能：修改src/analysis/中的分析算法
3. 自定义界面组件：在frontend/src/tiles/中添加新的仪表板组件
4. 集成新AI模型：遵循mjai协议规范实现bot.py

构建与打包流程

从源代码构建Akagi需要以下环境：

# 1. 安装依赖 # Linux: libwebkit2gtk-4.1-dev, libgtk-3-dev等 # macOS: Xcode Command Line Tools # Windows: WebView2运行时 # 2. 克隆代码 git clone https://gitcode.com/gh_mirrors/ak/Akagi cd Akagi # 3. 获取运行时组件 bash scripts/fetch-runtime.sh # 4. 构建应用 cargo tauri build --no-bundle # 5. 打包发布 bash scripts/package-zip.sh <目标平台>

最佳实践与性能优化

硬件配置建议

根据使用场景推荐不同的硬件配置：

网络延迟优化

Akagi对网络延迟敏感，建议：

1. 使用有线网络：避免Wi-Fi不稳定性
2. 关闭不必要的代理：减少中间节点
3. 优化DNS设置：使用可靠的DNS服务器
4. 定期清理浏览器缓存：Chromium模式下建议

内存使用优化

长时间运行Akagi时，可采取以下优化措施：

1. 定期清理历史记录：删除不需要的对局数据
2. 限制日志保留时间：在配置中设置日志自动清理
3. 关闭不必要的功能：如不需要可关闭Inspector功能
4. 使用轻量级AI模型：对性能要求不高的场景

社区生态与未来发展

活跃的开发者社区

Akagi拥有活跃的国际化社区，主要通过以下渠道交流：

• Discord服务器：实时技术支持与功能讨论
• GitHub Issues：问题报告与功能请求
• 深度维基：详细的文档与教程

路线图与未来特性

当前开发重点包括：

1. Amatsuki平台支持：扩展平台兼容性
2. 自定义主题系统：提供界面个性化选项
3. 前端体验优化：改进牌面布局与动画效果
4. 天鳳自动对局：目前仅支持观察模式

贡献指南

欢迎开发者参与Akagi的改进：

1. 代码贡献：遵循项目代码规范，提交Pull Request
2. 文档改进：完善使用文档与开发指南
3. 翻译贡献：帮助完善多语言支持
4. 问题反馈：提交详细的Bug报告

安全与合规说明

使用注意事项

Akagi设计初衷为教育目的，帮助玩家理解麻雀决策逻辑。使用时请注意：

1. 遵守平台规则：各游戏平台对辅助工具政策不同
2. 尊重其他玩家：避免在正式比赛中使用
3. 个人学习为主：将AI建议作为学习参考而非绝对指令

数据隐私保护

Akagi的所有数据处理都在本地完成：

• 无数据上传：所有分析在用户设备上执行
• 本地存储：配置、历史记录存储在本地
• 进程隔离：AI模型运行在独立进程中

许可证兼容性

项目采用清晰的许可证策略：

• 主程序：Apache License 2.0
• AI模型：独立许可证（如Mortal使用AGPL）
• 第三方库：均在NOTICE文件中明确标注

结语：AI时代的麻雀学习伙伴

Akagi代表了麻雀辅助工具的技术前沿，将复杂的概率计算和战略分析转化为直观的决策支持。无论您是刚入门的新手，还是希望突破瓶颈的进阶玩家，Akagi都能提供个性化的学习路径。

记住，工具的价值在于辅助思考而非替代思考。合理使用Akagi，结合自身对牌局的理解，才能真正提升麻雀水平，享受策略游戏的深度乐趣。通过数据驱动的分析方法和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