From 89f596ea64b625028f70c42f89d02826fda6ffef Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E4=BA=94=E9=A6=99=E4=B8=B8=E5=AD=90?= <15518898337@163.com>
Date: Fri, 5 Jun 2026 14:51:22 +0800
Subject: [PATCH] fix(jump-hop): extend creation timeout

---
 ...�玩法创作】平�入�与玩法链路-2026-05-15.md |  3 +-
 src/services/jump-hop/jumpHopClient.test.ts   | 39 +++++++++++++++++++
 src/services/jump-hop/jumpHopClient.ts        |  4 ++
 3 files changed, 45 insertions(+), 1 deletion(-)
 create mode 100644 src/services/jump-hop/jumpHopClient.test.ts

diff --git a/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md b/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
index 47791407..f0973a34 100644
--- a/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
+++ b/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
@@ -149,7 +149,8 @@ RPG / 拼图等�行�存档�以 `/api/profile/save-archives` 的�端列
 3. 地��调用一次 image2，输出一张 `5行*5列`�`1:1`��一纯洋红 `#FF00FF` key 背景的主题地�图集；跳一跳地�常包��地�花�雪�白石和云朵，�端�明化必须使用跳一跳专用洋红 key，��用近白底扣除，也�清��边缘连通的 key 色�素，��把绿色或白色主体误扣；�处�必须对边缘连通 key 色�容差清��去彩边 defringe 和底部残影清�，主体图�得自带洋红阴影�紫色底边�粉色�边�彩色光晕或�光底边，�行�阴影统一由 DOM 绘制；地�造型�示��求以主题物体本身外轮廓为准，�许苹果近似圆形�香蕉近似长�或长方形�西瓜近似扇形等自然差异，�统一�格规格�安全留白�正�30度视角和 2D/2.5D 手绘风格包装；所有地�素�必须��统一正�30度视角，相机�于物体正�方略高�置�镜头�下约30度，必须看到清晰正��侧��下沿�明显自身厚度和少�上表�，主体正�或侧����积必须接近或大于顶��积，顶��能作为辅助���；水果主题需�明确�求橙瓣看到橙皮正�外侧和果肉厚度�椰�看到壳的正�侧�和切�厚度�浆果�能�是从上往下看的圆形�顶；��生�纯俯视�正上方俯��鸟瞰地图��平铺俯��圆形顶视图或�平图标；主题物体本身必须是唯一��脚体，�能用自身切��边缘厚度�花瓣层或果皮边表现承�，�止在主题物体下方�外垫石��土墩�木��圆��托盘�岛屿底座或通用地�；�端和�端默认 `tilePrompt` 都必须使用“正�30度视角主题物体图集，物体本身作为跳跃�点�的�径，���交“平�素� / 跳� / 地� / 地砖�等会把模型拉回通用平�造型的�，�端生��也会清洗旧�稿�留的这些�；
 4. 背景底图�样由 image2 生�，�用现有 `coverComposite` / `coverImageSrc` 作为�行�背景读写字段，OSS 槽�固定为 `background/image.png`，�新增 SpacetimeDB 字段；�示�必须严格以用户主题关键�为背景主题，结构以左�两侧氛围为主，中央纵轴 1/2 区域��少元素�简���读且有纵深感，两侧�许更强立体层次和行进感；背景�作为底图，�止生�跳��地���脚物�角色�UI�文字�路径箭头或海报排版；
 5. �端按从上到下�从左到��匀切分为 `tile-01` 到 `tile-25` 的�明 PNG，�个切片必须使用唯一 slot/path �久化，�能按��的 `tileType` �用槽�；
