houhuan c06e3e55f9 docs: 更新指南和API以反映智能文件识别功能

更新 OPENCLAW_GUIDE.md 文档，强调新的全自动智能模式，简化用户操作说明。
同时修改 headless_api.py 的默认处理逻辑，使其能自动识别输入文件类型（图片或Excel）并路由到相应处理流程，提升用户体验。

2026-03-30 15:40:19 +08:00

2.7 KiB

Raw Blame History

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

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

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

headless_api.py 是系统的统一命令行入口。它现在支持智能文件类型识别，大多数情况下 OpenClaw 无需携带任何参数。

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

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

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

# 场景 2: 处理指定的任意文件 (图片或 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. 字段与逻辑变更 (v2.1)

2.1 蓉城易购 (Rongcheng)

条码位置：固定映射到 E列 (Index 4)。
数量逻辑：固定映射到 N列 (Index 13)。直接提取数值，不进行任何单位或规格换算。
单价与金额：Q列 (单价) 和 S列 (金额)。
条码分裂：若条码包含 /, ,, ，, 、 等分隔符，系统将自动均分数量。

2.2 烟草公司 (Tobacco)

条码位置：固定映射到 B列 (Index 1)。
数量换算：映射 G列 (订单量)，最终数量 = 订单量 x 10。
单价换算：映射 E列 (批发价)，最终单价 = 批发价 / 10。
金额逻辑：H列 (金额)。不看规格，直接按数量*单价逻辑填充。

3. OpenClaw 集成策略

3.1 任务分发逻辑

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

收到图片 -> 调用默认模式。
收到 Excel -> 调用 --excel 模式（推荐，支持全自动识别）。
用户明确要求“强制蓉城” -> 调用 --rongcheng。
用户明确要求“强制烟草” -> 调用 --tobacco。
用户纠正条码错误 -> 调用 --update-mapping。

3.2 错误码与返回值

0：处理成功，输出结果文件绝对路径。
1：处理失败，详细错误信息在 stderr。
WARNING： stderr 中包含 Price validation found... 表示价格差异过大。

版本：2.1 | 更新日期：2026-03-30

2.7 KiB Raw Blame History Unescape Escape