From 5a9bebcf71a07dd1eb59a8a571b2090c3a4f4694 Mon Sep 17 00:00:00 2001 From: kicer Date: Wed, 21 Oct 2026 21:18:45 +0800 Subject: [PATCH] =?UTF-8?q?feat(mcp):=20image=5Ftask=20=E8=BF=94=E5=9B=9E?= =?UTF-8?q?=20elapsed=20=E5=B9=B6=E6=8C=89=E8=80=97=E6=97=B6=E9=80=80?= =?UTF-8?q?=E9=81=BF=E8=BD=AE=E8=AF=A2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- mcp/image_task/README.md | 11 +++++++---- mcp/image_task/src/mcp-server.js | 23 ++++++++++++++++++++++- 2 files changed, 29 insertions(+), 5 deletions(-) diff --git a/mcp/image_task/README.md b/mcp/image_task/README.md index a2e667b..10d79a0 100644 --- a/mcp/image_task/README.md +++ b/mcp/image_task/README.md @@ -100,18 +100,18 @@ docker exec mcp_image_task node -e "fetch('http://localhost:3000/health').then(r `op=get` 按任务状态返回: -- `PROCESSING`:提示几秒后再查; -- `SUCCESS`:单个 `text` 块,摘要后跟图片 URL(单图直接给 `Image URL:`,多图按 `Image N:` 逐行列出): +- `PROCESSING`:带上已等待秒数 `elapsed`,建议等待 `min(30, 3 + floor(elapsed / 5))` 秒后再查; +- `SUCCESS`:单个 `text` 块,摘要后跟图片 URL(单图直接给 `Image URL:`,多图按 `Image N:` 逐行列出);`elapsed` 为从 `create` 到完成的总耗时: ```jsonc { "content": [ - { "type": "text", "text": "task_id: \nmodel: CogView-4\nprovider: zhipu\ntask_status: SUCCESS\nImage URL: https://..." } + { "type": "text", "text": "task_id: \nmodel: CogView-4\nprovider: zhipu\nelapsed: 12s\ntask_status: SUCCESS\nImage URL: https://..." } ] } ``` -- `FAIL`:`isError: true`,正文含 `task_status: FAIL` 与错误信息(上游 4xx/5xx、无 URL 返回等都会归档到这里)。 +- `FAIL`:`isError: true`,正文含 `task_status: FAIL`、总耗时 `elapsed` 与错误信息(上游 4xx/5xx、无 URL 返回等都会归档到这里)。 URL 由上游签名下发,**带有效期**(通常 24h),需要长期保存请及时转存。 @@ -390,6 +390,9 @@ A: 和 `video_task` 保持同一套任务型契约;同时避免一次生图把 **Q: 任务一直 PROCESSING 会不会没完没了?** A: 不会。上游调用封顶 180s,超时直接记 `FAIL`。 +**Q: 为什么 PROCESSING 时建议的等待时间会变长?** +A: 轮询间隔按 `min(30, 3 + floor(elapsed / 5))` 退避:前期密查尽快拿到结果,后期拉长间隔减少无意义轮询,封顶 30s。 + **Q: create 之后服务容器重启了,get 会怎样?** A: 任务表在进程内存里,重启即丢失,`get` 会返回 unknown task_id。需要重新 `create`。 diff --git a/mcp/image_task/src/mcp-server.js b/mcp/image_task/src/mcp-server.js index d3a24de..e674ba0 100644 --- a/mcp/image_task/src/mcp-server.js +++ b/mcp/image_task/src/mcp-server.js @@ -248,6 +248,7 @@ function runImageTask({ task, target, prompt, image }) { image, }) .then((data) => { + task.finishedAt = Date.now(); const urls = extractUrls(data); if (urls.length === 0) { task.status = "FAIL"; @@ -261,6 +262,7 @@ function runImageTask({ task, target, prompt, image }) { } }) .catch((e) => { + task.finishedAt = Date.now(); task.status = "FAIL"; task.error = `${e.message}${ e.detail ? ` Details: ${JSON.stringify(e.detail)}` : "" @@ -359,6 +361,20 @@ async function handleCreate({ args, headers }) { return { content: [{ type: "text", text: summary }] }; } +// 从 create 到完成(未完成则到当前)的累计秒数。 +// 已完成任务用 finishedAt 定格,避免它留在表里越查越大。 +function elapsedSeconds(task) { + const end = task.status === "PROCESSING" + ? Date.now() + : (task.finishedAt || Date.now()); + return Math.max(0, Math.round((end - task.createdAt) / 1000)); +} + +// 轮询退避:起步 3s,之后每多等 5s 加 1s,封顶 30s。 +function pollIntervalSeconds(elapsed) { + return Math.min(30, 3 + Math.floor(elapsed / 5)); +} + // ===== op=get:查询任务状态(只读本地表,不碰上游)===== async function handleGet({ args }) { // 与 handleCreate 同理:纯空白 task_id 应报"缺参数",而不是得到 Unknown task_id " " 这种含糊错误。 @@ -386,6 +402,8 @@ async function handleGet({ args }) { } if (task.status === "PROCESSING") { + const elapsed = elapsedSeconds(task); + const retryAfter = pollIntervalSeconds(elapsed); return { content: [ { @@ -394,9 +412,10 @@ async function handleGet({ args }) { `task_id: ${taskId}\n` + `model: ${task.model}\n` + `provider: ${task.provider}\n` + + `elapsed: ${elapsed}s\n` + `task_status: PROCESSING\n` + `\n` + - `Call op="get" again in a few seconds.`, + `Task is still processing. Sleep for ${retryAfter} seconds, then call op="get" again.`, }, ], }; @@ -411,6 +430,7 @@ async function handleGet({ args }) { text: `task_id: ${taskId}\n` + `provider: ${task.provider}\n` + + `elapsed: ${elapsedSeconds(task)}s\n` + `task_status: FAIL\n` + `error: ${task.error}`, }, @@ -428,6 +448,7 @@ async function handleGet({ args }) { `task_id: ${taskId}\n` + `model: ${task.model}\n` + `provider: ${task.provider}\n` + + `elapsed: ${elapsedSeconds(task)}s\n` + `task_status: SUCCESS\n` + `${lines}`; return { content: [{ type: "text", text: summary }] };