From 3008552331f32c1bc33368995b0e84f89acb52d4 Mon Sep 17 00:00:00 2001 From: xsl Date: Mon, 15 Jun 2026 10:51:02 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E7=BD=91=E5=85=B3):=20=E6=8E=A5=E5=8F=A34?= =?UTF-8?q?=20=E5=B7=B2=E5=AE=9E=E7=8E=B0=E8=AF=B4=E6=98=8E(=E6=97=A0?= =?UTF-8?q?=E5=9B=BE=E7=89=87=E5=AD=97=E6=AE=B5=E9=80=8F=E4=BC=A0+?= =?UTF-8?q?=E5=A4=96=E7=BD=91=E8=B1=86=E5=8C=85=E8=B0=83=E7=94=A8=E8=80=97?= =?UTF-8?q?=E6=97=B6)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 --- docs/网关-开发任务书.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/网关-开发任务书.md b/docs/网关-开发任务书.md index fb9ea86..f505438 100644 --- a/docs/网关-开发任务书.md +++ b/docs/网关-开发任务书.md @@ -206,7 +206,9 @@ sudo systemctl restart hair-gateway && sudo systemctl status hair-gateway 1. **联调依赖 worker**：阶段四之前可用**本地 stub worker**（返回 `/health` 200 + 假的 base64 图）独立开发；worker 真机就绪后再换真实地址端到端联调。 2. **接口文档是字段唯一权威**：图片字段映射表、对外字段名都以 `docs/接口文档.md` 为准，冲突时以文档为准并在 PR 说明指出。 3. **安全（先跑通后处理，已知项）**：`:28187` 当前 HTTP 明文 + 公网可达，密码明文传输；后续建议加 TLS / 内网 / IP 白名单（见架构文档 §13/§14）。本阶段不阻塞。 -4. **接口实现进度**：接口 **1/2/3/5 worker 已真实实现**（图片字段见上方映射表）；**接口 4（用户特征）仍为 mock**（无图片字段，原样透传）。 +4. **接口实现进度**：**接口 1/2/3/4/5 worker 均已真实实现**。接口 4（用户特征）返回 `features`(JSON 字符串)、 + **无图片字段，网关原样透传**；但接口4 worker 会调外网豆包视觉模型（`ark.cn-beijing.volces.com`）—— + 网关本身不受影响，但要知道该接口耗时含一次远程大模型调用（数秒）。 5. **生发图耗时**：接口 2（一次 N 张 Flux，~18s）、接口 3（~6s）经 ComfyUI 同步出图，**`request_timeout_seconds` 要调大**（建议 ≥120s），否则网关会先超时换 worker 重试。 ---