麻将 AI 助手 🀄

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

规则：川麻（血战到底）

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

工作流程

Step 1: 识别牌面（拍照）

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

编码格式：

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

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

Step 2: 运行分析

参数：

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

Step 3: 输出建议

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

川麻特殊规则

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

参考

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