Akagi 雀魂AI辅助完整教程：免费实时分析，4 步跑起来-平芜编程栈

Akagi 雀魂AI辅助完整教程：免费实时分析，4 步跑起来

【免费下载链接】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

Akagi 是一款开源的雀魂 AI 分析助手，实时给出向听数、和牌率与推荐切牌，支持雀魂、天鳳等多个平台，内置 AI 模型开箱即用。

牌局里最难受的三个时刻

东四局，点数落后，两家先后立直。你能做的只有：数河里的安全牌，估算自己的向听。没有数字，没有数据，决策全凭手感。

最难受的是没法复盘。一局打完，你只记得一句“那局打得贪了”，没有具体数据支撑。

Akagi 就是为这类时刻做的。它实时抓取对局流量，把数据和 AI 建议叠加在画面上，每局完整牌谱还会落盘，供事后复盘。

它是什么：把对局变成可量化的课

Akagi 是一款开源的实时麻将 AI 助手，Rust + Tauri 单文件程序。它用本地代理或内置浏览器捕获客户端流量，镜像牌局状态，在可拖拽的 HUD 里显示向听、听牌、和牌率、各家放铳风险与推荐切牌。覆盖雀魂（含三麻）、天鳳、麻雀一番街、天月麻將 4 个平台。

🚀 快速上手：4 步跑起来

拿到代码：

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

准备环境：装 Rust 1.80+ 与 Node.js 20+。不想编译可直接拿官方 release 的 zip，解压即跑。
启动应用：根目录执行cargo run，首次启动进设置向导，依次选语言、平台、抓包模式。
打开浏览器：Chromium 抓包模式下 Akagi 自动拉起独立浏览器，登录雀魂，开局后右侧出现数据。

⚙️ 核心能力一览

能力	对读者的价值
实时 HUD	向听、和牌率、各家放铳风险一眼看清
内置 AI 模型	嵌在可执行文件里，免装 Python 环境
双抓包模式	MITM 代理或内置浏览器，后者零配置
对局历史	完整对局自动落盘，图表化复盘
AutoPlay	Bot 直接点击牌桌打牌，雀魂/天鳳可用

开局：用向听数定方向

起手 13 张，HUD 会给出各条做牌路线的向听数与和牌率。手里宝牌多时，可以对比打快的期望与做大牌的期望，不再靠感觉选路。

中盘：攻防一眼看清

多家立直时，HUD 标注各家放铳风险，AI 给出推荐舍牌与置信度。犹豫时至少能看出哪张更危险、哪张留有多大的和牌余量。

终局之后：历史页找问题

完整对局全部落盘。历史页给出名次分布饼图、累计 PT 曲线（雀魂/天鳳/自定义规则可切换），以及和牌率、放铳率、立直率、平均和牌点数等统计。掉分先看立直率是不是掉了。

配置项怎么调

配置项	取值	效果
`capture.mode`	`mitm`/`chromium`	mitm 为系统级抓包需信任证书；chromium 零配置
`proxy.addr`	默认`127.0.0.1:23410`	端口被占用时改这里
`bot.active_4p`/`bot.active_3p`	bot 名称	四麻、三麻桌分别选用不同 bot
`overlay.enabled`	默认`true`	控制悬浮建议窗是否显示
`overlay.top_n`	正整数	建议列表显示几行
`autoplay.enabled`	默认`false`	是否让 bot 自动点击打牌
`network.github_mirror_mode`	`auto`/`direct`/`mirror`	下载更新时的线路选择

原理一瞥：数据怎么流转

采集：代理（端口 23410）或 CDP 拦截游戏 WebSocket 帧
转换：bridge 把雀魂 liqi 协议解析成统一的 MjaiEvent
分析：状态镜像驱动向听搜索，AI 产出推荐舍牌
展示：结果推送至 HUD 与悬浮建议窗

⚠️ 避坑速查：5 个高频故障

问题	解法
MITM 模式抓不到包	确认已信任`./ca/akagi-ca.crt`，用`curl http://127.0.0.1:23410/ping`验证，应返回 pong
游戏卡在加载画面	loopback 流量被送进代理，把`localhost`、`127.0.0.1`、`::1`从重定向里排除
Chromium 模式抓不到包	手动设置`capture.chromium.executable`指向浏览器完整路径
Bot 对局中崩溃	在 Inspector 页查 bot 死前最后一帧，附进反馈
三麻桌选错 bot	`bot.active_3p`与`bot.active_4p`相互独立，查设置里的 Bot 页