From 90395eeefe5bc5ba3b152f00ce2ac14239facd95 Mon Sep 17 00:00:00 2001 From: kicer Date: Thu, 24 Sep 2026 17:04:55 +0800 Subject: [PATCH] =?UTF-8?q?image=5Ftask:=20=E4=B8=8A=E6=B8=B8=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=E8=B0=83=E7=94=A8=E5=8A=A0=20120s=20=E8=B6=85?= =?UTF-8?q?=E6=97=B6=EF=BC=88AbortSignal.timeout=EF=BC=89=EF=BC=8C?= =?UTF-8?q?=E8=B6=85=E6=97=B6=E8=AE=B0=20FAIL=EF=BC=8C=E6=9D=9C=E7=BB=9D?= =?UTF-8?q?=E5=83=B5=E5=B0=B8=20PROCESSING=20=E4=BB=BB=E5=8A=A1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- mcp/image_task/README.md | 6 +++++- mcp/image_task/src/mcp-server.js | 31 +++++++++++++++++++++++-------- 2 files changed, 28 insertions(+), 9 deletions(-) diff --git a/mcp/image_task/README.md b/mcp/image_task/README.md index 26154ea..042b1de 100644 --- a/mcp/image_task/README.md +++ b/mcp/image_task/README.md @@ -148,6 +148,7 @@ Token 仅在每次 tool call 时从 header 读取,不写入任何存储、不 | op=get 查不到任务(ID 错/已过期/服务重启过) | `200`(MCP 工具返回) | `isError: true`,提示 unknown task_id | | 智谱 API 4xx/5xx | `200`(MCP 工具返回) | 在 `op=get` 中以 `isError: true` + `task_status: FAIL` 呈现,正文含智谱返回的状态码和 body | | 网络失败 | `200`(MCP 工具返回) | 同上,`task_status: FAIL`,正文含 `fetch` 错误信息 | +| 上游挂住不回(超时 >120s) | `200`(MCP 工具返回) | 同上,`task_status: FAIL`,正文提示 timed out;不会出现永久 PROCESSING 的僵尸任务 | --- @@ -253,7 +254,7 @@ image_task/ - **单工具 + `op` 分发**:`image_task(op=create|get)`,与 `video_task` 的服务形态完全一致,agent 侧一套轮询逻辑通吃图片/视频 - **同步上游 → 异步契约**:智谱 images 接口只支持同步,所以服务自维护一张任务表来模拟异步: - `create` 本地生成 `task_id`(`randomUUID`),登记 `PROCESSING`,把同步调用丢后台(fire-and-forget),立即返回 - - 后台完成时回写 `SUCCESS`(含 URLs)或 `FAIL`(含错误) + - 后台完成时回写 `SUCCESS`(含 URLs)或 `FAIL`(含错误);上游同步调用带 120s 超时(`AbortSignal.timeout`),超时记 `FAIL`,杜绝僵尸 `PROCESSING` - `get` 只读本地表,不碰上游 - 表为进程内存 Map:已完成任务保留 1 小时(TTL)、容量上限 1000,每次 `create` 顺带淘汰;**容器重启后任务丢失**,`get` 会报 unknown task_id;**不适用于多副本部署**(表不互通) - token/model 在 `create` 那一刻从请求 header 捕获进闭包,后台完成前不再读取,保持「每请求读 header」的无状态设计 @@ -283,6 +284,9 @@ A: 不需要。Model header 在每次 `tools/call` 都从当前请求读取, **Q: 上游是同步接口,为什么对外做成异步?** A: 为了和 `video_task` 保持同一套任务型契约,agent 侧只需维护一种「create 后轮询 get」的调用模式。同步调用被放到后台执行,对 AI 而言表现为标准异步任务。 +**Q: 任务一直 PROCESSING 会不会没完没了?** +A: 不会。上游同步调用封顶 120s(`AbortSignal.timeout`),超时直接记 `FAIL`,`get` 会拿到明确的 timed out 错误;不存在僵尸任务。 + **Q: create 之后服务容器重启了,get 会怎样?** A: 任务表在进程内存里,重启即丢失,`get` 会返回 unknown task_id 的 `isError`。需要重新 `create`。图片生成只跑几秒,受影响窗口很小;若将来要上多副本或需要可靠恢复,再把表换成持久化存储。 diff --git a/mcp/image_task/src/mcp-server.js b/mcp/image_task/src/mcp-server.js index 336a23c..c77f058 100644 --- a/mcp/image_task/src/mcp-server.js +++ b/mcp/image_task/src/mcp-server.js @@ -10,6 +10,10 @@ const ZHIPU_API_URL = "https://open.bigmodel.cn/api/paas/v4/images/generations"; const DEFAULT_MODEL = "CogView-3-Flash"; +// 上游同步调用耗时上限(出图几十秒量级,留足余量)。 +// 超时后任务记为 FAIL,避免上游挂而不回时永远卡在 PROCESSING。 +const UPSTREAM_TIMEOUT_MS = 120_000; + // ── 优雅退出 ────────────────────────────────────────────────────────────── // 容器里 node 以 PID 1 运行且未注册 SIGTERM 处理器时,内核不会对其执行默认 // 终止动作,docker stop/restart 会白等满 10s 宽限期才被 SIGKILL。 @@ -79,14 +83,25 @@ function pickModel(headers) { async function callZhipuImagesGenerations({ token, model, prompt }) { const body = { model, prompt }; - const resp = await fetch(ZHIPU_API_URL, { - method: "POST", - headers: { - Authorization: `Bearer ${token}`, - "Content-Type": "application/json", - }, - body: JSON.stringify(body), - }); + let resp; + try { + resp = await fetch(ZHIPU_API_URL, { + method: "POST", + headers: { + Authorization: `Bearer ${token}`, + "Content-Type": "application/json", + }, + body: JSON.stringify(body), + signal: AbortSignal.timeout(UPSTREAM_TIMEOUT_MS), + }); + } catch (e) { + // AbortSignal.timeout 中止时抛 TimeoutError/AbortError, + // 转成普通错误后由 runImageTask 回写 FAIL + if (e?.name === "TimeoutError" || e?.name === "AbortError") { + throw new Error(`Upstream request timed out after ${UPSTREAM_TIMEOUT_MS} ms`); + } + throw e; + } const text = await resp.text(); let data; try {