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
Akagi 雀魂助手是一款实时麻将 AI 辅助工具，支持雀魂、天凤、麻雀一番街等平台：它盯住你正在进行的牌局，实时算出向听数、听牌、荣和率、放铳风险，并给出建议舍牌。AI 模型直接内嵌在程序里，装完就能用，不用额外下载模型文件。
🎯 Akagi 雀魂助手适合谁
- 刚接触 AI 辅助的新手：安装向导一路引导选语言、平台、抓取方式，第一局就能在 HUD 上看到自己离听牌还差几张。
- 想复盘提升的老玩家：每局结束自动入库，History 页能看到段位分布饼图、积分曲线、和牌率、立直率这些平时记不住的数据。
- 想解放双手的日常玩家：开启全自动后，内置模型接管雀魂和天凤的出牌，你只需要看着结果验证自己的判断。
雀魂助手安装步骤：从 0 到第一局
- 克隆仓库并进入目录：
git clone https://gitcode.com/gh_mirrors/ak/Akagi cd Akagi- 按系统跑安装脚本：
# Windows：管理员 PowerShell scripts\install_akagi.ps1# macOS：终端 bash scripts/install_akagi.command- 首次启动跟着 Setup 向导走：选语言 → 选平台 → 选抓取方式（Chromium 免证书，MITM 需要信任一次 CA）→ 设置 Bot → 完成。
- 打开雀魂打一局，HUD 上出现向听数和推荐舍牌，就算跑通了。
抓取方式怎么选：Chromium 模式由 Akagi 自己拉起一个浏览器窗口，走 Chrome 调试协议截帧，零系统代理、零证书，最省事；MITM 模式适合用独立客户端的玩家，走127.0.0.1:23410本地代理。
核心能力拆解：麻将 AI 辅助能做到什么
实时数据分析
- 牌局镜像：手牌、副露、牌河、四家分数逐帧还原
- 核心指标：向听数、听牌、荣和率、振听率、对每位对手的放铳风险
- 历史统计：段位饼图、可切换计分规则的累计积分曲线、和牌/放铳平均点数等明细
决策辅助
- 内置纯 Rust 神经网络 Bot，权重已打进二进制，四人对局和三人麻将分别自动路由
- 可选云端推理：更强的托管模型，本地模型随时兜底，服务器连不上也不会卡住牌局
- 全自动模式：Bot 的决策直接变成出牌动作，带仿人类思考时延，避免机械操作
个性化配置方法
配置集中在根目录config.toml，常用项：
| 配置项 | 位置 | 作用 |
|---|---|---|
capture.mode | [capture] | mitm或chromium抓取方式 |
proxy.addr | [proxy] | 本地代理地址，默认127.0.0.1:23410 |
bot.active_4p/active_3p | [bot] | 四人 / 三人桌各自使用的 Bot |
bot.api.key | [bot.api] | 云端推理密钥，留空则纯本地 |
autoplay.enabled | [autoplay] | 全自动出牌总开关 |
autoplay.delay.mode | [autoplay.delay] | 思考时延策略，建议保留拟人模型 |
安全与流畅使用指南
- 优先用 Chromium 抓取：不动系统证书和代理，风险最小
- 走 MITM 时，把回环地址（
localhost、127.0.0.1）从代理规则里排除，否则客户端内部通信会被误转发 - 自动操作每天控制时长，别整夜挂机；保留拟人时延策略，维持自然出牌节奏
- 给模型推理留足内存，代理端口别和别的工具撞车
- 在 设置 → 更新 里定期检查新版本，行为数据有异常就去 Logs 页查诊断日志
✅ 常见问题（FAQ）
问：需要提前下载 AI 模型文件吗？不用。内置 Bot 的权重已经嵌在程序里，装完即可用。想换第三方 mjai 协议引擎，在 Bots 页从压缩包安装即可。
问：MITM 模式下抓不到牌局怎么办？先用curl http://127.0.0.1:23410/ping确认代理活着并返回pong，再检查 CA 证书是否已信任；嫌麻烦就直接切到 Chromium 模式。
问：用全自动会封号吗？项目方不提供任何担保，封号与否取决于平台规则和你的用法。建议控制使用时长、保留人类化时延、保持正常游玩行为。
问：云端推理是必须的吗？不是。默认完全离线跑本地模型；云端只是可选的更强模型，密钥失效时会自动回落到本地。
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），仅供参考
