如何快速部署雀魂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

想在雀魂对局中获得专业AI的实时指导，快速提升你的麻将水平吗？Akagi就是这样一个专为雀魂、天鳳、麻雀一番街和天月麻將设计的实时AI助手。它能使用自定义AI模型分析你的对局，给出精准的操作建议，让你在麻将桌上如虎添翼。

🎯 项目概览：你的AI麻将导师

想象一下，你在打麻将时有个职业选手在你耳边轻声说："现在打这张牌最安全"或者"这个听牌概率最高"。Akagi就是这样的存在，它通过实时分析你的牌局，提供听牌数、待牌、和牌率、听牌率、对手放铳风险和推荐切牌等关键信息。

这个项目采用Rust + Tauri技术栈重写，是一个单文件可执行程序，无需复杂的Python环境或额外安装。内置的AI模型已经打包在程序中，开箱即用！

小贴士：Akagi主要用于教育目的，帮助你理解麻将策略和提升技巧。合理使用，享受游戏乐趣才是最重要的。

🚀 快速入门指南：5分钟部署Akagi

第一步：下载对应版本

访问项目的Release页面，根据你的操作系统下载对应的压缩包：

第二步：解压运行

将下载的压缩包解压到任意有写入权限的目录，比如桌面或~/Apps/文件夹。双击运行里面的akagi程序即可。

第三步：首次设置向导

首次启动时，Akagi会引导你完成设置流程：

1. 选择界面语言（支持中文、日文、英文）
2. 选择游戏平台（雀魂、天鳳等）
3. 选择捕获模式
4. 配置AI机器人设置

整个过程只需几分钟，不需要安装任何额外的AI模型！

🎮 核心功能深度解析

实时HUD显示

Akagi的可拖拽界面会实时显示关键信息：

• 听牌数：距离和牌还差几张牌
• 待牌：可以组成听牌的牌
• 和牌率：当前手牌的和牌概率
• 听牌率：当前手牌的听牌概率
• 对手放铳风险：每个对手放铳的概率
• 推荐切牌：进攻或防守的最佳选择

两种捕获模式任你选

模式一：Chromium模式（推荐新手）

这是最简单的使用方式！Akagi会自动检测你电脑上的Chrome、Edge或Brave浏览器，并启动一个独立的浏览器窗口。你只需要在这个窗口中登录雀魂并开始游戏即可。

优点：

• 无需安装证书
• 无需配置系统代理
• 零设置成本

模式二：MITM代理模式（高级用户）

如果你想要系统级的代理支持，可以选择这个模式。Akagi会在程序目录下生成自签名CA证书，你需要信任这个证书，并将游戏客户端流量指向127.0.0.1:23410。

重要提醒：如果使用代理模式，请务必将本地回环地址（localhost, 127.0.0.1）排除在代理规则之外，否则可能导致游戏异常。

AI助手的智能大脑

内置AI机器人

Akagi自带一个纯Rust编写的神经网络AI模型，已经嵌入到程序中。这意味着：

• 无需下载额外文件
• 无需Python环境
• 4人麻将和3人麻将都支持
• 自动根据牌桌人数切换AI模式

这个内置模型的强度适中，适合大多数玩家使用。它基于行为克隆训练，能提供合理的建议，但不是顶尖的竞技引擎。

云端推理（可选升级）

如果你想要更强的AI分析能力，Akagi支持连接到远程推理服务器。内置模型会作为自动备胎——当云端服务不可用时，本地模型会立即接管，确保你的游戏不会中断。

获取云端推理密钥：

1. 在应用内购买或兑换密钥
2. 配置到设置中
3. 享受更强大的AI分析

⚙️ 高级配置与个性化设置

配置文件详解

Akagi的配置文件位于程序目录下，你可以根据需要进行调整：

# 机器人配置示例 [bot] active_4p = "akagi-native" # 4人麻将使用的AI active_3p = "akagi-native3p" # 3人麻将使用的AI cloud_inference = false # 是否启用云端推理

游戏历史记录

每一局完成的比赛都会被自动记录。在历史标签页中，你可以看到：

• 段位饼图统计：直观展示你的名次分布
• 累计PT折线图：支持多种计分规则（雀魂段位/天凤段位/自定义uma）
• 详细统计数据：胜率、放铳率、立直率、副露率、流局率等

三人麻将完整支持

Akagi对三人麻将提供了完整的支持：

• AI分析
• 按模式自动路由
• 历史统计数据
• 3人麻将的计分表

🎯 实战应用与技巧分享

实战功能深度体验

Akagi不仅仅是一个简单的分析工具，它提供了完整的麻将学习生态系统：

智能分析引擎：基于专业的麻将算法，提供准确的局势分析实时决策支持：每巡都给出最佳打牌建议风险预警系统：提前识别放铳风险，避免不必要的失分学习模式：通过历史对局分析，找出你的打法弱点

日志与诊断系统

Akagi提供详细的日志系统，帮助你排查问题：

<log_dir>/<session>/ ├── all.log # 所有追踪输出汇总 ├── <target>.log # 按模块过滤的日志 ├── proxy.binlog # 原始WebSocket二进制帧 └── inspector.jsonl # Inspector看到的帧

诊断标签页：可过滤的应用日志，按级别和模块分类检查器标签页：协议级的帧查看器，便于调试

🔒 安全使用与最佳实践

安全第一原则

1. 优先使用网页版：相比客户端版本风险更低
2. 合理控制使用频率：避免长时间连续使用
3. 保持自然游戏行为：适当使用游戏内表情和互动
4. 不要完全依赖AI：结合自己的判断进行游戏
5. 避免24小时挂机：保持正常的游戏时间

故障排除指南

常见问题解决方案

MITM模式抓不到包

# 确认代理是否正常运行 curl http://127.0.0.1:23410/ping # 应该返回 "pong"

游戏卡在加载画面检查代理设置，确保本地回环地址被正确排除

Chromium模式无法启动手动设置浏览器路径：capture.chromium.executable

Bot崩溃查看Inspector标签页中的最后一帧信息

🚀 总结与下一步行动

Akagi为你提供了一个完整的麻将AI分析解决方案，从实时HUD显示到历史数据分析，从内置AI到云端推理，从基础使用到高级配置，每一个功能都经过精心设计。

立即开始你的AI麻将之旅！

1. 下载最新版本：从项目页面获取对应操作系统的版本
2. 完成设置向导：按照提示完成语言、平台、捕获模式配置
3. 开始第一局游戏：体验AI辅助麻将的魅力
4. 加入社区交流：在Discord社区分享你的使用体验

记住，麻将是一门艺术，AI只是工具。真正的乐趣在于思考、决策和与人互动的过程。合理使用Akagi，享受游戏的本质乐趣，同时提升你的麻将水平！

最后提醒：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