@tea-agent/loop-agent 0.39.1 → 0.40.0-next.10

package/dist/worker/observe/static/views/dag-graph.js

@@ -22,6 +22,7 @@ import {
 	setDagGraphViewMode,
 	currentDagGraphViewMode,
 } from "../state.js";
+import { describeDagNodePurpose } from "../dag-node-purpose.js";
 import { selectDagNode } from "./dag-inspector.js";
 import { renderTrajectoryStoryboard } from "./dag-trajectory.js";
 
@@ -335,12 +336,13 @@ export function renderDagGraph(dag, dagRunId, existingWrap = null) {
 			const statusLine = `${statusSymbol(status)} ${statusLabel(node.status)} · ${formatMs(node.durationMs)}`;
 			// 节点宽 216、左右 padding≈14：按显示列宽截断（CJK 双宽）。
 			const maxDisplayWidth = Math.max(10, Math.floor((position.width - 28) / 7));
+			const purpose = describeDagNodePurpose(node.nodeId, node);
 			const group = svgEl("g", {
 				transform: `translate(${position.x} ${position.y})`,
 				class: `dag-graph-node status-${status}${node.nodeId === uiState.selectedDagNodeId ? " selected" : ""}${uiState.selectedDagNodeId && !related.has(node.nodeId) ? " dag-dimmed" : ""}`,
 				tabindex: 0,
 				role: "button",
-				"aria-label": `${node.nodeId}，状态 ${status}${historyLabel ? `，执行历史 ${historyLabel}` : ""}`,
+				"aria-label": `${node.nodeId}，${purpose ? `${purpose}，` : ""}状态 ${status}${historyLabel ? `，执行历史 ${historyLabel}` : ""}`,
 			});
 			group.appendChild(
 				svgEl("rect", { width: position.width, height: position.height, rx: 10 }),
@@ -352,7 +354,7 @@ export function renderDagGraph(dag, dagRunId, existingWrap = null) {
 					: "";
 			const attemptHint =
 				node.attemptCount > 0 ? `\nattempts: ${node.attemptCount}` : "";
-			title.textContent = `${node.nodeId}\n${node.executor ?? "未知执行器"}\n${status}${historyLabel ? `\n执行历史：${historyLabel}` : ""}${passHint}${attemptHint}`;
+			title.textContent = `${node.nodeId}${purpose ? `\n${purpose}` : ""}\n${node.executor ?? "未知执行器"}\n${status}${historyLabel ? `\n执行历史：${historyLabel}` : ""}${passHint}${attemptHint}`;
 			group.appendChild(title);
 			const label = svgEl("text", {
 				x: 14,

package/dist/worker/observe/static/views/dag-inspector.js

@@ -21,9 +21,11 @@ import {
 } from "../api.js";
 import { badge, formatLedgerSummary, formatMs, prettyJsonBlock } from "../format.js";
 import { renderMarkdown, renderInspectorDocument } from "../markdown-render.js";
+import { describeDagNodePurpose } from "../dag-node-purpose.js";
 import { buildPromptRestartCandidateOptions } from "../prompt-restart-candidates.js";
 import { copyText } from "../copy.js";
 import {
+	fetchWithWorkspaceScope,
 	uiState,
 	makeSessionEventIdentity,
 	makeDagNodeInputIdentity,
@@ -133,6 +135,175 @@ function createPromptRestartCopyButton(readCandidate) {
 	return button;
 }
 
+function formatPromptRestartMeta(text) {
+	const value = String(text ?? "");
+	const chars = [...value].length;
+	const lines = value.length === 0 ? 0 : value.split("\n").length;
+	return `${lines} 行 · ${chars.toLocaleString("zh-CN")} 字`;
+}
+
+function createPromptRestartBanner({ tone, kicker, title, body }) {
+	const banner = el("div", `prompt-restart-banner is-${tone}`);
+	banner.setAttribute("role", "status");
+	banner.appendChild(el("span", "prompt-restart-banner-kicker", kicker));
+	banner.appendChild(el("p", "prompt-restart-banner-title", title));
+	banner.appendChild(el("p", "prompt-restart-banner-body", body));
+	return banner;
+}
+
+function createPromptRestartCandidatePicker({
+	options,
+	value,
+	onChange,
+	label,
+	hint,
+}) {
+	const field = el("div", "prompt-restart-field");
+	field.appendChild(el("span", "prompt-restart-label", label));
+	const select = createCustomSelect({
+		ariaLabel: label,
+		className: "prompt-restart-candidate-select",
+		value,
+		disabled: options.length < 2,
+		options: options.map((option) => ({
+			value: option.key,
+			label: option.label,
+		})),
+		onChange: (nextKey) => {
+			onChange(String(nextKey));
+		},
+	});
+	select.setAttribute("data-testid", "prompt-restart-candidate");
+	field.appendChild(select);
+	const hintEl = el("p", "prompt-restart-hint", hint ?? "");
+	if (!hint) hintEl.hidden = true;
+	field.appendChild(hintEl);
+	return { field, select, hintEl };
+}
+
+function createPromptRestartModeSwitch({ value = "append", onChange }) {
+	const field = el("div", "prompt-restart-field prompt-restart-mode-field");
+	field.appendChild(el("span", "prompt-restart-label", "编辑模式"));
+	const group = el("div", "prompt-restart-mode-switch");
+	group.setAttribute("role", "radiogroup");
+	group.setAttribute("aria-label", "编辑模式");
+	group.setAttribute("data-testid", "prompt-restart-mode");
+	let current = value === "replace" ? "replace" : "append";
+	const buttons = [];
+	const sync = () => {
+		for (const btn of buttons) {
+			const selected = btn.dataset.mode === current;
+			btn.setAttribute("aria-checked", selected ? "true" : "false");
+			btn.classList.toggle("is-selected", selected);
+		}
+	};
+	for (const mode of [
+		{ value: "append", label: "追加指令" },
+		{ value: "replace", label: "全文替换" },
+	]) {
+		const btn = document.createElement("button");
+		btn.type = "button";
+		btn.className = "prompt-restart-mode-option";
+		btn.dataset.mode = mode.value;
+		btn.setAttribute("role", "radio");
+		btn.setAttribute("aria-label", mode.label);
+		btn.textContent = mode.label;
+		btn.addEventListener("click", () => {
+			if (current === mode.value) return;
+			current = mode.value;
+			sync();
+			onChange?.(current);
+		});
+		buttons.push(btn);
+		group.appendChild(btn);
+	}
+	Object.defineProperty(group, "value", {
+		configurable: true,
+		enumerable: true,
+		get() {
+			return current;
+		},
+		set(next) {
+			current = next === "replace" ? "replace" : "append";
+			sync();
+		},
+	});
+	sync();
+	field.appendChild(group);
+	const hint = el(
+		"p",
+		"prompt-restart-hint",
+		"追加会保留原提示词；全文替换会改写整份底稿。",
+	);
+	field.appendChild(hint);
+	return { field, group, hint };
+}
+
+function createPromptRestartPromptCard({
+	title,
+	badge,
+	readCandidate,
+	preTestId,
+	collapsible = false,
+	startCollapsed = false,
+}) {
+	const card = el("div", "prompt-restart-prompt-card");
+	const head = el("div", "prompt-restart-prompt-head");
+	const titles = el("div", "prompt-restart-prompt-titles");
+	const titleEl = el("span", "prompt-restart-prompt-title", title);
+	titles.appendChild(titleEl);
+	if (badge) {
+		titles.appendChild(el("span", "prompt-restart-prompt-badge", badge));
+	}
+	const metaEl = el("span", "prompt-restart-prompt-meta", "");
+	titles.appendChild(metaEl);
+	head.appendChild(titles);
+	const headActions = el("div", "prompt-restart-prompt-actions");
+	let fold = null;
+	let collapsed = Boolean(collapsible && startCollapsed);
+	const syncFold = () => {
+		if (!fold) return;
+		card.classList.toggle("is-collapsed", collapsed);
+		fold.setAttribute("aria-expanded", collapsed ? "false" : "true");
+		fold.textContent = collapsed ? "展开" : "收起";
+	};
+	if (collapsible) {
+		card.classList.add("is-collapsible");
+		fold = document.createElement("button");
+		fold.type = "button";
+		fold.className = "prompt-restart-prompt-fold";
+		fold.setAttribute("aria-controls", preTestId);
+		fold.addEventListener("click", (event) => {
+			event.preventDefault();
+			event.stopPropagation();
+			collapsed = !collapsed;
+			syncFold();
+		});
+		headActions.appendChild(fold);
+	}
+	headActions.appendChild(createPromptRestartCopyButton(readCandidate));
+	head.appendChild(headActions);
+	card.appendChild(head);
+	const pre = document.createElement("pre");
+	pre.className = "prompt-restart-readonly";
+	pre.setAttribute("data-testid", preTestId);
+	if (preTestId) pre.id = preTestId;
+	card.appendChild(pre);
+	const sync = (candidate) => {
+		const next = candidate ?? readCandidate?.();
+		titleEl.textContent =
+			next?.key === "frozen"
+				? "冻结原始提示词"
+				: (next?.label ?? title);
+		pre.textContent = next?.prompt ?? "";
+		metaEl.textContent = formatPromptRestartMeta(next?.prompt ?? "");
+		if (next?.truncated) metaEl.textContent += " · 已截断";
+	};
+	sync(readCandidate?.());
+	syncFold();
+	return { card, pre, titleEl, metaEl, sync };
+}
+
 function renderDagInspectorForCurrent() {
 	if (!inspectorSelection.dagRunId || !inspectorSelection.node) return;
 	renderDagInspector(
@@ -1116,7 +1287,7 @@ export function frontendGateLedgerLines(input) {
 /** DAG run 专属 prewrite-result 只读拉取（内联 fetch，不新增 api.js 依赖）。 */
 async function fetchPrewriteResultJson(dagRunId) {
 	try {
-		const res = await fetch(
+		const res = await fetchWithWorkspaceScope(
 			`/api/dag-runs/${encodeURIComponent(dagRunId)}/prewrite-result`,
 			{ credentials: "same-origin" },
 		);
@@ -1234,57 +1405,41 @@ async function renderPromptRestart(content, dagRunId, node) {
 
 	if (node.status !== "ERROR") {
 		// Non-failed nodes still show their frozen prompt — read-only.
-		const hint = el(
-			"p",
-			"muted",
-			`当前节点状态为 ${node.status ?? "unknown"}；仅失败（ERROR）节点支持编辑提示词并重启。以下可只读查看冻结提示词与历史失败候选。`,
+		const panel = el("div", "prompt-restart-panel is-readonly");
+		panel.appendChild(
+			createPromptRestartBanner({
+				tone: "readonly",
+				kicker: "只读",
+				title: `当前节点 ${node.status ?? "unknown"}`,
+				body: "仅失败（ERROR）节点支持编辑提示词并重启。以下可只读查看冻结提示词与历史失败候选。",
+			}),
 		);
-		hint.setAttribute("role", "status");
-		content.appendChild(hint);
-		const picker = el("label", "prompt-restart-field");
-		picker.appendChild(el("span", "muted", "提示词版本（只读）"));
-		const select = document.createElement("select");
-		select.className = "prompt-restart-mode-select";
-		select.setAttribute("data-testid", "prompt-restart-candidate");
-		for (const option of promptCandidateOptions) {
-			const element = document.createElement("option");
-			element.value = option.key;
-			element.textContent = option.label;
-			select.appendChild(element);
-		}
-		picker.appendChild(select);
-		if (promptCandidateOptions.length === 1) {
-			picker.appendChild(
-				el(
-					"span",
-					"muted",
-					historicalCandidatesMissing
+		const promptCard = createPromptRestartPromptCard({
+			title: "冻结原始提示词",
+			badge: "只读",
+			readCandidate: () => selectedCandidate,
+			preTestId: "prompt-restart-readonly",
+		});
+		const picker = createPromptRestartCandidatePicker({
+			options: promptCandidateOptions,
+			value: selectedCandidate.key,
+			label: "提示词版本（只读）",
+			hint:
+				promptCandidateOptions.length === 1
+					? historicalCandidatesMissing
 						? "该历史运行未保存失败 attempt 的实际提示词；新运行会在此列出。"
-						: "该节点没有已保存的失败 attempt。",
-				),
-			);
-		}
-		content.appendChild(picker);
-
-		const promptCard = el("div", "prompt-restart-prompt-card");
-		const promptHead = el("div", "prompt-restart-prompt-head");
-		promptHead.appendChild(el("span", "muted", "当前提示词"));
-		promptHead.appendChild(
-			createPromptRestartCopyButton(() => selectedCandidate),
-		);
-		promptCard.appendChild(promptHead);
-		const pre = document.createElement("pre");
-		pre.className = "prompt-restart-readonly";
-		pre.setAttribute("data-testid", "prompt-restart-readonly");
-		pre.textContent = selectedCandidate.prompt;
-		promptCard.appendChild(pre);
-		content.appendChild(promptCard);
-		select.addEventListener("change", () => {
-			selectedCandidate =
-				promptCandidateOptions.find((option) => option.key === select.value) ??
-				promptCandidateOptions[0];
-			pre.textContent = selectedCandidate.prompt;
+						: "该节点没有已保存的失败 attempt。"
+					: "可切换查看冻结底稿与历史失败候选。",
+			onChange: (nextKey) => {
+				selectedCandidate =
+					promptCandidateOptions.find((option) => option.key === nextKey) ??
+					promptCandidateOptions[0];
+				promptCard.sync(selectedCandidate);
+			},
 		});
+		panel.appendChild(picker.field);
+		panel.appendChild(promptCard.card);
+		content.appendChild(panel);
 		return;
 	}
 
@@ -1299,151 +1454,129 @@ async function renderPromptRestart(content, dagRunId, node) {
 		return;
 	}
 
-	const box = el("div", "prompt-restart-box");
+	const box = el("div", "prompt-restart-box prompt-restart-panel is-edit");
 	box.appendChild(
-		el(
-			"p",
-			"muted",
-			"编辑该失败节点的提示词并从它重启：父 run spec 保持冻结，将创建带修改提示词的续跑 run（实验能力，仅 ERROR 节点）。",
-		),
-	);
-	const candidateRow = el("label", "prompt-restart-field");
-	candidateRow.appendChild(el("span", "muted", "提示词版本"));
-	const candidateSelect = document.createElement("select");
-	candidateSelect.className = "prompt-restart-mode-select";
-	candidateSelect.setAttribute("data-testid", "prompt-restart-candidate");
-	for (const option of promptCandidateOptions) {
-		const element = document.createElement("option");
-		element.value = option.key;
-		element.textContent = option.label;
-		candidateSelect.appendChild(element);
-	}
-	candidateRow.appendChild(candidateSelect);
-	const candidateHint = el(
-		"span",
-		"muted",
-		promptCandidateOptions.length > 1
-			? "选择失败候选会载入全文替换；冻结原始提示词仍可使用追加模式。"
-			: historicalCandidatesMissing
-				? "该历史运行未保存失败 attempt 的实际提示词；新运行会在此列出。"
-				: "该节点没有已保存的失败 attempt；当前仅有冻结原始提示词。",
-	);
-	candidateRow.appendChild(candidateHint);
-	box.appendChild(candidateRow);
-
-	const modeRow = el("div", "prompt-restart-mode");
-	modeRow.appendChild(el("span", "muted", "编辑模式"));
-	const modeSelect = document.createElement("select");
-	modeSelect.className = "prompt-restart-mode-select";
-	modeSelect.setAttribute("data-testid", "prompt-restart-mode");
-	const appendOption = document.createElement("option");
-	appendOption.value = "append";
-	appendOption.textContent =
-		"追加指令（推荐）：保留原提示词，在末尾追加 operator_addendum 块";
-	const replaceOption = document.createElement("option");
-	replaceOption.value = "replace";
-	replaceOption.textContent = "全文替换（高级）：替换整个提示词";
-	modeSelect.appendChild(appendOption);
-	modeSelect.appendChild(replaceOption);
-	modeSelect.value = "append";
-	modeRow.appendChild(modeSelect);
-	box.appendChild(modeRow);
-
-	const baseLabel = el(
-		"div",
-		"prompt-restart-field prompt-restart-prompt-card",
-	);
-	const baseHead = el("div", "prompt-restart-prompt-head");
-	baseHead.appendChild(
-		el("span", "muted", `冻结提示词（只读底稿 · ${nodeId}）`),
+		createPromptRestartBanner({
+			tone: "edit",
+			kicker: "可编辑",
+			title: "从失败节点编辑提示词并重启",
+			body: "父 run spec 保持冻结，将创建带修改提示词的续跑 run。",
+		}),
 	);
-	baseHead.appendChild(createPromptRestartCopyButton(() => selectedCandidate));
-	baseLabel.appendChild(baseHead);
-	const baseBlock = document.createElement("pre");
-	baseBlock.className = "prompt-restart-readonly";
-	baseBlock.setAttribute("data-testid", "prompt-restart-base");
-	baseBlock.textContent = selectedCandidate.prompt;
-	baseLabel.appendChild(baseBlock);
-	box.appendChild(baseLabel);
+	const promptCard = createPromptRestartPromptCard({
+		title: `冻结提示词（只读底稿 · ${nodeId}）`,
+		badge: "底稿",
+		readCandidate: () => selectedCandidate,
+		preTestId: "prompt-restart-base",
+		collapsible: true,
+		startCollapsed: true,
+	});
+	const picker = createPromptRestartCandidatePicker({
+		options: promptCandidateOptions,
+		value: selectedCandidate.key,
+		label: "提示词版本",
+		hint:
+			promptCandidateOptions.length > 1
+				? "选择失败候选会载入全文替换；冻结原始提示词仍可使用追加模式。"
+				: historicalCandidatesMissing
+					? "该历史运行未保存失败 attempt 的实际提示词；新运行会在此列出。"
+					: "该节点没有已保存的失败 attempt；当前仅有冻结原始提示词。",
+		onChange: (nextKey) => {
+			selectedCandidate =
+				promptCandidateOptions.find((option) => option.key === nextKey) ??
+				promptCandidateOptions[0];
+			promptCard.sync(selectedCandidate);
+			replaceArea.value = selectedCandidate.prompt;
+			if (selectedCandidate.key !== "frozen") {
+				modeSelect.value = "replace";
+			}
+			picker.hintEl.hidden = false;
+			picker.hintEl.textContent = selectedCandidate.truncated
+				? "该候选已截断，仅供查看，不能直接提交重启。"
+				: selectedCandidate.key === "frozen"
+					? "冻结原始提示词可使用追加或全文替换。"
+					: "已载入该失败候选；可在全文替换编辑器中修订后重启。";
+			applyModeVisibility();
+		},
+	});
+	const modeSwitch = createPromptRestartModeSwitch({
+		value: "append",
+		onChange: () => applyModeVisibility(),
+	});
+	const modeSelect = modeSwitch.group;
+	const toolbar = el("div", "prompt-restart-toolbar");
+	toolbar.appendChild(picker.field);
+	toolbar.appendChild(modeSwitch.field);
+	box.appendChild(toolbar);
 
-	const addendumLabel = el("label", "prompt-restart-field");
+	const addendumLabel = el("label", "prompt-restart-field prompt-restart-work");
+	addendumLabel.appendChild(
+		el("span", "prompt-restart-label", "追加指令"),
+	);
 	addendumLabel.appendChild(
 		el(
-			"span",
-			"muted",
-			"追加指令（将包裹为 <operator_addendum> 块附加到原提示词末尾）",
+			"p",
+			"prompt-restart-hint",
+			"将包裹为 <operator_addendum> 块附加到原提示词末尾",
 		),
 	);
 	const addendumArea = document.createElement("textarea");
-	addendumArea.className = "prompt-restart-textarea";
-	addendumArea.rows = 6;
+	addendumArea.className = "prompt-restart-textarea prompt-restart-textarea-work";
+	addendumArea.rows = 8;
 	addendumArea.placeholder = "例如：重点检查 X 边界；输出前先自检 Y 约束…";
 	addendumArea.setAttribute("data-testid", "prompt-restart-addendum");
 	addendumLabel.appendChild(addendumArea);
 	box.appendChild(addendumLabel);
 
-	const replaceLabel = el("label", "prompt-restart-field");
-	replaceLabel.appendChild(el("span", "muted", `完整提示词（${nodeId}）`));
+	const replaceLabel = el("label", "prompt-restart-field prompt-restart-work");
+	replaceLabel.appendChild(
+		el("span", "prompt-restart-label", `完整提示词（${nodeId}）`),
+	);
 	const replaceArea = document.createElement("textarea");
-	replaceArea.className = "prompt-restart-textarea";
-	replaceArea.rows = 16;
+	replaceArea.className = "prompt-restart-textarea prompt-restart-textarea-work";
+	replaceArea.rows = 12;
 	replaceArea.value = selectedCandidate.prompt;
 	replaceArea.setAttribute("data-testid", "prompt-restart-textarea");
 	replaceLabel.appendChild(replaceArea);
 	box.appendChild(replaceLabel);
 
+	const baseLabel = promptCard.card;
+	box.appendChild(baseLabel);
+
 	const applyModeVisibility = () => {
 		const append = modeSelect.value === "append";
-		baseLabel.style.display = append ? "" : "none";
-		addendumLabel.style.display = append ? "" : "none";
-		replaceLabel.style.display = append ? "none" : "";
+		baseLabel.classList.toggle("is-hidden", !append);
+		addendumLabel.classList.toggle("is-hidden", !append);
+		replaceLabel.classList.toggle("is-hidden", append);
 	};
-	modeSelect.addEventListener("change", applyModeVisibility);
-	candidateSelect.addEventListener("change", () => {
-		selectedCandidate =
-			promptCandidateOptions.find(
-				(option) => option.key === candidateSelect.value,
-			) ?? promptCandidateOptions[0];
-		baseBlock.textContent = selectedCandidate.prompt;
-		replaceArea.value = selectedCandidate.prompt;
-		if (selectedCandidate.key !== "frozen") {
-			modeSelect.value = "replace";
-		}
-		if (candidateHint) {
-			candidateHint.textContent = selectedCandidate.truncated
-				? "该候选已截断，仅供查看，不能直接提交重启。"
-				: selectedCandidate.key === "frozen"
-					? "冻结原始提示词可使用追加或全文替换。"
-					: "已载入该失败候选；可在全文替换编辑器中修订后重启。";
-		}
-		applyModeVisibility();
-	});
 	applyModeVisibility();
 
 	const reasonLabel = el("label", "prompt-restart-field");
-	reasonLabel.appendChild(el("span", "muted", "重启原因（结构化说明）"));
+	reasonLabel.appendChild(el("span", "prompt-restart-label", "重启原因"));
+	reasonLabel.appendChild(
+		el("p", "prompt-restart-hint", "结构化说明，会写入续跑 provenance"),
+	);
 	const reasonArea = document.createElement("textarea");
-	reasonArea.className = "prompt-restart-textarea";
+	reasonArea.className = "prompt-restart-textarea prompt-restart-textarea-compact";
 	reasonArea.rows = 3;
 	reasonArea.value = `operator-prompt-override / run=${dagRunId} / node=${nodeId} / 手工编辑失败节点提示词后重启`;
 	reasonArea.setAttribute("data-testid", "prompt-restart-reason");
 	reasonLabel.appendChild(reasonArea);
 	box.appendChild(reasonLabel);
 
-	const row = el("div", "prompt-restart-actions");
+	const row = el("div", "prompt-restart-actions prompt-restart-footer");
+	const status = el("p", "prompt-restart-status", "");
+	status.setAttribute("role", "status");
+	status.setAttribute("aria-live", "polite");
 	const submit = document.createElement("button");
 	submit.type = "button";
 	submit.className = "prompt-restart-submit";
 	submit.textContent = "资格预检并重启";
 	submit.setAttribute("data-testid", "prompt-restart-submit");
+	row.appendChild(status);
 	row.appendChild(submit);
 	box.appendChild(row);
 
-	const status = el("p", "prompt-restart-status", "");
-	status.setAttribute("role", "status");
-	status.setAttribute("aria-live", "polite");
-	box.appendChild(status);
-
 	content.appendChild(box);
 
 	const setStatus = (text, isError = false) => {
@@ -1535,7 +1668,7 @@ async function renderPromptRestart(content, dagRunId, node) {
 						setStatus(`重启完成，新 run：${newRunId}`);
 						const open = document.createElement("button");
 						open.type = "button";
-						open.className = "prompt-restart-submit";
+						open.className = "prompt-restart-submit is-secondary";
 						open.textContent = "打开新 run";
 						open.addEventListener("click", () => {
 							window.location.hash = `#/dag/${encodeURIComponent(String(newRunId))}`;
@@ -1880,7 +2013,7 @@ function effectiveExecutionKey(dagRunId, node) {
 async function fetchExecutionOutput(dagRunId, nodeId, key) {
 	const url = `/api/dag-runs/${encodeURIComponent(dagRunId)}/nodes/${encodeURIComponent(nodeId)}/execution-output?key=${encodeURIComponent(key)}`;
 	try {
-		const res = await fetch(url);
+		const res = await fetchWithWorkspaceScope(url);
 		let body = null;
 		try {
 			body = await res.json();
@@ -2378,6 +2511,16 @@ function fillDagInspectorContent(content, dagRunId, node) {
 	}
 }
 
+function inspectorNodePurpose(node) {
+	return describeDagNodePurpose(node?.nodeId, node);
+}
+
+function appendInspectorPurpose(title, node) {
+	const purpose = inspectorNodePurpose(node);
+	if (!purpose) return;
+	title.appendChild(el("p", "dag-inspector-purpose", purpose));
+}
+
 function buildDagInspectorHeader(dagRunId, node) {
 	const header = el("div", "dag-inspector-header");
 	header.dataset.dagRunId = String(dagRunId ?? "");
@@ -2385,6 +2528,7 @@ function buildDagInspectorHeader(dagRunId, node) {
 	const title = el("div", "dag-inspector-title");
 	title.appendChild(el("h3", null, "节点检查器"));
 	title.appendChild(el("div", "dag-inspector-node", node.nodeId));
+	appendInspectorPurpose(title, node);
 	header.appendChild(title);
 	const controls = el("div", "dag-inspector-controls");
 	const status = badge(node.status ?? "unknown");
@@ -2464,6 +2608,16 @@ function syncDagInspectorHeader(panel, dagRunId, node) {
 	header.dataset.dagNodeId = String(node.nodeId ?? "");
 	const nodeLabel = header.querySelector(".dag-inspector-node");
 	if (nodeLabel) nodeLabel.textContent = node.nodeId;
+	const title = header.querySelector(".dag-inspector-title");
+	const purposeLine = header.querySelector(".dag-inspector-purpose");
+	const purpose = inspectorNodePurpose(node);
+	if (purposeLine && purpose) {
+		purposeLine.textContent = purpose;
+	} else if (purposeLine && !purpose) {
+		purposeLine.remove();
+	} else if (!purposeLine && purpose && title) {
+		title.appendChild(el("p", "dag-inspector-purpose", purpose));
+	}
 	const status = header.querySelector(".dag-inspector-status");
 	if (status) {
 		const next = badge(node.status ?? "unknown");

package/dist/worker/observe/static/views/dag.d.ts

@@ -0,0 +1,13 @@
+export interface DagNodeRemark {
+	failed: boolean;
+	text: string;
+	isErrorSummary: boolean;
+}
+
+export function resolveNodeRemark(node: {
+	status?: string | null;
+	errorPreview?: string | null;
+	label?: string | null;
+	nodeId: string;
+	rank?: string | number | null;
+} | null | undefined): DagNodeRemark;

package/dist/worker/observe/static/views/dag.js

@@ -70,6 +70,7 @@ import {
 	dashboardVisibleFeatures,
 	findDagForRun,
 } from "../dag-model.js";
+import { describeDagNodePurpose } from "../dag-node-purpose.js";
 import { layoutDag } from "../dag-layout.js";
 import {
 	showView,
@@ -136,7 +137,7 @@ export function extractFirstErrorSummary(errorPreview) {
 	return effective ?? "";
 }
 
-/** Resolve 备注 cell content for a DAG node (failed → summary; else label). */
+/** Resolve 备注 cell content for a DAG node (failed → summary; else purpose). */
 export function resolveNodeRemark(node) {
 	const failed = isNodeFailed(node?.status);
 	if (failed) {
@@ -147,10 +148,10 @@ export function resolveNodeRemark(node) {
 			isErrorSummary: Boolean(summary),
 		};
 	}
-	const label = typeof node?.label === "string" ? node.label.trim() : "";
+	const purpose = describeDagNodePurpose(node?.nodeId, node);
 	return {
 		failed: false,
-		text: label || "—",
+		text: purpose || "—",
 		isErrorSummary: false,
 	};
 }
@@ -363,7 +364,7 @@ export async function renderDagDetail(dagRunId, initial = true) {
 			"page-action-btn",
 			"在操作台中止此运行 →",
 		);
-		interruptLink.href = `/#/recovery?dagRunId=${encodeURIComponent(dag.dagRunId)}&intent=interrupt`;
+		interruptLink.href = `/#/operate/recovery?dagRunId=${encodeURIComponent(dag.dagRunId)}&intent=interrupt`;
 		interruptLink.setAttribute("data-testid", "inspect-dag-interrupt-link");
 		interruptLink.title = "只跳转到操作台 Recovery，不会在观测页执行中止";
 		primaryEntries.push(["协作中止", interruptLink]);
@@ -481,6 +482,7 @@ export function startDagPolling(dagRunId, initial = true) {
 		const active = await renderDagDetail(dagRunId, isInitial);
 		if (generation !== uiState.pollingGeneration || !active) return;
 		const delay = detailPollDelay("running", isPageVisible());
+		if (delay == null) return;
 		uiState.dagPollTimer = setTimeout(() => {
 			uiState.dagPollTimer = null;
 			void poll(false);