houhuan
32d41244e5
- 新增智能识别功能，自动检测蓉城易购、烟草公司、杨碧月订单特征 - 修改订单服务流程，在Excel处理前自动执行专用预处理 - 更新无界面API，支持智能识别模式，简化OpenClaw集成 - 完善供应商专用预处理逻辑，修复数量计算和单位换算问题 - 添加变更日志和最终更新报告文档，记录v2.1版本变更
46 lines
2.3 KiB
Markdown
46 lines
2.3 KiB
Markdown
# OCR 订单处理系统 - v2.1 更新报告
|
||
|
||
## 1. 业务逻辑变更 (Business Logic Updates)
|
||
|
||
### 1.1 智能识别与自动路由
|
||
- **功能描述**：系统现在能自动扫描 Excel 前 50 行的特征码。
|
||
- **蓉城易购**：检测到 `RCDH` 关键字时自动启用专用清洗。
|
||
- **烟草公司**：检测到 `专卖证号` 或 `510109104938` 时自动启用专用清洗。
|
||
- **杨碧月**：检测到经手人为 `杨碧月` 时自动执行列对齐预处理。
|
||
|
||
### 1.2 供应商清洗规则校准
|
||
| 供应商 | 条码列 | 数量逻辑 | 单价逻辑 | 金额逻辑 |
|
||
| :--- | :--- | :--- | :--- | :--- |
|
||
| **蓉城易购** | E列 (Index 4) | N列 (Index 13)，不换算 | Q列 (Index 16) | S列 (Index 18) |
|
||
| **烟草公司** | B列 (Index 1) | G列 (Index 6) **x 10** | E列 (Index 4) **/ 10** | H列 (Index 7) |
|
||
|
||
## 2. 系统接口与集成 (API & Integration)
|
||
|
||
### 2.1 Headless API (headless_api.py)
|
||
- **更新内容**：`--excel` 参数现在支持全自动识别模式，OpenClaw 无需再手动区分供应商。
|
||
- **日志增强**：所有详细日志通过 `stderr` 输出，`stdout` 仅保留最终结果路径，确保自动化脚本精准捕获。
|
||
|
||
### 2.2 OpenClaw 对接文档
|
||
- **文档更新**：[OPENCLAW_GUIDE.md](OPENCLAW_GUIDE.md) 已同步至 v2.1，包含最新的列映射说明和调用示例。
|
||
|
||
## 3. 测试与质量保证 (QA & Testing)
|
||
|
||
### 3.1 自动化测试
|
||
- **回归测试**：已通过 `订单1774849009841.xlsx` (蓉城) 和 `订单明细20260330133908.xlsx` (烟草) 的实测验证。
|
||
- **单价校验**：集成了银豹标准进货价对比功能，差异超过 1.0 元时自动触发警告。
|
||
|
||
### 3.2 风险清单与回滚方案
|
||
- **风险**：若供应商 Excel 格式发生重大列位移（非上述索引），自动处理可能失效。
|
||
- **回滚方案**：可通过 `git checkout v2.0` 回退至上一稳定版本。
|
||
- **监控**：建议 OpenClaw 监控 `stderr` 中的 `ERROR` 关键字并实时预警。
|
||
|
||
## 4. 变更日志 (Changelog)
|
||
- `[FIX]` 修复了蓉城易购条码分裂导致的数量计算错误（30 变 5）。
|
||
- `[FIX]` 修复了烟草订单单价计算未除以 10 的问题。
|
||
- `[NEW]` 实现了基于 `header=None` 的全局智能指纹识别。
|
||
- `[OPT]` 移除了 UI 界面中冗余的验证匹配按钮，精简流程。
|
||
|
||
---
|
||
*报告生成日期：2026-03-30*
|
||
*负责人：Trae Code Assistant*
|