AOZHOU 价格提取 Skill

OCR 识别澳洲空运价格图片 → 24列标准输出 → 上传 WPS。

⚠️ 铁律：仅提取用户最新提交图片，禁止复制历史数据

• 禁止查看/引用/复制任何历史脚本中的 price/data 数组
• 禁止从历史输出文件直接读取数据
• 禁止硬编码历史图片路径作为源文件
• 每次提取必须从用户当前提交文件全新 OCR 识别
• 有就是有，没有就是没有：不得用历史数据填补缺失值

一、核心参数

全局规则

• 频次为空时默认填"Daily"：频次列如果为空则填入 Daily（0727全局规则）
• 分泡列不提取：分泡列始终留空，不提取任何分泡数据（0720全局规则）

二、强制流程

1. 确认图片路径
2. ocr_utils.scan_to_log() 扫描 → 日志输出
3. 按 Y 坐标分组识别数据块
4. ocr_utils.find_price_at_xy() 逐行提取 → 比重推导
5. 生成 24 列 DataFrame
6. 保存 → 上传 WPS → 删除临时文件

2.1 OCR 统一导入（所有平台一致）

import sys, os
sys.path.insert(0, os.path.expanduser('~/.workbuddy/skills'))
from ocr_utils import scan_image, scan_to_log, find_price_at_xy, find_text_at_xy, check_env

check_env()  # 启动时自检，确保引擎版本一致

三、目的地数据块配置 ⚠️ 最可能变化

3.1 生效日期（每个目的地不同）

3.2 备注（每个目的地不同）

四、OCR 坐标提取（核心）

4.1 价格列 X 坐标范围

⚠️ 新图片 X 范围可能变化：需要对照图片重新标定。

4.2 数据行 Y 坐标（每个目的地）

AKL（4 行，Y=180-520）：

209 平托 → 托盘, 238 平散 → 散货, 268 1:120以下散 → 散货
300 1:100以下散 → 散货, 331 1:300托盘 → 托盘, 360 1:300散货 → 散货
387 1:500托盘 → 托盘, 420 1:500散货 → 散货, 450 1:800托盘 → 托盘
480 1:800散货 → 散货, 511 1:1000散托 → 散货/托盘

BNE（3 行，Y=697-980）：

742 平托 → 托盘, 778 平散 → 散货, 811 1:120以内泡散 → 散货
865 1:100以内泡散 → 散货, 917 1:300散托 → 散货/托盘
949 1:500散托 → 散货/托盘, 977 1:800散托 → 散货/托盘

MEL（2 行，Y=1227-1700）：

1305 平托 → 托盘, 1374 平散 → 散货, 1442 1:100以内限散 → 散货
1506 1:250散 → 散货, 1572 1:300托 → 托盘, 1637 1:300散 → 散货
1698 1:500散+托 → 散货/托盘

SYD（3 行，Y=1954-2380）：

2016 平托 → 托盘, 2061 平散 → 散货, 2107 1:100以内限散 → 散货
2140 1:250散 → 散货, 2199 1:300托 → 托盘, 2241 1:300散 → 散货
2287 1:400散+托 → 散货/托盘, 2333 1:500散+托 → 散货/托盘
2378 1:800散+托 → 散货/托盘

⚠️ 新图片 Y 坐标必须重新标定：用 OCR 日志对齐文本。

五、货型清理规则

def clean_cargo_type(cargo_str):
    cargo_str = cargo_str.replace('：', ':').replace(' ', '')
    # 平托/平散 → 1:1
    if '平托' in cargo_str or '平散' in cargo_str:
        return '1:1'
    # 1:XXX格式 → 保留
    match = re.search(r'1:(\d+)', cargo_str)
    if match:
        return f"1:{match.group(1)}"
    return cargo_str

最终货型格式：1:1、1:100、1:120、1:250、1:300、1:400、1:500、1:800、1:1000

六、比重推导（calc_ratio_range）

与 Excel 数据源不同，AOZHOU 使用自定义推导（非 ratio_engine）：

# 正常 1:XXX → start=XXX, end=下一个更大比的start-1
# "1:XXX以下/以内/限" → start=0, end=XXX
# 末档 → end=9999

关键规则：相同比重的多行（如 1:300 托盘 + 1:300 散货）共享同一结束比重。

七、散托类型判断

⚠️ 优先级：cargo_str 判断 > st_type 默认值。

八、价格提取（find_price_at_xy）

def find_price_at_xy(target_ys, x_min, x_max):
    # Y 容差 ±5 像素
    # X 必须在 x_min ~ x_max 范围内
    # 匹配纯数字（含小数）
    # 返回 float

• 支持 target_ys 为 list（多行范围）
• 正则：^\d+(\.\d+)?$

九、常见坑

坑1：X 坐标偏移

新图片排版不同时，价格列 X 范围需要重新标定。对照 OCR 日志逐列验证。

坑2：Y 坐标漂移

OCR 对同一图片的 Y 坐标可能有 ±3px 偏差，abs(y - target_y) <= 5 容差处理。

坑3：1000KG 可能在下一行

AKL 1000KG 搜索范围扩大到了 [y-2, y+3]。

坑4：BNE 1000KG OCR 异常

OCR 可能误读价格，需检查 1000KG > 100KG 时用 100KG 值替换。

坑5：int() 转换丢失小数

价格直接用 int() 而非 float，注意检查是否有小数价格。

