houhuan fefcfe4595 feat(headless_api): 扩展条码映射功能，支持倍数、单价和规格配置

- 修改 update_barcode_mapping 函数，新增 multiplier、unit、price、spec 参数
- 支持特殊倍数处理（如箱转瓶）、固定单价和规格配置
- 更新命令行参数，增加 --multiplier、--unit、--price、--spec 选项
- 完善映射配置结构，支持多字段描述
- 同步更新 OPENCLAW_GUIDE.md 文档说明新功能

2026-03-31 11:38:07 +08:00

2.0 KiB

Raw Blame History

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

# --- 条码映射与特殊处理指令 ---

# 1. 简单的条码映射 (旧条码 -> 新条码)
python headless_api.py --update-mapping --barcode "123" --target "456"

# 2. 特殊倍数处理 (例如某条码识别为1件，实际需换算为30瓶)
python headless_api.py --update-mapping --barcode "690123" --multiplier 30 --unit "瓶"

# 3. 固定单价与规格
python headless_api.py --update-mapping --barcode "690123" --price 3.5 --spec "1*30"

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

2.0 KiB Raw Blame History Unescape Escape