# 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*