2

backend/txm/doc/README.md

@@ -0,0 +1,51 @@
+使用说明
+
+1. 安装依赖：
+   ```powershell
+   pip install -r requirements.txt
+   ```
+2. 启动 Tk 测试界面：
+   ```powershell
+   python -m app.ui.tk_app
+   ```
+3. 在界面中点击“选择图片”，然后点击“识别 EAN-13”。
+
+摄像头识别
+1. 在 Tk 界面点击“摄像头识别”，程序会打开默认摄像头（`config/config.yaml` 可配置 index、分辨率与轮询间隔）。
+2. 一旦识别到任意条码（优先 EAN‑13），会自动关闭摄像头并在界面显示结果。
+3. 再次点击“停止摄像头”可手动关闭。
+
+HTTP 服务（上传识别）
+1. 启动服务：
+   ```powershell
+   python -m app.server.main
+   ```
+2. PowerShell 上传示例：
+   ```powershell
+   Invoke-RestMethod -Uri http://127.0.0.1:8000/recognize/ean13 -Method Post -Form @{ file = Get-Item .\sample.jpg }
+   ```
+3. 响应：
+   ```json
+   { "code": "6901234567892", "type": "EAN13", "others": [{ "type": "CODE128", "code": "..." }], "message": "ok" }
+   ```
+
+配置说明
+- 编辑 `config/config.yaml` 可调整预处理、ROI 过滤、解码参数；字体路径已按系统自动选择。
+- `app.server` 中的 `host/port/max_upload_mb` 控制 HTTP 服务监听与上传大小限制。
+
+注意事项
+- 该程序不会自动启动摄像头或后台任务，均需用户手动触发。
+- 若图片分辨率过低或条码倾斜严重，识别率会下降，可增大 `warp_target_height` 与 `sample_rows` 数量。
+
+Pyzbar/ZBar 安装说明
+- Windows: 直接 `pip install pyzbar` 即可（已包含 zbar DLL）。
+- macOS: 安装 zbar 库后再安装 pyzbar：
+  ```bash
+  brew install zbar; pip install pyzbar
+  ```
+- Linux (Debian/Ubuntu)：
+  ```bash
+  sudo apt-get update; sudo apt-get install -y libzbar0; pip install pyzbar
+  ```
+
+