Releases: toki-2004/MahjongHelper
Releases · toki-2004/MahjongHelper
Release list
v1.4.1 建议标签与细节优化
v1.4.0 识别与切牌全面升级
v1.4.0 更新内容
- 识别链路重写：几何检测定位 + 原始像素匹配（无预处理），与模板采集工具同一套逻辑，识别更稳定
- 切牌建议升级：日麻向听数（普通形 / 七对子 / 国士无双）+ 有效进张评估，红5 宝牌优先保留
- 新增模板采集工具 template_capture.py：自动检测牌面、人工标注、自动填充预填、一键重建模板库
- 支持红5万 / 红5索 / 红5筒（共 37 类牌）
- 正式识别界面移除纠错下拉框（模板由采集工具维护）
- 模板库随版本内置（37 类模板 + 196 样本）
MahjongHelper v1.3.0
🀄 MahjongHelper v1.3.0（最终版）
🚀 本版亮点
- 识别算法升级：样本级匹配（kNN）+ 粗粒度快速搜索，9 张示例图 100% 全部识别正确（单张约 100ms）
- 模板库重新生成：20 张彩色平均模板 + 123 个对齐样本（配准后保存，消除重影）
- 彩色模板采集、修正后自动 F1 刷新、少牌（3~18 张）识别、下拉栏可修正 1w 等修复均已包含
📦 使用
- 解压
MahjongHelper-v1.3.0.zip - 保持
MahjongHelper.exe与_internal文件夹在同一目录 - 运行
MahjongHelper.exe，按 F2 框选手牌区域即可识别
🔧 技术结构
- 布局搜索：粗粒度灰度匹配（32x48）快速确定分档数与偏移
- 判定：全彩 BGR 样本级匹配（每张牌保留全部对齐样本，取最高分）
- 模板：
_internal/templates/+_internal/templates/samples/
MahjongHelper v1.2.1
🀄 MahjongHelper v1.2.1
✅ 本版修复
- 模板采集保留彩色：修正后存储的模板为彩色（之前会被转成灰度丢失花色信息）
- 修正后自动 F1 刷新：更新模板后立即重新识别当前区域
- 少牌识别修复：支持 3~18 张手牌，按牌行实际范围分档，不再将一张牌切碎识别成多张
- 下拉栏修正：默认为“（选择修正）”占位，可对任意牌（含 1w）进行模板修正
- 灰度旧模板自动替换：检测到旧版本采集的灰度模板时直接替换为彩色，避免混色
- 模板库更新：实战采集模板与标记样本融合平均，input 测试准确率 99.2%
📦 使用
- 解压
MahjongHelper-v1.2.1.zip - 保持
MahjongHelper.exe与_internal文件夹在同一目录 - 运行
MahjongHelper.exe，按 F2 框选手牌区域即可识别；识别有误时用下拉栏选择正确牌修正模板
MahjongHelper v1.2.0
🀄 MahjongHelper v1.2.0
✨ 主要更新
- 视觉模块重写：改为彩色（BGR）模板匹配，同时利用花色颜色与形状；模板库由原始模板 + 多样本平均构建，9 张示例图自测准确率 99.2%
- 识别框对齐：按牌面精确定位，同一张图内所有识别框尺寸完全一致，牌间间隙不入框
- 全局热键修复：F2 框选 / F1 刷新 / ESC 取消真正生效（Qt 信号桥）
- 多屏支持：主程序框选与调试工具截图均支持副屏（按鼠标所在屏幕定位，绝对坐标抓取）
- 新增调试工具：
debug_capture.py，F2 全屏 / F3 框选保存测试图到 input/ - 牌面预处理优化：降噪、对比度拉伸、背景白化，识别更稳定
- 在线修正：改为用正确牌图像直接替换模板并立即生效
📦 使用
- 解压
MahjongHelper-v1.2.0.zip - 保持
MahjongHelper.exe与_internal文件夹在同一目录 - 运行
MahjongHelper.exe，按 F2 框选手牌区域即可识别
🔧 技术说明
- 模板目录：
_internal/templates/（34 张彩色模板） - 识别流程：区域提取 → 分档搜索 → 彩色归一化相关匹配 → 逐槽位取最高分
- 调试输出：
debug_output/（识别框 + 牌名 + 置信度）
MahjongHelper v1.1.0
v1.1.0 更新内容
- 修复打包版识别失效：模板矩阵在路径覆盖后未重建、缺失模板生成错误尺寸占位矩阵，导致 exe 识别为 0 张；现与源码运行识别完全一致
- 修复 F2 识别后程序未响应：出牌建议算法由指数级 DFS 重写为动态规划，19 张牌从 60 秒以上降至约 200ms
- 修复 F2 后无识别结果/全部误报 1w：分档数量选择改为置信度优先并搜索对齐偏移，失败槽位显示为 ?
- 识别速度大幅提升：模板匹配向量化，单次识别约 60~90ms
- 下拉框纠错即时生效，无需重启
- 用示例图重训 2s/3s/1p~9p 模板，示例牌型识别与正确答案完全一致
使用方法
- 解压后以管理员身份运行 MahjongHelper.exe（全局热键需要管理员权限）
- F2 框选手牌区域，F1 刷新识别，ESC 取消
- 识别有误时可用牌下方的下拉框修正，程序会自动更新模板