From c06e3e55f91ce482ebda718a673807f1a979ece7 Mon Sep 17 00:00:00 2001 From: houhuan Date: Mon, 30 Mar 2026 15:40:19 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E6=8C=87=E5=8D=97?= =?UTF-8?q?=E5=92=8CAPI=E4=BB=A5=E5=8F=8D=E6=98=A0=E6=99=BA=E8=83=BD?= =?UTF-8?q?=E6=96=87=E4=BB=B6=E8=AF=86=E5=88=AB=E5=8A=9F=E8=83=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 更新 OPENCLAW_GUIDE.md 文档，强调新的全自动智能模式，简化用户操作说明。 同时修改 headless_api.py 的默认处理逻辑，使其能自动识别输入文件类型（图片或Excel）并路由到相应处理流程，提升用户体验。 --- OPENCLAW_GUIDE.md | 36 ++++++++++++++---------------------- headless_api.py | 22 ++++++++++++++-------- 2 files changed, 28 insertions(+), 30 deletions(-) diff --git a/OPENCLAW_GUIDE.md b/OPENCLAW_GUIDE.md index 280d97b..633777d 100644 --- a/OPENCLAW_GUIDE.md +++ b/OPENCLAW_GUIDE.md @@ -4,36 +4,28 @@ ## 1. 核心接口说明 (headless_api.py) -`headless_api.py` 是系统的统一命令行入口。它支持多种模式，通过参数切换功能。 +`headless_api.py` 是系统的统一命令行入口。它现在支持**智能文件类型识别**，大多数情况下 OpenClaw **无需携带任何参数**。 + +### 1.1 全自动智能模式 (推荐方式) +无论是收到**图片**还是 **Excel**，都可以直接调用。系统会自动判断文件类型，如果是 Excel 则自动识别供应商指纹并处理；如果是图片则先 OCR 后再智能处理。 -### 1.1 智能 Excel 订单处理 (推荐) -当用户直接提供供应商导出的 Excel 文件时使用。**系统会自动识别文件内容特征（如：蓉城易购 RCDH、烟草公司专卖证号、杨碧月经手人），并自动路由至专用预处理流程。** ```bash -# 处理 data/input 中最新的 Excel -python headless_api.py --excel - -# 处理指定 Excel -python headless_api.py "data/input/supplier_order.xlsx" --excel -``` - -### 1.2 图片 OCR 识别 -当接收到用户发送的采购单图片时使用。OCR 识别完成后，生成的 Excel 同样会经过智能预处理。 -```bash -# 自动处理 data/input 中最新的图片 +# 场景 1: 自动处理 data/input 中最新的文件 (图片或 Excel) python headless_api.py -# 处理指定图片 -python headless_api.py "data/input/my_invoice.jpg" +# 场景 2: 处理指定的任意文件 (图片或 Excel) +python headless_api.py "data/input/my_file.jpg" +python headless_api.py "data/input/my_file.xlsx" ``` -### 1.3 显式特殊供应商处理 -仅在智能识别失效时，用于强制指定处理模式。 +### 1.2 显式特殊指令 +仅在需要强制指定特定流程时使用。 ```bash -# 显式指定：蓉城易购模式 -python headless_api.py --rongcheng +# 强制指定为 Excel 处理模式 (即便文件没有正确后缀) +python headless_api.py --excel -# 显式指定：烟草公司模式 -python headless_api.py --tobacco +# 强制映射条码 +python headless_api.py --update-mapping --barcode "123" --target "456" ``` ## 2. 字段与逻辑变更 (v2.1) diff --git a/headless_api.py b/headless_api.py index 0641ddf..710581f 100644 --- a/headless_api.py +++ b/headless_api.py @@ -121,17 +121,23 @@ def run_pipeline(args): # OrderService.process_excel 内部会自动调用 _check_special_preprocess final_excel = order_service.process_excel(input_path) - # 5. 图片 OCR 处理 (默认) + # 5. 智能处理 (默认逻辑：自动判断图片还是 Excel) else: - input_path = args.input or get_latest_file("data/input", [".jpg", ".jpeg", ".png", ".bmp"]) + input_path = args.input or get_latest_file("data/input", [".jpg", ".jpeg", ".png", ".bmp", ".xlsx", ".xls"]) if not input_path: - print("ERROR: No input image found.", file=sys.stderr) + print("ERROR: No input file found in data/input.", file=sys.stderr) return None - logger.info(f"开始 OCR 处理图片: {input_path}") - ocr_service = OCRService(config_manager) - excel_intermediate = ocr_service.process_image(input_path) - if excel_intermediate: - final_excel = order_service.process_excel(excel_intermediate) + + ext = os.path.splitext(input_path)[1].lower() + if ext in [".xlsx", ".xls"]: + logger.info(f"智能识别为 Excel 文件，开始处理: {input_path}") + final_excel = order_service.process_excel(input_path) + else: + logger.info(f"智能识别为图片文件，开始 OCR 处理: {input_path}") + ocr_service = OCRService(config_manager) + excel_intermediate = ocr_service.process_image(input_path) + if excel_intermediate: + final_excel = order_service.process_excel(excel_intermediate) # 6. 后续处理 (校验与输出) if final_excel: