PokemonCardSearch/docs/卡牌区域OCR_rec宽容政策.md

卡牌区域 OCR rec 宽容政策

适用范围

适用于 card_no 检测框裁剪后的 rec-only OCR 后处理。
检测模型：yolo26s_card_no（conf=0.3，多框取最高 conf）。
识别模型：PP-OCRv6_medium_rec（仅 rec）。
合法格式清单见：卡牌区域OCR内容指南.md。

---

一、单次宽容原则

所有宽容政策最多只能宽容一项，不能对宽容后的结果继续宽容。

命中任一条后立即返回，不再套用后续政策。

---

二、宽容政策列表（按执行顺序）

1. 末尾稀有度后缀 / 符号剥离

• 完整后缀（长到短）：RRR/SSR/SAR/CHR/CSR/UR/HR/SR/RR/AR/MR/MA/PR/TR
• 单符号：*、★、$、C（允许前导空格，如 " C"、" SAR"）
• 例：001/095RR → 001/095；DPBP#299* → DPBP#299；36/160★ → 36/160

2. 末尾 - 补 P（新增）

• 条件：rec 文本以 - 结尾
• 动作：末尾追加 P
• 例：001/SM- → 001/SM-P
• 说明：检测框偶发裁掉促销码末尾 P 时使用；仍只宽容一次

3. 纯数字固定位置 1/7 → /

仅限纯数字，长度 ≥4：

位数	检查位置（1-based）	索引（0-based）
7	第 4 位	3
6	第 3 位	2
5	第 3 位	2
4	第 2 位	1
≤3	不采用	—

• 该位是 1 或 7 才转换
  
• 例：0827202 → 082/202；21712 → 21/12；1164 → 1/64
  
• 反例：168132（6 位，第 3 位是 8）→ 不触发

4. 中间空格去除

• 条件：整串只含数字、空格、至多一个 /
• 动作：去掉所有空格
  
• 例：43/1 10 → 43/110

5. 中间点号转斜杠

• 条件：纯数字.纯数字
  
• 动作：. → /
  
• 例：208.184 → 208/184

6. No. / mo. / Na. 归一

• No./NO./Na/mo./ma. + 1~4 位数字 → 统一 No.数字
  
• 例：No 006 → No.006；mo.066 → No.066；Na 128 → No.128

---

三、低分不合规置空（与“无编号”区分）

在完成至多一次宽容后：

条件	card_no	empty_reason	展示归类 blank_type	含义
无 yolo26s_card_no 检测框（conf<0.3）	空	no_detection	无编号	卡牌本身没有编号
有检测框，但 rec 原文为空	空	rec_empty	无编号（与上合并）	裁剪区 rec 无字，视同无编号
有检测框，rec_score ≤ 0.9，且宽容后不符合指南合法格式	空	blur_unreadable	模糊不可读	图片太模糊，无法可靠识字
有检测框，rec_score > 0.9	保留宽容结果	null	（有效）	高分可信
有检测框，rec_score ≤ 0.9 但宽容后符合合法格式	保留宽容结果	null	（有效）	低分但形态合法，保留

合法格式 = 指南中的老五种 + 补全四项（斜杠两侧 1~5、更长促销码、中点 ·、长码 ≥3）。

展示层两类空结果：

• 无编号 = no_detection ∪ rec_empty
  
• 模糊不可读 = blur_unreadable

---

四、实现

from modules.card_no_leniency import apply_leniency, finalize_card_no, is_valid_card_no_format

# 仅宽容
apply_leniency("001/SM-")   # -> "001/SM-P"

# 宽容 + 低分置空
finalize_card_no(rec_text, rec_score)
# -> {card_no, leniency_applied, empty_reason}

---

五、效果示例

rec 原文	rec_score	结果 card_no	empty_reason	说明
001/SM-	0.999	001/SM-P	—	政策 2
0827202	0.95	082/202	—	政策 3
No 006	0.99	No.006	—	政策 6
opponent	0.999	opponent	—	高分保留（框错另议）
xyz	0.70	``（空）	blur_unreadable	低分+不合规
``（空）	0	``（空）	rec_empty	rec 无输出
（无检测记录）	—	``（空）	no_detection	本身无编号