🔴 坑6：凭记忆看图片 → 复制历史数据（0608惨痛教训）

错误：AKL/BNE/MEL/SYD 四个已有航线的价格，实际输出的是旧批次数据，而非 0608 图片数据。
- AKL-MU 平托：应该 32/30/30/30/30，输出成了旧数据的 32/20/19/17/17
- SYD-MU 1:300托：应该 32/32/32，输出成了旧数据的 37/37/37
- BNE 列格式：新图片是标准5列(45/100/300/500/1000)，旧脚本是非标准列(100/500/1000)

铁律：
1. ❌ 禁止"扫一眼图片"就标记为熟悉航线，凭记忆填数据
2. ✅ 必须逐行跑 RapidOCR，逐格对照 OCR 日志填入数据
3. ✅ 即使是"已有航线"，也必须基于当前图片 OCR 录入
4. ✅ ZRH/ARN/CAI 新航线数据正确，恰恰证明了「新航线 = 强制看图片 = 不出错」

🔴 坑7：OCR Y坐标段归属串位（0608教训）

错误：OCR Y=2346 的 1:800散+托=24/24 属于 MEL 段，但被错误复制到 SYD 段。
SYD 段实际末行为 Y=3315 1:500散+托=29/29/29，图中无 1:800。

铁律：每条航线提取完成后，必须回看图片确认首行和末行的货型是否正确，防止 OCR 坐标串位。

坑8：MUSTGO +5 ≠ 散托增量（0608教训）

错误：将 MUSTGO +5 / MUST GO +5 当作散托增量（散托增量=5）。
MUSTGO 是优先货物附加费，不是托盘加价。

铁律：AOZHOU 图片中 没有散托增量（无「托盘+N元/kg」字样），散托增量列全部留空。

坑9：卡车转运段不提取（0608教训）

错误：提取了「BNE/ADL/PER 中转统配 JL/HO/TG/PR」和「SYD/MEL 中转统配 NH/JL/TG/5J/AI/PR」。
这些都是 卡车转运/地面运输价格，非空运报价，不应提取。

铁律：图片中含「中转」「统配」「卡车点」等字样的段落 → 跳过不提取。

坑10：OCR 未捕获货型标签时禁止猜测（0608教训）

错误：CK-AKL 首行 OCR 未捕获货型标签（Y=604 仅有数字 40/33/33/33/33），猜测填「散托」。
实际应为「平托→1:1」。

铁律：OCR 缺失货型标签时，对照图片人工确认，不能凭价格高低推测货型。

坑11：图片中斜杠（/）价格不得补填（0608教训）

错误：MEL 1:800 图片中 300KG 列为斜杠（/），脚本中填入了 24。
1:800 比率下 300KG 不在报价范围，应为空。

铁律：图片标注「/」的格子 → 输出留空，禁止用相邻列价格补填。

坑12：全段同价货物不拆分比率（0608教训）

错误：早期将「平托」一行拆分成多个比率段（1:1→1:100→1:200→...），产生重复数据。

铁律：平托/平散/单机 等全段同价货物 → 单行输出，范围 0→9999，货型 1:1。

#11 ZRH/ARN（MU）

坑13：002图片结构频次规范化（0803新增）

DAILY→Daily，天天→Daily，D246/D1357保留。统配段MU737+MU739合并为MU航司。含"中转"/"统配"/"卡车点"字样段跳过不提取。

坑14：散/托双行 vs 散+托单行的判定方法（0824新增，ZRH结构）⚠️ 判定规则

背景：ZRH 型图片（MU直飞欧线）中，同一货型档位可能是「散/托不同价双行」或「散托同价单行」，判定依据是图片本身的三层特征，不得凭记忆：

判定特征（三层证据，来自本次 OCR 日志）：
1. 价格格自带散/托前缀：某档价格格显示为「散19」「托 21」（数字前有散/托文字）→ 该档散托不同价，拆为两行输出（散行散托类型=散货，托行=托盘），两行共享同一比重区间
2. 货型标签 Y 坐标居中：合并标签如「1:250散+托」的 Y 坐标正好位于上下两行价格之间（如 y447 夹在 y433 散价与 y459 托价中间）→ 合并单元格垂直居中，覆盖两行
3. 纯数字价格 + 同行标签：货型标签「1:300散+拖」与其价格（纯数字无前缀）在同一 Y 行 → 散托同价，单行输出，散托类型=散货/托盘（注意「拖」是 OCR 对「托」的形近误读）

输出规则：
- 散/托双行：两行比重区间相同（如 1:250 均为 100-250），散托类型分别为散货/托盘
- 散+托单行：一行，散托类型=散货/托盘
- 历史脚本结构仅作交叉验证参考，价格数字必须来自本次图片 OCR（铁律）

十、脚本模板

脚本模板：e:/FCI-RATE/.workbuddy/tools/extract_aozhou.py
图片：用户提交（可通过命令行参数指定）

新图片时需更新：
1. 所有目的地的 OCR 数据 → 手动录入 data 数组
2. 生效日期（对应图片标题日期）
3. 备注信息（MUSTGO 仅放备注列）
4. 确认无卡车转运段数据
5. 确认散托增量全部为空
6. 逐像素核对 OCR 数据与图片一致
7. 0615 这类长图可按主运价分段处理：AKL、BNE、ADL、MEL、SYD；中间的“中转统配/卡车点”整段跳过
8. 目的港、备注、航司只取主运价区；不要把中转统配段混入主表