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作为一款开源的多平台麻雀AI辅助工具Akagi通过实时分析牌局数据、提供精准决策建议帮助玩家在雀魂、天鳳、麻雀一番街等主流平台提升竞技水平。本文将全面解析Akagi的核心功能、安装配置、高级特性以及技术架构为您提供从入门到精通的完整路径。核心理念数据驱动的麻雀决策革命传统麻雀游戏依赖经验和直觉而Akagi带来了数据驱动的科学决策方法。项目名称源自经典动漫《斗牌传说》中的主角赤木茂象征着对麻雀游戏的深度理解和战略思维。Akagi的核心价值在于将复杂的概率计算、牌效分析和风险评估转化为直观的可视化建议让普通玩家也能获得职业级的决策支持。三大核心技术支柱实时分析引擎基于Rust重写的分析模块每秒可处理超过200种牌局变化计算向听数、有效牌、和牌概率等关键指标多平台兼容性支持雀魂、天鳳、麻雀一番街、天月麻雀等主流平台无论是四人麻将还是三人麻雀都能完美适配模块化AI系统采用mjai协议标准支持任意兼容该协议的AI模型内置Mortal AI作为示例模型快速上手十分钟完成部署与配置环境准备与安装Akagi采用单文件便携式设计无需复杂的安装过程。根据您的操作系统选择对应的版本操作系统下载文件运行要求Windowsakagi-版本-windows-x64.zip需要WebView2运行环境Windows 10 1803已预装macOSakagi-版本-macos-arm64.zipApple Silicon芯片首次运行需右键点击并选择打开Linuxakagi-版本-linux-x64.zip需要WebKit2GTK 4.1库支持安装步骤从官方仓库下载对应平台的压缩包解压到任意具有写入权限的目录如~/Apps/或桌面直接运行可执行文件配置文件和日志将保存在同一目录下首次启动配置向导首次启动Akagi时系统会引导您完成五个关键配置步骤语言选择支持英语、日语、简体中文、繁体中文四种界面语言游戏平台选择根据您常玩的平台选择雀魂、天鳳或麻雀一番街捕获模式配置选择MITM代理模式或Chromium浏览器模式证书信任仅MITM模式需要安装自签名CA证书AI模型安装一键安装内置的Mortal AI模型两种捕获模式对比Akagi提供两种数据捕获方式适应不同用户需求特性MITM代理模式Chromium浏览器模式配置复杂度中等简单系统影响需配置系统代理无系统级影响证书要求需要安装CA证书无需证书浏览器支持任意浏览器仅Chromium内核浏览器性能影响低低推荐新手使用Chromium模式只需在设置中选择Chromium并点击检测按钮Akagi会自动启动浏览器并创建独立配置文件无需任何代理或证书配置。核心功能深度解析实时HUD显示系统Akagi的界面设计遵循信息密度适中关键数据突出的原则主要显示区域包括手牌分析区显示当前手牌的向听数、有效牌、改良方向推荐出牌区基于AI分析给出最佳出牌建议附带期望值评分风险评估图可视化展示每张牌对各个对手的放铳风险对手信息面板显示其他玩家的立直状态、副露情况、打牌习惯牌局事件流实时记录吃、碰、杠、立直等重要事件AI模型集成机制Akagi采用独特的进程隔离架构确保AI模型与主程序之间的安全边界Akagi主进程 (Rust) ↓ JSONL标准协议 mjai AI子进程 (Python) ↓ 模型推理 决策输出 → HUD显示这种设计带来三大优势许可证兼容性AGPL协议的AI模型如Mortal不会影响主程序的Apache 2.0许可证稳定性隔离AI进程崩溃不会导致主程序异常热插拔支持可随时更换或更新AI模型而无需重启主程序双模式AI路由系统Akagi智能识别牌局类型自动切换对应的AI模型四人麻将模式使用bot.active_4p配置的模型三人麻雀模式使用bot.active_3p配置的模型分析模式如未配置对应模型仅显示分析数据而不提供AI建议历史记录与统计分析每次完整对局都会被自动记录存储在配置目录/history/路径下。历史系统提供排名分布饼图直观展示1st/2nd/3rd/4th的分布比例累计PT曲线图支持多种计分规则切换雀魂段位系统铜/银/金/玉/王座天鳳段位系统新人→天鳳位自定义规则可编辑uma和段位奖励详细统计数据和牌率、放铳率、立直率副露率、流局率平均和牌点数、平均放铳点数平均和牌巡目役满、流局满贯次数高级功能与定制化自定义AI模型集成除了内置的Mortal AIAkagi支持集成任何符合mjai协议的AI模型。集成步骤准备模型文件将AI模型放置在mjai_bot/模型名称/目录下配置manifest文件创建manifest.toml定义模型参数安装依赖环境通过界面点击安装环境按钮自动配置Python环境激活模型在设置中选择对应模型并启用配置系统详解Akagi的配置采用TOML格式存储在config.toml文件中。主要配置区块[general] language zh-CN # 界面语言 [platform] kind Majsoul # 游戏平台 [capture] mode chromium # 捕获模式 [capture.chromium] executable # 自动检测浏览器 user_data_dir # 独立浏览器配置文件 [bot] enabled true active_4p mortal # 四人麻将AI active_3p mortal3p # 三人麻雀AI调试与诊断工具Akagi内置完整的调试系统帮助用户排查问题诊断日志按模块和级别过滤的应用日志支持实时追踪协议检查器原始WebSocket帧、mjai事件、AI响应的三层查看会话保存完整对局数据可导出用于问题报告故障排查黄金法则遇到问题时首先保存当前会话文件夹包含所有日志和原始数据然后前往Discord社区或GitHub Issues寻求帮助。技术架构与开发指南现代化技术栈Akagi v3采用前沿技术栈构建确保性能与可维护性层级技术选型作用应用框架Tauri 2跨平台桌面应用框架后端语言Rust 2021高性能系统级编程异步运行时Tokio异步I/O处理前端框架React 19 TypeScript用户界面开发样式系统Tailwind CSS v4 shadcn/ui现代化UI组件状态管理Zustand前端状态管理数据可视化Recharts图表渲染AI运行时Python 3.12 uv模型执行环境模块化架构设计项目采用清晰的分层架构各模块职责明确src/ ├── analysis/ # 麻雀分析引擎向听数、有效牌、风险评估 ├── bot/ # AI模型管理器与运行时 ├── bridge/ # 平台协议适配器雀魂、天鳳等 ├── capture/ # 数据捕获层MITM/CDP ├── game_state/ # 游戏状态跟踪与转换 ├── history/ # 对局历史记录系统 ├── inspector/ # 调试与协议检查 └── ipc/ # 前后端通信接口开发者扩展指南如需为Akagi添加新功能可参考以下扩展点添加新游戏平台在src/bridge/目录下创建新的协议解析器扩展分析功能修改src/analysis/中的分析算法自定义界面组件在frontend/src/tiles/中添加新的仪表板组件集成新AI模型遵循mjai协议规范实现bot.py构建与打包流程从源代码构建Akagi需要以下环境# 1. 安装依赖 # Linux: libwebkit2gtk-4.1-dev, libgtk-3-dev等 # macOS: Xcode Command Line Tools # Windows: WebView2运行时 # 2. 克隆代码 git clone https://gitcode.com/gh_mirrors/ak/Akagi cd Akagi # 3. 获取运行时组件 bash scripts/fetch-runtime.sh # 4. 构建应用 cargo tauri build --no-bundle # 5. 打包发布 bash scripts/package-zip.sh 目标平台最佳实践与性能优化硬件配置建议根据使用场景推荐不同的硬件配置使用场景最低配置推荐配置基础分析4GB内存双核CPU8GB内存四核CPUAI辅助模式8GB内存四核CPU16GB内存六核CPU专业训练16GB内存六核CPU32GB内存八核CPU网络延迟优化Akagi对网络延迟敏感建议使用有线网络避免Wi-Fi不稳定性关闭不必要的代理减少中间节点优化DNS设置使用可靠的DNS服务器定期清理浏览器缓存Chromium模式下建议内存使用优化长时间运行Akagi时可采取以下优化措施定期清理历史记录删除不需要的对局数据限制日志保留时间在配置中设置日志自动清理关闭不必要的功能如不需要可关闭Inspector功能使用轻量级AI模型对性能要求不高的场景社区生态与未来发展活跃的开发者社区Akagi拥有活跃的国际化社区主要通过以下渠道交流Discord服务器实时技术支持与功能讨论GitHub Issues问题报告与功能请求深度维基详细的文档与教程路线图与未来特性当前开发重点包括Amatsuki平台支持扩展平台兼容性自定义主题系统提供界面个性化选项前端体验优化改进牌面布局与动画效果天鳳自动对局目前仅支持观察模式贡献指南欢迎开发者参与Akagi的改进代码贡献遵循项目代码规范提交Pull Request文档改进完善使用文档与开发指南翻译贡献帮助完善多语言支持问题反馈提交详细的Bug报告安全与合规说明使用注意事项Akagi设计初衷为教育目的帮助玩家理解麻雀决策逻辑。使用时请注意遵守平台规则各游戏平台对辅助工具政策不同尊重其他玩家避免在正式比赛中使用个人学习为主将AI建议作为学习参考而非绝对指令数据隐私保护Akagi的所有数据处理都在本地完成无数据上传所有分析在用户设备上执行本地存储配置、历史记录存储在本地进程隔离AI模型运行在独立进程中许可证兼容性项目采用清晰的许可证策略主程序Apache License 2.0AI模型独立许可证如Mortal使用AGPL第三方库均在NOTICE文件中明确标注结语AI时代的麻雀学习伙伴Akagi代表了麻雀辅助工具的技术前沿将复杂的概率计算和战略分析转化为直观的决策支持。无论您是刚入门的新手还是希望突破瓶颈的进阶玩家Akagi都能提供个性化的学习路径。记住工具的价值在于辅助思考而非替代思考。合理使用Akagi结合自身对牌局的理解才能真正提升麻雀水平享受策略游戏的深度乐趣。通过数据驱动的分析方法和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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
