面向日麻初学者的 Windows 桌面辅助工具。根据实时牌局提供切牌、役种方向和防守参考,支持 Steam 雀魂的三麻与四麻。
- 先胡牌、做大牌、先防守、避四四种模式,可随时切换。
- 展示推荐切牌、简短解释、有效进张及未见张数。
- 持续显示手牌放铳风险,高风险推荐可配置提醒门槛。
- 按对手展示听牌估计和危险牌,支持手牌范围与全部牌种。
- 提供立直、吃碰、杠、拔北及和牌提示,展示牌面估分和结算结果。
- 支持置顶、小窗、窗口缩放,以及深色、浅色、粉色主题。
- 支持本地图片背景和可选动态背景。
- 集成 MAX 启动、停止恢复、正式版更新检查,以及仅打牌辅助模式。
适用于 Windows 10 / 11 的 x64 电脑。首次安装请解压 v0.3.0 完整便携版,然后安装 v0.4.0 教练累积更新包。
已有 v0.3.0 至 v0.3.2 的用户可直接更新。结束对局,点击「停止并恢复」并关闭教练,将更新包中的 MahjongCoach 文件夹复制到「雀魂新手教练.exe」所在目录,选择合并文件夹并替换同名文件,然后重新打开教练。
二向听及以上会比较当前进张、进张后的平均进张和摸到其他牌后的改良空间。一向听优先比较能直接听牌的未见张数。四麻做大牌时,在有适用的和率估计时一起比较打点和和牌机会。临近流局时,「避四/避末」会收紧未听牌且面临威胁时的推进条件。
牌效和改良思路参考「魔女」的搭子教程及 79 教程的分向听牌理,评分参数由本项目设定。魔女 Blog 日本麻将教学 · Seventh9 日麻教程
发行包内置 Python、PySide6、分析引擎、MAX 和 Live2D 播放依赖。解压完成后双击 雀魂新手教练.exe,即可打开界面。请将整个文件夹解压到可写目录,例如 D:\Games\MahjongCoach,并保留子文件夹。无需安装 Python、Go 或运行构建命令。
GitHub 自动生成的 Source code 压缩包用于源码开发。使用桌面程序请选择上面的 win-x64.zip 附件。
在 Steam 安装并更新「雀魂麻将」,先正常启动一次,确认能进入游戏大厅,再退出游戏。
在 Steam 库右键雀魂 → 管理 → 浏览本地文件,记下程序的位置。连接设置中需要选择这里的 Jantama_MahjongSoul.exe。
从 Clash Verge Rev 官方发行页 下载适合电脑的 Windows x64 安装包,安装后打开。详细安装步骤见 官方文档。
- 已有订阅的用户,在「订阅」中导入并启用配置,确认所选节点能访问雀魂。
- 使用直连的用户,可在「订阅」中导入发行包内的
Clash-直连示例.yaml并启用。该配置的出口是 DIRECT。 - 教练启动期间保持 Clash Verge Rev 运行。Clash 的 TUN 功能需要可用的服务模式,按 Clash 的提示安装或启用服务。
教练目前通过 Clash Verge Rev 的 Windows 命名管道接口控制配置。其他代理客户端和只开放 HTTP 控制接口的安装方式尚未适配。
双击 雀魂新手教练.exe,首次打开会显示「连接设置」。也可在大窗左侧或小窗「主题」菜单中重新打开。
| 字段 | 填写方法 |
|---|---|
| 雀魂程序 | 点「选择」,找到步骤 1 的游戏 exe |
| Clash 配置目录 | 默认自动填入当前 Windows 用户的配置目录。目录内应有 clash-verge.yaml 和 profiles 文件夹 |
| MAX 网络出口 | 点「读取代理组」。直连选择 DIRECT,需要代理时选择订阅中的可用代理组 |
默认 Clash 目录为 %APPDATA%\io.github.clash-verge-rev.clash-verge-rev。如果使用便携版,在 Clash 内打开实际配置目录后选择该目录。
点击「保存」。设置存储在发行包内的 MajsoulMax-Steam/launcher.json,更换电脑、游戏路径或代理组后可以重新填写。
也可以取消设置,先点「示例手牌」查看界面。
- 确认 Steam 在线、Clash 正在运行。
- 默认开启「全解锁关闭 · 仅辅助」。可在启动前切换外观模式。
- 点击「启动雀魂」,等待状态变为提示已开启。
- 首次启动可能需要下载 MAX 协议数据并建立本地代理证书。MAX 更新失败时,先查看
MajsoulMax-Steam/max.log,确认网络出口可访问 GitHub。 - 登录后从新的一局开始,建议首次使用在人机对局确认提示。
- 根据窗口建议在游戏中手动操作。结束后点击「停止并恢复」,或关闭教练。
本地代理证书用于读取游戏消息,启动时可能加入当前用户证书存储。启动流程会临时开启 TUN、切换规则模式并增加游戏进程分流,停止时恢复保存的网络配置。使用中请保持教练和 Clash 运行。
窗口尺寸、位置、大小窗、置顶、策略选择、危险牌查看范围,以及深色、浅色、粉色配色会自动保存。下次打开恢复上次状态。界面偏好位于 %LOCALAPPDATA%/MahjongCoach/appearance.ini,升级时自动迁移原来的 外观.ini,换版本解压目录也会复用。背景收藏支持本地图片、动图、动态场景和碧蓝航线 Live2D。
发行包已包含背景目录清单和模型播放器。点击「下载并应用」时才下载对应资源,首次下载需要网络。模型、贴图和视频可能较大,请等待进度完成。视频使用静音循环播放,Live2D 需要显卡驱动支持 OpenGL。播放失败时可切回内置插画。
主题视频和游戏模型来自第三方资源服务,服务可用性与授权遵循各自项目。第三方角色资源按需下载。
| 问题 | 处理方法 |
|---|---|
| 下载后找不到启动程序 | 下载 Releases 中的 win-x64.zip 附件,完整解压后打开 |
| 没有填写设置 | 左侧「连接设置」或小窗「主题 → 连接设置」中填写 |
| 找不到 Clash 配置 | 先打开 Clash 并启用一个配置,再选择含 clash-verge.yaml 的目录 |
| 提示找不到代理组 | 先停止并恢复,打开设置,读取当前配置的代理组并重新保存 |
| 找不到雀魂程序 | 从 Steam 的「浏览本地文件」进入游戏目录,选择游戏 exe |
| 启动失败或端口占用 | 先关闭其他 MAX、麻将助手,检查 23410、12121、12122 端口,再重试 |
| 登录后没有手牌 | 退出示例模式,开始新的一局。中途重连时可能要等待下一局 |
| 关闭时恢复失败 | 保持 Clash 开启,重新点击「停止并恢复」。保留 session.json 和 launcher-state.json 供恢复使用 |
| 动态背景失败 | 检查网络和显卡驱动,先选内置插画测试基础界面 |
| Windows 提示未知发布者 | 当前发行程序未作代码签名,请核对下载来源和 SHA256SUMS.txt |
启动与恢复状态、角色搭配和背景缓存保存在解压目录,界面偏好保存在当前 Windows 用户目录。程序运行时不要移动目录或删除配置文件。分享日志前请检查其中的账号与对局信息。
更新教练时解压到新目录,先关闭旧版并完成恢复,再按需迁移连接设置与背景收藏。MAX 的正式版检查在空闲时自动进行。
开发环境需要 Windows x64、Python 3.12 和 Go。安装依赖并构建引擎后启动。
py -3.12 -m pip install -r requirements.txt
cd MahjongCoach/engine-source
go build -o ../engine/mahjong-coach-engine.exe .
cd ../..
py -3.12 MahjongCoach/coach.pyw实时数据需要 MajsoulMax-Steam/app/MajsoulMax/MajsoulMax.exe。开发时可从 MAX 正式发行页 下载官方包,解压到该路径,并保留原压缩包以供版本识别。设置通过界面填写。
点击「避四」后,教练结合点数、分差、牌局阶段和实际切牌风险调整攻守。三麻显示为「避末」。
- 先比较保持当前最小向听数的切法,在有效进张、打点和估计风险之间权衡。
- 听牌和好一向听拥有更宽的进攻参考范围,低打点但等牌多的听牌也会继续争取和牌。
- 有对手威胁时,只有推进风险超过当前牌形的参考线、且有明显更安全的合法切牌,才建议本巡退守。
- 庄家、后段追分、多个对手威胁及领先分差会调整进攻参考线。领先末位和对手立直本身都不会单独触发弃和。
- 有风险估计时优先比较同向听切法,缺失估计不会直接视为安全。顶部说明牌形、进张、风险和本巡攻守理由。
- 继续进攻时正常评估吃碰、立直和杠,退守时才采用相应保守建议。
参考线和风险惩罚属于启发式规则,尚未经过大规模对战评测。点数信息不足时仍可按牌形和风险判断,无法确认比赛长度时不会启用后段分差修正。同点按危险侧处理。合法和牌目前仍建议收下,暂未计算末局跳过和牌、流局结算及完整顺位期望。
放铳风险根据公开弃牌、副露、巡目和立直状态估算。对手听牌概率与听牌条件下的牌种危险度相乘,再合并各家的估计。开局信息不足时显示「待估」。
危险牌列表用于辅助防守,具体等待牌仍需推测。概率尚未经过实战校准,少见牌型、对手打法和信息缺失都可能影响结果。
有效进张的未见张数包含可能在其他玩家手中的牌。和牌估分未必涵盖本场、供托、里宝牌及所有特殊役,实际点数以游戏结算为准。
实时辅助可能违反游戏平台规则。请自行了解平台要求及账号风险。
| 文件 | 用途 |
|---|---|
coach.pyw、studio.py |
桌面窗口、主题与牌面展示 |
backend.py |
本地数据接收和启动恢复 |
presenter.py、strategy.py |
出牌策略及中文提示 |
engine-source/ |
修改后的 Go 分析引擎 |
backgrounds.py |
背景收藏 |
max_updates.py |
正式版检查和更新 |
日志、账号会话、个人皮肤配置、代理配置及下载缓存均保存在本机。
- mahjong-helper,MIT,分析引擎。原许可证保存在
MahjongCoach/LICENSE-engine.txt。 - riichi-mahjong-tiles,CC0,麻将牌面。
- MajsoulMax,本机启动集成所依赖的上游项目。
内置插画和头像由 AI 生成。第三方模型、视频、游戏立绘和相关运行库的使用与分发应遵守各自授权。