@tea-agent/loop-agent 0.42.0-next.9 → 0.42.1

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

@@ -20,20 +20,20 @@ export const OUTPUT_FOLLOW_LATEST_PX = 48;
 
 export const UI_TEXT = {
 	dashboard: "总览",
-	dagRuns: "DAG 运行",
-	dagHistory: "DAG 运行历史",
+	dagRuns: "运行流程",
+	dagHistory: "运行历史",
 	viewAllDags: "查看全部 →",
-	failures: "异常 Task",
+	failures: "异常任务",
 	nightJobs: "夜间任务",
 	batchDetail: "批次详情",
 	runDetail: "运行详情",
-	dagDetail: "DAG 详情",
-	activeDags: "进行中的 DAG",
-	recentDags: "最近 DAG 运行",
-	batches: "Worker 批次",
-	noActiveDags: "当前没有进行中的 DAG，启动后将出现在这里。",
-	noRecentDags: "暂无 DAG 运行记录。",
-	noFormalDagHistory: "暂无正式 DAG 运行记录",
+	dagDetail: "运行详情",
+	activeDags: "进行中的流程",
+	recentDags: "最近运行",
+	batches: "任务批次",
+	noActiveDags: "当前没有进行中的流程，启动后将出现在这里。",
+	noRecentDags: "暂无运行记录。",
+	noFormalDagHistory: "暂无正式运行记录",
 	noFormalDagHistoryHint:
 		"dry-run / init-only 预检记录不会出现在此列表中。",
 	dagHistoryRefreshFailed: "刷新失败，当前展示上一次结果",
@@ -41,34 +41,34 @@ export const UI_TEXT = {
 	dagHistoryCopiedAnnounce: "已复制运行 ID",
 	dagHistoryCopyFailed: "复制失败，请手动选择运行 ID",
 	dagHistoryCopyTooltip: "复制运行 ID",
-	noBatches: "暂无 Worker 批次，运行后将出现在这里。",
+	noBatches: "暂无任务批次，运行后将出现在这里。",
 	noNodes: "暂无节点。",
 	noOutput: "暂无节点输出。",
 	noInput: "暂无节点输入。",
 	inputLoading: "正在加载节点输入…",
-	inputUnavailable: "未在冻结 DAG tasks[] 中找到该节点输入。",
+	inputUnavailable: "没有在本次运行保存的执行计划中找到该节点设置。",
 	inputDynamicUnsupported:
-		"该节点为运行时动态展开节点，Phase A 暂不提供完整输入。",
-	inputRunSpecUnavailable: "无法读取冻结 DAG 规格（run.json）。",
+		"该节点是在运行过程中动态生成的，暂时无法展示完整的运行前设置。",
+	inputRunSpecUnavailable: "无法读取本次运行开始前保存的执行计划（run.json）。",
 	inputError: "加载节点输入失败。",
-	inputFrozenLabel: "冻结 DAG 节点定义",
-	inputFingerprintNote: "仅保存 assembled prompt 指纹，全文未持久化",
-	noSessionEvents: "该 Pi 节点暂无过程日志（可能尚未执行、走 CLI 路径，或为历史 run）",
-	noShellProcess: "该 shell 节点尚未留下命令回执。",
+	inputFrozenLabel: "本次运行开始前保存的执行设置",
+	inputFingerprintNote: "这里只保存最终提示内容的校验信息，没有保存完整文本。",
+	noSessionEvents: "该 AI 节点暂无过程日志（可能尚未执行、通过命令行执行，或来自较早的运行）。",
+	noShellProcess: "该命令节点尚未留下执行记录。",
 	noPresetProcess: "该内部处理器尚未留下过程回执。",
-	staticNoProcess: "静态节点没有逐步执行过程，请查看节点输出。",
+	staticNoProcess: "系统直接生成的节点没有逐步执行过程，请查看节点输出。",
 	processLoading: "正在加载执行过程…",
 	processError: "加载执行过程失败。",
-	shellCommandsHeading: "Shell 命令",
+	shellCommandsHeading: "命令执行记录",
 	shellPresetHeading: "内部处理器",
 	noArtifacts: "暂无产物记录。",
 	noActiveCommand: "当前没有正在执行的命令。",
-	noFailures: "当前没有异常 Task。",
+	noFailures: "当前没有异常任务。",
 	enterDetail: "查看详情 →",
 	repoRoot: "仓库根目录",
 	generatedAt: "生成时间",
 	refreshStatus: "更新",
-	failureInbox: "异常 Task",
+	failureInbox: "异常任务",
 	nearRealtime: "轮询刷新",
 	manualRefresh: "手动刷新",
 	autoRefresh: "自动刷新",

package/dist/worker/observe/static/dag-context-reason-labels.js

@@ -30,6 +30,25 @@ const CONTEXT_TRANSFER_REASON_LABELS = {
 	WORKER_CONTINUATION_AUTHORITY_MISMATCH: "Worker 派生运行的归属事实不一致",
 	WORKER_CONTINUATION_NEEDS_RECONCILE: "Worker 派生运行已存在，需要先恢复核对",
 	WORKER_CONTINUATION_LEASE_CONFLICT: "该 Worker Task 已有运行占用",
+	"parent-lifecycle-ineligible": "原运行尚未完整结束，只有已完成的运行才能从这里继续",
+	"convergence-rerun-unsupported": "原运行使用自动收敛流程，暂不支持替换产出后继续",
+	"evaluation-rerun-unsupported": "评测运行暂不支持替换产出后继续",
+	"budget-lineage-missing": "缺少原运行的额度使用记录",
+	"budget-lineage-breached": "原运行已经用完或超出额度",
+	"budget-lineage-drift": "原运行的额度规则已经变化",
+	"sourceBindingMatched-drift": "任务来源与原运行不一致",
+	"taskContractBindingMatched-drift": "任务约定与原运行不一致",
+	"controllerIdentityMatched-drift": "运行控制器版本与原运行不一致",
+	"skillSnapshotVerified-drift": "节点使用的技能版本无法与原运行核对",
+	"workspaceMatched-drift": "当前工作区内容与原运行结束时不一致",
+	"restart-subgraph-contains-writer": "受影响范围里有写入节点，但它的文件边界不够明确",
+	"restart-subgraph-contains-decision-gate": "受影响范围里包含需要人工重新决定的关卡",
+	"restart-subgraph-contains-unsafe-shell": "受影响范围里有不能安全自动重跑的命令",
+	"dynamic-rerun-unsupported": "受影响范围里有无法安全重新生成的动态节点",
+	"parent-facts-invalid": "准备沿用的节点没有完整的成功记录",
+	"workspace-checkpoint-missing": "缺少原运行结束时的工作区校验记录",
+	"workspace-drift": "当前工作区已经发生变化，不能安全接着写",
+	HIGH_RISK_AUTHORITY_MISSING: "高风险重跑缺少完整的写入、动态节点或额度校验信息",
 	INELIGIBLE: "当前不满足继续运行的条件",
 	PARENT_IMMUTABILITY_VIOLATION: "父运行事实发生变化，已阻止派生",
 	PARENT_LIFECYCLE: "父运行状态不允许派生继续",

package/dist/worker/observe/static/dag-history-labels.js

@@ -19,6 +19,7 @@ const ATTEMPT_FAILURE_LABELS = {
 	"structured-repair-exhausted": "结构化修复耗尽",
 	"governance-blocked": "治理规则阻断",
 	"empty-output": "输出为空",
+	network: "网络连接失败",
 	auth: "认证失败",
 	quota: "额度或限流",
 	"rate-limit": "额度或限流",

package/dist/worker/observe/static/dag-inspector-humanize.d.ts

@@ -0,0 +1,16 @@
+export type InspectorMetaCopy = {
+	label: string;
+	value: string;
+	help: string | null;
+	rawLabel: string | null;
+	rawValue: string | null;
+};
+
+export function inspectorFieldLabel(field: unknown): string;
+export function inspectorValueLabel(field: unknown, value: unknown): string;
+export function inspectorListValueLabel(value: unknown): string;
+export function inspectorFieldHelp(field: unknown): string | null;
+export function describeInspectorMeta(
+	field: unknown,
+	value: unknown,
+): InspectorMetaCopy;

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

@@ -0,0 +1,342 @@
+/**
+ * Human-readable copy for the DAG node inspector.
+ *
+ * API payloads keep their stable machine fields and enum values. The inspector
+ * uses these maps only at render time and preserves the raw terms in titles so
+ * diagnostics remain available without making them the primary UI language.
+ */
+
+const FIELD_LABELS = Object.freeze({
+	executor: "执行方式",
+	role: "节点职责",
+	complexity: "任务复杂度",
+	writePolicy: "写入权限",
+	toolProfile: "可用工具范围",
+	depends_on: "需要先完成的节点",
+	dependsPolicy: "前置节点要求",
+	failureAwareDependsOn: "失败时仍可读取的前置节点",
+	runIf: "什么情况下执行",
+	kind: "执行类型",
+	modelHint: "建议使用的模型",
+	preset: "预设处理流程",
+	cwd: "执行目录",
+	timeoutMs: "超时时间（毫秒）",
+	nonZeroExitPolicy: "命令失败时如何处理",
+	gates: "执行前后检查",
+	handlers: "内部处理器",
+	status: "当前状态",
+	outputMode: "输出形式",
+	firstProtocolLine: "首行格式要求",
+	resolved: "成功加载的扩展",
+	requested: "计划加载的扩展",
+	sha256: "内容校验码",
+	lengthChars: "字符数",
+	artifact: "记录文件",
+	run: "运行编号",
+	node: "节点编号",
+	model: "使用模型",
+	rank: "执行顺序",
+	origin: "结果来源",
+	duration: "耗时",
+	attempt: "第几次执行",
+	declared: "是否找到运行前设置",
+	dispatched: "是否已把任务交给执行器",
+	"node status": "节点状态",
+	"context digest": "本次上下文校验码",
+	"captured at": "记录时间",
+	components: "上下文组成项数量",
+	truncations: "被截断的内容数量",
+	skills: "加载的技能数量",
+	extensions: "加载的扩展数量",
+	tools: "可用工具数量",
+	parent: "来源运行",
+	"graph sha256": "文件关系校验码",
+	path: "文件位置",
+	media: "文件类型",
+	schema: "数据格式",
+	materialization: "文件生成状态",
+	bytes: "文件大小（字节）",
+	revision: "是否可以替换",
+	supersedes: "替换前版本校验码",
+	producer: "由哪个节点生成",
+	required: "是否必须使用",
+	"Direct consumers": "会直接使用此文件的节点",
+	"运行类型": "运行类型",
+	"来源运行": "来源运行",
+	"发起方式": "为什么创建这次运行",
+	"人工选择节点": "人工选择的起点",
+	"从此节点重新执行": "实际重新执行的起点",
+	"重跑计划哈希": "重跑计划校验码",
+});
+
+const FIELD_HELP = Object.freeze({
+	executor: "这一步是由 AI、命令，还是系统规则来完成。",
+	role: "这个节点在整条流程里负责规划、修改、审查还是验证。",
+	complexity: "系统对这一步工作量和推理难度的预估。",
+	writePolicy: "这一步是否能修改文件，以及能修改到什么程度。",
+	toolProfile: "这一步被允许使用哪一类工具。",
+	depends_on: "这些节点完成后，这一步才能开始。",
+	dependsPolicy: "前置节点出现失败或跳过时，这一步是否还能继续。",
+	failureAwareDependsOn: "即使这些前置节点失败，本节点仍可读取它们留下的信息。",
+	runIf: "只有预设条件成立时，这一步才会执行。",
+	kind: "系统实际采用的执行方法。",
+	modelHint: "配置建议使用的 AI 模型，实际模型以执行记录为准。",
+	preset: "系统预先定义好的一套处理步骤。",
+	cwd: "命令从哪个文件夹开始运行。",
+	timeoutMs: "执行超过这段时间后会被判定为超时。",
+	nonZeroExitPolicy: "命令返回失败时，是立即停止还是仅记录结果。",
+	gates: "开始或结束前必须通过的检查。",
+	handlers: "这个节点内部会依次调用的处理步骤。",
+	status: "这一步目前进行到什么状态。",
+	outputMode: "结果需要按普通文本还是固定结构返回。",
+	firstProtocolLine: "结果第一行必须遵守的格式。",
+	resolved: "实际成功加载并可供节点使用的扩展。",
+	requested: "运行计划原本要求加载的扩展。",
+	sha256: "用于确认内容有没有变化的一串校验值。",
+	lengthChars: "保存内容包含多少个字符。",
+	artifact: "这条记录在工作区中的保存位置。",
+	run: "这次完整运行的唯一编号。",
+	node: "当前步骤的唯一编号。",
+	model: "这一步实际使用的 AI 模型。",
+	rank: "这一步位于依赖流程的第几层，不等同于执行次数。",
+	origin: "当前结果是本次生成、沿用旧结果，还是人工替换而来。",
+	duration: "这一步从开始到结束花费的时间。",
+	attempt: "当前查看的是第几次执行尝试。",
+	declared: "运行开始前是否保存了这一步的设置。",
+	dispatched: "任务是否已经真正交给执行器。",
+	"node status": "交给执行器之后，这一步最终处于什么状态。",
+	"context digest": "用于确认节点实际收到的整组内容是否变化。",
+	"captured at": "系统记录节点实际上下文的时间。",
+	components: "节点实际收到的上下文由多少部分组成。",
+	truncations: "有多少部分因为过长而只提供了节选。",
+	skills: "本次执行实际提供了多少项技能。",
+	extensions: "本次执行实际加载了多少个扩展。",
+	tools: "本次执行允许调用多少种工具。",
+	parent: "当前运行是从哪一次旧运行继续而来。",
+	"graph sha256": "用于确认文件生产和使用关系没有变化。",
+	path: "文件在工作区中的相对位置。",
+	media: "文件的内容类型，例如 JSON 或纯文本。",
+	schema: "结构化文件必须符合的数据规则。",
+	materialization: "登记的文件是否已经真实生成，并且与记录一致。",
+	bytes: "文件占用的存储大小。",
+	revision: "这个文件是否允许上传新版本并从后续节点继续。",
+	supersedes: "被当前版本替换掉的旧文件校验值。",
+	producer: "最初生成这个文件的节点。",
+	required: "后续节点是否必须使用这个文件。",
+	"Direct consumers": "会直接读取这个文件的下一批节点。",
+	"运行类型": "这是首次运行，还是从旧运行继续创建的新运行。",
+	"来源运行": "新运行所依据的旧运行编号。",
+	"发起方式": "为什么会从旧运行创建这次新运行。",
+	"人工选择节点": "操作者希望从哪个节点开始重新执行。",
+	"从此节点重新执行": "系统检查依赖后，最终决定从哪个节点开始。",
+	"重跑计划哈希": "用于确认预览计划和真正执行时的计划完全一致。",
+});
+
+const FIELD_VALUE_LABELS = Object.freeze({
+	executor: {
+		pi: "AI 执行",
+		shell: "命令执行",
+		static: "系统直接生成",
+	},
+	kind: {
+		pi: "AI 执行",
+		shell: "命令执行",
+		static: "系统直接生成",
+	},
+	complexity: {
+		LOW: "较简单",
+		MED: "中等",
+		HIGH: "较复杂",
+	},
+	role: {
+		planner: "任务规划",
+		implementer: "执行修改",
+		reviewer: "结果审查",
+		verifier: "验证结果",
+		closeout: "收尾确认",
+		scout: "信息收集",
+		supervisor: "流程监督",
+	},
+	writePolicy: {
+		"read-only": "只读，不修改文件",
+		exclusive: "仅此节点可以修改指定文件",
+		"docs-only": "只允许修改文档",
+	},
+	toolProfile: {
+		"read-only": "只读工具",
+		write: "可修改文件的工具",
+	},
+	status: {
+		PENDING: "等待执行",
+		RUNNING: "正在执行",
+		FINISHED: "已完成",
+		ERROR: "执行失败",
+		SKIPPED: "已跳过",
+		pending: "等待执行",
+		running: "正在执行",
+		finished: "已完成",
+		completed: "已完成",
+		succeeded: "成功",
+		failed: "失败",
+		error: "执行失败",
+		skipped: "已跳过",
+		captured: "已记录",
+		missing: "没有记录",
+		invalid: "记录不可用",
+		available: "可用",
+		unavailable: "不可用",
+	},
+	declared: {
+		available: "已保存",
+		missing: "未保存",
+		invalid: "记录不可用",
+	},
+	dispatched: {
+		dispatched: "已下发",
+		pending: "尚未下发",
+		missing: "没有下发记录",
+	},
+	dependsPolicy: {
+		all: "所有前置节点成功后才执行",
+		"all-or-condition-skip": "前置节点成功，或按条件允许跳过后执行",
+	},
+	nonZeroExitPolicy: {
+		fail: "命令失败就停止",
+		record: "记录失败结果后继续",
+	},
+	outputMode: {
+		"structured-required": "必须按固定结构输出",
+		text: "普通文本",
+	},
+	"node status": {
+		PENDING: "等待执行",
+		RUNNING: "正在执行",
+		FINISHED: "已完成",
+		ERROR: "执行失败",
+		SKIPPED: "已跳过",
+	},
+	materialization: {
+		materialized: "文件已生成",
+		missing: "文件缺失",
+		mismatch: "文件与登记信息不一致",
+		"not-recorded": "没有生成记录",
+	},
+	revision: {
+		eligible: "可以替换",
+		blocked: "不能替换",
+	},
+	origin: {
+		executed: "本次运行生成",
+		imported: "沿用上一次运行的结果",
+		overridden: "使用了人工替换的新文件",
+		unknown: "暂时无法确定",
+	},
+	required: {
+		yes: "必须使用",
+		no: "可选",
+		true: "必须使用",
+		false: "可选",
+	},
+	"发起方式": {
+		"artifact-override": "替换产出后继续",
+		"prompt-override": "修改提示词后重跑",
+		"node-rerun": "从指定节点重跑",
+	},
+	"运行类型": {
+		root: "首次运行",
+		continuation: "从旧运行继续的新运行",
+	},
+	"差异类型": {
+		text: "文本文件",
+		json: "结构化数据文件（JSON）",
+		binary: "二进制文件",
+	},
+	"风险级别": {
+		low: "较低",
+		medium: "中等",
+		high: "较高",
+	},
+});
+
+const LIST_LABELS = Object.freeze({
+	skills: "可用技能",
+	"piExtensions（声明）": "计划加载的 AI 扩展",
+	requested: "计划加载的扩展",
+	allowedPaths: "允许读取或修改的范围",
+	forbiddenPaths: "禁止访问或修改的范围",
+	writeSet: "本节点实际可以修改的范围",
+	"Direct consumers": "会直接使用此文件的节点",
+});
+
+const COMMON_VALUE_LABELS = Object.freeze({
+	unknown: "暂时无法确定",
+	"(none)": "无",
+	"(parse failed)": "无法解析",
+	pass: "通过",
+	fail: "失败",
+	warning: "有提醒",
+	true: "是",
+	false: "否",
+	"system-prompt": "系统说明",
+	"dag-pi-system-prompt": "系统说明",
+	"dag-pi-user-message": "任务消息",
+	"managed-task-contract": "任务约定",
+	"developer-prompt": "开发约束",
+	"user-prompt": "用户要求",
+	"task-contract": "任务约定",
+	"execution-constraint": "执行限制",
+	"context-file": "补充资料",
+	"upstream-artifact": "上游文件",
+	"tool-contract": "工具使用规则",
+	"runtime-fact": "运行信息",
+	full: "完整包含",
+	excerpt: "只包含节选",
+	summary: "只包含摘要",
+	"reference-only": "只提供引用位置",
+	omitted: "未包含",
+});
+
+export function inspectorFieldLabel(field) {
+	const raw = String(field ?? "");
+	return FIELD_LABELS[raw] ?? LIST_LABELS[raw] ?? raw;
+}
+
+export function inspectorValueLabel(field, value) {
+	const rawField = String(field ?? "");
+	const rawValue = String(value ?? "");
+	if (rawField === "runIf" && rawValue) return "满足预设条件时执行";
+	return (
+		FIELD_VALUE_LABELS[rawField]?.[rawValue] ??
+		COMMON_VALUE_LABELS[rawValue] ??
+		rawValue
+	);
+}
+
+export function inspectorFieldHelp(field) {
+	return FIELD_HELP[String(field ?? "")] ?? null;
+}
+
+export function inspectorListValueLabel(value) {
+	const raw = String(value ?? "");
+	const separator = raw.indexOf(":");
+	if (separator > 0) {
+		const token = raw.slice(0, separator);
+		const humanToken = COMMON_VALUE_LABELS[token];
+		if (humanToken) return `${humanToken}${raw.slice(separator)}`;
+	}
+	return COMMON_VALUE_LABELS[raw] ?? raw;
+}
+
+export function describeInspectorMeta(field, value) {
+	const rawLabel = String(field ?? "");
+	const rawValueText = String(value ?? "");
+	const label = inspectorFieldLabel(rawLabel);
+	const humanValue = inspectorValueLabel(rawLabel, rawValueText);
+	return {
+		label,
+		value: humanValue,
+		help: inspectorFieldHelp(rawLabel),
+		rawLabel: label === rawLabel ? null : rawLabel,
+		rawValue: humanValue === rawValueText ? null : rawValueText,
+	};
+}

package/dist/worker/observe/static/dag-node-purpose.js

@@ -12,7 +12,7 @@ const NODE_PURPOSE_BY_ID = {
 	"implement-pi": "在允许路径内按计划改代码，完成本轮主实现。",
 	"implement-core": "在允许路径内完成核心实现，不越出约定写入范围。",
 	"repair-pi": "只修验证暴露出的可修复问题，不重开需求、不扩大 writeSet。",
-	"verify-shell": "跑冻结的验证命令，用退出码证明实现是否达标。",
+	"verify-shell": "运行预先确定的验证命令，用命令结果判断是否达标。",
 	"soft-verify-shell": "先做软验证，留下证据供过程监督，不立刻判整单失败。",
 	"hard-verify-shell": "硬验证：命令必须通过，作为后续审查与收口的事实。",
 	"review-pi": "对照需求与 diff 做只读审查，给出通过或需修订。",
@@ -35,14 +35,14 @@ const NODE_PURPOSE_BY_ID = {
 	"static-invariant-shell": "跑静态不变量检查，确认约定结构与约束仍成立。",
 	"changeset-impact-shell": "评估本轮 diff 的影响面，标出高风险改动。",
 	"closeout-artifact-shell": "收集收口所需的确定性产物与证据路径。",
-	"final-verify-shell": "收口前最后一轮冻结验证，作为完成权威。",
+	"final-verify-shell": "收尾前运行最后一轮固定验证，作为完成依据。",
 	"closeout-summary-pi": "把验证与交付事实写成简短交接摘要。",
 
 	"frontend-contract-pi": "把前端需求整理成可追踪契约：页面、状态、验收与边界。",
 	"frontend-contract-import-shell": "导入并固化前端实现契约，供后续设计、写入与验证节点使用。",
 	"frontend-scout-pi": "只读侦察前端结构、组件与接口用法，不改文件。",
 	"frontend-plan-pi": "选定实现与 Mock/API 策略，输出可执行的前端实现契约补丁。",
-	"frontend-design-policy-shell": "确定前端设计与 Mock/API 策略，冻结后续实现必须遵守的规则。",
+	"frontend-design-policy-shell": "确定前端设计和数据对接方案，并保存后续实现必须遵守的规则。",
 	"frontend-design-review-pi": "审查前端计划是否可写：通过则沿用原计划，否则要求修订。",
 	"frontend-plan-revision-pi": "按设计审查意见修订前端契约，不扩大范围。",
 	"frontend-final-design-review-pi": "复核修订后的前端计划，只有通过才能授权写入。",
@@ -51,9 +51,9 @@ const NODE_PURPOSE_BY_ID = {
 	"frontend-lint-baseline-shell": "记录写入前的 lint 基线，供实现后对比，不阻断写入。",
 	"frontend-implement-pi": "按已批准契约改前端代码、状态与交互，留在 writeSet 内。",
 	"frontend-verify-assess-shell": "跑静态/行为/Mock 验证并评估能否有界修复。",
-	"frontend-verify-shell": "执行冻结的前端验证命令，产出可复查的通过或失败证据。",
+	"frontend-verify-shell": "运行预先确定的前端检查，留下可复查的通过或失败结果。",
 	"frontend-repair-pi": "只修评估为可修复的前端失败，不重开需求。",
-	"frontend-reverify-shell": "修复后用同一套冻结命令复验。",
+	"frontend-reverify-shell": "修复后用同一套检查再次验证。",
 	"frontend-review-context-shell": "打包真实 diff 与有效验证证据，供审查节点使用。",
 	"frontend-review-pi": "对照契约审查前端实现与证据，给出通过或需修订。",
 	"frontend-review-gate-shell": "前端审查门禁：结论为通过才进入收口。",
@@ -85,7 +85,7 @@ const NODE_PURPOSE_BY_ID = {
 	"validate-backend-test-environment-shell": "检查 Python/pytest 与测试布局是否可跑，失败则不消耗模型。",
 	"backend-test-analysis-contract-shell": "固化后端测试分析契约与布局。",
 	"backend-test-environment-scout-pi": "侦察后端测试环境与入口，不改业务代码。",
-	"backend-test-execution-contract-shell": "冻结后端测试如何执行、产物写到哪里。",
+	"backend-test-execution-contract-shell": "确定后端测试如何执行、结果保存到哪里。",
 	"generate-backend-md-plan-pi": "生成中文模块索引与用例卡片计划。",
 	"materialize-backend-md-module-manifest-shell": "把 Markdown 模块清单落到磁盘。",
 	"review-and-revise-backend-md-cases-pi": "独立审查并修订 Markdown 用例。",
@@ -145,7 +145,7 @@ function describeFromPattern(nodeId) {
 		return "确定性门禁：核验上游结论，通过才放行后续节点。";
 	}
 	if (id.endsWith("-shell") && id.includes("verify")) {
-		return "跑冻结验证命令，留下可复查的通过/失败证据。";
+		return "运行预先确定的验证命令，留下可复查的通过或失败结果。";
 	}
 	if (id.endsWith("-shell") && (id.includes("report") || id.includes("manifest"))) {
 		return "把本轮证据整理成报告或清单，不改业务代码。";
@@ -181,9 +181,9 @@ function describeFromPattern(nodeId) {
 }
 
 function describeFromExecutor(executor) {
-	if (executor === "shell") return "运行确定性命令并留下证据。";
-	if (executor === "pi") return "由模型执行该步骤，范围受节点契约约束。";
-	if (executor === "static") return "按冻结规则直接给出结果，不调用模型。";
+	if (executor === "shell") return "由系统运行预先设置的命令，并保存执行结果。";
+	if (executor === "pi") return "由 AI 完成这一步，能做的事情受运行设置限制。";
+	if (executor === "static") return "按预先确定的规则直接给出结果，不调用 AI。";
 	return "";
 }
 

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

@@ -1,5 +1,24 @@
+import { isRowNavigationClick } from "./router.js";
 /** DOM helpers (Observe UI R5). */
 
+/** Compact action with a visible icon and an accessible, focusable tooltip. */
+export function iconButton(label, icon, className = "") {
+	const button = el("button", `observe-icon-button ${className}`.trim());
+	button.type = "button";
+	setIconButton(button, label, icon);
+	return button;
+}
+
+export function setIconButton(button, label, icon) {
+	button.setAttribute("aria-label", label);
+	button.setAttribute("data-tooltip", label);
+	button.setAttribute("title", label);
+	while (button.firstChild) button.removeChild(button.firstChild);
+	const glyph = el("i", icon);
+	glyph.setAttribute("aria-hidden", "true");
+	button.appendChild(glyph);
+}
+
 /**
  * Stable key → node maps, kept per (parent, scope) so reconcileKeyed never
  * depends on dataset support. A WeakMap keyed by parent holds a map of
@@ -205,7 +224,7 @@ export function buildTable(headers, rows) {
 		if (row.className) tr.className = row.className;
 		if (row.onClick) {
 			tr.classList.add("clickable");
-			tr.addEventListener("click", row.onClick);
+			tr.addEventListener("click", (event) => { if (isRowNavigationClick(event)) row.onClick(event); });
 		}
 		for (const cell of row.cells) {
 			const td = document.createElement("td");

package/dist/worker/observe/static/format-pool.d.ts

@@ -69,3 +69,5 @@ export function taskIdentityKey(
 	featureId: string | null | undefined,
 	taskId: string | null | undefined,
 ): string;
+
+export function matchesPoolTaskFilter(task: Record<string, unknown>, filters?: { status?: string; q?: string ;}): boolean;

package/dist/worker/observe/static/format-pool.js

@@ -151,3 +151,9 @@ export function collectPlannerReadyTasks(features) {
 export function taskIdentityKey(featureId, taskId) {
 	return `${featureId ?? ""}\0${taskId ?? ""}`;
 }
+
+export function matchesPoolTaskFilter(task, filters = {}) {
+	if (!matchesPoolStatusFilter(task.status, filters.status)) return false;
+	const query = String(filters.q ?? "").trim().toLocaleLowerCase();
+	return !query || [task.title, task.taskId, task.featureId, task.workerRunId, task.failureCategory, task.recommendedFollowUp].join(" ").toLocaleLowerCase().includes(query);
+}

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

@@ -405,3 +405,10 @@ export function formatLedgerSummary(summary) {
 	}
 	return lines.join("\n");
 }
+
+/** A batch ending does not imply all child tasks passed. */
+export function batchStatusBadge(batch) {
+	const status = String(batch?.status ?? "").toLowerCase();
+	if (["succeeded", "completed"].includes(status)) return el("span", "badge", "已结束");
+	return badge(batch?.status);
+}

package/dist/worker/observe/static/index.html

@@ -132,8 +132,8 @@
 
         <section data-view="dag" id="view-dag" class="view" hidden>
           <div class="view-heading">
-            <p class="view-kicker">Agent DAG</p>
-            <h2>DAG 详情</h2>
+            <p class="view-kicker">自动执行流程</p>
+            <h2>运行详情</h2>
           </div>
           <section
             id="dag-relations"
@@ -240,11 +240,11 @@
         <section data-view="failures" id="view-failures" class="view" hidden>
           <div class="view-heading">
             <p class="view-kicker">Attention Queue</p>
-            <h2>异常 Task</h2>
+            <h2>异常任务</h2>
             <p>按运行状态和建议跟进项集中处理需要人工介入的 Task。</p>
           </div>
           <div id="failures-empty" class="panel empty-state" hidden>
-            当前没有异常 Task
+            当前没有异常任务
           </div>
           <section id="failures-list" class="panel panel-table"></section>
         </section>