feat: align surgery API with schemas and extend client tooling

- Refactor app API and schemas; adjust surgery pipeline, repository, and session manager.

- Improve consumption TSV logging and consumable vision integration; trim voice resolution.

- Add Baidu Face 1:N search script, .env.example entries, and client API integration doc.

- Update demo client, staging checklist, surgery interface doc, and related tests; add sample face image.

Made-with: Cursor

.env.example

@@ -123,6 +123,20 @@ CONSUMABLE_CLASSIFIER_TOPK=5
 # 短语音识别模型：固定普通话（默认 1537；勿用 1737 英语等）。代码会始终带上此 dev_pid。
 # BAIDU_SPEECH_ASR_DEV_PID=1537
 
+# --- Baidu Face（可选；仅 `scripts/baidu_face_1n_search.py` 批量人脸 1：N 搜索；需在控制台创建应用并开通人脸识别）---
+# BAIDU_FACE_APP_ID=
+# BAIDU_FACE_API_KEY=
+# BAIDU_FACE_SECRET_KEY=
+# 搜索的人脸组 id，逗号分隔，最多 10 个；未传命令行 --groups 时使用此项
+# 仅允许英文/数字/下划线（与控制台「用户组 id」一致），不能中文；否则 API 会报 222005
+# BAIDU_FACE_GROUP_ID_LIST=my_group_1
+# BAIDU_FACE_MAX_USER_NUM=1
+# BAIDU_FACE_MATCH_THRESHOLD=80
+# BAIDU_FACE_QUALITY_CONTROL=NONE
+# BAIDU_FACE_LIVENESS_CONTROL=NONE
+# BAIDU_FACE_CONNECTION_TIMEOUT_MS=
+# BAIDU_FACE_SOCKET_TIMEOUT_MS=
+
 # --- MinIO（语音 WAV 存桶；`docker-compose.dev.yml` 内已含 `minio` 服务；本机只跑 API 时填 127.0.0.1:9000）---
 # docker compose -f docker-compose.dev.yml up -d minio
 # MINIO_ENDPOINT=127.0.0.1:9000