@tea-agent/loop-agent 0.9.0 → 0.10.0

package/dist/worker/observe/static/app.js

@@ -3,6 +3,12 @@ import { layoutDag } from "./dag-layout.js";
 const ACTIVE_DETAIL_POLL_MS = 2000;
 const HIDDEN_POLL_MS = 30000;
 const DASHBOARD_POLL_MS = 5000;
+const DAG_INSPECTOR_DEFAULT_WIDTH = 440;
+const DAG_INSPECTOR_MIN_WIDTH = 360;
+const DAG_INSPECTOR_MAX_WIDTH = 680;
+const DAG_INSPECTOR_RIGHT_OFFSET = 24;
+const DAG_INSPECTOR_VIEWPORT_MARGIN = 48;
+const DAG_INSPECTOR_KEYBOARD_STEP = 24;
 
 const UI_TEXT = {
 	dashboard: "总览",
@@ -56,10 +62,28 @@ const STATUS_LABELS = {
 };
 
 const LIVENESS_LABELS = {
-	active: "活跃",
+	active: "执行器正常",
+	"node-quiet": "执行器正常，节点长时间无活动",
 	quiet: "无输出（存活）",
-	stale: "心跳失联",
+	stale: "执行器心跳中断",
 	"timeout-risk": "即将超时",
+	orphaned: "执行器已退出",
+	"unknown-host": "无法判断（在其他主机运行）",
+	unknown: "无法判断（无心跳记录）",
+};
+
+const DAG_EFFECTIVE_STATUS_LABELS = {
+	pending: "等待执行",
+	running: "正在执行",
+	"running-quiet": "运行可疑",
+	paused: "已暂停",
+	interrupted: "执行已中断",
+	"remote-unknown": "远端状态未知",
+	finished: "已完成",
+	failed: "执行失败",
+	superseded: "任务已另行完成",
+	abandoned: "已放弃",
+	unknown: "状态未知",
 };
 
 const STEP_LABELS = {
@@ -135,6 +159,7 @@ let sessionEvents = [];
 let lastSnapshot = null;
 let dagInspectorOpen = false;
 let dagInspectorTab = "output";
+let dagInspectorWidth = null;
 let dagGraphViewportState = null;
 const dagGraphViewportStates = new Map();
 let dagTimelineViewportState = null;
@@ -372,16 +397,18 @@ function statusSymbol(status) {
 	return "◇";
 }
 
-function badgeClass(status) {
+export function badgeClass(status) {
 	if (!status) return "unknown";
 	const key = status.toLowerCase().replace(/_/g, "-");
-	if (key === "finished" || key === "completed" || key === "succeeded" || key === "done") {
+	if (["finished", "completed", "succeeded", "done", "superseded"].includes(key)) {
 		return "succeeded";
 	}
-	if (key === "error" || key === "failed") return "failed";
+	if (["error", "failed", "interrupted"].includes(key)) return "failed";
 	if (key === "partial-failed") return "partial-failed";
-	if (key === "skipped") return "skipped";
-	if (key === "running" || key === "started") return "running";
+	if (key === "skipped" || key === "abandoned") return "skipped";
+	if (key === "running" || key === "started" || key === "running-quiet") return "running";
+	if (key === "paused") return "blocked";
+	if (key === "remote-unknown") return "unknown";
 	return key;
 }
 
@@ -398,12 +425,25 @@ function formatTs(value) {
 	return d.toLocaleString("zh-CN", { hour12: false });
 }
 
-function formatMs(ms) {
+export function formatMs(ms) {
 	if (ms === undefined || ms === null) return "—";
 	if (ms < 1000) return `${ms}ms`;
+	if (ms >= 60_000) {
+		const totalSeconds = Math.floor(ms / 1000);
+		return `${Math.floor(totalSeconds / 60)}min ${totalSeconds % 60}s`;
+	}
 	return `${(ms / 1000).toFixed(1)}s`;
 }
 
+function dagStatusBadge(status) {
+	const value = status ?? "unknown";
+	return el(
+		"span",
+		`badge badge-${badgeClass(value)}`,
+		DAG_EFFECTIVE_STATUS_LABELS[value] ?? statusLabel(value),
+	);
+}
+
 function formatDuration(ms) {
 	if (ms === undefined || ms === null || Number.isNaN(ms)) return "—";
 	if (ms < 0) ms = 0;
@@ -518,6 +558,25 @@ function metaGrid(entries) {
 	return dl;
 }
 
+const TERMINAL_DAG_EFFECTIVE_STATUSES = new Set([
+	"finished",
+	"failed",
+	"superseded",
+	"abandoned",
+]);
+
+export function dagMetaVisibility(dag) {
+	const terminal =
+		(dag?.lifecycle ?? "").toLowerCase() === "completed"
+		|| TERMINAL_DAG_EFFECTIVE_STATUSES.has(dag?.effectiveStatus);
+	return {
+		showExecutorStatus: !terminal,
+		showConsistencyWarning: dag?.stateConsistent === false,
+		showResume: dag?.recoveryEligibility?.canResume === true,
+		showReconcile: dag?.recoveryEligibility?.canReconcile === true,
+	};
+}
+
 function buildTable(headers, rows) {
 	const table = document.createElement("table");
 	const thead = document.createElement("thead");
@@ -635,6 +694,10 @@ function formatSessionEventLabel(event) {
 	if (!event || typeof event !== "object") return "未知类型";
 	const type = typeof event.type === "string" ? event.type : "unknown";
 	const toolName = event.toolName ?? event.name ?? "—";
+	if (type === "agent_start") return "Agent 已启动";
+	if (type === "agent_end") return "Agent 已结束";
+	if (type === "agent_settled") return "Agent 已稳定";
+	if (type === "turn_start") return "开始新一轮处理";
 	if (type === "tool_execution_start" || type === "tool_start") {
 		return `调用工具 · ${toolName}`;
 	}
@@ -647,16 +710,53 @@ function formatSessionEventLabel(event) {
 	return type;
 }
 
-function formatSessionEventTime(event) {
-	if (!event || typeof event !== "object") return "—";
+function sessionEventTimestamp(event) {
+	if (!event || typeof event !== "object") return "";
 	const ts =
 		(typeof event.timestamp === "string" && event.timestamp) ||
 		(typeof event.at === "string" && event.at) ||
 		(typeof event.recordedAt === "string" && event.recordedAt);
-	if (!ts) return "—";
+	return ts || "";
+}
+
+function formatSessionEventTime(event) {
+	const ts = sessionEventTimestamp(event);
+	if (!ts) return "未记录时间";
 	return formatTs(ts).replace(/\s.*/, "") || formatTs(ts);
 }
 
+function sessionEventKind(event) {
+	const type = typeof event?.type === "string" ? event.type : "unknown";
+	if (type === "tool_execution_start" || type === "tool_start") return "tool-start";
+	if (type === "tool_execution_end" || type === "tool_end") return "tool-end";
+	if (type === "turn_end" || type === "assistant" || type === "assistant_message") {
+		return "assistant";
+	}
+	if (type.startsWith("agent_") || type === "turn_start") return "lifecycle";
+	return "protocol";
+}
+
+function buildSessionTimelineItems(events) {
+	const items = [];
+	for (let index = 0; index < events.length; index += 1) {
+		const event = events[index];
+		const type = typeof event?.type === "string" ? event.type : "unknown";
+		if (type === "message_start" || type === "message_end") {
+			let count = 1;
+			while (index + 1 < events.length) {
+				const nextType = events[index + 1]?.type;
+				if (nextType !== "message_start" && nextType !== "message_end") break;
+				count += 1;
+				index += 1;
+			}
+			items.push({ event, kind: "protocol", protocolCount: count });
+			continue;
+		}
+		items.push({ event, kind: sessionEventKind(event) });
+	}
+	return items;
+}
+
 async function mergeSessionEvents(dagRunId, nodeId) {
 	if (!dagRunId || !nodeId) return;
 	const page = await fetchJson(
@@ -691,6 +791,94 @@ function closeDagInspector() {
 	}
 }
 
+function closeDagInspectorOnOutsideClick(event) {
+	if (!dagInspectorOpen || !(event.target instanceof Element)) return;
+	if (
+		event.target.closest(
+			"#dag-inspector, .dag-node-table tbody tr, button, a, input, select, textarea, [role='button'], [role='tab']",
+		)
+	) {
+		return;
+	}
+	closeDagInspector();
+}
+
+function dagInspectorMaximumWidth() {
+	return Math.max(
+		DAG_INSPECTOR_MIN_WIDTH,
+		Math.min(
+			DAG_INSPECTOR_MAX_WIDTH,
+			window.innerWidth - DAG_INSPECTOR_VIEWPORT_MARGIN,
+		),
+	);
+}
+
+function setDagInspectorWidth(panel, requestedWidth) {
+	const maximum = dagInspectorMaximumWidth();
+	dagInspectorWidth = Math.min(
+		maximum,
+		Math.max(DAG_INSPECTOR_MIN_WIDTH, Math.round(requestedWidth)),
+	);
+	panel.style.setProperty("--dag-inspector-width", `${dagInspectorWidth}px`);
+	return { minimum: DAG_INSPECTOR_MIN_WIDTH, maximum, value: dagInspectorWidth };
+}
+
+function createDagInspectorResizeHandle(panel) {
+	const handle = el("div", "dag-inspector-resize-handle");
+	handle.tabIndex = 0;
+	handle.setAttribute("role", "separator");
+	handle.setAttribute("aria-orientation", "vertical");
+	handle.setAttribute("aria-label", "调整节点检查器宽度");
+	handle.title = "拖动调整节点检查器宽度";
+
+	const updateRange = (requestedWidth) => {
+		const range = setDagInspectorWidth(
+			panel,
+			requestedWidth ?? dagInspectorWidth ?? DAG_INSPECTOR_DEFAULT_WIDTH,
+		);
+		handle.setAttribute("aria-valuemin", String(range.minimum));
+		handle.setAttribute("aria-valuemax", String(range.maximum));
+		handle.setAttribute("aria-valuenow", String(range.value));
+	};
+
+	updateRange();
+	handle.addEventListener("pointerdown", (event) => {
+		if (event.button !== 0) return;
+		event.preventDefault();
+		handle.setPointerCapture(event.pointerId);
+		document.body.classList.add("is-resizing-dag-inspector");
+	});
+	handle.addEventListener("pointermove", (event) => {
+		if (!handle.hasPointerCapture(event.pointerId)) return;
+		updateRange(window.innerWidth - event.clientX - DAG_INSPECTOR_RIGHT_OFFSET);
+	});
+	const stopResizing = (event) => {
+		if (handle.hasPointerCapture(event.pointerId)) {
+			handle.releasePointerCapture(event.pointerId);
+		}
+		document.body.classList.remove("is-resizing-dag-inspector");
+	};
+	handle.addEventListener("pointerup", stopResizing);
+	handle.addEventListener("pointercancel", stopResizing);
+	handle.addEventListener("keydown", (event) => {
+		const currentWidth = dagInspectorWidth ?? DAG_INSPECTOR_DEFAULT_WIDTH;
+		if (event.key === "ArrowLeft") {
+			event.preventDefault();
+			updateRange(currentWidth + DAG_INSPECTOR_KEYBOARD_STEP);
+		} else if (event.key === "ArrowRight") {
+			event.preventDefault();
+			updateRange(currentWidth - DAG_INSPECTOR_KEYBOARD_STEP);
+		} else if (event.key === "Home") {
+			event.preventDefault();
+			updateRange(DAG_INSPECTOR_MIN_WIDTH);
+		} else if (event.key === "End") {
+			event.preventDefault();
+			updateRange(dagInspectorMaximumWidth());
+		}
+	});
+	return handle;
+}
+
 function captureDagTimelineViewportState(panel) {
 	const scrollEl = panel.querySelector(".process-timeline-scroll");
 	if (scrollEl?.dataset.dagRunId && scrollEl.dataset.nodeId) {
@@ -716,11 +904,33 @@ function renderSessionTimeline(content, nodeId) {
 		return;
 	}
 
+	const timelineItems = buildSessionTimelineItems(sessionEvents);
+	const hasEventTimes = sessionEvents.some((event) => Boolean(sessionEventTimestamp(event)));
+	if (!hasEventTimes) {
+		content.appendChild(
+			el("p", "process-timeline-note", "事件未记录具体时间，以下按采集顺序展示。"),
+		);
+	}
 	const ul = el("ul", "process-timeline");
-	for (const event of sessionEvents) {
-		const li = el("li", "process-timeline-item");
-		li.appendChild(el("span", "process-timeline-time", formatSessionEventTime(event)));
-		li.appendChild(el("span", "process-timeline-label", formatSessionEventLabel(event)));
+	for (let index = 0; index < timelineItems.length; index += 1) {
+		const item = timelineItems[index];
+		const li = el(
+			"li",
+			`process-timeline-item process-timeline-${item.kind}${hasEventTimes ? " has-time" : ""}`,
+		);
+		if (index === 0) li.classList.add("is-first");
+		if (index === timelineItems.length - 1) li.classList.add("is-last");
+		const rail = el("span", "process-timeline-rail");
+		rail.appendChild(el("span", "process-timeline-dot"));
+		li.appendChild(rail);
+		if (hasEventTimes) {
+			li.appendChild(el("span", "process-timeline-time", formatSessionEventTime(item.event)));
+		}
+		const label =
+			item.protocolCount > 1
+				? `消息收发 · 已合并 ${item.protocolCount} 条协议事件`
+				: formatSessionEventLabel(item.event);
+		li.appendChild(el("span", "process-timeline-label", label));
 		ul.appendChild(li);
 	}
 	content.appendChild(ul);
@@ -756,12 +966,27 @@ function renderSessionTimeline(content, nodeId) {
 }
 
 export function isDagRunActive(dag) {
+	if (["running", "running-quiet", "remote-unknown", "pending"].includes(dag.effectiveStatus)) return true;
+	// Only "unknown" (and absent) means liveness evidence is insufficient;
+	// it must NOT override raw lifecycle/status/node facts. Every other concrete
+	// effectiveStatus is authoritative-non-active and short-circuits to false.
+	if (dag.effectiveStatus && dag.effectiveStatus !== "unknown") return false;
 	const status = (dag.status ?? "").toLowerCase();
+	if ((dag.lifecycle ?? "").toLowerCase() === "paused") return false;
+	if (["orphaned", "stale"].includes((dag.liveness ?? "").toLowerCase())) return false;
 	if (TERMINAL_RUN_STATUSES.has(status)) return false;
 	if (["running", "pending", "started"].includes(status)) return true;
 	return (dag.nodes ?? []).some((n) => isNodeActive(n.status));
 }
 
+const DASHBOARD_FEATURE_STATUSES = new Set(["running", "needs_action"]);
+
+export function dashboardVisibleFeatures(features) {
+	return (features ?? []).filter((feature) =>
+		DASHBOARD_FEATURE_STATUSES.has(feature?.status),
+	);
+}
+
 function dagProgress(dag) {
 	const nodes = dag.nodes ?? [];
 	const finished = nodes.filter((n) => isNodeFinished(n.status)).length;
@@ -786,13 +1011,69 @@ function findDagForRun(snapshot, workerRunId, task) {
 	return undefined;
 }
 
-function kpiCard(label, value, extraClass) {
+let kpiHelpSeed = 0;
+function kpiCard(label, value, extraClass, helpText) {
 	const card = el("div", `kpi-card${extraClass ? ` ${extraClass}` : ""}`);
 	card.appendChild(el("div", "kpi-label", label));
-	card.appendChild(el("div", "kpi-value", String(value)));
+	const valueWrap = el("div", "kpi-value-row");
+	valueWrap.appendChild(el("div", "kpi-value", String(value)));
+	if (helpText) {
+		kpiHelpSeed += 1;
+		const tipId = `kpi-tip-${kpiHelpSeed}`;
+		const helpBtn = el("button", "kpi-help");
+		helpBtn.type = "button";
+		helpBtn.setAttribute("aria-describedby", tipId);
+		helpBtn.setAttribute("aria-label", `${label} 指标说明`);
+		const icon = el("i", "ri-question-line");
+		icon.setAttribute("aria-hidden", "true");
+		helpBtn.appendChild(icon);
+		const tip = el("span", "kpi-tip");
+		tip.id = tipId;
+		tip.setAttribute("role", "tooltip");
+		tip.textContent = helpText;
+		valueWrap.appendChild(helpBtn);
+		valueWrap.appendChild(tip);
+	}
+	card.appendChild(valueWrap);
 	return card;
 }
 
+function repoBaseName(repoRoot) {
+	if (!repoRoot) return "未绑定仓库";
+	const trimmed = String(repoRoot).replace(/[\\/]+$/, "");
+	const parts = trimmed.split(/[\\/]/);
+	return parts[parts.length - 1] || trimmed || "未绑定仓库";
+}
+
+function renderRepoBanner(repoEl, snapshot) {
+	if (!repoEl) return;
+	clearNode(repoEl);
+	const repoRoot = snapshot.repoRoot ?? "";
+	const icon = el("i", "ri-git-repository-line");
+	icon.setAttribute("aria-hidden", "true");
+	repoEl.appendChild(icon);
+	const text = el("div", "repo-banner-text");
+	text.appendChild(el("span", "repo-banner-name", repoBaseName(repoRoot)));
+	const pathLine = el("span", "repo-banner-path", repoRoot || "路径未知");
+	pathLine.title = repoRoot || "";
+	text.appendChild(pathLine);
+	repoEl.appendChild(text);
+}
+
+function renderProjectionFault(error) {
+	const banner = el("div", "projection-fault");
+	banner.setAttribute("role", "alert");
+	const icon = el("i", "ri-error-warning-line");
+	icon.setAttribute("aria-hidden", "true");
+	banner.appendChild(icon);
+	const body = el("div", "projection-fault-body");
+	body.appendChild(el("p", "projection-fault-title", "指标暂不可用：数据投影失败。"));
+	body.appendChild(el("p", "projection-fault-message", error.message ?? "投影失败 (projection failed)"));
+	if (error.at) body.appendChild(el("p", "projection-fault-at", `发生时间：${error.at}`));
+	banner.appendChild(body);
+	return banner;
+}
+
 function renderActiveDagCard(dag, nowMs) {
 	const card = el("div", "active-dag-card");
 	if (isNodeActive(dag.status) || getActiveNodes(dag).length > 0) {
@@ -801,7 +1082,7 @@ function renderActiveDagCard(dag, nowMs) {
 	const title = dag.title || dag.dagRunId;
 	const header = el("div", "active-dag-header");
 	header.appendChild(el("span", "active-dag-title", title));
-	header.appendChild(badge(dag.status));
+	header.appendChild(dagStatusBadge(dag.effectiveStatus ?? dag.status));
 	card.appendChild(header);
 
 	const progress = dagProgress(dag);
@@ -1121,6 +1402,7 @@ function renderDagInspector(dagRunId, node) {
 	clearNode(panel);
 	panel.classList.add("is-open");
 	panel.setAttribute("aria-hidden", "false");
+	panel.appendChild(createDagInspectorResizeHandle(panel));
 	const header = el("div", "dag-inspector-header");
 	const title = el("div", "dag-inspector-title");
 	title.appendChild(el("h3", null, "节点检查器"));
@@ -1242,10 +1524,12 @@ async function renderDashboard(scrollTo) {
 	setBreadcrumb([{ label: UI_TEXT.dashboard }]);
 
 	const kpiEl = document.getElementById("dashboard-kpi");
+	const featureEl = document.getElementById("dashboard-features");
 	const activeEl = document.getElementById("dashboard-active-dags");
 	const riskEl = document.getElementById("dashboard-risk");
 	const dagsEl = document.getElementById("dashboard-dags");
 	const batchesEl = document.getElementById("dashboard-batches");
+	const repoEl = document.getElementById("dashboard-repo");
 
 	const snapshot = await fetchJson("/api/snapshot");
 	if (!snapshot) return;
@@ -1260,21 +1544,88 @@ async function renderDashboard(scrollTo) {
 		.sort((a, b) => dagSortTime(b).localeCompare(dagSortTime(a)))
 		.slice(0, 10);
 
+	const features = dashboardVisibleFeatures(snapshot.features);
+	featureEl.hidden = features.length === 0;
+	clearNode(featureEl);
+	if (features.length > 0) {
+		featureEl.appendChild(el("h3", "section-heading", "Feature 决策"));
+		featureEl.appendChild(buildTable(
+			["Feature", "状态", "下一步", "原因", "required AC", "证据"],
+			features.map((feature) => ({ cells: [
+				feature.featureId,
+				feature.statusLabel ?? feature.status,
+				feature.nextAction?.command ?? feature.nextAction?.label ?? "—",
+				feature.blockingItems?.[0]?.message ?? `${feature.summary?.tasksSucceeded ?? 0}/${feature.summary?.tasksTotal ?? 0} tasks completed`,
+				`${feature.summary?.requiredAcCovered ?? 0}/${feature.summary?.requiredAcTotal ?? 0}`,
+				artifactLink("查看", feature.evidence?.delivery ?? feature.evidence?.closeout ?? feature.evidence?.morningReport ?? feature.evidence?.observeSnapshot),
+			] })),
+		));
+	}
+	if (features.length > 0 && (snapshot.projectionWarnings ?? []).length > 0) {
+		featureEl.appendChild(el("p", "empty", `投影警告：${snapshot.projectionWarnings.join("；")}`));
+	}
+
+	renderRepoBanner(repoEl, snapshot);
+
 	clearNode(kpiEl);
+	const dagHealth = snapshot.health?.dag;
+	const dagActiveRuns = dagHealth?.activeRuns ?? activeDags.length;
+	const dagRunningNodes = dagHealth?.runningNodes
+		?? activeDags.flatMap((dag) => dag.nodes ?? []).filter((node) => ["running", "started"].includes((node.status ?? "").toLowerCase())).length;
+	const dagPendingNodes = dagHealth?.pendingNodes
+		?? activeDags.flatMap((dag) => dag.nodes ?? []).filter((node) => ["pending", "queued"].includes((node.status ?? "").toLowerCase())).length;
+	const dagPausedRuns = dagHealth?.pausedRuns ?? 0;
+	const dagStaleRuns = dagHealth?.staleRuns ?? 0;
+	const dagInterruptedRuns = dagHealth?.interruptedRuns ?? 0;
+	const dagInconsistentRuns = dagHealth?.inconsistentRuns ?? 0;
+	const dagAttentionRuns = dagHealth?.attentionRuns
+		?? dagRuns.filter((dag) => (dag.lifecycle ?? "").toLowerCase() !== "completed" && (
+			(dag.lifecycle ?? "").toLowerCase() === "paused"
+			|| ["stale", "orphaned"].includes((dag.liveness ?? "").toLowerCase())
+			|| ["interrupted", "remote-unknown"].includes(dag.effectiveStatus)
+			|| dag.stateConsistent === false
+		)).length;
+
 	const quietCount = snapshot.health?.quietCount ?? 0;
 	const staleCount = snapshot.health?.staleCount ?? 0;
 	const timeoutRiskCount = snapshot.health?.timeoutRiskCount ?? 0;
 	const failuresCount = snapshot.health?.failuresCount ?? 0;
-	kpiEl.appendChild(kpiCard("活跃 DAG", activeDags.length, "kpi-highlight"));
-	kpiEl.appendChild(kpiCard("活跃 Task", snapshot.health?.activeTasks ?? 0));
-	kpiEl.appendChild(kpiCard("无输出", quietCount, quietCount > 0 ? "kpi-muted" : ""));
-	kpiEl.appendChild(kpiCard("心跳失联", staleCount, staleCount > 0 ? "kpi-risk" : ""));
-	kpiEl.appendChild(
-		kpiCard("即将超时", timeoutRiskCount, timeoutRiskCount > 0 ? "kpi-risk" : ""),
-	);
-	kpiEl.appendChild(
-		kpiCard("失败", failuresCount, failuresCount > 0 ? "kpi-danger" : ""),
-	);
+
+	if (snapshot.projectionError) {
+		kpiEl.appendChild(renderProjectionFault(snapshot.projectionError));
+	} else {
+		const dagGroup = el("fieldset", "kpi-group");
+		dagGroup.appendChild(el("legend", "kpi-group-legend", "DAG 运行"));
+		const dagCards = el("div", "kpi-grid");
+		dagCards.appendChild(kpiCard("活跃 DAG", dagActiveRuns, "kpi-highlight",
+			"当前处于运行、静默运行、远端状态未知或等待执行的 DAG 数量（来源：.harness/dag-runs 的有效状态）。"));
+		dagCards.appendChild(kpiCard("执行中节点", dagRunningNodes, "",
+			"活跃 DAG 中状态为 running 或 started、正在执行的节点数量；DAG 内执行单元统一称为节点。"));
+		dagCards.appendChild(kpiCard("等待节点", dagPendingNodes, "",
+			"活跃 DAG 中状态为 pending 或 queued、尚未开始执行的节点数量。"));
+		dagCards.appendChild(kpiCard("暂停 DAG", dagPausedRuns, dagPausedRuns > 0 ? "kpi-muted" : "",
+			"生命周期被暂停的 DAG 运行数量（来源：.harness/dag-runs 下的 lifecycle 目录）。"));
+		dagCards.appendChild(kpiCard("需处理 DAG", dagAttentionRuns, dagAttentionRuns > 0 ? "kpi-risk" : "",
+			"未完成且暂停、失联、中断、远端状态未知或状态不一致的 DAG 数量；同一个 DAG 只计一次。"));
+		dagGroup.appendChild(dagCards);
+
+		const workerGroup = el("fieldset", "kpi-group");
+		workerGroup.appendChild(el("legend", "kpi-group-legend", "Worker 执行"));
+		const workerCards = el("div", "kpi-grid");
+		workerCards.appendChild(kpiCard("活跃 Worker Task", snapshot.health?.activeTasks ?? 0, "",
+			"当前运行或等待执行的 Worker Task Pool 任务数量（来源：.harness/task-pool 的状态、运行记录与事件；不含 .harness/tasks 下的 task.json）。"));
+		workerCards.appendChild(kpiCard("无输出", quietCount, quietCount > 0 ? "kpi-muted" : "",
+			"心跳仍正常，但超过无输出判定时长仍没有新输出的 Worker Task 数量。"));
+		workerCards.appendChild(kpiCard("心跳失联", staleCount, staleCount > 0 ? "kpi-risk" : "",
+			"超过心跳失联判定时长仍没有新心跳的 Worker Task 数量。"));
+		workerCards.appendChild(kpiCard("即将超时", timeoutRiskCount, timeoutRiskCount > 0 ? "kpi-risk" : "",
+			"命令已执行时长超过 80% 超时的 Worker Task 数量。"));
+		workerCards.appendChild(kpiCard("失败", failuresCount, failuresCount > 0 ? "kpi-danger" : "",
+			"状态为 failed 的 Worker Task 数量。"));
+		workerGroup.appendChild(workerCards);
+		kpiEl.appendChild(workerGroup);
+		kpiEl.appendChild(dagGroup);
+	}
 
 	const nowMs = Date.now();
 
@@ -1292,28 +1643,39 @@ async function renderDashboard(scrollTo) {
 		activeEl.appendChild(list);
 	}
 
-	const riskCount = failuresCount + staleCount + timeoutRiskCount;
 	clearNode(riskEl);
-	riskEl.classList.toggle("panel-risk-attention", riskCount > 0);
+	const dagRiskCount = dagAttentionRuns;
+	const workerRiskCount = failuresCount + staleCount + timeoutRiskCount;
+	riskEl.classList.toggle("panel-risk-attention", dagRiskCount > 0 || workerRiskCount > 0);
 	riskEl.appendChild(el("h3", "section-heading", "运行风险"));
-	if (riskCount === 0) {
+	if (dagRiskCount === 0 && workerRiskCount === 0) {
 		riskEl.appendChild(el("p", "risk-empty", "当前没有需要处理的异常。"));
 	} else {
-		riskEl.appendChild(el("div", "risk-total", String(riskCount)));
-		riskEl.appendChild(
-			el(
-				"p",
-				"risk-summary",
-				`失败 ${failuresCount} · 心跳失联 ${staleCount} · 即将超时 ${timeoutRiskCount}`,
-			),
-		);
-		const link = el("a", "risk-link", "查看异常 Task →");
-		link.href = "#/failures";
-		link.addEventListener("click", (event) => {
-			event.preventDefault();
-			navigate("/failures");
-		});
-		riskEl.appendChild(link);
+		const riskBlocks = el("div", "risk-blocks");
+		if (dagRiskCount > 0) {
+			const dagBlock = el("div", "risk-block risk-block-dag");
+			dagBlock.appendChild(el("div", "risk-block-label", "需处理 DAG"));
+			dagBlock.appendChild(el("div", "risk-total", String(dagRiskCount)));
+			dagBlock.appendChild(el("p", "risk-summary",
+				`去重运行数 ${dagAttentionRuns} · 中断 ${dagInterruptedRuns} · 失联 ${dagStaleRuns} · 状态不一致 ${dagInconsistentRuns} · 暂停 ${dagPausedRuns}`));
+			riskBlocks.appendChild(dagBlock);
+		}
+		if (workerRiskCount > 0) {
+			const workerBlock = el("div", "risk-block risk-block-worker");
+			workerBlock.appendChild(el("div", "risk-block-label", "Worker 风险"));
+			workerBlock.appendChild(el("div", "risk-total", String(workerRiskCount)));
+			workerBlock.appendChild(el("p", "risk-summary",
+				`失败 ${failuresCount} · 心跳失联 ${staleCount} · 即将超时 ${timeoutRiskCount}`));
+			const link = el("a", "risk-link", "查看异常 Task →");
+			link.href = "#/failures";
+			link.addEventListener("click", (event) => {
+				event.preventDefault();
+				navigate("/failures");
+			});
+			workerBlock.appendChild(link);
+			riskBlocks.appendChild(workerBlock);
+		}
+		riskEl.appendChild(riskBlocks);
 	}
 
 	clearNode(dagsEl);
@@ -1339,7 +1701,7 @@ async function renderDashboard(scrollTo) {
 				rail.appendChild(
 					el(
 						"span",
-						`dag-run-timeline-dot status-${String(dag.status ?? "unknown").toLowerCase()}`,
+						`dag-run-timeline-dot status-${badgeClass(dag.effectiveStatus ?? dag.status)}`,
 					),
 				);
 				item.appendChild(rail);
@@ -1356,7 +1718,7 @@ async function renderDashboard(scrollTo) {
 				item.appendChild(content);
 
 				const state = el("span", "dag-run-timeline-status");
-				state.appendChild(badge(dag.status));
+				state.appendChild(dagStatusBadge(dag.effectiveStatus ?? dag.status));
 				item.appendChild(state);
 				timeline.appendChild(item);
 			}
@@ -1559,7 +1921,7 @@ function renderRunDagProgress(task, snapshot) {
 	panel.appendChild(
 		metaGrid([
 			["DAG", dag.title || dag.dagRunId],
-			["状态", badge(dag.status)],
+			["当前状态", dagStatusBadge(dag.effectiveStatus ?? dag.status)],
 			["进度", `${progress.finished}/${progress.total} 个节点`],
 			[
 				"详情",
@@ -1821,19 +2183,38 @@ async function renderDagDetail(dagRunId, initial = true) {
 		.length;
 
 	clearNode(metaEl);
-	metaEl.appendChild(
-		metaGrid([
-			["标题", dag.title || dag.dagRunId],
-			["DAG 运行 ID", dag.dagRunId],
-			["状态", badge(dag.status)],
-			["开始时间", formatTs(dag.startedAt)],
-			["结束时间", formatTs(dag.finishedAt)],
-			["总耗时", formatDuration(dag.durationMs)],
-			["进度", `${progress.finished}/${progress.total}`],
-			["成功/失败/跳过", `${succeededCount}/${failedCount}/${skippedCount}`],
-			["DAG 路径", dag.dagPath ?? "—"],
-		]),
+	const visibility = dagMetaVisibility(dag);
+	const livenessValue = LIVENESS_LABELS[dag.liveness] ?? dag.liveness ?? LIVENESS_LABELS.unknown;
+	const primaryEntries = [
+		["标题", dag.title || dag.dagRunId],
+		["DAG 运行 ID", dag.dagRunId],
+		["状态", dagStatusBadge(dag.effectiveStatus ?? dag.status)],
+	];
+	if (visibility.showExecutorStatus) primaryEntries.push(["执行器状态", livenessValue]);
+	if (visibility.showConsistencyWarning) primaryEntries.push(["状态一致性", "不一致，需要处理"]);
+	if (visibility.showResume) primaryEntries.push(["允许恢复", "是"]);
+	if (visibility.showReconcile) primaryEntries.push(["允许收口", "是"]);
+	primaryEntries.push(
+		["开始时间", formatTs(dag.startedAt)],
+		["结束时间", formatTs(dag.finishedAt)],
+		["总耗时", formatDuration(dag.durationMs)],
+		["进度", `${progress.finished}/${progress.total}`],
+		["成功/失败/跳过", `${succeededCount}/${failedCount}/${skippedCount}`],
+		["DAG 路径", dag.dagPath ?? "—"],
 	);
+	metaEl.appendChild(metaGrid(primaryEntries));
+	const details = el("details", "meta-diagnostics");
+	details.appendChild(el("summary", null, "诊断信息"));
+	details.appendChild(metaGrid([
+		["当前判定", dagStatusBadge(dag.effectiveStatus ?? dag.status)],
+		["原始记录状态", badge(dag.status)],
+		["执行器状态", livenessValue],
+		["生命周期", dag.lifecycle ?? "—"],
+		["状态一致性", visibility.showConsistencyWarning ? "不一致，需要处理" : "一致"],
+		["允许恢复", visibility.showResume ? "是" : "否"],
+		["允许收口", visibility.showReconcile ? "是" : "否"],
+	]));
+	metaEl.appendChild(details);
 
 	clearNode(ranksEl);
 		ranksEl.appendChild(el("h3", null, "DAG 依赖图"));
@@ -1955,6 +2336,7 @@ function route() {
 if (typeof window !== "undefined") {
 	window.addEventListener("hashchange", route);
 	window.addEventListener("load", route);
+	document.addEventListener("pointerdown", closeDagInspectorOnOutsideClick);
 	document.addEventListener("visibilitychange", () => {
 		if (!isPageVisible()) return;
 		const r = parseRoute();