@tea-agent/loop-agent 0.42.0-next.9 → 0.43.0-next.1

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

@@ -16,6 +16,12 @@ import {
 	describeTransferError,
 	formatContextTransferReasonList,
 } from "../dag-context-reason-labels.js";
+import {
+	describeInspectorMeta,
+	inspectorFieldLabel,
+	inspectorListValueLabel,
+	inspectorValueLabel,
+} from "../dag-inspector-humanize.js";
 import {
 	fetchJson,
 	fetchSpecEvidenceFile,
@@ -31,7 +37,6 @@ import {
 } from "../api.js";
 import {
 	badge,
-	formatLedgerSummary,
 	formatMs,
 	prettyJsonBlock,
 } from "../format.js";
@@ -72,7 +77,7 @@ import { createCustomSelect } from "../custom-select.js";
 // reused inspector shell never keeps stale node closures: every render writes
 // the latest {dagRunId, node} here and tab clicks re-render from the same
 // reference, always resolving the currently selected node identity.
-const inspectorSelection = { dagRunId: null, node: null };
+const inspectorSelection = { dagRunId: null, node: null, run: null };
 
 /**
  * 失败状态行统一入口：错误信息中嵌入的已知 reason code 先给中文语义
@@ -111,34 +116,95 @@ export const ARTIFACT_FILE_PREVIEW_SURFACES = Object.freeze({
 	revisionSelection: "artifact-revision-current-preview",
 });
 
+const INSPECTOR_PAGE_GUIDANCE = Object.freeze({
+	overview: {
+		eyebrow: "先看结论",
+		title: "这个节点做了什么",
+		body: "先看当前状态、执行方式和结果来源；需要追细节时，再进入后面的页面。",
+	},
+	input: {
+		eyebrow: "运行前",
+		title: "系统原本准备怎么做",
+		body: "这里是开始执行前保存的任务说明、依赖关系和读写范围，不代表这些内容后来一定被实际使用。",
+	},
+	context: {
+		eyebrow: "执行时",
+		title: "AI 实际拿到了哪些资料",
+		body: "这一页只展示系统在下发任务时真正记录到的内容；没有记录时会明确说明，不会用运行前设置代替。",
+	},
+	timeline: {
+		eyebrow: "执行过程",
+		title: "这一步实际发生了什么",
+		body: "按顺序查看 AI 的回复、工具调用或命令结果；失败时优先看标红步骤和错误输出。",
+	},
+	"spec-evidence": {
+		eyebrow: "需求依据",
+		title: "它有没有真的读过需求",
+		body: "只有成功读取文件或查询知识库的记录才算证据；模型自己提到文件名不算。",
+	},
+	output: {
+		eyebrow: "执行结果",
+		title: "它产出了什么，谁会用",
+		body: "先确认文件是否真实生成、能否替换以及后续谁会使用，再查看具体输出内容。",
+	},
+	lineage: {
+		eyebrow: "来源与影响",
+		title: "这一步从哪里来，会影响哪里",
+		body: "用于判断结果是本次生成还是沿用旧运行，以及替换或重跑会从哪个位置继续。",
+	},
+});
+
+function buildInspectorPageLead(tab) {
+	const copy = INSPECTOR_PAGE_GUIDANCE[tab];
+	if (!copy) return null;
+	const lead = el("section", "inspector-page-lead");
+	lead.dataset.page = tab;
+	lead.append(
+		el("span", "inspector-page-eyebrow", copy.eyebrow),
+		el("h4", null, copy.title),
+		el("p", null, copy.body),
+	);
+	return lead;
+}
+
+function ensureInspectorPageLead(content, tab) {
+	const existing = content.querySelector(
+		`.inspector-page-lead[data-page="${tab}"]`,
+	);
+	if (existing) return existing;
+	const lead = buildInspectorPageLead(tab);
+	if (lead) content.insertBefore(lead, content.firstChild);
+	return lead;
+}
+
 export const CONTEXT_EXPORT_TARGETS = Object.freeze([
 	{
 		value: "generic",
-		label: "通用 Agent 交接包",
-		description: "适合交给其他 Agent 或 LLM 继续处理",
+		label: "通用 AI 交接包",
+		description: "适合交给其他 AI 工具继续处理",
 		icon: "ri-robot-2-line",
-		contents: "receipt · manifest · handoff.md",
+		contents: "执行时记录 · 文件清单 · 交接说明",
 	},
 	{
 		value: "pi-session",
-		label: "Pi 可重开会话",
-		description: "兼容时附带可由 Pi 打开的 session JSONL",
+		label: "可在 Pi 中恢复的会话",
+		description: "如果记录兼容，会附带可直接恢复的会话文件",
 		icon: "ri-terminal-box-line",
-		contents: "receipt · manifest · session.jsonl（兼容时）",
+		contents: "执行时记录 · 文件清单 · 可恢复的 Pi 会话（兼容时）",
 	},
 	{
 		value: "readable",
 		label: "可读执行记录",
 		description: "便于人工审阅，不承诺完整重现执行",
 		icon: "ri-file-list-3-line",
-		contents: "receipt · manifest · transcript.md",
+		contents: "执行时记录 · 文件清单 · 可读对话记录",
 	},
 	{
 		value: "pi-handoff",
-		label: "Pi Handoff 交接包",
-		description: "面向 Pi Handoff 工作流的兼容格式",
+		label: "Pi 专用交接包",
+		description: "用于把资料交给 Pi 的继续处理流程",
 		icon: "ri-share-forward-box-line",
-		contents: "receipt · manifest · handoff.md",
+		contents: "执行时记录 · 文件清单 · Pi 交接说明",
 	},
 ]);
 
@@ -398,7 +464,7 @@ function createPromptRestartPromptCard({
 		const next = candidate ?? readCandidate?.();
 		titleEl.textContent =
 			next?.key === "frozen"
-				? "冻结原始提示词"
+				? "运行开始时的提示词"
 				: (next?.label ?? title);
 		pre.textContent = next?.prompt ?? "";
 		metaEl.textContent = formatPromptRestartMeta(next?.prompt ?? "");
@@ -415,6 +481,7 @@ function renderDagInspectorForCurrent() {
 		inspectorSelection.dagRunId,
 		inspectorSelection.node,
 		false,
+		inspectorSelection.run,
 	);
 }
 
@@ -628,6 +695,7 @@ async function renderSpecEvidence(content, dagRunId, nodeId, cachedEvidence) {
 		restoreInspectorContentScroll(content, dagRunId, nodeId, "spec-evidence");
 		return;
 	}
+	ensureInspectorPageLead(content, "spec-evidence");
 	if (!evidence) {
 		content.appendChild(el("p", "empty", "无法加载规范证据。"));
 		restoreInspectorContentScroll(content, dagRunId, nodeId, "spec-evidence");
@@ -638,8 +706,8 @@ async function renderSpecEvidence(content, dagRunId, nodeId, cachedEvidence) {
 	const statusLabels = {
 		"spec-read": "已读取规范",
 		"source-bound": "已绑定任务源",
-		"spec-injected": "仅注入 skill",
-		"search-only": "仅执行检索",
+		"spec-injected": "已提供阅读能力，但没有读取记录",
+		"search-only": "只搜索过，没有读取内容",
 		"kb-queried": "已观察知识库查询",
 		"no-evidence": "未观察到读取",
 	};
@@ -680,7 +748,7 @@ async function renderSpecEvidence(content, dagRunId, nodeId, cachedEvidence) {
 	};
 
 	appendListSection(
-		"注入的 Skill",
+		"提供给节点的技能",
 		evidence.skillInjection?.skills,
 		(skill) => {
 			const item = el("li", null);
@@ -705,9 +773,9 @@ async function renderSpecEvidence(content, dagRunId, nodeId, cachedEvidence) {
 			icon.setAttribute("aria-hidden", "true");
 			button.append(
 				icon,
-				document.createTextNode(` ${source.kind}: `),
+				document.createTextNode(` ${inspectorListValueLabel(source.kind)}: `),
 				el("code", null, source.path),
-				document.createTextNode(` · sha256 ${source.sha256.slice(0, 12)}…`),
+				document.createTextNode(` · 内容校验码 ${source.sha256.slice(0, 12)}…`),
 			);
 			button.addEventListener("click", () =>
 				onSpecEvidenceFileClick(
@@ -767,7 +835,7 @@ async function renderSpecEvidence(content, dagRunId, nodeId, cachedEvidence) {
 			item.appendChild(button);
 			return item;
 		},
-		"unavailable：未观察到规范读取。",
+		"没有记录到节点读取规范文件。",
 	);
 	appendListSection(
 		`规范检索（${evidence.specSearches?.length ?? 0}）`,
@@ -782,7 +850,7 @@ async function renderSpecEvidence(content, dagRunId, nodeId, cachedEvidence) {
 			);
 			return item;
 		},
-		"unavailable：未观察到规范检索。",
+		"没有记录到节点检索规范。",
 	);
 	appendListSection(
 		`知识库查询（${evidence.knowledgeBaseQueries?.length ?? 0}）`,
@@ -794,7 +862,7 @@ async function renderSpecEvidence(content, dagRunId, nodeId, cachedEvidence) {
 			item.append(icon, document.createTextNode(` ${query.connector}`));
 			return item;
 		},
-		"unavailable：未观察到知识库查询；connector 可能未配置或未调用。",
+		"没有记录到知识库查询；可能未配置知识库连接，或节点没有使用它。",
 	);
 
 	if (
@@ -809,10 +877,10 @@ async function renderSpecEvidence(content, dagRunId, nodeId, cachedEvidence) {
 			icon,
 			document.createTextNode(
 				evidence.status === "source-bound"
-					? "DAG 已绑定权威任务源及内容哈希，但尚未观察到成功的 read 工具调用；绑定证明上下文来源，read 事件才证明节点读取了完整文件。"
+					? "系统已确认任务来源和文件版本，但没有记录到节点成功读取完整文件。仅绑定文件不能证明节点真的读过内容。"
 					: evidence.status === "no-evidence"
-						? "未观察到规范读取。只有 session event 中成功配对的 read 工具调用才算已读取，模型总结或文件名命中不能作为证明。"
-						: "规范 skill 已注入，但未观察到规范读取或知识库查询；grep/find/ls 只能证明检索，不能替代 read。",
+						? "没有记录到节点读取规范。模型总结里提到文件名，不等于节点真正读取了文件。"
+						: "已把规范阅读能力提供给节点，但没有记录到它读取规范或查询知识库；只搜索到文件名不等于读过文件内容。",
 			),
 		);
 		content.appendChild(warning);
@@ -923,7 +991,7 @@ function renderSpecEvidenceDetail(content, dagRunId, nodeId) {
 			el(
 				"span",
 				"spec-evidence-detail-hash",
-				`绑定 sha256 ${String(detail.data.sha256 ?? "").slice(0, 12)}… · 当前 ${detail.data.hashMatch ? "一致" : "不一致"}`,
+				`登记的内容校验码 ${String(detail.data.sha256 ?? "").slice(0, 12)}… · 当前文件${detail.data.hashMatch ? "一致" : "不一致"}`,
 			),
 		);
 	} else if (detail.source === "read" && detail.data?.readAt) {
@@ -969,15 +1037,29 @@ function renderSpecEvidenceDetail(content, dagRunId, nodeId) {
 
 function sourceLabel(source) {
 	if (source === "defaults") return "继承默认值";
-	if (source === "schema-default") return "schema 默认";
-	if (source === "merged") return "合并";
+	if (source === "schema-default") return "系统默认值";
+	if (source === "merged") return "合并后的值";
 	return null;
 }
 
 function appendMetaRow(dl, label, value, source) {
 	if (value == null || value === "") return;
-	const dt = el("dt", null, label);
-	const dd = el("dd", null, String(value));
+	const copy = describeInspectorMeta(label, value);
+	const dt = el("dt", null, copy.label);
+	const dd = el("dd", null, copy.value);
+	const labelHelp = [
+		copy.help ? `含义：${copy.help}` : null,
+		copy.rawLabel ? `技术字段：${copy.rawLabel}` : null,
+	].filter(Boolean);
+	if (labelHelp.length > 0) {
+		const tooltipText = labelHelp.join("\n");
+		const help = el("span", "node-input-summary-help", "?");
+		help.tabIndex = 0;
+		help.setAttribute("data-tooltip", tooltipText);
+		help.setAttribute("aria-label", tooltipText);
+		dt.appendChild(help);
+	}
+	if (copy.rawValue) dd.setAttribute("title", `原始值：${copy.rawValue}`);
 	const inherited = sourceLabel(source);
 	if (inherited) {
 		dd.appendChild(document.createTextNode(" "));
@@ -990,12 +1072,20 @@ function appendMetaRow(dl, label, value, source) {
 function appendCodeList(parent, title, values) {
 	if (!values || values.length === 0) return;
 	const section = el("section", "node-input-section");
-	section.appendChild(el("h4", null, title));
+	const heading = el("h4", null, inspectorFieldLabel(title));
+	if (inspectorFieldLabel(title) !== title) {
+		heading.setAttribute("title", `技术字段：${title}`);
+	}
+	section.appendChild(heading);
 	const list = el("ul", "node-input-code-list");
 	for (const value of values) {
 		const item = document.createElement("li");
 		const code = document.createElement("code");
-		code.textContent = String(value);
+		const rawValue = String(value);
+		code.textContent = inspectorListValueLabel(rawValue);
+		if (code.textContent !== rawValue) {
+			code.setAttribute("title", `原始值：${rawValue}`);
+		}
 		item.appendChild(code);
 		list.appendChild(item);
 	}
@@ -1063,9 +1153,9 @@ function renderDagNodeInputDetail(content, data) {
 		section.appendChild(el("h4", null, "任务正文"));
 		if (data.prompt.source?.path) {
 			const meta = el("p", "muted");
-			meta.textContent = `source: ${data.prompt.source.path}${
+			meta.textContent = `任务说明来源：${data.prompt.source.path}${
 				data.prompt.source.sha256Prefix
-					? ` (sha256 ${data.prompt.source.sha256Prefix}…)`
+					? `（内容校验码 ${data.prompt.source.sha256Prefix}…）`
 					: ""
 			}`;
 			section.appendChild(meta);
@@ -1085,7 +1175,7 @@ function renderDagNodeInputDetail(content, data) {
 
 	if (data.executorInput) {
 		const section = el("section", "node-input-section");
-		section.appendChild(el("h4", null, "执行器输入摘要"));
+		section.appendChild(el("h4", null, "将如何执行"));
 		const dl = el("dl", "node-input-summary");
 		appendMetaRow(dl, "kind", data.executorInput.kind, null);
 		if (data.executorInput.modelHint) {
@@ -1158,7 +1248,7 @@ function renderDagNodeInputDetail(content, data) {
 
 	if (data.boundaries) {
 		const section = el("section", "node-input-section");
-		section.appendChild(el("h4", null, "边界与输出契约"));
+		section.appendChild(el("h4", null, "读写范围与输出要求"));
 		const dl = el("dl", "node-input-summary");
 		appendMetaRow(dl, "outputMode", data.boundaries.outputMode, null);
 		appendMetaRow(
@@ -1169,7 +1259,7 @@ function renderDagNodeInputDetail(content, data) {
 		);
 		section.appendChild(dl);
 		if (data.boundaries.outputContract) {
-			section.appendChild(el("h5", null, "outputContract"));
+			section.appendChild(el("h5", null, "输出内容要求"));
 			section.appendChild(renderMarkdown(data.boundaries.outputContract));
 		}
 		appendCodeList(section, "allowedPaths", data.boundaries.allowedPaths);
@@ -1181,7 +1271,7 @@ function renderDagNodeInputDetail(content, data) {
 	if (data.piExtensionRunFacts) {
 		const facts = data.piExtensionRunFacts;
 		const section = el("section", "node-input-section");
-		section.appendChild(el("h4", null, "Pi 扩展运行事实"));
+		section.appendChild(el("h4", null, "AI 扩展加载结果"));
 		if (!facts.exists) {
 			section.appendChild(
 				el(
@@ -1222,7 +1312,7 @@ function renderDagNodeInputDetail(content, data) {
 
 	if (data.promptFingerprint?.exists) {
 		const section = el("section", "node-input-section");
-		section.appendChild(el("h4", null, "Assembled prompt 指纹"));
+		section.appendChild(el("h4", null, "最终提示内容校验信息"));
 		const dl = el("dl", "node-input-summary");
 		appendMetaRow(
 			dl,
@@ -1274,6 +1364,7 @@ async function renderDagNodeInput(content, dagRunId, node) {
 		preserveIntent: true,
 	});
 	clearNode(content);
+	ensureInspectorPageLead(content, "input");
 	const loading = el("p", "muted", UI_TEXT.inputLoading);
 	loading.setAttribute("role", "status");
 	loading.setAttribute("aria-live", "polite");
@@ -1293,6 +1384,7 @@ async function renderDagNodeInput(content, dagRunId, node) {
 	}
 
 	clearNode(content);
+	ensureInspectorPageLead(content, "input");
 	const finishInputRender = () => {
 		restoreInspectorContentScroll(content, dagRunId, nodeId, "input");
 		uiState.dagNodeInputLoading = false;
@@ -1355,31 +1447,45 @@ export function frontendGateLedgerLines(input) {
 	if (prewriteResult?.ok && prewriteResult.body) {
 		const parsed = prewriteResult.body;
 		if (parsed?.classification) {
-			lines.push(`classification: ${String(parsed.classification)}`);
+			const classifications = {
+				accepted: "通过，可以进入写入阶段",
+				blocked: "未通过，已阻止写入",
+				warning: "有提醒，需要留意",
+			};
+			lines.push(
+				`写入前检查：${classifications[parsed.classification] ?? String(parsed.classification)}`,
+			);
 			if (parsed.failureCode) {
-				lines.push(`failureCode: ${String(parsed.failureCode)}`);
+				lines.push(`问题编号：${String(parsed.failureCode)}`);
 			}
 			if (parsed.failureReason) {
-				lines.push(`failureReason: ${String(parsed.failureReason)}`);
+				lines.push(`原因：${String(parsed.failureReason)}`);
 			}
 		} else {
-			lines.push("frontend-prewrite-result.json 内容无法解析为结构化结果。");
+			lines.push("写入前检查结果无法解析，请查看运行记录。");
 		}
 	} else if (prewriteResult && prewriteResult.status === 404) {
-		lines.push("frontend-prewrite-result.json 尚未生成（门禁未执行或缺失）。");
+		lines.push("写入前检查尚未执行，或没有留下检查结果。");
 	} else if (prewriteResult) {
 		lines.push(
-			"frontend-prewrite-result.json 读取失败（只读接口拒绝/服务异常，安全降级）。",
+			"暂时无法读取写入前检查结果；为安全起见，不把它当成已通过。",
 		);
 	} else {
-		lines.push("frontend-prewrite-result.json 尚未生成（门禁未执行或缺失）。");
+		lines.push("写入前检查尚未执行，或没有留下检查结果。");
 	}
 	if (ledgerBody && ledgerBody.present === true) {
-		lines.push(formatLedgerSummary(ledgerBody));
+		const value = (candidate) =>
+			typeof candidate === "number" ? candidate : "未知";
+		lines.push(
+			`需求覆盖记录：原始片段 ${value(ledgerBody.fragmentCount)} 个；整理后的需求 ${value(ledgerBody.canonicalRequirementCount)} 条；待处理 ${value(ledgerBody.unresolvedCount)} 条；冲突 ${value(ledgerBody.conflictCount)} 条。`,
+		);
+		if (ledgerBody.stale === true) {
+			lines.push("提醒：任务来源后来发生过变化，这份需求覆盖记录可能已经过时。");
+		}
 	} else if (ledgerBody) {
-		lines.push("ledger: 无（任务无引用或 ledger 缺失，不伪造计数）");
+		lines.push("没有需求覆盖记录；可能是任务没有引用资料，或记录尚未生成。不会猜测数量。");
 	} else if (taskId) {
-		lines.push("ledger: 暂不可查（只读接口失败，安全降级）");
+		lines.push("需求覆盖记录暂时无法查看；不会把读取失败当成没有问题。");
 	}
 	return lines;
 }
@@ -1426,7 +1532,7 @@ export async function fetchFrontendGateLedgerData(dagRunId) {
 async function renderFrontendGateLedger(content, dagRunId) {
 	const section = el("section", "node-input-section");
 	section.appendChild(
-		el("h4", null, "Frontend prewrite 门禁 / source fidelity ledger"),
+		el("h4", null, "前端写入前检查与需求覆盖记录"),
 	);
 	const status = el("p", "muted", "加载中…");
 	status.setAttribute("role", "status");
@@ -1472,11 +1578,11 @@ function buildContextExportSection(dagRunId, node) {
 	const heading = el("div", "context-export-heading");
 	const headingCopy = el("div", null);
 	headingCopy.appendChild(el("span", "context-export-eyebrow", "上下文交接包"));
-	const title = el("h4", null, "把这个节点交给另一个 Agent");
+	const title = el("h4", null, "把这个节点的资料交给另一个 AI");
 	title.id = "context-export-title";
 	headingCopy.appendChild(title);
 	headingCopy.appendChild(
-		el("p", null, "选择接收方式和保护级别，系统会生成一个可核验的 ZIP 交接包。"),
+		el("p", null, "选择接收方式和是否脱敏，系统会生成一个带来源校验信息的 ZIP 交接包。"),
 	);
 	const invariant = el("div", "context-export-invariant");
 	const lockIcon = el("i", "ri-lock-2-line");
@@ -1560,10 +1666,10 @@ function buildContextExportSection(dagRunId, node) {
 	ticket.setAttribute("aria-live", "polite");
 	const ticketTop = el("div", "context-export-ticket-top");
 	ticketTop.append(
-		el("span", "context-export-ticket-type", "CONTEXT / ZIP"),
+		el("span", "context-export-ticket-type", "交接资料 / ZIP"),
 		el("span", "context-export-ticket-safety", "已脱敏"),
 	);
-	const ticketTitle = el("strong", "context-export-ticket-title", "通用 Agent 交接包");
+	const ticketTitle = el("strong", "context-export-ticket-title", "通用 AI 交接包");
 	const ticketRows = el("dl", "context-export-ticket-rows");
 	const appendTicketRow = (label, value, className) => {
 		const term = el("dt", null, label);
@@ -1571,12 +1677,12 @@ function buildContextExportSection(dagRunId, node) {
 		ticketRows.append(term, detail);
 		return detail;
 	};
-	const recipientValue = appendTicketRow("用途", "适合交给其他 Agent 或 LLM 继续处理");
+	const recipientValue = appendTicketRow("用途", "适合交给其他 AI 工具继续处理");
 	const contentsValue = appendTicketRow("包含", CONTEXT_EXPORT_TARGETS[0].contents, "is-mono");
 	const protectionValue = appendTicketRow("保护", "自动隐藏匹配到的疑似凭据");
 	const attemptValue = appendTicketRow(
 		"来源",
-		`${node.nodeId} · attempt ${selectedAttemptNumber(dagRunId, node) ?? 1}`,
+		`${node.nodeId} · 第 ${selectedAttemptNumber(dagRunId, node) ?? 1} 次执行`,
 		"is-mono",
 	);
 	ticket.append(
@@ -1584,7 +1690,7 @@ function buildContextExportSection(dagRunId, node) {
 		el("span", "context-export-ticket-label", "即将生成"),
 		ticketTitle,
 		ticketRows,
-		el("p", "context-export-ticket-foot", "附带 manifest 哈希，可核对来源与完整性"),
+		el("p", "context-export-ticket-foot", "附带文件清单和内容校验码，可以核对资料来源与完整性"),
 	);
 	workspace.appendChild(ticket);
 	section.appendChild(workspace);
@@ -1604,7 +1710,7 @@ function buildContextExportSection(dagRunId, node) {
 		recipientValue.textContent = target.description;
 		contentsValue.textContent = target.contents;
 		protectionValue.textContent = profile.description;
-		attemptValue.textContent = `${node.nodeId} · attempt ${selectedAttemptNumber(dagRunId, node) ?? 1}`;
+		attemptValue.textContent = `${node.nodeId} · 第 ${selectedAttemptNumber(dagRunId, node) ?? 1} 次执行`;
 		const safety = ticket.querySelector(".context-export-ticket-safety");
 		if (safety) {
 			safety.textContent = profileValue === "raw" ? "原始内容" : "已脱敏";
@@ -1647,7 +1753,7 @@ function buildContextExportSection(dagRunId, node) {
 			}
 			submit.disabled = true;
 			try {
-				setStatus("正在生成可验证 Context Bundle…");
+				setStatus("正在生成带来源校验信息的交接包…");
 				const clientRequestId = `inspect-context-export-${Date.now()}-${Math.random()
 					.toString(36)
 					.slice(2, 10)}`;
@@ -1673,7 +1779,7 @@ function buildContextExportSection(dagRunId, node) {
 				if (operation?.state !== "succeeded" || !operation.result?.downloadUrl) {
 					throw new Error(operation?.errorMessage ?? "导出未成功完成");
 				}
-				setStatus("Bundle 已生成，正在安全下载…");
+				setStatus("交接包已生成，正在安全下载…");
 				const downloaded = await downloadContextExport(operation.result.downloadUrl);
 				const objectUrl = URL.createObjectURL(downloaded.blob);
 				const link = document.createElement("a");
@@ -1684,7 +1790,7 @@ function buildContextExportSection(dagRunId, node) {
 				link.remove();
 				URL.revokeObjectURL(objectUrl);
 				setStatus(
-					`下载完成 · ${operation.result.bundleId} · ${new Intl.NumberFormat("zh-CN").format(operation.result.bytes)} bytes\nSHA-256 ${operation.result.bundleSha256}`,
+					`下载完成 · ${operation.result.bundleId} · ${new Intl.NumberFormat("zh-CN").format(operation.result.bytes)} 字节\n内容校验码 ${operation.result.bundleSha256}`,
 				);
 			} catch (error) {
 					setStatus(transferErrorStatusText(error, "导出未成功完成"), true);
@@ -1816,14 +1922,14 @@ function createArtifactContentPreview(
 			el(
 				"span",
 				null,
-				`${data.mediaType ?? "unknown"} · ${new Intl.NumberFormat("zh-CN").format(data.sourceBytes ?? 0)} bytes`,
+				`${data.mediaType ?? "未知类型"} · ${new Intl.NumberFormat("zh-CN").format(data.sourceBytes ?? 0)} 字节`,
 			),
 		];
 		if (typeof data.sha256 === "string" && data.sha256.length >= 12) {
 			const sha = el(
 				"span",
 				null,
-				` · sha256 ${data.sha256.slice(0, 12)}…`,
+				` · 内容校验码 ${data.sha256.slice(0, 12)}…`,
 			);
 			sha.title = data.sha256;
 			metaChildren.push(sha);
@@ -1835,7 +1941,7 @@ function createArtifactContentPreview(
 				el(
 					"p",
 					"artifact-content-preview-unavailable",
-					"该文件的媒体类型不支持安全内嵌显示；路径、大小和 SHA-256 已核验。",
+					"该文件类型不适合直接在页面中显示；系统已经核对文件位置、大小和内容校验码。",
 				),
 			);
 			return;
@@ -1856,7 +1962,7 @@ function createArtifactContentPreview(
 		if (data.redacted) notes.push("疑似凭据已脱敏");
 		if (data.truncated) {
 			notes.push(
-				`仅显示前 ${new Intl.NumberFormat("zh-CN").format(data.maxBytes ?? 0)} bytes`,
+				`仅显示前 ${new Intl.NumberFormat("zh-CN").format(data.maxBytes ?? 0)} 字节`,
 			);
 		}
 		if (notes.length > 0) {
@@ -1872,19 +1978,57 @@ function createArtifactContentPreview(
 	return { element: details, reset };
 }
 
-function buildArtifactRevisionSection(dagRunId, node) {
+export function artifactRevisionRunEligibility(run) {
+	// File-level eligibility only says that a file has a known replacement
+	// contract. Creating a derived run has stricter, run-level safeguards.
+	// Keep this check here so the UI does not invite an action the server will
+	// necessarily reject later.
+	if (!run) return { eligible: true };
+	const lifecycle = String(run.lifecycle ?? "").toLowerCase();
+	const status = String(run.status ?? "").toLowerCase();
+	if (lifecycle !== "completed") {
+		return {
+			eligible: false,
+			title: "这次运行还没有完整结束",
+			description:
+				"请等待运行收尾为“已完成”。进行中、暂停中，或尚未收尾的报错，都不能从替换产出继续。",
+		};
+	}
+	if (!new Set(["failed", "partial_failed"]).has(status)) {
+		return {
+			eligible: false,
+			title: "这次运行不支持替换产出后继续",
+			description:
+				"只有已完整结束且结果为“失败”或“部分失败”的运行，才能换文件后继续。当前运行已经成功完成；文件本身可替换，不代表可以创建后续运行。",
+		};
+	}
+	return { eligible: true };
+}
+
+function buildArtifactRevisionSection(dagRunId, node, run) {
 	const { section, body } = createDagActionCard({
-		eyebrow: "产出修订",
-		title: "替换产出后继续运行",
-		description: "上传一个候选新版本，先校验差异和影响范围，再决定是否创建新的运行。",
+		eyebrow: "替换已有文件",
+		title: "换掉这个节点的产出后继续",
+		description: "上传新文件后，系统会先检查格式并告诉你哪些后续节点需要重做；确认前不会改动原运行。",
 		icon: "ri-file-transfer-line",
 		className: "artifact-revision-box",
 	});
 	section.dataset.actionSection = "artifact-revision";
+	const runEligibility = artifactRevisionRunEligibility(run);
+	if (!runEligibility.eligible) {
+		body.appendChild(
+			buildDagActionAvailability({
+				tone: "blocked",
+				title: runEligibility.title,
+				description: runEligibility.description,
+			}),
+		);
+		return section;
+	}
 	body.appendChild(
 		buildDagActionAvailability({
-			title: "正在检查是否可以安全修订",
-			description: "读取已冻结的产出关系和修订规则。",
+			title: "正在检查这个文件能不能安全替换",
+			description: "系统正在读取运行开始前保存的文件关系和替换规则。",
 		}),
 	);
 	void (async () => {
@@ -1894,7 +2038,7 @@ function buildArtifactRevisionSection(dagRunId, node) {
 			body.appendChild(
 				buildDagActionAvailability({
 					tone: "blocked",
-					title: "这个运行暂时不能安全修订产出",
+					title: "这个运行暂时不能安全替换产出",
 					description:
 						"缺少结构化的产出关系，系统无法可靠判断哪些后续节点会受影响，也不会根据文件名或提示词猜测。",
 					reasonCode:
@@ -1921,8 +2065,8 @@ function buildArtifactRevisionSection(dagRunId, node) {
 		body.appendChild(
 			buildDagActionAvailability({
 				tone: "ready",
-				title: `可修订 ${eligible.length} 个产出`,
-				description: "父运行不会被修改；确认后会创建一条新的派生运行。",
+				title: `可以替换 ${eligible.length} 个已生成文件`,
+				description: "原运行不会被修改；确认后系统会另外创建一次新运行。",
 			}),
 		);
 		const form = el("div", "dag-action-form artifact-revision-form");
@@ -1951,7 +2095,7 @@ function buildArtifactRevisionSection(dagRunId, node) {
 			form.appendChild(currentArtifactPreview.element);
 			artifactSelect.addEventListener("change", currentArtifactPreview.reset);
 			const fileLabel = el("label", "prompt-restart-field");
-		fileLabel.appendChild(el("span", "dag-action-field-label", "选择新文件（最多 10 MiB）"));
+		fileLabel.appendChild(el("span", "dag-action-field-label", "选择新文件（最多 10 MB）"));
 		const file = document.createElement("input");
 		file.type = "file";
 		file.className = "dag-action-file-input";
@@ -1963,7 +2107,7 @@ function buildArtifactRevisionSection(dagRunId, node) {
 		const reason = document.createElement("textarea");
 		reason.className = "prompt-restart-textarea";
 		reason.rows = 3;
-		reason.placeholder = "说明为什么要替换此产物";
+		reason.placeholder = "例如：计划遗漏了一个验收条件，需要更正后继续";
 		reason.dataset.testid = "artifact-revision-reason";
 		reasonLabel.appendChild(reason);
 		form.appendChild(reasonLabel);
@@ -1997,7 +2141,7 @@ function buildArtifactRevisionSection(dagRunId, node) {
 					return;
 				}
 				if (selectedFile.size > 10 * 1024 * 1024) {
-					setStatus("文件超过 10 MiB 限制。", true);
+					setStatus("文件超过 10 MB 限制。", true);
 					return;
 				}
 				if (!reason.value.trim()) {
@@ -2014,7 +2158,7 @@ function buildArtifactRevisionSection(dagRunId, node) {
 						reader.readAsDataURL(selectedFile);
 					});
 					const candidateBase64 = String(dataUrl).split(",", 2)[1] ?? "";
-					setStatus("正在校验候选字节、schema 与 diff…");
+					setStatus("正在检查新文件格式并对比差异…");
 					const stageId = `artifact-stage-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
 					const staged = await postOperatorAction(
 						"artifactRevisionStage",
@@ -2035,7 +2179,7 @@ function buildArtifactRevisionSection(dagRunId, node) {
 					if (stageOp?.state !== "succeeded" || !revision?.revisionId) {
 						throw new Error(stageOp?.errorMessage ?? "修订校验失败");
 					}
-					setStatus("校验通过，正在计算 direct consumers 与传递影响闭包…");
+					setStatus("文件检查通过，正在计算哪些后续节点需要重新执行…");
 					const planId = `artifact-plan-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
 					const planned = await postOperatorAction(
 						"artifactRevisionPlan",
@@ -2048,17 +2192,23 @@ function buildArtifactRevisionSection(dagRunId, node) {
 					);
 					const plan = planOp?.result?.plan;
 					if (!plan) throw new Error(planOp?.errorMessage ?? "影响预览失败");
-					planHost.appendChild(el("h5", null, "修订与影响预览"));
+					planHost.appendChild(el("h5", null, "替换结果与影响范围"));
 					planHost.appendChild(
 						transparencyMetaList([
-							["修订 ID", revision.revisionId],
-							["候选文件 SHA-256", revision.candidate?.sha256],
-							["差异类型", revision.diff?.kind],
-							["风险级别", plan.risk],
-							["直接使用者", plan.impact?.directConsumerNodeIds?.join(", ") || "无"],
-							["需要重跑", plan.impact?.affectedNodeIds?.join(", ") || "无"],
-							["可以沿用", plan.impact?.importedNodeIds?.join(", ") || "无"],
-							["计划哈希", plan.planHash],
+							["本次替换编号", revision.revisionId],
+							["新文件校验码", revision.candidate?.sha256],
+							[
+								"文件内容类型",
+								inspectorValueLabel("差异类型", revision.diff?.kind),
+							],
+							[
+								"预计风险",
+								inspectorValueLabel("风险级别", plan.risk),
+							],
+							["最先受影响的节点", plan.impact?.directConsumerNodeIds?.join(", ") || "无"],
+							["会重新执行的节点", plan.impact?.affectedNodeIds?.join(", ") || "无"],
+							["会沿用结果的节点", plan.impact?.importedNodeIds?.join(", ") || "无"],
+							["本次计划校验码", plan.planHash],
 						]),
 					);
 					if (revision.diff?.summary) {
@@ -2069,7 +2219,7 @@ function buildArtifactRevisionSection(dagRunId, node) {
 					}
 					if (plan.eligible !== true) {
 						setStatus(
-							`派生运行被阻断：${formatContextTransferReasonList(plan.blockedReasons) ?? "当前不满足继续运行的条件"}`,
+							`暂时不能创建新运行：${formatContextTransferReasonList(plan.blockedReasons) ?? "当前不满足继续运行的条件"}`,
 							true,
 						);
 						return;
@@ -2084,7 +2234,7 @@ function buildArtifactRevisionSection(dagRunId, node) {
 						void (async () => {
 							execute.disabled = true;
 							try {
-								setStatus("正在执行受影响闭包；父 run 保持不可变…");
+								setStatus("正在创建新运行并重新执行受影响节点；原运行保持不变…");
 								const executeId = `artifact-execute-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
 								const accepted = await postOperatorAction(
 									"artifactRevisionExecute",
@@ -2097,7 +2247,7 @@ function buildArtifactRevisionSection(dagRunId, node) {
 									},
 									executeId,
 								);
-								if (!accepted.ok || !accepted.body?.operationId) throw new Error(accepted.body?.error?.message ?? "派生运行未被接受");
+								if (!accepted.ok || !accepted.body?.operationId) throw new Error(accepted.body?.error?.message ?? "新运行未被接受");
 								const operation = await pollOperationToTerminal(accepted.body.operationId, setStatus);
 								const childRunId = operation?.result?.newRunId;
 								if (childRunId) {
@@ -2115,17 +2265,17 @@ function buildArtifactRevisionSection(dagRunId, node) {
 									planHost.appendChild(open);
 								}
 								if (operation?.state !== "succeeded" || !operation.result?.newRunId) {
-									throw new Error(operation?.errorMessage ?? operation?.result?.message ?? "派生运行失败");
+									throw new Error(operation?.errorMessage ?? operation?.result?.message ?? "新运行失败");
 								}
-								setStatus(`派生运行完成：${operation.result.newRunId}`);
+								setStatus(`新运行完成：${operation.result.newRunId}`);
 							} catch (error) {
-								setStatus(transferErrorStatusText(error, "派生运行失败"), true);
+								setStatus(transferErrorStatusText(error, "新运行失败"), true);
 							} finally {
 								execute.disabled = false;
 							}
 						})();
 					});
-					setStatus("影响预览已冻结；确认后将重新规划并校验 plan hash。" );
+					setStatus("影响范围已经锁定；确认时系统会再次检查文件、运行和计划是否有变化。" );
 				} catch (error) {
 					setStatus(transferErrorStatusText(error, "影响预览失败"), true);
 				} finally {
@@ -2149,20 +2299,26 @@ function buildDagActionIntro(node) {
 			"重跑会创建新的运行；当前运行及其已经保存的事实始终保持不变。",
 		),
 	);
-	const state = el("span", "dag-action-node-state", node.status ?? "unknown");
+	const rawState = node.status ?? "unknown";
+	const state = el(
+		"span",
+		"dag-action-node-state",
+		inspectorValueLabel("status", rawState),
+	);
+	if (state.textContent !== rawState) state.setAttribute("title", `原始值：${rawState}`);
 	intro.append(copy, state);
 	return intro;
 }
 
-async function renderPromptRestart(content, dagRunId, node) {
+async function renderPromptRestart(content, dagRunId, node, run) {
 	const nodeId = node.nodeId;
 	clearNode(content);
 	const intro = buildDagActionIntro(node);
-	const revisionSection = buildArtifactRevisionSection(dagRunId, node);
+	const revisionSection = buildArtifactRevisionSection(dagRunId, node, run);
 	const { section: promptSection, body: promptBody } = createDagActionCard({
 		eyebrow: "提示词重跑",
 		title: "修改失败提示后重新执行",
-		description: "仅失败节点可编辑提示词并从当前节点继续；其他节点只提供冻结提示查看。",
+		description: "只有执行失败的节点可以修改提示词并从这里继续；其他节点只能查看运行开始前保存的提示词。",
 		icon: "ri-restart-line",
 		className: "prompt-rerun-action-box",
 	});
@@ -2170,7 +2326,7 @@ async function renderPromptRestart(content, dagRunId, node) {
 	promptBody.appendChild(
 		buildDagActionAvailability({
 			title: "正在读取节点提示",
-			description: "检查冻结版本和历史失败候选。",
+			description: "检查运行开始前保存的版本，以及每次失败时实际使用的版本。",
 		}),
 	);
 	const exportSection = buildContextExportSection(dagRunId, node);
@@ -2199,7 +2355,7 @@ async function renderPromptRestart(content, dagRunId, node) {
 		promptBody.appendChild(
 			buildDagActionAvailability({
 				tone: "blocked",
-				title: "无法读取这个节点的冻结提示",
+				title: "无法读取这个节点原先保存的提示词",
 				description: "当前不能安全预览或修改提示词。可以继续使用最下方的上下文导出。",
 			}),
 		);
@@ -2210,7 +2366,7 @@ async function renderPromptRestart(content, dagRunId, node) {
 	if (!frozenBasePrompt) {
 		promptBody.appendChild(
 			buildDagActionAvailability({
-				title: "这个节点没有冻结提示",
+				title: "这个节点没有保存原始提示词",
 				description: "因此不能从这里修改提示词重跑。",
 			}),
 		);
@@ -2236,12 +2392,12 @@ async function renderPromptRestart(content, dagRunId, node) {
 			createPromptRestartBanner({
 				tone: "readonly",
 				kicker: "只读",
-				title: `当前节点 ${node.status ?? "unknown"}`,
-				body: "仅失败（ERROR）节点支持编辑提示词并重启。以下可只读查看冻结提示词与历史失败候选。",
+				title: `当前节点：${inspectorValueLabel("status", node.status ?? "unknown")}`,
+				body: "只有执行失败的节点支持编辑提示词并重启。下面可以查看原始提示词，以及历次失败时实际使用的提示词。",
 			}),
 		);
 		const promptCard = createPromptRestartPromptCard({
-			title: "冻结原始提示词",
+			title: "运行开始前保存的提示词",
 			badge: "只读",
 			readCandidate: () => selectedCandidate,
 			preTestId: "prompt-restart-readonly",
@@ -2253,9 +2409,9 @@ async function renderPromptRestart(content, dagRunId, node) {
 			hint:
 				promptCandidateOptions.length === 1
 					? historicalCandidatesMissing
-						? "该历史运行未保存失败 attempt 的实际提示词；新运行会在此列出。"
-						: "该节点没有已保存的失败 attempt。"
-					: "可切换查看冻结底稿与历史失败候选。",
+						? "这个较早的运行没有保存失败时实际使用的提示词；新运行会在这里列出。"
+						: "该节点没有保存过失败时使用的提示词。"
+					: "可以切换查看原始版本和历次失败时使用的版本。",
 			onChange: (nextKey) => {
 				selectedCandidate =
 					promptCandidateOptions.find((option) => option.key === nextKey) ??
@@ -2273,7 +2429,7 @@ async function renderPromptRestart(content, dagRunId, node) {
 		promptBody.appendChild(
 			buildDagActionAvailability({
 				tone: "blocked",
-				title: "冻结提示不完整，无法安全编辑",
+				title: "保存的提示词不完整，无法安全编辑",
 				description:
 					"为避免用截断文本覆盖完整提示，请改用 CLI：dag rerun --prompt-override。",
 			}),
@@ -2287,11 +2443,11 @@ async function renderPromptRestart(content, dagRunId, node) {
 			tone: "edit",
 			kicker: "可编辑",
 			title: "从失败节点编辑提示词并重启",
-			body: "父 run spec 保持冻结，将创建带修改提示词的续跑 run。",
+			body: "原运行的设置和记录保持不变；系统会另建一次使用新提示词的运行。",
 		}),
 	);
 	const promptCard = createPromptRestartPromptCard({
-		title: `冻结提示词（只读底稿 · ${nodeId}）`,
+		title: `原始提示词（只读 · ${nodeId}）`,
 		badge: "底稿",
 		readCandidate: () => selectedCandidate,
 		preTestId: "prompt-restart-base",
@@ -2304,10 +2460,10 @@ async function renderPromptRestart(content, dagRunId, node) {
 		label: "提示词版本",
 		hint:
 			promptCandidateOptions.length > 1
-				? "选择失败候选会载入全文替换；冻结原始提示词仍可使用追加模式。"
+				? "选择某次失败使用的版本后，会载入完整文本供你修改；原始提示词仍可选择只追加补充说明。"
 				: historicalCandidatesMissing
-					? "该历史运行未保存失败 attempt 的实际提示词；新运行会在此列出。"
-					: "该节点没有已保存的失败 attempt；当前仅有冻结原始提示词。",
+					? "这个较早的运行没有保存失败时实际使用的提示词；新运行会在这里列出。"
+					: "该节点没有保存过失败时使用的提示词；当前只有原始提示词。",
 		onChange: (nextKey) => {
 			selectedCandidate =
 				promptCandidateOptions.find((option) => option.key === nextKey) ??
@@ -2321,8 +2477,8 @@ async function renderPromptRestart(content, dagRunId, node) {
 			picker.hintEl.textContent = selectedCandidate.truncated
 				? "该候选已截断，仅供查看，不能直接提交重启。"
 				: selectedCandidate.key === "frozen"
-					? "冻结原始提示词可使用追加或全文替换。"
-					: "已载入该失败候选；可在全文替换编辑器中修订后重启。";
+					? "原始提示词可以选择追加说明，也可以全文替换。"
+					: "已载入这次失败时使用的提示词；修改完整文本后即可重启。";
 			applyModeVisibility();
 		},
 	});
@@ -2344,7 +2500,7 @@ async function renderPromptRestart(content, dagRunId, node) {
 		el(
 			"p",
 			"prompt-restart-hint",
-			"将包裹为 <operator_addendum> 块附加到原提示词末尾",
+			"这段补充会加在原提示词末尾，不会改写原文（内部记录为 operator_addendum）。",
 		),
 	);
 	const addendumArea = document.createElement("textarea");
@@ -2379,14 +2535,14 @@ async function renderPromptRestart(content, dagRunId, node) {
 	applyModeVisibility();
 
 	const reasonLabel = el("label", "prompt-restart-field");
-	reasonLabel.appendChild(el("span", "prompt-restart-label", "重启原因"));
+	reasonLabel.appendChild(el("span", "prompt-restart-label", "为什么要重启？"));
 	reasonLabel.appendChild(
-		el("p", "prompt-restart-hint", "结构化说明，会写入续跑 provenance"),
+		el("p", "prompt-restart-hint", "这段说明会随新运行一起保存，方便以后追溯。"),
 	);
 	const reasonArea = document.createElement("textarea");
 	reasonArea.className = "prompt-restart-textarea prompt-restart-textarea-compact";
 	reasonArea.rows = 3;
-	reasonArea.value = `operator-prompt-override / run=${dagRunId} / node=${nodeId} / 手工编辑失败节点提示词后重启`;
+	reasonArea.value = `修改失败节点 ${nodeId} 的提示词后重新运行（来源运行：${dagRunId}）`;
 	reasonArea.setAttribute("data-testid", "prompt-restart-reason");
 	reasonLabel.appendChild(reasonArea);
 	box.appendChild(reasonLabel);
@@ -2398,7 +2554,7 @@ async function renderPromptRestart(content, dagRunId, node) {
 	const submit = document.createElement("button");
 	submit.type = "button";
 	submit.className = "prompt-restart-submit";
-	submit.textContent = "资格预检并重启";
+	submit.textContent = "检查是否可重跑并开始";
 	submit.setAttribute("data-testid", "prompt-restart-submit");
 	row.appendChild(status);
 	row.appendChild(submit);
@@ -2441,7 +2597,7 @@ async function renderPromptRestart(content, dagRunId, node) {
 			}
 			submit.disabled = true;
 			try {
-				setStatus("正在做重跑资格预检（dagRerunPlan）…");
+				setStatus("正在检查这次重跑是否安全可行…");
 				const overrides = [{ nodeId, prompt, mode }];
 				const planRes = await postOperatorAction("dagRerunPlan", {
 					runId: dagRunId,
@@ -2461,9 +2617,9 @@ async function renderPromptRestart(content, dagRunId, node) {
 
 				const est = plan.estimatedExecution;
 				const estText = est
-					? `（将执行 ${est.nodeCount ?? "?"} 个节点 / ${est.piCallCount ?? "?"} 次 Pi 调用）`
+					? `（将执行 ${est.nodeCount ?? "?"} 个节点，其中 ${est.piCallCount ?? "?"} 个需要 AI 处理）`
 					: "";
-				setStatus(`预检通过${estText}，正在提交续跑（dagRerun）…`);
+				setStatus(`检查通过${estText}，正在创建新运行…`);
 				const clientRequestId = `inspect-prompt-restart-${Date.now()}-${Math.random()
 					.toString(36)
 					.slice(2, 10)}`;
@@ -2491,21 +2647,21 @@ async function renderPromptRestart(content, dagRunId, node) {
 					const newRunId =
 						op.dagRunId ?? op.result?.newRunId ?? op.runSummary?.runId ?? null;
 					if (newRunId) {
-						setStatus(`重启完成，新 run：${newRunId}`);
+						setStatus(`重启完成，新运行：${newRunId}`);
 						const open = document.createElement("button");
 						open.type = "button";
 						open.className = "prompt-restart-submit is-secondary";
-						open.textContent = "打开新 run";
+						open.textContent = "打开新运行";
 						open.addEventListener("click", () => {
 							navigate(`/dag/${encodeURIComponent(String(newRunId))}`);
 						});
 						row.appendChild(open);
 					} else {
-						setStatus("重启完成（未能解析新 run id，请在 DAG 历史中查看）。");
+						setStatus("重启完成（暂时无法取得新运行编号，请在 DAG 历史中查看）。");
 					}
 				} else if (op) {
 					setStatus(
-						`续跑操作终态：${op.state}${op.errorMessage ? ` — ${op.errorMessage}` : ""}`,
+						`新运行最终状态：${inspectorValueLabel("status", op.state)}${op.errorMessage ? ` — ${op.errorMessage}` : ""}`,
 						true,
 					);
 				} else {
@@ -2552,8 +2708,9 @@ function transparencyMetaList(rows) {
 
 function renderNodeOverview(content, dagRunId, node) {
 	const root = el("div", "node-transparency-root");
+	root.appendChild(buildInspectorPageLead("overview"));
 	root.appendChild(
-		el("p", "node-input-semantics", "本页只展示当前运行已持久化的节点事实。"),
+		el("p", "node-input-semantics", "这里展示系统为当前运行保存的真实记录；字段已转换为易懂名称，悬停可查看原始技术字段。"),
 	);
 	const summary = el("section", "node-input-section");
 	summary.appendChild(el("h4", null, "节点事实"));
@@ -2571,12 +2728,12 @@ function renderNodeOverview(content, dagRunId, node) {
 	);
 	root.appendChild(summary);
 	const semantics = el("section", "node-input-section");
-	semantics.appendChild(el("h4", null, "事实阶段"));
+	semantics.appendChild(el("h4", null, "这些信息分别在什么时候产生"));
 	semantics.appendChild(
 		el(
 			"p",
 			"muted",
-			"输入页是 frozen declaration；有效上下文页是 dispatch-time receipt；产物页是执行后 materialization。缺失阶段会明确标记，不用预览冒充事实。",
+			"“执行设置”是运行开始前保存的配置；“实际上下文”是下发任务时真正交给节点的内容；“产出”是执行结束后保存的文件。缺少哪个阶段会明确显示，预览内容不会被当成已经发生的事实。",
 		),
 	);
 	root.appendChild(semantics);
@@ -2591,6 +2748,7 @@ function selectedAttemptNumber(dagRunId, node) {
 }
 
 async function renderEffectiveContext(content, dagRunId, node) {
+	ensureInspectorPageLead(content, "context");
 	content.appendChild(el("p", "muted", "正在加载有效上下文事实…"));
 	const result = await fetchDagNodeContext(
 		dagRunId,
@@ -2605,6 +2763,7 @@ async function renderEffectiveContext(content, dagRunId, node) {
 	)
 		return;
 	clearNode(content);
+	ensureInspectorPageLead(content, "context");
 	if (!result.ok || !result.body) {
 		const error = el(
 			"p",
@@ -2628,33 +2787,29 @@ async function renderEffectiveContext(content, dagRunId, node) {
 	);
 	if (receipt?.status !== "captured") {
 		const missing = el("div", "node-transparency-omission");
+		const reasonCode = receipt?.reasonCode ?? "CONTEXT_RECEIPT_MISSING";
+		const missingLabel = contextTransferReasonLabel(reasonCode);
 		missing.appendChild(
 			el(
 				"h4",
 				null,
-				receipt?.status === "invalid" ? "Receipt 不可用" : "未捕获",
+				receipt?.status === "invalid" ? "执行时记录不可用" : "没有执行时记录",
 			),
 		);
-		missing.appendChild(
-			el("code", null, receipt?.reasonCode ?? "CONTEXT_RECEIPT_MISSING"),
-		);
-		const missingLabel = contextTransferReasonLabel(
-			receipt?.reasonCode ?? "CONTEXT_RECEIPT_MISSING",
-		);
-		if (missingLabel) {
-			missing.appendChild(el("p", "muted", missingLabel));
-		}
+		const reason = el("p", "muted", missingLabel ?? reasonCode);
+		if (missingLabel) reason.setAttribute("title", `技术代码：${reasonCode}`);
+		missing.appendChild(reason);
 		missing.appendChild(
 			el(
 				"p",
 				"muted",
-				"当前只有 frozen input / prompt 指纹；它们不是 Effective Context。历史 run 不做事后回填。",
+				"当前只有运行前设置和提示内容校验码，无法证明执行时真正收到了哪些内容。较早的运行不会事后补写这份记录。",
 			),
 		);
 		root.appendChild(missing);
 	} else {
 		const captured = el("section", "node-input-section");
-		captured.appendChild(el("h4", null, "Captured receipt"));
+		captured.appendChild(el("h4", null, "这次执行实际收到的内容"));
 		captured.appendChild(
 			transparencyMetaList([
 				["context digest", receipt.contextDigest],
@@ -2690,21 +2845,20 @@ async function renderEffectiveContext(content, dagRunId, node) {
 
 function artifactInventorySection(data, dagRunId, nodeId) {
 	const root = el("section", "node-input-section node-artifact-inventory");
-	root.appendChild(el("h4", null, "声明产物与消费关系"));
+	root.appendChild(el("h4", null, "本节点生成和使用的文件"));
 	if (!data?.binding?.available) {
 		const warning = el("div", "node-transparency-omission");
 		const bindingCode =
 			data?.binding?.reasonCode ?? "ARTIFACT_BINDING_UNAVAILABLE";
-		warning.appendChild(el("code", null, bindingCode));
 		const bindingLabel = contextTransferReasonLabel(bindingCode);
-		if (bindingLabel) {
-			warning.appendChild(el("p", "muted", bindingLabel));
-		}
+		const reason = el("p", "muted", bindingLabel ?? bindingCode);
+		if (bindingLabel) reason.setAttribute("title", `技术代码：${bindingCode}`);
+		warning.appendChild(reason);
 		warning.appendChild(
 			el(
 				"p",
 				"muted",
-				"该历史 run 没有 frozen Artifact Binding；不会从 prompt、outputContract、路径或文件名推断 consumer。",
+				"这个较早的运行没有保存明确的文件使用关系；系统不会根据提示词、输出要求或文件名猜测谁会使用它。",
 			),
 		);
 		root.appendChild(warning);
@@ -2742,7 +2896,7 @@ function artifactInventorySection(data, dagRunId, nodeId) {
 		);
 		appendCodeList(
 			card,
-			"Direct consumers",
+			"会直接使用此文件的节点",
 			artifact.directConsumerNodeIds ?? [],
 		);
 		if (artifact.materialization?.status === "materialized") {
@@ -2756,7 +2910,7 @@ function artifactInventorySection(data, dagRunId, nodeId) {
 	}
 	for (const artifact of data.consumes ?? []) {
 		const card = el("div", "node-artifact-card is-consumed");
-		card.appendChild(el("h5", null, `消费 ${artifact.artifactId}`));
+		card.appendChild(el("h5", null, `使用 ${artifact.artifactId}`));
 		card.appendChild(
 			transparencyMetaList([
 				["producer", artifact.producerNodeId],
@@ -2775,7 +2929,7 @@ function artifactInventorySection(data, dagRunId, nodeId) {
 		(data.produces ?? []).length === 0 &&
 		(data.consumes ?? []).length === 0
 	) {
-		root.appendChild(el("p", "empty", "该节点没有声明的产物绑定。"));
+		root.appendChild(el("p", "empty", "该节点没有登记会生成或使用的文件。"));
 	}
 	return root;
 }
@@ -2797,10 +2951,12 @@ async function prependArtifactInventory(content, dagRunId, node) {
 					"node-input-error node-artifact-inventory",
 					result.body?.error || "无法加载产物绑定事实。",
 				);
-	content.insertBefore(section, content.firstChild);
+	const lead = content.querySelector(".inspector-page-lead");
+	content.insertBefore(section, lead?.nextSibling ?? content.firstChild);
 }
 
 async function renderRunLineage(content, dagRunId, node) {
+	ensureInspectorPageLead(content, "lineage");
 	content.appendChild(el("p", "muted", "正在加载来源与影响关系…"));
 	const result = await fetchDagRunLineage(dagRunId);
 	if (
@@ -2811,6 +2967,7 @@ async function renderRunLineage(content, dagRunId, node) {
 	)
 		return;
 	clearNode(content);
+	ensureInspectorPageLead(content, "lineage");
 	if (!result.ok || !result.body) {
 		content.appendChild(
 			el("p", "node-input-error", result.body?.error || "无法加载来源与影响关系。"),
@@ -2819,21 +2976,11 @@ async function renderRunLineage(content, dagRunId, node) {
 	}
 	const data = result.body;
 	const root = el("div", "node-transparency-root");
-	const intro = el("section", "node-lineage-intro");
-	intro.append(
-		el("h4", null, "这个节点从哪里来，会影响哪里"),
-		el(
-			"p",
-			"muted",
-			"这里展示派生运行继承、替换或重新执行了哪些节点。产出文件的直接使用者请到“产出”中查看。",
-		),
-	);
-	root.appendChild(intro);
 	root.appendChild(
 		transparencyMetaList([
 			["运行类型", data.kind === "root" ? "首次运行" : "派生运行"],
 			["来源运行", data.parentRunId ?? null],
-			["发起方式", data.trigger ?? null],
+			["发起方式", inspectorValueLabel("发起方式", data.trigger)],
 			["人工选择节点", data.operatorSelectedNodeId ?? null],
 			["从此节点重新执行", data.effectiveFromNodeId ?? null],
 			["重跑计划哈希", data.planHash ?? null],
@@ -3246,7 +3393,7 @@ function renderCachedOrPreviewBody(content, dagRunId, node, key, isLatest) {
 	}
 	if (cached && cached.ok === false) {
 		const message =
-			cached.error || "该次执行输出暂不可用（artifact 缺失或无法读取）。";
+			cached.error || "该次执行输出暂不可用（记录文件缺失或无法读取）。";
 		const error = el("p", "empty", message);
 		error.setAttribute("role", "status");
 		content.appendChild(error);
@@ -3290,7 +3437,7 @@ async function loadAndRenderExecutionOutput(
 			(result.status === 0
 				? "加载执行输出失败（网络错误）。"
 				: result.status === 404
-					? "该次执行输出暂不可用（artifact 缺失或无法读取）。"
+					? "该次执行输出暂不可用（记录文件缺失或无法读取）。"
 					: `加载执行输出失败（HTTP ${result.status}）。`);
 		// Cache the miss for this key only — never wipe other valid bodies.
 		setDagNodeExecutionOutputCache(dagRunId, nodeId, key, {
@@ -3328,7 +3475,8 @@ function repaintOutputTabBody(content, dagRunId, node) {
 	// Remove everything after the attempt bar (or all if no bar).
 	const inventory = content.querySelector(".node-artifact-inventory");
 	const bar = content.querySelector(".dag-inspector-attempt-bar");
-	const keep = [inventory, bar].filter(Boolean);
+	const lead = content.querySelector(".inspector-page-lead");
+	const keep = [lead, inventory, bar].filter(Boolean);
 	while (content.firstChild) content.removeChild(content.firstChild);
 	for (const nodeEl of keep) content.appendChild(nodeEl);
 
@@ -3394,7 +3542,7 @@ function renderProcessCommandCard(command) {
 	details.appendChild(summary);
 	const body = el("div", "process-timeline-card-body");
 	const meta = [
-		command.exitCode != null ? `exit ${command.exitCode}` : null,
+		command.exitCode != null ? `退出码 ${command.exitCode}` : null,
 		command.durationMs != null ? `耗时 ${formatMs(command.durationMs)}` : null,
 		command.failureCategory ? command.failureCategory : null,
 	].filter(Boolean);
@@ -3404,11 +3552,11 @@ function renderProcessCommandCard(command) {
 		);
 	}
 	if (command.stdout) {
-		body.appendChild(el("div", "process-timeline-section-label", "stdout"));
+		body.appendChild(el("div", "process-timeline-section-label", "正常输出"));
 		appendProcessPre(body, command.stdout);
 	}
 	if (command.stderr) {
-		body.appendChild(el("div", "process-timeline-section-label", "stderr"));
+		body.appendChild(el("div", "process-timeline-section-label", "错误输出"));
 		appendProcessPre(body, command.stderr);
 	}
 	if (command.truncated) {
@@ -3619,7 +3767,7 @@ function renderExecutorAwareTimeline(content, dagRunId, node) {
 	});
 }
 
-function fillDagInspectorContent(content, dagRunId, node) {
+function fillDagInspectorContent(content, dagRunId, node, run) {
 	const previousRenderedNode = content.dataset.dagNodeId ?? "";
 	const previousRenderedRun = content.dataset.dagRunId ?? "";
 	const previousTab = content.dataset.inspectorTab ?? "";
@@ -3657,6 +3805,9 @@ function fillDagInspectorContent(content, dagRunId, node) {
 	content.dataset.inspectorTab = activeTab;
 	// Drop timeline-only classes when switching tabs so output layout stays clean.
 	content.className = "dag-inspector-content";
+	if (activeTab !== "prompt-restart") {
+		content.classList.add("is-readable-page");
+	}
 	ensureInspectorContentScrollCapture(
 		content,
 		dagRunId,
@@ -3670,10 +3821,12 @@ function fillDagInspectorContent(content, dagRunId, node) {
 	} else if (activeTab === "lineage") {
 		void renderRunLineage(content, dagRunId, node);
 	} else if (activeTab === "spec-evidence") {
+		ensureInspectorPageLead(content, "spec-evidence");
 		void renderSpecEvidence(content, dagRunId, node.nodeId);
 	} else if (activeTab === "prompt-restart") {
-		void renderPromptRestart(content, dagRunId, node);
+		void renderPromptRestart(content, dagRunId, node, run);
 	} else if (activeTab === "timeline") {
+		ensureInspectorPageLead(content, "timeline");
 		const attemptBuilt = buildAttemptBar(dagRunId, node);
 		if (attemptBuilt?.bar) content.appendChild(attemptBuilt.bar);
 		renderExecutorAwareTimeline(content, dagRunId, node);
@@ -3684,6 +3837,7 @@ function fillDagInspectorContent(content, dagRunId, node) {
 		void renderDagNodeInput(content, dagRunId, node);
 	} else {
 		// output tab: attempt bar + latest preview immediate / historical async body.
+		ensureInspectorPageLead(content, "output");
 		const attemptBuilt = buildAttemptBar(dagRunId, node);
 		if (attemptBuilt?.bar) content.appendChild(attemptBuilt.bar);
 		const key = effectiveExecutionKey(dagRunId, node);
@@ -3884,12 +4038,13 @@ function dagInspectorSignature(dagRunId, node) {
 	]);
 }
 
-export function renderDagInspector(dagRunId, node, initial = true) {
+export function renderDagInspector(dagRunId, node, initial = true, run = null) {
 	// Record the current selection before any early-return so tab handlers
 	// (which reference the mutable inspectorSelection slot) always re-render
 	// the currently selected node, never a stale build-time closure.
 	inspectorSelection.dagRunId = dagRunId;
 	inspectorSelection.node = node;
+	inspectorSelection.run = run;
 	const panel = document.getElementById("dag-inspector");
 	if (!panel) return;
 	captureDagTimelineViewportState(panel);
@@ -3939,7 +4094,7 @@ export function renderDagInspector(dagRunId, node, initial = true) {
 			scrollTop: pre.scrollTop,
 		}));
 		clearNode(existingContent);
-		fillDagInspectorContent(existingContent, dagRunId, node);
+		fillDagInspectorContent(existingContent, dagRunId, node, run);
 		// Async tabs restore themselves after fetch; sync tabs restore here.
 		if (activeTab === "output" || activeTab === "timeline") {
 			restoreInspectorContentScroll(
@@ -3970,7 +4125,7 @@ export function renderDagInspector(dagRunId, node, initial = true) {
 	panel.appendChild(buildDagInspectorHeader(dagRunId, node));
 
 	const content = el("div", "dag-inspector-content");
-	fillDagInspectorContent(content, dagRunId, node);
+	fillDagInspectorContent(content, dagRunId, node, run);
 	panel.appendChild(content);
 	panel.dataset.contentSignature = nextContentSignature;
 }