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
刚打完一把牌,回放时却想不起自己该切哪张。Akagi 就是来解决这个问题的:它是一款面向雀魂、天鳳等麻将游戏的实时 AI 辅助工具,边打边抓包,当场告诉你向听数、听牌和推荐切牌。
Akagi:麻将玩家的实时AI助手
Akagi 是为雀魂、天鳳、Riichi City 玩家准备的实时 AI 分析工具:它捕获你的对局,交给 AI 计算,把建议直接显示在可拖拽的 HUD 上。
- 实时显示向听、听牌、和牌率
- 逐家放铳风险与推荐切牌
- 内置纯 Rust AI 模型,免安装
- 对局历史自动记录与统计
- 四麻与三麻(Sanma)均支持
如何三步完成安装
前提条件
- Windows 10/11、macOS(Apple Silicon)或 Linux 环境
- 雀魂或天鳳账号
- Linux 用户需先安装 WebKit2GTK 4.1(
apt install libwebkit2gtk-4.1-0等)
安装步骤
- 从项目 Releases 页下载对应系统的便携 zip,解压到任意可写目录(例如
~/Apps/或桌面)。 - 运行解压目录里的
akagi可执行文件,按首次启动的设置向导依次选择:语言 → 平台 → 抓包模式 → bot 设置。 - 选择 Chromium 模式的话,Akagi 会自动找到并启动受控浏览器,你直接登录游戏开打;选择 MITM 模式,则信任证书
./ca/akagi-ca.crt,并把游戏客户端流量导向127.0.0.1:23410。 - 验证代理:
curl http://127.0.0.1:23410/ping返回pong即配置成功。
配置文件、日志、对局历史都会生成在可执行文件旁边,迁移或卸载就是复制或删掉整个目录。想自己编译的话:
git clone https://gitcode.com/gh_mirrors/ak/Akagi cd Akagi cargo run典型工作流
对局中实时分析切牌
手牌复杂、下家又刚打出一张幺九,你不知道该切哪张时不用等局后复盘。Akagi 会实时镜像游戏状态,HUD 上直接显示当前向听数、听牌、和牌率,内置模型每巡给出推荐切牌,并按对手逐家估算放铳风险,你当场就能做决定。
查清最近的真实水平
感觉最近胜率在下滑却说不清原因?每场正常结束的对局都会自动落到历史目录,History 页直接给出名次饼图、累计 PT 折线(可选雀魂段位 / 天鳳段位 / 自定义 uma 计分规则),以及和牌率、放铳率、立直率、平均放铳点数等统计。列表可按平台、人数、日期过滤,点任意一局看最终排名与完整事件流,细节见对局历史模块文档。
换更强的模型或让 AI 代打
内置模型不够用时,在 Bots 页开启云端推理:把每次决策交给托管的更强模型,服务器连不上时内置模型自动兜底,对局不会卡住,密钥可在应用内购买或兑换。想让 AI 替你打牌,开启 AutoPlay 即可(目前支持雀魂与天鳳),实现细节见自动打牌模块文档。
架构要点
Akagi 用 Rust + Tauri 2 重写为单二进制,日常使用无需 Python 环境。
src/capture/+src/proxy/:MITM 代理与 Chromium DevTools 协议两条抓包路径src/bridge/:把各平台私有协议解析成标准 mjai 事件流src/analysis/:计算向听、听牌、和牌率、放铳风险与切牌推荐src/bot/:管理内置模型、云端 API 与外部 mjai bot 子进程
注意事项与常见坑
- ✅ 新手优先选 Chromium 模式:免代理、免证书,在启动的浏览器里登录即玩。
- ✅ MITM 模式下,把
localhost、127.0.0.1、::1一律设为直连,不要经过 Akagi;否则游戏内部通信会被劫走,牌局可能卡死。 - ⚠️ 内置模型是行为克隆训练的小型网络,棋力刻意保持中等,是合理默认值而非顶尖引擎,建议当参考而非标准答案。
- ⚠️ 若 Chromium 窗口还开着就重启 Akagi,它会关掉旧浏览器再开一个新窗口;不要对同一 profile 同时跑两个 Akagi 实例。
- ❌ 不要长时间挂 AutoPlay,也不要在官方比赛中使用 AI 辅助;项目仅供教育用途,账号风险由你自己承担。
FAQ
- 需要安装 Python 或 Mortal 吗?不需要。内置模型嵌在可执行文件里;外部 mjai bot 才需要 Python,且发行包已自带。
- 支持哪些平台?雀魂、天鳳(均支持四麻三麻与自动打牌),Riichi City(仅观察),天月麻將计划中。
- 开始对局后没有数据怎么办?检查抓包配置:MITM 模式确认 ping 能返回 pong;Chromium 模式在设置里确认浏览器路径。
- bot 中途崩溃了怎么排查?在 Logs 页 Inspector 标签查看 bot 死前看到的最后一帧,附在问题报告里。
- 三麻和四麻的模型怎么切换?
bot.active_3p与bot.active_4p相互独立,在 Settings → Bot 中修改,Akagi 按牌桌人数自动选用。
下一步
- 从 Releases 下载对应平台的便携 zip,解压后运行
akagi。 - 想源码构建:克隆
https://gitcode.com/gh_mirrors/ak/Akagi后执行cargo run。 - 想开发自己的 AI:阅读 mjai Bot 接口文档,参考
mjai_bot/example/中的示例 bot。
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辅助生成(AIGC),仅供参考