feat(接口2/3): 加 use_mask 开关用于遮罩对比；网关回退纯透传

- 接口3 generate_grow_b 增加 use_mask（默认 true）：false 跳过检测、
  直接送划线图（空遮罩）
- 接口2 generate_grow_results 增加 use_mask：false 用干净原图+空遮罩，
  只跑一次 ComfyUI、N 项复用
- app.py 接口2/3 增加 use_mask form 参数并透传
- gateway/app.py 回退为纯透传（移除 OpenAPI schema 注入，请求体原样转发）
- docs 补 use_mask 说明

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

hairline/service.py

@@ -128,9 +128,12 @@ def generate_previews(image_bgr: np.ndarray, gender: str):
     return results
 
 
-def generate_grow_results(image_bgr: np.ndarray, gender: str):
+def generate_grow_results(image_bgr: np.ndarray, gender: str, use_mask: bool = True):
     """该性别全部发际线：预览图(白线) + 生发图(ComfyUI)。同步、串行。
 
+    use_mask（默认 True）：是否启用 inpaint 遮罩，用于测试对比（同接口3）。
+      False 时用**干净原图 + 空遮罩**送 ComfyUI（不烧黑色模板线），与模板无关，
+      故只跑一次 ComfyUI、N 项复用同一张生发图；预览图（白线）仍按各模板生成。
     Returns: list[dict] {"hairline_type","order","image_bgr"(预览), "grown_png"(bytes 或 None)}。
     无人脸返回 None。某张 ComfyUI 失败时该项 grown_png=None，不影响其余。
     """
@@ -140,21 +143,36 @@ def generate_grow_results(image_bgr: np.ndarray, gender: str):
     if ctx is None:
         return None
     uv, ext_faces = load_ext_mesh()
+
+    # 禁用遮罩：干净原图 + 空遮罩，与模板无关 → 只跑一次 ComfyUI，下面 N 项复用
+    shared_grown = None
+    if not use_mask:
+        try:
+            h, w = image_bgr.shape[:2]
+            buf = io.BytesIO()
+            compose_comfy_rgba(image_bgr, np.zeros((h, w), np.uint8)).save(buf, format="PNG")
+            shared_grown = comfyui.run(buf.getvalue())
+        except Exception as e:  # noqa: BLE001
+            logger.warning("接口2 生发图失败(无遮罩)：%s", e)
+
     results = []
     for order, (key, white_path) in enumerate(get_texture_map()[gender], start=1):
         white = load_texture_rgba(white_path)
         preview = render_hairline_overlay(image_bgr, ctx["points"], ext_faces, uv, white)
 
-        grown_png = None
-        try:
-            black = load_texture_rgba(_black_texture_path(white_path))
-            marked, mask = build_inpaint_mask(
-                image_bgr, ctx["landmarks"], ctx["parse_map"], ctx["points"], black)
-            buf = io.BytesIO()
-            compose_comfy_rgba(marked, mask).save(buf, format="PNG")
-            grown_png = comfyui.run(buf.getvalue())
-        except Exception as e:  # noqa: BLE001  单张失败不拖垮整请求
-            logger.warning("接口2 生发图失败 type=%s：%s", key, e)
+        if not use_mask:
+            grown_png = shared_grown
+        else:
+            grown_png = None
+            try:
+                black = load_texture_rgba(_black_texture_path(white_path))
+                marked, mask = build_inpaint_mask(
+                    image_bgr, ctx["landmarks"], ctx["parse_map"], ctx["points"], black)
+                buf = io.BytesIO()
+                compose_comfy_rgba(marked, mask).save(buf, format="PNG")
+                grown_png = comfyui.run(buf.getvalue())
+            except Exception as e:  # noqa: BLE001  单张失败不拖垮整请求
+                logger.warning("接口2 生发图失败 type=%s：%s", key, e)
 
         results.append({"hairline_type": key, "order": order,
                         "image_bgr": preview, "grown_png": grown_png})