ETERNITY 价格提取 Skill

提取 ETERNITY 空运运价（OCR 图片 / 手动录入）→ 24列标准输出 → 上传 WPS。

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

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

一、核心参数（全部路线共享）

通用提取规则

二、强制流程

1. 确认输入类型（OCR图片 或 手动录入Excel）
2. OCR图片型：ocr_utils.scan_to_log() 扫描 → 日志 → 对照手动录入数据
3. 手动录入型：直接读取数据表
4. 生成 24 列 DataFrame
5. 保存 → 上传 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, check_env

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

三、16 条路线配置表 ⚠️ 核心参考

3.1 索引表

3.2 路线详细规则

#1 LHR（MU/CA）⚠️ 0713 更新

#2 TPE（CZ/CK）⚠️ 跳转点

#3 BKK/SIN/HAN（CK）

#4 HAN（CA）⚠️ 45KG全N/A

#5 HKG（CK）

#6 AMS（CZ/CK/CA）

#7 LAX（CZ/CK/CA）

#8 ORD（CZ/CK/CA/KE）

#9 FRA（CZ/CK/CA/LH）

#10 JFK（CA/QF/KE）

#11 NLU（CZ）

#12 YYZ（CZ/MU/KE）

#13 HAN/SGN/DAD（VN）⚠️ 0713 更新

#14 SGN（CZ）

#15 NRT/KIX（CZ/CK）⚠️ 日本双港

#16 ICN（CK/CZ）

#24 CZ腹舱直达（CZ）

#25 HO（HO）⚠️ 多目的地 + 澳线中转

#26 CK亚大线直飞（CK）

四、OCR 提取模式（部分路线）

部分路线通过 OCR 日志辅助，但数据实际为手动录入。

# 标准 OCR 日志记录
ocr = RapidOCR()
ocr_result, _ = ocr(IMAGE_PATH)

for item in ocr_result:
    box, text = item[0], item[1]
    y, x = int(box[0][1]), min(box[0][0], box[1][0])
    # 日志记录，供人工校正

五、数据录入模式

多数 ETERNITY 脚本使用硬编码手动录入：

# 模式1：纯硬编码（如 AMS）
data = [
    ('1:100', '', '', '', 0, 100, '散货', '单询'),
    ('1:200', 44, 44, 44, 200, 249, '散货', ''),
    ...
]

# 模式2：从手动录入Excel读取（如 VN HAN/SGN/DAD）
df_raw = pd.read_excel(INPUT_FILE)
# 列名映射 + 标准24列输出

六、货型与比重规则

货型转换表

比重起始规则（1:1 档）

七、散托类型判断

与全局规则一致：

1. 备注含 +N → 散货，增量=N
2. 无增量但货型含"托" → 托盘
3. 无增量含"散" → 散货
4. 默认 → 散货/托盘

八、常见坑

坑1：CA-HAN 45KG 全 N/A

货机直飞无 45KG 报价，不能填 0 或 fallback。

坑2：TPE 跳转点

中转地必须填入跳转点列而非转运点列。

坑3：航司简化

OCR 可能读到 CK257/CZ313 等含数字的航司，必须简化。

坑4：BKK/SIN/HAN 多港一行

三个目的地共享同一价格表，每行产出 3 条记录。

坑5：NRT/KIX 不同频次

CZ8309:Daily, CK241:D36, CK247:D26，不能统一。

坑7：单询行不提取（0525新增，0615补充）

重量段价格全为非数字（如"单询"）的行跳过不提取。
仅提取所有价格列为有效数字的行。

0615 AMS 教训：图片第一行 1:100以下 单询 靠45 50 表示价格为空，不能生成记录；其中 靠45 50 是说明文字，不是 45KG=45/50 报价，也不能写入 45KG 列。

坑8：散托增量从备注提取（0525新增）

备注含 托盘+X元/KG 或 托盘+X → 散货，增量=X。
例如：托盘+1元/KG → 散托类型=散货，散托增量=1。
无托盘声明 → 散货/托盘，增量空。

坑9：OCR 价格数字识别错误（0525新增）

OCR 可能将 41→21 看错。每行价格必须人工对照图片逐行核实，不能信任自动 OCR 结果。

坑10：合并单元格托散同价被误继承 + 覆盖范围误判（0525新增，0601补充）

当「托散同价」在合并单元格中垂直居中时，合并范围内的空行会错误继承上行的「托盘+N」备注。
规则：遇到合并单元格备注，合并范围内所有行共享同一备注和散托类型，不能逐行独立继承。

⚠️ 0601 补充（NLU 线路）：OCR 可能将合并单元格首行（如 1:400）的「托散同价」错误识别为「托盘+2元/kg」，
导致合并覆盖范围起止行误判。必须人工对照原始图片确认合并单元格的实际覆盖起止行。

坑11：逐行核实备注，禁止批量推断（0525新增）

