OCR 订单处理系统 - OpenClaw 对接指南 (v2.2)

1. 核心接口说明 (headless_api.py)

headless_api.py 是系统的统一命令行入口。它支持智能文件类型与供应商识别，OpenClaw 通常无需携带任何功能参数。

1.1 全自动智能模式 (推荐方式)

无论是收到图片还是 Excel，都可以直接调用。系统会自动判断文件类型：如果是 Excel 则自动识别供应商指纹（蓉城、烟草、杨碧月等）并处理；如果是图片则先 OCR 后再智能处理。

# 自动处理 data/input 中最新的文件 (图片或 Excel)
python headless_api.py

# 处理指定的任意文件 (图片或 Excel)
python headless_api.py "data/input/my_file.jpg"
python headless_api.py "data/input/my_file.xlsx"

1.2 显式特殊指令 (备用)

仅在自动识别失效或需要特殊操作时使用。

# 强制指定为 Excel 处理模式
python headless_api.py --excel

# 强制更新条码映射关系
python headless_api.py --update-mapping --barcode "123" --target "456"

2. 字段与逻辑变更

2.1 蓉城易购 (Rongcheng)

条码映射：E列 (Index 4)。
数量逻辑：N列 (Index 13)。直接提取，不进行单位换算。
条码分裂：支持 / , ， 、 分隔符自动均分。

2.2 烟草公司 (Tobacco)

条码映射：B列 (Index 1)。
数量逻辑：G列 (订单量) x 10。
单价逻辑：E列 (批发价) / 10。

2.3 杨碧月 (Yang Biyue)

自动对齐：自动识别经手人并对齐“商品条码”、“数量”、“单价”等标准列。

版本：2.2 | 更新日期：2026-03-31

1.7 KiB Raw Blame History Unescape Escape