docs: update README with API and deployment guide

README.md

@@ -1,2 +1,35 @@
-# face-service
+# Face Service — 人脸识别服务
 
+## 概述
+
+基于 InsightFace (buffalo_l) 的人脸检测与识别服务，部署于 GPU 服务器，提供人脸检测、特征提取、1:1 比对、1:N 识别 API。
+
+## 模型
+
+- InsightFace buffalo_l (检测 + 识别)
+- 检测尺寸: 640×640
+- 特征维度: 512
+
+## API
+
+| 端点 | 方法 | 说明 |
+|------|------|------|
+| /api/status | GET | 服务状态和模型信息 |
+| /api/detect | POST | 人脸检测 (返回 bbox + 关键点) |
+| /api/recognize | POST | 人脸识别 (返回特征向量 + 匹配身份) |
+| /api/compare | POST | 1:1 比对 (两张人脸 → 相似度) |
+| /api/face-detect | POST | 别名: 同 /api/detect |
+| /api/face-recognize | POST | 别名: 同 /api/recognize |
+| /api/face-compare | POST | 别名: 同 /api/compare |
+
+## 部署
+
+```bash
+cd /data/ymq/face-service
+bash build.sh
+sudo systemctl restart face-service
+```
+
+## 端口
+
+9091