内置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
对热爱日麻的玩家来说,Akagi是一款能实时分析雀魂、天凤、麻雀一番街、天月麻将对局的麻将AI辅助工具。它最吸引人的设计,是同时提供内置AI与云端推理两种机器人后端:一个开箱即用、完全离线,一个性能更强但需要密钥。本指南将带你完整了解两者的区别,并手把手教你如何选择与切换。
上图是 Akagi 的实战界面:右侧"AI 推薦"面板实时给出策略(如 Discard、Hora 置信度),顶部"線上 API"标签表明当前正通过云端推理运行。
一、什么是Akagi的双机器人后端?
Akagi 默认内置一个纯 Rust 的麻将AI模型,权重直接嵌在可执行文件内,无需安装 Python、无需下载模型、无需任何配置,四麻三麻都能直接开打。同时,它支持将每一次决策交给远程推理服务器上更强的托管模型,这就是第二种后端——云端推理。
两个后端的默认配置在 src/config/bot.rs 中定义:内置机器人的保留名称是akagi-native(四麻)与akagi-native3p(三麻),开箱即用。
二、内置AI与云端推理的核心区别
| 对比维度 | 内置AI(本地模型) | 云端推理(远程模型) |
|---|---|---|
| 棋力水平 | 中等,行为克隆训练的小型网络 | 更强,服务器端托管的大模型 |
| 网络要求 | 完全离线,零依赖 | 需要联网,请求推理服务器 |
| 安装成本 | 零安装,随应用附带 | 需配置服务器地址 + API 密钥 |
| 费用 | 免费 | 需购买或兑换密钥 |
| 对局可靠性 | 稳定,无外部依赖 | 断网/限流时自动降级为本地兜底 |
内置模型刻意保持"合理的默认值"而非顶尖引擎,这正是它的定位:让新手零门槛获得 AI 建议;而云端推理则是给追求更高棋力的玩家准备的进阶选项。
三、如何选择:什么时候该用哪种后端?
- 新手入门、离线环境、不想折腾→ 直接用内置AI。它是
bot.active_4p与bot.active_3p的默认值,打开应用即可享受实时向听、听牌率、放铳风险和推荐切牌。 - 追求更强建议、愿意付费→ 切换云端推理,把每次决策交给托管大模型。
- 想两者兼得→ 完全可以!开启云端推理后,本地模型依然保持加载,作为自动兜底。
四、最快配置方法:三步开启云端推理
第1步:获取云端推理密钥
密钥有三种获取方式:应用内购买、兑换码兑换(将预付码换成密钥或给已有密钥加时长),或到官方 Discord 社区咨询。兑换与密钥状态检查由 src/bot/api.rs 中的ApiClient实现(对应/v3/redeem、/v3/key、/v3/models等接口)。
第2步:填写服务器与密钥
在Bots标签页找到内置机器人,填写以下配置(前端表单见 NativeApiFields.tsx,对应后端结构NativeApiConfig):
- enabled:打开云端推理开关
- API Server URL:默认预填
https://mjapi.shinkuan.me,无需手输 - API Key:粘贴你获取到的 32 位密钥
只有当开关开启 + 服务器地址 + 密钥三者齐全时,云端推理才会真正生效(见
NativeApiConfig::is_active)。
第3步:保存并验证
保存后,顶部的"線上 API"状态标签会亮起,表示云端推理已接管决策。你还可以通过/v3/models为四麻、三麻分别指定不同的模型 ID(留空则使用服务器默认模型)。
五、按模式切换:四麻与三麻独立配置
Akagi 支持按牌桌人数自动选择后端:bot.active_4p与bot.active_3p互相独立,开局时根据人数自动启用对应配置。所以你可以四麻用云端推理、三麻用内置AI,互不干扰。
同时,云端模型也可按模式分别指定:model_4p与model_3p字段分别控制两种牌桌使用的托管模型,留空则让服务器自行选择默认模型。
六、值得了解的三个安全机制
- 自动兜底(Fallback):服务器连不上、被限流或密钥无效时,bot 会静默改用本地模型的着法,对局永远不会卡住。
- 熔断器(Circuit Breaker):一次 API 调用失败后,会在 5 秒到 120 秒的指数退避窗口内跳过云端请求,避免服务器宕机时每巡都白等超时(实现见 src/bot/native.rs)。
- 对局中热切换:配置修改会在下一个决策点立即生效,不必等下一场对局——打错密钥、想换模型,随手改完下一巡就生效。
七、进阶:接入你自己的AI模型
如果你不只是想用现成的双后端,而是希望运行自定义的 mjai 麻将AI,Akagi 同样支持:把 bot 文件夹放入mjai_bot/目录即可通过子进程方式运行(协议详见 mjai_bot/README.md),内置的 Mortal AI 就是最典型的示例。这与内置/云端两条路径互不冲突,是给开发者准备的扩展点。
总结
无论你是想要一个零配置、全离线、开箱即用的内置AI,还是追求更强棋力的云端推理,Akagi 的双机器人后端设计都能满足——还能按四麻/三麻分别组合。对照本指南,3 分钟即可完成从选择到切换的全部配置,立刻开始你的 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辅助生成（AIGC），仅供参考
