houhuan
fefcfe4595
- 修改 update_barcode_mapping 函数，新增 multiplier、unit、price、spec 参数 - 支持特殊倍数处理（如箱转瓶）、固定单价和规格配置 - 更新命令行参数，增加 --multiplier、--unit、--price、--spec 选项 - 完善映射配置结构，支持多字段描述 - 同步更新 OPENCLAW_GUIDE.md 文档说明新功能
54 lines
2.0 KiB
Markdown
54 lines
2.0 KiB
Markdown
# OCR 订单处理系统 - OpenClaw 对接指南 (v2.2)
|
||
|
||
## 1. 核心接口说明 (headless_api.py)
|
||
|
||
`headless_api.py` 是系统的统一命令行入口。它支持**智能文件类型与供应商识别**，OpenClaw 通常**无需携带任何功能参数**。
|
||
|
||
### 1.1 全自动智能模式 (推荐方式)
|
||
无论是收到**图片**还是 **Excel**，都可以直接调用。系统会自动判断文件类型：如果是 Excel 则自动识别供应商指纹（蓉城、烟草、杨碧月等）并处理；如果是图片则先 OCR 后再智能处理。
|
||
|
||
```bash
|
||
# 自动处理 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 显式特殊指令 (备用)
|
||
仅在自动识别失效或需要特殊操作时使用。
|
||
```bash
|
||
# 强制指定为 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*
|