houhuan/orc-order-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
708402c7fb
orc-order-v2/OPENCLAW_GUIDE.md
houhuan 3e2f46d26d docs(openclaw): 更新对接指南并重构蓉城易购处理逻辑 
- 将蓉城易购处理逻辑从启动器迁移至专用服务类，提升代码模块化
- 更新 OpenClaw 指南，详细说明新增的多种处理模式（Excel、特殊供应商、条码映射）
- 统一 headless_api 入口，通过参数化支持不同处理流程
2026-03-30 10:15:01 +08:00

2.5 KiB
Raw Blame History

OCR 订单处理系统 - OpenClaw 对接指南 (增强版)

本指南旨在帮助 OpenClaw 实现对采购单处理系统的全功能自动化控制，涵盖图片识别、Excel 清洗、特殊供应商处理及条码映射管理。

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

headless_api.py 是系统的统一命令行入口。它支持多种模式，通过参数切换功能。

1.1 图片 OCR 识别 (默认模式)

当接收到用户发送的采购单图片时使用。

# 自动处理 data/input 中最新的图片
python headless_api.py

# 处理指定图片
python headless_api.py "data/input/my_invoice.jpg"

1.2 纯 Excel 订单处理

当用户直接提供供应商导出的 Excel 文件时使用。

# 处理 data/input 中最新的 Excel
python headless_api.py --excel

# 处理指定 Excel
python headless_api.py "data/input/supplier_order.xlsx" --excel

1.3 特殊供应商预处理

针对格式极其特殊的供应商（如蓉城易购、烟草公司），系统内置了专用逻辑。

# 处理蓉城易购订单 (自动从 data/output 找最新订单文件)
python headless_api.py --rongcheng

# 处理烟草公司订单
python headless_api.py --tobacco

1.4 条码映射管理

当发现 OCR 识别出的条码与系统库不一致时，可通过此接口更新映射关系。

# 将原始条码 12345 映射为系统目标条码 67890
python headless_api.py --update-mapping --barcode "12345" --target "67890"

2. OpenClaw 集成策略

2.1 任务分发逻辑

OpenClaw 应根据用户输入判断调用的参数：

  • 收到图片 -> 调用默认模式。
  • 收到 Excel -> 调用 --excel 模式。
  • 用户提到“蓉城”或“易购” -> 调用 --rongcheng。
  • 用户提到“烟草” -> 调用 --tobacco。
  • 用户纠正条码错误 -> 调用 --update-mapping。

2.2 结果获取

  • 成功：脚本会在 stdout 打印生成的 Excel 绝对路径。OpenClaw 捕获此路径并发送文件。
  • 单价预警：脚本会在 stderr 输出 WARNING: Price validation found...。OpenClaw 应捕获并转述给用户：“文件已生成，但发现部分商品价格异常，请注意查看。”

3. 常见目录定义

  • data/input/：存放待处理的原始图片或 Excel。
  • data/output/：存放 OCR 识别后的中间文件（蓉城/烟草模式会从此目录读取）。
  • data/result/：最终生成的标准银豹采购单。

版本：2.0 | 更新日期：2026-03-25