feat: 新增接口22生发控制与测试页

docs/接口文档.md

@@ -17,6 +17,7 @@
 | 1 四庭七眼测量 | POST | `/api/v1/face/measure` |
 | 6 四庭七眼测量 v2 | POST | `/api/v1/face/measure-v2` |
 | 2 C 端生发 | POST | `/api/v1/hair/grow` |
+| 22 生发密度与发际线高度 | POST | `/api/v1/hair/grow-22` |
 | 3 B 端生发 | POST | `/api/v1/hair/grow-b` |
 | 72 B 端五个关键点 | POST | `/api/v1/face/b-end-points` |
 | 4 用户特征 | POST | `/api/v1/face/features` |
@@ -91,7 +92,6 @@ GPU worker的所有动态接口均启用IP限制：允许本机及`ip_access.jso
 | 1006 | 文件超出大小限制 | 单文件超过 1 MB |
 | 1007 | 图片参数错误 | file / url / base64 未传，或同时传了多个（三者严格互斥） |
 | 1008 | 图片格式不支持 | 非 JPG / PNG |
-| 1009 | 未授权 | 缺少或错误的 `X-Internal-Token`（`/api/*` 路径鉴权） |
 | 1010 | 来源IP不允许 | 仅GPU worker：直连IP不在本机/白名单内，或来源/白名单配置无效；HTTP403 |
 
 ---
@@ -363,6 +363,21 @@ GPU worker的所有动态接口均启用IP限制：允许本机及`ip_access.jso
 
 ---
 
+## 接口 22 生发密度与发际线高度
+
+`POST /api/v1/hair/grow-22` 使用接口 2 的图片输入、`gender`、`hair_style` 和返回结构。
+
+| 表单字段 | 默认值 | 取值和效果 |
+| --- | --- | --- |
+| `hair_density` | 必填 | `sparse` 稀疏、`normal` 正常、`dense` 浓密。至少提交一档，多选时重复提交同名字段。提示词为「填充遮罩区域的头发，发量{描述}，人物增加一点磨皮」，三档描述依次为「稀疏」「正常」「适中偏多」。 |
+| `hairline_height` | `0` | `[-1, 1]`，`-1` 最高，`0` 正常，`1` 最低。端点相对正常位置移动眉心到下巴垂直像素距离的 10%。非零时须启用 `use_mask`。 |
+
+每个发型用一张正常高度贴图渲染预览，按请求高度移动预览线。女性 1–5 号在 WebUI 出图后移动贴回区域和重绘带。其他发型用移动后的预览曲线生成生发遮罩。
+
+例如选择两档时，表单传 `hair_density=sparse` 和 `hair_density=dense`。每个「密度 × 发型」组合返回一项，结果的 `hair_density` 字段标明对应档位。
+
+生发图与透明发际线 PNG 对齐到输入照片尺寸。测试页运行在本机 Worker 的 `/static/test_interface22.html`，扶正裁切预览依赖接口 52。
+
 ## 接口 3：B 端生发接口
 
 **说明**：医生/操作端在用户照片上用马克笔标注目标发际线后，**只需上传这一张划线图**。系统检测划线 →
@@ -476,7 +491,7 @@ GPU worker的所有动态接口均启用IP限制：允许本机及`ip_access.jso
 
 Worker 直连时图片字段使用 `_base64` 后缀。检测不到人脸返回 `1001`，非正面或标注所需点位无法取得时返回 `1003`，图片无法解码返回 `1008`。
 
-对外 42、52、72 的客户端登录、令牌验证和刷新均由 `main` 分支的网关处理。网关将 52 和 72 转发至本分支的 worker，worker 仍校验来源 IP 和网关注入的 `X-Internal-Token`。对外测试请使用网关同源的测试页。
+对外 42、52、72 的客户端登录、令牌验证和刷新均由 `main` 分支的网关处理。网关将 52 和 72 转发至本分支的 Worker，Worker 通过直连来源 IP 白名单授权。对外测试请使用网关同源的测试页。
 
 ---
 
@@ -659,7 +674,7 @@ Ft 两端保持横坐标并取平均高度，Zy 为 234 到 454 的距离。只
 
 ## 接口 52：发际线 PNG 生成接口
 
-**说明**：入参同接口2（先选性别、再多选发型）。对每个选中发型返回一张 `middle` 设计叠图与生发图。**目标上庭 =（中庭 + 下庭）÷2**，从眉心向上定位；所有形状的中点对齐同一目标。`high` / `low` 已停用，旧字段保留为 `null`。
+**说明**：入参同接口2（先选性别、再多选发型）。对每个选中发型返回一张 `middle` 设计叠图与生发图。**目标上庭 =（中庭 + 下庭）×0.45**，从眉心向上定位；所有形状的中点对齐同一目标。`high` / `low` 已停用，旧字段保留为 `null`。
 
 **请求**：`POST /api/v1/hairline/generate-52`（仅GPU worker，端口8187；本次不在网关新增路由）
 
@@ -769,12 +784,12 @@ Ft 两端保持横坐标并取平均高度，Zy 为 234 到 454 的距离。只
         "order": 1,
         "height_placement": {
           "old_center": {"x": 540.0, "y": 450.0},
-          "new_center": {"x": 540.0, "y": 430.0},
-          "shift_x_px": 0.0, "shift_y_px": -20.0, "target_error_px": 0.0
+          "new_center": {"x": 540.0, "y": 461.0},
+          "shift_x_px": 0.0, "shift_y_px": 11.0, "target_error_px": 0.0
         }
       }
     ],
-    "best_hairline_center_point": {"x": 540, "y": 430},
+    "best_hairline_center_point": {"x": 540, "y": 461},
     "high_hairline_center_point": null,
     "low_hairline_center_point": null,
     "input_image_base64": "/9j/4AAQ...",
@@ -783,14 +798,14 @@ Ft 两端保持横坐标并取平均高度，Zy 为 234 到 454 的距离。只
     "coordinate_space": "original_image",
     "framing": null,
     "height_rule": {
-      "name": "court_average", "formula": "上庭 = (中庭 + 下庭) / 2",
+      "name": "court_average", "formula": "上庭 = (中庭 + 下庭) × 0.45",
       "measurement_source": "hairline_landmarks",
       "brow_center": {"x": 540.0, "y": 740.0},
       "nose_bottom": {"x": 540.0, "y": 1050.0},
       "chin_tip": {"x": 540.0, "y": 1360.0},
       "middle_height_px": 310.0, "lower_height_px": 310.0,
-      "target_upper_height_px": 310.0, "target_upper_height_cm": null,
-      "target_center": {"x": 540.0, "y": 430.0}
+      "target_upper_height_px": 279.0, "target_upper_height_cm": null,
+      "target_center": {"x": 540.0, "y": 461.0}
     },
     "guide_landmarks": {
       "9": {"x": 540.0, "y": 740.0}, "150": {"x": 470.0, "y": 1340.0},