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

刚打完一把牌，回放时却想不起自己该切哪张。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 按牌桌人数自动选用。