同一价格表中不同货型可能有不同增量值（如 1:167 托盘+4 但左右行是+2）。
规则：每行备注必须逐行人工核对，不能批量假定相邻行相同。散托增量不可跨行继承。

坑12：频次从「其他说明」合并取最大值（0525新增）

多航司表格底部「其他说明」中列出各航司频次（CA DAILY, QF D3/7, KE D1-7），
取所有航司中频次最高者作为统一输出（如 KE D1-7 → Daily）。

坑13：航班号不放跳转点（0525新增）

跳转点列仅用于中转地三字码（如 TPE 的跳转点模式）。
航班号（CZ8309/CK241 等）不属于跳转点，应放入备注列或忽略。

坑21：HO 航线「暂时不接」与「平散-2」处理（0713新增）

症状：HO 图片中 BKK/HAN 行标注 天天暂时不接，SYD/MEL 行标注 平散-2。
规则：
- 暂时不接 不是停飞，价格仍然存在，整行保留，备注中体现该状态。
- 平散-2 是无处放置的货型/调整说明，整入 Remark 列。
- HO 澳线中转（ADL/BNE/PER）Remark 统一为 PVG SYD/MEL中转 接第二天卡车，跳转点=SYD,MEL；中转行无航班数字，频次留空。

坑22：底部黄色卡车转运表格 → 一律不提取（2026-09-23 全局规则，推翻 0803 旧规）⚠️

症状：欧线价格表底部有黄色区块，列标题通常是 转运点（XXX转…） / 单价（+100kgs）/KG / Min，
每行一个卡车转运目的地（多城市可能用 / 拼接，如 MAN/BHX/EMA）。LHR 已知，FRA/AMS/FCO 等同样适用。

★ 现行规则（2026-09-23 用户拍板，ETERNITY 全局）：这类行没有主价格（45/100/300/500/1000KG 五档全空），
只有卡车转运费，属于中转点数据 → 整块跳过，不生成任何行。来源：0921 批次 muca_lhr_001.png 用户反馈
「你看你提取的最后一些数据，没有价格的，属于中转点数据，不应该提取」，确认为全局新规则。

边界（别扩大化）：
- 只豁免「底部黄色转运表」这种无主价格的行。
- 主价格行本身带中转标注的照常提取——如 HO 澳线 ADL/BNE/PER（有价格，跳转点=SYD,MEL）、VN 线 HAN/SGN 中转区块、
TPE 跳转点模式，这些不属于本坑范围，维持原规则。
- 若某张图用户明确要求把转运表提回来（个案），以当次指令为准，不改本全局规则。

❌ 已废弃规则（0803 版）：~~转运表提取为转运点行（跳转点=空运到达机场、转运点=卡车终点、
转运费增量值=单价、最低收费=Min、价格列全留空、货型1:1、比重0~9999）~~ —— 2026-09-23 起不再执行。
历史批次（0803/0817/0824 等）的 LHR 输出里含转运点行，属旧规产物，不追溯清理，除非用户点名。

坑23：VN 越南线「暂时封舱」与二程频次处理（0713新增）

症状：VN 图片中部分行（如 PER、JNB）标注 暂时封舱，其他说明列含 二程窄体/二程宽体/二程1宽/二程天天宽。
规则：
- 暂时封舱 不是停飞，价格仍然存在，整行保留，备注中体现该状态。
- 频次仅在有明确 天天 字样时输出 Daily（如天天窄体、天天宽体、二程天天宽）；二程窄体/二程宽体/二程1宽 等无明确数字时频次留空，整句放入 Remark。
- 左侧标注 HAN/SGN中转 的区块，跳转点统一填 HAN,SGN；直达行留空。
- 货型统一为 1:1，散托类型 散货/托盘。

九、脚本模板分布（使用时取最新版本）

十、印度/孟加拉/斯里兰卡 手动录入模式（0526新增）

10.1 触发场景

用户发送手动录入的价格文本（非图片），通常以"周二上午千亚印度仓报更新收货"起头。

10.2 索引表

10.3 通用规则

• 生效日期：从文本日期（如"周二"）推导，当天或次日
• 货型转换：平托→1:1(托盘), 平散→1:1(散货), 1:250/1:300/1:500/1:1000 保留
• 比重链式：1:1→1:250→1:300→1:500→1:1000→9999
• 45KG 默认留空（手动录入通常不报45KG价）
• 所有重量段（100/300/500/1000）填充同一价格（除非明确标注）

10.4 特殊航线规则

CMB ⚠️ 复杂格式

「平29」＝ 全重量段同价 29（不属于 200KG 起限制）
「200KG起 1:200 27」＝ 45KG/100KG 留空，300/500/1000=27
结构：

抛货区（各自独立区间，全段同价）:
  1:80(0→80), 1:100(0→100), 1:120(0→120)
平货区（链式）:
  1:1(0→200)  — 全段同价
  1:200(200→300)  — 45/100空
  1:300(300→9999) — 45/100空

