From d2662a1f377982b324c477e7b8cde310d24852d0 Mon Sep 17 00:00:00 2001
From: Blizzard <blizzardzhang@icloud.com>
Date: Fri, 26 Jun 2026 17:52:26 +0800
Subject: [PATCH] =?UTF-8?q?fix(history):=20=E5=8E=86=E5=8F=B2=E8=BF=90?=
 =?UTF-8?q?=E8=A1=8C=E5=A4=8D=E7=9B=98=E8=AF=BB=E5=BA=93=E6=8C=81=E4=B9=85?=
 =?UTF-8?q?=E5=8C=96=20=E2=80=94=E2=80=94=20=E6=9D=9C=E7=BB=9D=E8=BF=87=20?=
 =?UTF-8?q?Redis=20TTL=20=E5=90=8E=E5=8D=A1=E3=80=8C=E6=B5=81=E5=BC=8F?=
 =?UTF-8?q?=E4=B8=AD=E2=80=A6=E3=80=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

问题：历史任务超 Redis 流 10min TTL 后，SSE 回放在空流上永久阻塞 → 运行页卡「流式中…」、
轨迹/工具/输出全空。

修复：收尾把最终输出 + 执行轨迹持久化到 PG，历史复盘改读库（不依赖 Redis TTL）：
- store：Task 加 output/trace 两列；SaveTaskOutput/SaveTaskTrace/GetRunDetail。
  trace 用 type:text（不是 jsonb）——否则提交时空串 "" 入 jsonb 列会 INSERT 失败、整条任务不落库。
  （已 ALTER 既有 trace 列 jsonb→text。）
- gateway：token/exec 录制器在 done 时把累计的输出/轨迹快照落库。
- 新增 GET /tasks/:id/replay 返回持久化的 {output, exec}。
- RunsView：选中历史运行改 runReplay() 读库（秒回、phase 立即 done/error），不再 SSE 回放。
  即便旧任务无持久化数据，也是 done+空态，绝不再卡「流式中…」。

live：新任务落库 output 305 字(含表格) + 轨迹 5 事件，/replay 正确返回；tsc+vite、gateway 全绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 sundynix-desktop/frontend/src/lib/api.ts      |  8 ++++
 .../frontend/src/views/RunsView.tsx           | 21 +++++----
 .../internal/handler/task_handler.go          | 43 +++++++++++++++++--
 sundynix-gateway/internal/router/router.go    |  1 +
 sundynix-gateway/internal/store/models.go     |  3 ++
 sundynix-gateway/internal/store/pgsql.go      | 28 ++++++++++++
 6 files changed, 89 insertions(+), 15 deletions(-)

diff --git a/sundynix-desktop/frontend/src/lib/api.ts b/sundynix-desktop/frontend/src/lib/api.ts
index 0441332..db500a6 100644
--- a/sundynix-desktop/frontend/src/lib/api.ts
+++ b/sundynix-desktop/frontend/src/lib/api.ts
@@ -519,3 +519,11 @@ export async function taskEval(taskId: string): Promise<EvalResult | null> {
   if (!res.ok) return null;
   return res.json() as Promise<EvalResult>;
 }
+
+// runReplay: 历史运行复盘 —— 读库取持久化的输出 + 轨迹（不依赖 Redis TTL，秒回）。
+export async function runReplay(taskId: string): Promise<{ output: string; exec: ExecEvent[] }> {
+  const res = guard401(await fetch(`${GATEWAY}/api/v1/tasks/${taskId}/replay`, { headers: bearer() }));
+  if (!res.ok) throw new Error(`replay failed: ${res.status}`);
+  const d = (await res.json()) as { output?: string; exec?: ExecEvent[] };
+  return { output: d.output ?? "", exec: d.exec ?? [] };
+}
diff --git a/sundynix-desktop/frontend/src/views/RunsView.tsx b/sundynix-desktop/frontend/src/views/RunsView.tsx
index 6a45b8c..7470035 100644
--- a/sundynix-desktop/frontend/src/views/RunsView.tsx
+++ b/sundynix-desktop/frontend/src/views/RunsView.tsx
@@ -1,11 +1,11 @@
-import { useCallback, useEffect, useRef, useState } from "react";
+import { useCallback, useEffect, useState } from "react";
 import { Activity, FileText, History, Wrench } from "lucide-react";
 import { ExecTrace } from "../components/ExecTrace";
 import { Markdown } from "../components/Markdown";
 import { ChartView } from "../components/ChartView";
 import { extractChartBlocks, hasChart } from "../lib/chartspec";
 import { deriveNodes, emptyRun, type RunState } from "../lib/run";
