内置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），仅供参考