ClawHub

Mahjong AI

Other

AI Mahjong Assistant 🀄 — Snap a photo of your hand, get optimal discard suggestions. Sichuan Mahjong rules (Blood Battle / 血战到底). Supports tile recognition...

Install

openclaw skills install mahjong-ai

麻将 AI 助手 🀄

川麻（四川麻将）AI 出牌顾问。拍照发手牌，分析最优出牌。

规则：川麻（血战到底）

  • 只有 筒、条、万 三门，共 108 张（每种 1-9 各 4 张）
  • 每人 13 张手牌，摸牌后 14 张选择出牌
  • 胡牌条件：4 组面子（顺子/刻子）+ 1 对将（雀头）
  • 特殊胡法：七对、龙七对、清一色、对对胡等
  • 血战到底：一人胡了继续打，直到剩一人没胡

工作流程

Step 1: 识别牌面（拍照）

收到照片后，用视觉识别：

  1. 手牌（13或14张）
  2. 场上已打出的牌（牌池/河牌）
  3. 已碰/杠的牌

编码格式：

  • 万子：1m 2m ... 9m
  • 筒子：1p 2p ... 9p
  • 条子：1s 2s ... 9s

列出识别结果让用户确认后再分析。

Step 2: 运行分析

python3 scripts/mahjong_analyze.py \
  --hand "1m,2m,3m,5m,5m,3p,4p,7p,8p,9p,2s,3s,4s,6s" \
  --discard "1p,2p,5p,5p,9s,9s" \
  --meld "6m,6m,6m"

参数：

  • --hand / -H：手牌（必填，13或14张）
  • --discard / -d：场上已打出的牌（可选）
  • --meld / -m：已碰/杠的牌（可选）

Step 3: 输出建议

  • 14张 → 推荐打哪张，附安全度🟢🟡🔴 + 听牌张数
  • 13张 → 显示听什么牌 + 剩余张数
  • 安全度基于场面已出牌计算（出越多越安全、19边张更安全）

川麻特殊规则

  • 不能吃，只能碰/杠/胡
  • 血战到底：一人胡了继续打
  • 番数：清一色4番、七对4番、龙七对8番、对对胡2番

参考

  • 详细牌理：见 references/mahjong_theory.md