重量 OCR 接入说明

功能位置

重量 OCR 已作为功能模块并入 integration-service，不再作为独立微服务部署，不新增端口、数据库或注册服务名。

主要代码：

POST /internal/integrations/weight-ocr/batches
X-Internal-Service-Token: 内部服务令牌
Content-Type: application/json

请求示例：

{
  "inputDirectory": "batch-001",
  "outputDirectory": null,
  "cropStartRatio": 0.5,
  "horizontalTrimRatio": 0.25,
  "recursive": false
}

inputDirectory 默认相对于 WEIGHT_OCR_INPUT_ROOT，outputDirectory 默认在 WEIGHT_OCR_OUTPUT_ROOT 下按批次 ID 自动创建。接口拒绝访问两个受控根目录之外的路径。

BAIDU_OCR_ENABLED=true
BAIDU_OCR_API_KEY=百度应用的API Key
BAIDU_OCR_SECRET_KEY=百度应用的Secret Key
INTERNAL_SERVICE_TOKEN=至少32字节的内部令牌

本地默认目录：

${java.io.tmpdir}/baiyue-weight-ocr/input
${java.io.tmpdir}/baiyue-weight-ocr/output

国内服务器默认目录：

/data/baiyue/weight-ocr/input
/data/baiyue/weight-ocr/output

可选配置：

环境变量	默认值	说明
`WEIGHT_OCR_MAX_IMAGE_SIZE`	`3MB`	单张原图及裁剪图上限
`WEIGHT_OCR_MAX_IMAGE_PIXELS`	`40000000`	解码后最大像素数
`WEIGHT_OCR_MAX_BATCH_SIZE`	`50`	单批图片上限
`BAIDU_OCR_CONNECT_TIMEOUT`	`10s`	建连超时
`BAIDU_OCR_REQUEST_TIMEOUT`	`60s`	单次请求超时
`BAIDU_OCR_MIN_REQUEST_INTERVAL`	`600ms`	百度请求最小间隔
`BAIDU_OCR_MAX_QPS_RETRIES`	`3`	百度 QPS 限制重试次数

批次输出目录/
├─ batch-results.json
├─ cropped/
└─ raw/

接口和结果文件仅返回相对于受控根目录的路径，不返回服务器绝对路径。真实百度响应不写入日志，只保存在批次的 raw 目录。