feat(接口2): 移植head3d发际线管线 + 接口2实现方案文档

- 从head3d复制发际线检测管线到 hairline/ 包：MediaPipe Tasks + SegFormer分割
  + 17锚点射线检测 + 502点mesh(face_ext.obj)+UV
- 复制模型：face_landmarker.task(3.7MB)、SegFormer config/preprocessor
  (model.safetensors 340MB 单独下载中)
- 新增 docs/接口2-C端生发-技术实现方案.md：第一步=发际线曲线叠加预览图，
  新增gender必填参数，按性别贴图数量输出(female5/male4)，hairline_type英文key，
  服务端cv2逐三角形warp渲染器(head3d只有浏览器端Three.js渲染)
- 接口文档.md 接口2章节同步：gender参数、输出语义、错误码说明
- hairline_texture/ 9张发际线贴图入库

docs/接口文档.md

@@ -177,7 +177,9 @@
 
 ## 接口 2：C 端生发接口
 
-**说明**：输入用户正面照，输出生发后的图片，以及推荐的发际线（可能多张），并按合适度排序。
+**说明**：输入用户正面照 + 性别，按性别对应的发际线类型，逐张把建议发际线渲染到照片上，输出多张方案。
+
+> **当前阶段（第一步）**：`image_url` 返回的是「**原照片 + 发际线曲线叠加的预览图**」，尚未做真正的文生图生发；后续会替换为生发后图片。实现见 [`接口2-C端生发-技术实现方案.md`](接口2-C端生发-技术实现方案.md)。
 
 **请求**：`POST /api/v1/hair/grow`
 
@@ -187,19 +189,20 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 |------|------|------|------|
-| beauty_enabled | bool | 否 | 生发图是否带美颜效果，默认 false。提供该开关 |
+| gender | string | **是** | 性别：`male` / `female`。决定使用的发际线贴图集合 |
+| beauty_enabled | bool | 否 | 生发图是否带美颜效果，默认 false（当前阶段不生效） |
 
 ### 输出（data）
 
-`results`：发际线方案数组（可能多张），每个元素：
+`results`：发际线方案数组，**数量 = 该性别的发际线类型数**（`female` 5 个 / `male` 4 个）。每个元素：
 
 | 字段 | 类型 | 说明 |
 |------|------|------|
-| image_url | string | 生发后图片 URL |
-| hairline_type | string | 图片对应的发际线形（如：花瓣形、波浪形） |
-| order | int | 排序序号（1 = 最优，2 次之 …） |
+| image_url | string | 方案预览图 URL（当前 = 发际线叠加图） |
+| hairline_type | string | 发际线类型 key：`ellipse`/`flower`/`heart`/`straight`/`wave`（female），`ellipse`/`m`/`straight`/`inverse_arc`（male） |
+| order | int | 排序序号（当前阶段固定 `1..N`，按贴图顺序，暂不计算合适度） |
 
-### 响应示例（当前 Mock 返回值）
+### 响应示例
 
 ```json
 {
@@ -208,14 +211,14 @@
   "request_id": "mock-request-id",
   "data": {
     "results": [
-      { "image_url": "https://hair.xiangsilian.com/static/sample.jpg", "hairline_type": "花瓣形", "order": 1 },
-      { "image_url": "https://hair.xiangsilian.com/static/sample.jpg", "hairline_type": "波浪形", "order": 2 }
+      { "image_url": "https://hair.xiangsilian.com/static/annotations/uuid1.png", "hairline_type": "ellipse", "order": 1 },
+      { "image_url": "https://hair.xiangsilian.com/static/annotations/uuid2.png", "hairline_type": "flower", "order": 2 }
     ]
   }
 }
 ```
 
-> 识别失败时返回通用错误码（1001 / 1002 / 1003 等）。
+> 识别失败时返回通用错误码（1001 / 1002 / 1003 等）。`gender` 缺失或非法值返回参数错误（1008）；本接口已改为必填入参，不再自动判别性别（1004 不再使用）。
 
 ---