DAC ⚠️ 复杂格式

抛货: 1:120(0→120), 1:100(0→100), 1:80(0→80)
普货: "+100 15" = 100KG重量段价格=15 ⚠️
      "+300 14.5" = 300KG=14.5（不是比重！）

城市差异：上海有抛货+普货，杭州仅有普货（无抛货 1:80-1:120）

MH-MAA ⚠️ 泡托/泡散

平托(1:1) → 1:80泡托 → 1:100泡托 → [链式1:250-1:1000]
平散(1:1) → 1:80泡散 → 1:100泡散 → [同上链式]

泡货插入低比重档，改变链式结构。

10.5 常见坑

坑14：CMB「平」全段同价 ≠ 200KG起限制（0526新增）

「平29 200KG起 1:200 27」中，「平29」是不属于 200KG 起的独立条目，
全重量段同价 29。仅有「1:200」和「1:300」受 200KG 起限制。

坑15：「+100」在 DAC 中是重量段，非比重（0526新增）

手动录入文本中「+100 15」表示 100KG 重量段价格=15，
和「1:100」完全不同。不能当成货型处理。

坑16：泡托/泡散改变链式比重结构（0526新增）

MH-MAA 中「1:80泡托」「1:100泡托」是独立的低比重档（0-100区），
与标准链式「0→250→300→500→1000→9999」结构不同。

坑17：城市间航线覆盖不全（0526新增）

CX-DAC 抛货仅上海有，杭州只有普货部分。
不能默认所有城市都有全部货型。

10.6 脚本模板

🔴 坑18：复制旧数据当「不变」→ 全部价格错误（0608教训）

严重错误案例：0608 批次提取短航线9条时，凭肉眼扫一眼图片就标记「与0601不变」，直接复制了 0601 脚本的数据，导致 NLU 和 LAX 两条远程航线价格被严重低估。

实际情况：
- NLU: 0601 为 38/41/45/49/…，0608 实际为 43/47/53/59/…（涨+5~+12）
- LAX: 0601 为 36/38/42/48/…，0608 实际为 39/41/45/51/…（涨+3~+5）
- 其余7条短航线（BKK/SIN/HAN/CA HAN/HKG/TPE/SGN/VN/NRTKIX）确实不变

铁律：
1. ❌ 禁止凭「看起来一样」复制旧数据
2. ✅ 每个新批次必须逐格 OCR 核实全部价格
3. ✅ 标记「不变」前必须跑 RapidOCR，逐行逐列对比
4. ✅ 手工录入脚本中的 data 数组必须来自本次 OCR 结果，不是旧脚本复制
5. ✅ 看到“单询 / 单询价 / 价格空白”时整行跳过，不生成任何重量段价格

🔴 坑19：散托类型/增量全量硬编码，未逐行提取「其他说明」列（0608教训）

错误案例：NLU 和 LAX 脚本中 '散托增量': 2 和 '散托类型': '散货/托盘' 在 records.append() 中对所有行硬编码，完全忽略了图片「其他说明」列的逐行差异。

实际情况（NLU）：
- 1:80~1:200 其他说明「托盘+2元/kg」→ 散货, 增量=2
- 1:250~1:300 其他说明「托盘+1元/kg」→ 散货, 增量=1（⚠️ 与上方不同）
- 1:400~1:1000 无托盘+N / 托散同价 → 散货/托盘, 增量=空

修复方式：data 数组中每行独立声明 st_type 和 increment，records.append() 使用行级值而非全局常量。

铁律：
1. ❌ 禁止在 records.append() 中硬编码 '散托增量': 2 或 '散托类型': '散货/托盘'
2. ✅ data 数组中每行必须包含独立的散托类型和散托增量字段
3. ✅ 「其他说明」列有「托盘+N」→ st='散货', inc=N
4. ✅ 「其他说明」列为空或「托散同价」→ st='散货/托盘', inc=''

经验10：ETERNITY 提取验证清单 ✅

每次 ETERNITY 提取完成后必须核对：
1. 每条航线的价格是否来自当前批次图片（非旧批次复制）
2. NLU/LAX/FRA/AMS/LHR/JFK/ORD/YYZ 等远程航线价差是否合理
3. 散托增量（托盘+N）是否正确提取，逐行对照「其他说明」列，禁止全局硬编码
4. 散托类型：有托盘+N → 散货，无 → 散货/托盘
5. 45KG 列是否按图片正确处理（有/无/N/A）
6. 频次是否清洗干净（无中文杂质）
7. "单询"行是否已跳过；靠45/50 等说明文字不得误填 45KG 价格列
8. 底部黄色转运表（若图片存在）是否已按坑22 整块跳过不提取（2026-09-23 全局规则）；欧线图（LHR/FRA/AMS/FCO/BCN/MAD/MXP 等）默认检查——出现转运点行即为错。