-import { listRuns, taskEval, streamExec, streamTokens, type RunSummary, type EvalResult } from "../lib/api";
+import { listRuns, taskEval, runReplay, type RunSummary, type EvalResult } from "../lib/api";
 import { Tabs, Panel, Dot, Badge, EmptyState, cn, type TabDef } from "../ui";
 
 type DetailTab = "trace" | "tools" | "eval";
@@ -32,31 +32,30 @@ export function RunsView({ run }: { run: RunState }) {
   const [replay, setReplay] = useState<RunState>(emptyRun);
   const [evalRes, setEvalRes] = useState<EvalResult | null>(null);
   const [tab, setTab] = useState<DetailTab>("trace");
-  const closeRef = useRef<(() => void) | null>(null);
 
   useEffect(() => {
     let alive = true;
     const load = () => listRuns(40).then((r) => alive && setRuns(r)).catch(() => {});
     load();
     const id = setInterval(load, 5000);
-    return () => { alive = false; clearInterval(id); closeRef.current?.(); };
+    return () => { alive = false; clearInterval(id); };
   }, []);
 
+  // 选中历史运行：读库取持久化的输出 + 轨迹复盘（秒回、不依赖 Redis TTL）。
   const selectRun = useCallback((taskId: string) => {
-    closeRef.current?.();
     if (taskId === run.taskId) { setSel(null); setEvalRes(null); return; }
     setSel(taskId);
-    setReplay({ phase: "streaming", taskId, output: "", events: [], exec: [] });
+    setReplay({ phase: "submitting", taskId, output: "", events: [], exec: [] });
     setEvalRes(null);
-    const closeExec = streamExec(taskId, (ev) => setReplay((r) => ({ ...r, exec: [...r.exec, ev] })), () => setReplay((r) => ({ ...r, phase: "done" })), () => {});
-    const closeTok = streamTokens(taskId, (tok) => setReplay((r) => ({ ...r, output: r.output + tok })), () => {}, () => {});
-    closeRef.current = () => { closeExec(); closeTok(); };
+    runReplay(taskId)
+      .then((d) => setReplay({ phase: "done", taskId, output: d.output, events: [], exec: d.exec }))
+      .catch(() => setReplay({ phase: "error", taskId, output: "", events: [], exec: [], error: "复盘数据不可用" }));
     taskEval(taskId).then(setEvalRes).catch(() => {});
   }, [run.taskId]);
 
   // 新实时运行开始 → 切回「当前运行」+ 回到轨迹标签。
   useEffect(() => {
-    if (run.taskId) { closeRef.current?.(); setSel(null); setEvalRes(null); setTab("trace"); }
+    if (run.taskId) { setSel(null); setEvalRes(null); setTab("trace"); }
   }, [run.taskId]);
 
   // 当前实时运行的评测：完成后拉一次。
@@ -99,7 +98,7 @@ export function RunsView({ run }: { run: RunState }) {
           </div>
           <div className="min-h-0 flex-1 overflow-auto p-1.5">
             {liveActive && (
-              <button onClick={() => { closeRef.current?.(); setSel(null); setEvalRes(null); }}
+              <button onClick={() => { setSel(null); setEvalRes(null); }}
                 className={cn("mb-1 flex w-full items-center gap-2 rounded-md px-2 py-2 text-left", sel === null ? "bg-ink-800 ring-1 ring-brand/40" : "hover:bg-ink-850")}>
                 <Dot tone={run.phase === "streaming" ? "running" : run.phase === "done" ? "success" : "neutral"} pulse={run.phase === "streaming"} />
                 <span className="flex-1 truncate text-xs text-slate-200">当前运行</span>
diff --git a/sundynix-gateway/internal/handler/task_handler.go b/sundynix-gateway/internal/handler/task_handler.go
index d559e8b..12f2d06 100644
--- a/sundynix-gateway/internal/handler/task_handler.go
+++ b/sundynix-gateway/internal/handler/task_handler.go
@@ -9,6 +9,7 @@ import (
 	"net/http"
 	"os"
 	"strconv"
+	"strings"
 	"time"
 
 	"github.com/gin-contrib/sse"
@@ -85,9 +86,19 @@ func (h *Handler) startTokenRecorder(taskID string) {
 		return
 	}
 	ctx, cancel := context.WithTimeout(context.Background(), 6*time.Minute) // 兜底防泄漏
+	var out strings.Builder                                                 // 收尾时把整段输出快照落库（供过 Redis TTL 的历史复盘）
 	unsub, err := h.bus.SubscribeTokens(taskID,
-		func(tok []byte) { _ = h.cache.StreamAppend(ctx, store.ChannelToken, taskID, "token", string(tok)) },
-		func() { _ = h.cache.StreamAppend(ctx, store.ChannelToken, taskID, "done", ""); cancel() },
+		func(tok []byte) {
+			out.Write(tok)
+			_ = h.cache.StreamAppend(ctx, store.ChannelToken, taskID, "token", string(tok))
+		},
+		func() {
+			_ = h.cache.StreamAppend(ctx, store.ChannelToken, taskID, "done", "")
+			if out.Len() > 0 {
+				_ = h.db.SaveTaskOutput(context.Background(), taskID, out.String())
+			}
+			cancel()
+		},
 	)
 	if err != nil {
 		cancel()
@@ -104,9 +115,23 @@ func (h *Handler) startExecRecorder(taskID string) {
 		return
 	}
 	ctx, cancel := context.WithTimeout(context.Background(), 12*time.Minute) // 含 HITL 审批等待，给足
+	var evs []json.RawMessage                                                // 收尾时把轨迹快照落库（供过 Redis TTL 的历史复盘）
 	unsub, err := h.bus.SubscribeExec(taskID,
-		func(data []byte) { _ = h.cache.StreamAppend(ctx, store.ChannelExec, taskID, "exec", string(data)) },
-		func() { _ = h.cache.StreamAppend(ctx, store.ChannelExec, taskID, "done", ""); cancel() },
+		func(data []byte) {
+			cp := make([]byte, len(data))
+			copy(cp, data)
+			evs = append(evs, cp)
+			_ = h.cache.StreamAppend(ctx, store.ChannelExec, taskID, "exec", string(data))
+		},
+		func() {
+			_ = h.cache.StreamAppend(ctx, store.ChannelExec, taskID, "done", "")
+			if len(evs) > 0 {
+				if b, err := json.Marshal(evs); err == nil {
+					_ = h.db.SaveTaskTrace(context.Background(), taskID, string(b))
+				}
+			}
+			cancel()
+		},
 	)
 	if err != nil {
 		cancel()
@@ -421,6 +446,16 @@ func (h *Handler) StatsOverview(c *gin.Context) {
 	})
 }
 
+// TaskReplay: GET /api/v1/tasks/:id/replay —— 历史运行复盘（持久化的输出 + 轨迹，读库不依赖 Redis TTL）。
+func (h *Handler) TaskReplay(c *gin.Context) {
+	output, trace := h.db.GetRunDetail(c.Request.Context(), c.Param("id"))
+	var exec []json.RawMessage
+	if trace != "" {
+		_ = json.Unmarshal([]byte(trace), &exec)
+	}
+	c.JSON(http.StatusOK, gin.H{"output": output, "exec": exec})
+}
+
 // Runs: GET /api/v1/runs?limit= —— 运行历史列表（任务 + 评测分级），供「运行 · 观测」复盘。
 func (h *Handler) Runs(c *gin.Context) {
 	limit := 30
diff --git a/sundynix-gateway/internal/router/router.go b/sundynix-gateway/internal/router/router.go
index db517d3..8447ec2 100644
--- a/sundynix-gateway/internal/router/router.go
+++ b/sundynix-gateway/internal/router/router.go
@@ -74,6 +74,7 @@ func New(db *store.Postgres, cache *store.Redis, bus *nats.Bus, blobStore *blob.
 			p.GET("/billing", h.Billing)
 			p.GET("/stats/overview", h.StatsOverview) // 工作台仪表盘聚合
 			p.GET("/runs", h.Runs)                    // 运行历史（复盘）
+			p.GET("/tasks/:id/replay", h.TaskReplay)  // 历史运行复盘（持久化输出+轨迹，免 Redis TTL）
 		}
 
 		// 运维控制面：LLM 模型配置（含 API 密钥管理）—— 必须管理员（RequireAdmin）。
diff --git a/sundynix-gateway/internal/store/models.go b/sundynix-gateway/internal/store/models.go
index f4f62d0..5c2f209 100644
--- a/sundynix-gateway/internal/store/models.go
+++ b/sundynix-gateway/internal/store/models.go
@@ -21,6 +21,9 @@ type Task struct {
 	Graph  string `gorm:"type:jsonb"`          // React Flow 导出的 DSL 原文
 	Status string `gorm:"size:32"`             // submitted / running / done / failed / timeout
 	Detail string `gorm:"type:text"`           // 失败/超时原因等（状态机回写）
+	// 收尾持久化：供「运行历史复盘」永久回放（Redis 流仅 10min TTL，过期后历史任务靠这两列）。
+	Output string `gorm:"type:text"` // 最终模型输出（收尾时由网关从流快照落库）
+	Trace  string `gorm:"type:text"` // 执行轨迹事件 JSON 数组（存为文本，容忍空串；不在库内查它）
 }
 
 // Eval 是一次任务的自动化评测结果（dispatcher 评完经 NATS 回写，每任务一条，按 task_id upsert）。
diff --git a/sundynix-gateway/internal/store/pgsql.go b/sundynix-gateway/internal/store/pgsql.go
index 5fda67e..6f538cc 100644
--- a/sundynix-gateway/internal/store/pgsql.go
+++ b/sundynix-gateway/internal/store/pgsql.go
@@ -145,6 +145,34 @@ func (p *Postgres) GetTaskStatus(ctx context.Context, id string) (status, detail
 	return t.Status, t.Detail
 }
 
+// SaveTaskOutput 收尾时落库最终模型输出（供历史复盘，best-effort）。
+func (p *Postgres) SaveTaskOutput(ctx context.Context, id, output string) error {
+	if p.db == nil {
+		return nil
+	}
+	return p.db.WithContext(ctx).Model(&Task{}).Where("task_id = ?", id).Update("output", output).Error
+}
+
+// SaveTaskTrace 收尾时落库执行轨迹 JSON（供历史复盘，best-effort）。
+func (p *Postgres) SaveTaskTrace(ctx context.Context, id, traceJSON string) error {
+	if p.db == nil {
+		return nil
+	}
+	return p.db.WithContext(ctx).Model(&Task{}).Where("task_id = ?", id).Update("trace", traceJSON).Error
+}
+
+// GetRunDetail 取一条任务持久化的输出 + 轨迹（历史复盘读库，不依赖 Redis TTL）。
+func (p *Postgres) GetRunDetail(ctx context.Context, id string) (output, trace string) {
+	if p.db == nil {
+		return "", ""
+	}
+	var t Task
+	if err := p.db.WithContext(ctx).Select("output", "trace").Where("task_id = ?", id).First(&t).Error; err != nil {
+		return "", ""
+	}
+	return t.Output, t.Trace
+}
+
 // SaveEval 落库一条评测结果（按 task_id upsert：重评覆盖）。
 func (p *Postgres) SaveEval(ctx context.Context, e *Eval) error {
 	if p.db == nil {