-6. 结果页�展示陶泥儿 logo �明角色预览�地�池预览和首� 3 地�预览；���供旧角色图生�槽。
+6. 结果页�展示陶泥儿 logo �明角色预览�地�池预览和首� 3 地�预览；���供旧角色图生�槽；
+7. �端跳一跳创作 client 的创建会�与执行生�动作请求都必须使用 20 分钟等待窗�，��背景底图�地�图集�切片�抠图和 OSS 写入�在�端执行时被共创会�默认 15 秒超时中断。
 
 �行�规则真相必须沉到 `module-jump-hop`，�端��拖拽蓄力�角色�移�投影和�地�馈。失败��功跳跃次数�游�时长冻结��行�快照和�布作�状�以�端为准。v1 ��留公开 combo / perfect / 通关语义，旧 `score` 兼容映射为�功跳跃次数。公开列表应走 `jump_hop_gallery_card_view` 订阅缓存，���次 HTTP 请求调用 procedure 组装全�列表。
 
diff --git a/src/services/jump-hop/jumpHopClient.test.ts b/src/services/jump-hop/jumpHopClient.test.ts
new file mode 100644
index 00000000..7f284fc0
--- /dev/null
+++ b/src/services/jump-hop/jumpHopClient.test.ts
@@ -0,0 +1,39 @@
+import { beforeEach, expect, test, vi } from 'vitest';
+
+const requestJsonMock = vi.hoisted(() => vi.fn());
+
+const { createCreationAgentClientMock } = vi.hoisted(() => ({
+  createCreationAgentClientMock: vi.fn(),
+}));
+
+vi.mock('../creation-agent', () => ({
+  createCreationAgentClient: createCreationAgentClientMock,
+}));
+
+vi.mock('../apiClient', () => ({
+  requestJson: requestJsonMock,
+}));
+
+beforeEach(() => {
+  vi.resetModules();
+  createCreationAgentClientMock.mockReset();
+  createCreationAgentClientMock.mockReturnValue({
+    createSession: vi.fn(),
+    getSession: vi.fn(),
+    sendMessage: vi.fn(),
+    streamMessage: vi.fn(),
+    executeAction: vi.fn(),
+  });
+  requestJsonMock.mockReset();
+});
+
+test('jump hop creation keeps image2 generation requests alive long enough', async () => {
+  await import('./jumpHopClient');
+
+  expect(createCreationAgentClientMock).toHaveBeenCalledWith(
+    expect.objectContaining({
+      createSessionTimeoutMs: 20 * 60 * 1000,
+      executeActionTimeoutMs: 20 * 60 * 1000,
+    }),
+  );
+});
diff --git a/src/services/jump-hop/jumpHopClient.ts b/src/services/jump-hop/jumpHopClient.ts
index 779c415a..aeea825e 100644
--- a/src/services/jump-hop/jumpHopClient.ts
+++ b/src/services/jump-hop/jumpHopClient.ts
@@ -31,6 +31,8 @@ import {
 const JUMP_HOP_API_BASE = '/api/creation/jump-hop/sessions';
 const JUMP_HOP_WORKS_API_BASE = '/api/creation/jump-hop/works';
 const JUMP_HOP_RUNTIME_API_BASE = '/api/runtime/jump-hop';
+// 中文注释：跳一跳创作会等待背景图�25 格图集�切片和 OSS 写入，�能沿用共创会�默认 15 秒超时。
+const JUMP_HOP_GENERATION_TIMEOUT_MS = 20 * 60 * 1000;
 const JUMP_HOP_RUNTIME_READ_RETRY: ApiRetryOptions = {
   maxRetries: 1,
   baseDelayMs: 120,
@@ -87,6 +89,8 @@ const jumpHopCreationClient = createCreationAgentClient<
     streamIncomplete: '跳一跳共创消���结果�完整',
     executeAction: '执行跳一跳共创�作失败',
   },
+  createSessionTimeoutMs: JUMP_HOP_GENERATION_TIMEOUT_MS,
+  executeActionTimeoutMs: JUMP_HOP_GENERATION_TIMEOUT_MS,
 });
 
 type FlattenedJumpHopWorkProfileResponse = Omit<