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

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

@@ -100,6 +100,9 @@ function buildOccurrenceCard(dagRunId, occurrence) {
 		false;
 	const card = document.createElement("button");
 	card.type = "button";
+	card.setAttribute("data-node-id", occurrence.nodeId);
+	card.setAttribute("data-execution-id", occurrence.executionId);
+	card.setAttribute("data-execution-key", occurrence.pass ? `pass-${occurrence.pass}` : "");
 	const extraClasses = [
 		recovered ? "is-recovered" : "",
 		occurrence.availability === "partial" ? "is-partial" : "",

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

@@ -11,3 +11,9 @@ export function resolveNodeRemark(node: {
 	nodeId: string;
 	rank?: string | number | null;
 } | null | undefined): DagNodeRemark;
+
+/** 面包屑次级：可读标题优先（截断），缺失/失败回退 run ID。 */
+export function dagBreadcrumbLabel(
+	dag: { title?: string | null } | null | undefined,
+	dagRunId: string,
+): string;

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

@@ -43,6 +43,8 @@ import {
 } from "../router.js";
 import {
 	fetchJson,
+	fetchJsonResult,
+	summarizeFetchError,
 	artifactUrl,
 	parseArtifactPreviewResponse,
 } from "../api.js";
@@ -67,7 +69,7 @@ import {
 	mountViewState,
 	makeSessionEventIdentity,
 } from "../state.js";
-import { uiState, dagGraphViewportStates, dagGraphViewModes } from "../state.js";
+import { uiState, dagGraphViewportStates, dagGraphViewModes, inspectRouteStates } from "../state.js";
 import { sortPoolTasks } from "../format-pool.js";
 import {
 	dagMetaVisibility,
@@ -76,11 +78,13 @@ import {
 	findDagForRun,
 } from "../dag-model.js";
 import { describeDagNodePurpose } from "../dag-node-purpose.js";
+import { inspectorValueLabel } from "../dag-inspector-humanize.js";
 import { layoutDag } from "../dag-layout.js";
 import {
 	showView,
 	setBreadcrumb,
 	updateHeaderRefresh,
+	bindManualViewRefresh,
 	mountRelationBar,
 } from "../shell-chrome.js";
 import {
@@ -197,7 +201,9 @@ export function buildDagNodeTable(dagRunId, nodes) {
 				index + 1,
 				node.nodeId,
 				node.rank ?? "—",
-				node.executor ?? "—",
+				node.executor
+					? inspectorValueLabel("executor", node.executor)
+					: "—",
 				node.model ?? "—",
 				node.status ? badge(node.status) : "—",
 				formatMs(node.durationMs),
@@ -211,10 +217,10 @@ export function buildDagNodeTable(dagRunId, nodes) {
 	const nodeTable = buildTable(
 		[
 			"序号",
-			"节点 ID",
-			"依赖层",
+			"步骤编号",
+			"执行层级",
 			"执行方式",
-			"模型",
+			"实际模型",
 			"状态",
 			"耗时",
 			"执行历史",
@@ -235,12 +241,20 @@ export function buildDagNodeTable(dagRunId, nodes) {
 	return nodeTable;
 }
 
+/** 面包屑次级：可读标题优先（截断），缺失/失败回退 run ID。 */
+export function dagBreadcrumbLabel(dag, dagRunId) {
+	const title = typeof dag?.title === "string" ? dag.title.trim() : "";
+	return title ? truncateText(title, 48) : dagRunId;
+}
+
 export async function renderDagDetail(dagRunId, initial = true) {
 	showView("dag");
-	setBreadcrumb([
+	const breadcrumbParts = (label) => [
 		{ label: UI_TEXT.dashboard, href: "#/" },
-		{ label: dagRunId },
-	]);
+		...(inspectRouteStates.get("return-list") ? [{ label: "返回结果列表", href: inspectRouteStates.get("return-list") }] : []),
+		{ label },
+	];
+	setBreadcrumb(breadcrumbParts(dagRunId));
 
 	if (initial || uiState.currentDagRunId !== dagRunId) {
 		uiState.currentDagRunId = dagRunId;
@@ -249,7 +263,7 @@ export async function renderDagDetail(dagRunId, initial = true) {
 		uiState.sessionEvents = [];
 		uiState.sessionEventIdentity = null;
 		uiState.dagInspectorOpen = false;
-		uiState.dagInspectorTab = "output";
+		uiState.dagInspectorTab = null;
 		uiState.dagInspectorAttempt = null;
 		uiState.dagGraphViewportState = null;
 		uiState.dagTimelineViewportState = null;
@@ -261,7 +275,7 @@ export async function renderDagDetail(dagRunId, initial = true) {
 	const metaEl = document.getElementById("dag-meta");
 	const ranksEl = document.getElementById("dag-ranks");
 	const nodesEl = document.getElementById("dag-nodes");
-	if (initial && metaEl) mountViewState(metaEl, "loading", "加载 DAG…");
+	if (initial && metaEl) mountViewState(metaEl, "loading", "正在加载运行流程…");
 	uiState.dagGraphViewportState = captureDagGraphViewportState(
 		uiState.dagGraphViewportState,
 		dagRunId,
@@ -271,17 +285,34 @@ export async function renderDagDetail(dagRunId, initial = true) {
 		dagGraphViewportStates.set(dagRunId, uiState.dagGraphViewportState);
 	}
 
-	const [dag, snapshot] = await Promise.all([
-		fetchJson(`/api/dag-runs/${encodeURIComponent(dagRunId)}`),
+	const requestGeneration = uiState.pollingGeneration;
+	const [dagResult, snapshot] = await Promise.all([
+		fetchJsonResult(`/api/dag-runs/${encodeURIComponent(dagRunId)}`),
 		fetchJson("/api/snapshot"),
 	]);
+	if (requestGeneration !== uiState.pollingGeneration || uiState.currentDagRunId !== dagRunId) return false;
+	if (!dagResult.ok && dagResult.status !== 404) {
+		let error = metaEl.querySelector(".dag-refresh-error");
+		if (!error) { error = el("div", "dag-refresh-error"); metaEl.appendChild(error); }
+		clearNode(error);
+		error.appendChild(el("span", "node-input-error", `更新失败，保留上次内容。${summarizeFetchError(dagResult)}`));
+		const retry = el("button", "btn btn-secondary", "重试");
+		retry.type = "button";
+		retry.addEventListener("click", () => { void renderDagDetail(dagRunId, false); });
+		error.appendChild(retry);
+		return true;
+	}
+	metaEl.querySelector(".dag-refresh-error")?.remove();
+	const dag = dagResult.ok ? dagResult.body : null;
+	if (dag) setBreadcrumb(breadcrumbParts(dagBreadcrumbLabel(dag, dagRunId)));
 	if (snapshot) {
 		uiState.lastSnapshot = snapshot;
-		updateHeaderRefresh(snapshot.generatedAt);
+		updateHeaderRefresh(snapshot.generatedAt, { mode: dag && isDagRunActive(dag) ? "auto" : "ended" });
+		bindManualViewRefresh("dag", () => renderDagDetail(dagRunId, false));
 	}
 	if (!dag) {
 		clearNode(metaEl);
-		mountViewState(metaEl, "error", "找不到该 DAG 运行。");
+		mountViewState(metaEl, "error", "找不到这次运行。运行记录可能已被清理。");
 		mountRelationBar("dag-relations", {}, snapshot);
 		closeDagInspector();
 		return false;
@@ -307,6 +338,16 @@ export async function renderDagDetail(dagRunId, initial = true) {
 	);
 
 	const nodes = dag.nodes ?? [];
+	if (initial) {
+		const routeState = parseRoute().inspector ?? inspectRouteStates.get(`dag:${dagRunId}`);
+		if (routeState?.nodeId && routeState.open !== false && nodes.some((node) => node.nodeId === routeState.nodeId)) {
+			uiState.selectedDagNodeId = routeState.nodeId;
+			uiState.dagInspectorOpen = true;
+			uiState.dagInspectorTab = ["overview", "input", "context", "timeline", "compare", "output", "lineage", "spec-evidence", "prompt-restart"].includes(routeState.tab) ? routeState.tab : null;
+			uiState.dagInspectorAttempt = { dagRunId, nodeId: routeState.nodeId, key: routeState.executionKey };
+			uiState.sessionEventIdentity = makeSessionEventIdentity(dagRunId, routeState.nodeId);
+		}
+	}
 	if (
 		uiState.selectedDagNodeId &&
 		!nodes.some((n) => n.nodeId === uiState.selectedDagNodeId)
@@ -327,7 +368,7 @@ export async function renderDagDetail(dagRunId, initial = true) {
 		(n) => (n.status ?? "").toLowerCase() === "skipped",
 	).length;
 	const succeededCount = nodes.filter(
-		(n) => isNodeFinished(n.status) && !isNodeFailed(n.status),
+		(n) => isNodeFinished(n.status) && !isNodeFailed(n.status) && String(n.status ?? "").toLowerCase() !== "skipped",
 	).length;
 
 	// reuse-dag-detail-shell: on a poll refresh (non-initial) we keep the
@@ -354,7 +395,7 @@ export async function renderDagDetail(dagRunId, initial = true) {
 		LIVENESS_LABELS[dag.liveness] ?? dag.liveness ?? LIVENESS_LABELS.unknown;
 	const primaryEntries = [
 		["标题", dag.title || dag.dagRunId],
-		["DAG 运行 ID", dag.dagRunId],
+		["运行编号", dag.dagRunId],
 		["状态", dagStatusBadge(dag.effectiveStatus ?? dag.status)],
 	];
 	if (visibility.showExecutorStatus)
@@ -381,9 +422,8 @@ export async function renderDagDetail(dagRunId, initial = true) {
 		["开始时间", formatTs(dag.startedAt)],
 		["结束时间", formatTs(dag.finishedAt)],
 		["总耗时", formatDuration(dag.durationMs)],
-		["进度", `${progress.finished}/${progress.total}`],
+		["已结束", `${progress.finished}/${progress.total}`],
 		["成功/失败/跳过", `${succeededCount}/${failedCount}/${skippedCount}`],
-		["DAG 路径", dag.dagPath ?? "—"],
 	);
 	const lintSummary = frontendLintSummary(dag.frontendLint);
 	if (lintSummary) {
@@ -401,6 +441,7 @@ export async function renderDagDetail(dagRunId, initial = true) {
 		],
 		["允许恢复", visibility.showResume ? "是" : "否"],
 		["允许收口", visibility.showReconcile ? "是" : "否"],
+		["记录保存位置", dag.dagPath ?? "—"],
 	]);
 	if (!initial && existingDetails?.parentNode === metaEl) {
 		const existingPrimary = metaEl.querySelector(":scope > .meta-grid");
@@ -429,7 +470,7 @@ export async function renderDagDetail(dagRunId, initial = true) {
 	);
 	if (nodes.length === 0) {
 		clearNode(ranksEl);
-		ranksEl.appendChild(el("h3", null, "DAG 依赖图"));
+		ranksEl.appendChild(el("h3", null, "执行步骤关系"));
 		ranksEl.appendChild(el("p", "empty", UI_TEXT.noNodes));
 	} else if (reuseShell && existingGraphWrap?.parentNode === ranksEl) {
 		// reuse-dag-graph-wrap + viewport identity: keep wrap/viewport alive.
@@ -440,16 +481,16 @@ export async function renderDagDetail(dagRunId, initial = true) {
 		}
 	} else {
 		clearNode(ranksEl);
-		ranksEl.appendChild(el("h3", null, "DAG 依赖图"));
+		ranksEl.appendChild(el("h3", null, "执行步骤关系"));
 		ranksEl.appendChild(renderDagGraph(dag, dagRunId, null));
 	}
 
 	const nodesScrollLeft = nodesEl.scrollLeft;
 	clearNode(nodesEl);
 	const nodeHeading = el("div", "dag-section-heading");
-	nodeHeading.appendChild(el("h3", null, "节点"));
+	nodeHeading.appendChild(el("h3", null, "执行步骤"));
 	nodeHeading.appendChild(
-		el("span", "dag-section-meta", `共 ${nodes.length} 个节点`),
+		el("span", "dag-section-meta", `共 ${nodes.length} 个步骤`),
 	);
 	nodesEl.appendChild(nodeHeading);
 
@@ -479,6 +520,7 @@ export async function renderDagDetail(dagRunId, initial = true) {
 		dagRunId,
 		nodes.find((node) => node.nodeId === uiState.selectedDagNodeId),
 		initial,
+		dag,
 	);
 	return isDagRunActive(dag);
 }

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

@@ -1,3 +1,4 @@
+import { isPlainNavigationClick, isRowNavigationClick } from "../router.js";
 /** Observe UI — formal DAG run history page (independent #/dags). */
 import { UI_TEXT } from "../constants.js";
 import { el, clearNode } from "../dom.js";
@@ -331,6 +332,7 @@ function buildRow(run) {
 		`/dag/${encodeURIComponent(run.dagRunId)}`,
 	);
 	nameLink.addEventListener("click", (event) => {
+		if (!isPlainNavigationClick(event)) return;
 		event.preventDefault();
 		event.stopPropagation();
 		navigate(`/dag/${encodeURIComponent(run.dagRunId)}`);

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

@@ -1,3 +1,4 @@
+import { isRowNavigationClick } from "../router.js";
 /** Observe UI view module (R5). */
 import {
 	UI_TEXT,
@@ -19,6 +20,7 @@ import {
 import { clearNode, el, reconcileKeyed, syncCompatibleNode } from "../dom.js";
 import {
 	badge,
+	batchStatusBadge,
 	badgeClass,
 	statusLabel,
 	formatTs,
@@ -287,16 +289,12 @@ export async function renderDashboard(scrollTo) {
 	const dagStaleRuns = dagHealth?.staleRuns ?? 0;
 	const dagInterruptedRuns = dagHealth?.interruptedRuns ?? 0;
 	const dagInconsistentRuns = dagHealth?.inconsistentRuns ?? 0;
-	const dagAttentionRuns =
-		dagHealth?.attentionRuns ??
-		dagRuns.filter(
-			(dag) =>
-				(dag.lifecycle ?? "").toLowerCase() !== "completed" &&
-				((dag.lifecycle ?? "").toLowerCase() === "paused" ||
-					["stale", "orphaned"].includes((dag.liveness ?? "").toLowerCase()) ||
-					["interrupted", "remote-unknown"].includes(dag.effectiveStatus) ||
-					dag.stateConsistent === false),
-		).length;
+	const attentionDags = dagRuns.filter((dag) =>
+		["paused", "failed", "error", "interrupted"].includes(String(dag.lifecycle ?? "").toLowerCase()) ||
+		["failed", "error", "interrupted", "remote-unknown"].includes(String(dag.effectiveStatus ?? dag.status ?? "").toLowerCase()) ||
+		["stale", "orphaned"].includes(String(dag.liveness ?? "").toLowerCase()) || dag.stateConsistent === false,
+	);
+	const dagAttentionRuns = attentionDags.length;
 
 	const quietCount = snapshot.health?.quietCount ?? 0;
 	const staleCount = snapshot.health?.staleCount ?? 0;
@@ -504,6 +502,7 @@ export async function renderDashboard(scrollTo) {
 							dagBlock.appendChild(el("div", "risk-block-label", "需处理 DAG"));
 							dagBlock.appendChild(el("div", "risk-total", String(block.total)));
 							dagBlock.appendChild(el("p", "risk-summary", block.summary));
+							const details = el("details", "risk-dag-list"); details.appendChild(el("summary", "risk-link", "查看需处理运行")); details.appendChild(el("div", "risk-dag-items")); dagBlock.appendChild(details);
 							return dagBlock;
 						},
 						update: (dagBlock, block) => {
@@ -511,6 +510,15 @@ export async function renderDashboard(scrollTo) {
 							if (total) total.textContent = String(block.total);
 							const summary = dagBlock.querySelector(".risk-summary");
 							if (summary) summary.textContent = block.summary;
+							const list = dagBlock.querySelector(".risk-dag-items");
+							if (list) {
+								clearNode(list); for (const dag of attentionDags) {
+									const link = el("a", "object-link", dag.title || dag.dagRunId);
+									link.href = inspectPathToCanonicalHref(`/dag/${encodeURIComponent(dag.dagRunId)}`);
+									list.appendChild(link);
+								}
+							}
+
 						},
 					},
 				);
@@ -634,7 +642,8 @@ export async function renderDashboard(scrollTo) {
 					create: (batch) => {
 						const tr = document.createElement("tr");
 						tr.classList.add("clickable");
-						tr.addEventListener("click", () =>
+						tr.addEventListener("click", (event) =>
+							isRowNavigationClick(event) &&
 							navigate(`/batch/${encodeURIComponent(batch.batchRunId)}`),
 						);
 						return tr;
@@ -643,7 +652,7 @@ export async function renderDashboard(scrollTo) {
 						const cells = [
 							batch.batchRunId,
 							batch.featureId ?? "—",
-							badge(batch.status),
+							batchStatusBadge(batch),
 							formatTs(batch.startedAt),
 							summaryText(batch.summary),
 						];

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

@@ -1,3 +1,5 @@
+import { bindManualViewRefresh, mountTaskRelationPicker } from "../shell-chrome.js";
+import { sortAttentionTasks } from "../format-pool.js";
 /** Observe UI view module (R5). */
 import {
 	UI_TEXT,
@@ -66,9 +68,23 @@ import {
 import { layoutDag } from "../dag-layout.js";
 import { showView, setBreadcrumb, updateHeaderRefresh } from "../shell-chrome.js";
 import { artifactLink } from "../kpi.js";
+import { taskFailureCategoryLabel, followUpLabel } from "../task-failure-labels.js";
+
+/** 异常页枚举单元格：中文主文案，raw token 保留在 title 供排障（未知原文透传）。 */
+function attentionTokenCell(raw, kind) {
+	const value = String(raw ?? "").trim();
+	if (!value) return "—";
+	const kindName = kind === "category" ? "分类" : "跟进";
+	const mapped = kind === "category" ? taskFailureCategoryLabel(value) : followUpLabel(value);
+	const cell = el("span", "attention-token");
+	cell.textContent = mapped;
+	cell.setAttribute("title", mapped === value ? `未收录的${kindName} token：${value}` : `${kindName} token：${value}`);
+	return cell;
+}
 
 export async function renderFailures() {
 	showView("failures");
+	bindManualViewRefresh("failures", () => renderFailures());
 	setBreadcrumb([
 		{ label: UI_TEXT.dashboard, href: "#/" },
 		{ label: UI_TEXT.failures },
@@ -89,15 +105,9 @@ export async function renderFailures() {
 		return;
 	}
 	uiState.lastSnapshot = snapshot;
-	updateHeaderRefresh(snapshot.generatedAt);
+	updateHeaderRefresh(snapshot.generatedAt, { mode: "manual" });
 
-	const tasks = (snapshot.tasks ?? []).filter(
-		(task) =>
-			task.status === "failed" ||
-			task.status === "blocked" ||
-			task.status === "stale" ||
-			task.liveness === "stale",
-	);
+	const tasks = sortAttentionTasks(snapshot.tasks ?? []);
 
 	if (tasks.length === 0) {
 		clearNode(listEl);
@@ -122,11 +132,11 @@ export async function renderFailures() {
 			? () => navigate(`/run/${encodeURIComponent(task.workerRunId)}`)
 			: undefined,
 		cells: [
-			task.taskId ?? "—",
+			objectRouteLink("task", task.taskId, snapshot, task.featureId),
 			task.featureId ?? "—",
 			badge(task.status),
-			task.failureCategory ?? "—",
-			task.recommendedFollowUp ?? "—",
+			attentionTokenCell(task.failureCategory, "category"),
+			attentionTokenCell(task.recommendedFollowUp, "followUp"),
 			(() => {
 				const links = el("div", "artifact-links");
 				const r = refs(task);

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

@@ -1,3 +1,5 @@
+import { renderInlineArtifactList } from "./run.js";
+import { bindManualViewRefresh, mountTaskRelationPicker } from "../shell-chrome.js";
 /** Observe UI view module (R5). */
 import {
 	UI_TEXT,
@@ -79,6 +81,7 @@ import { artifactLink } from "../kpi.js";
 
 export async function renderFeatureDetail(featureId) {
 	showView("feature");
+	bindManualViewRefresh("feature", () => renderFeatureDetail(featureId));
 	setBreadcrumb([
 		{ label: UI_TEXT.dashboard, href: "#/" },
 		{ label: featureId || "Feature" },
@@ -124,7 +127,7 @@ export async function renderFeatureDetail(featureId) {
 		return false;
 	}
 	uiState.lastSnapshot = snapshot;
-	updateHeaderRefresh(snapshot.generatedAt);
+	updateHeaderRefresh(snapshot.generatedAt, { mode: "manual" });
 
 	const feature = lookup.kind === "found" ? lookup.feature : undefined;
 	if (!feature) {
@@ -143,31 +146,8 @@ export async function renderFeatureDetail(featureId) {
 		return false;
 	}
 
-	// Relations: only proven snapshot objects (feature itself + linked tasks if present).
-	const linkedTask = (feature.tasks ?? [])
-		.map((t) => t.taskId)
-		.find((id) => objectExistsInSnapshot("task", id, snapshot));
-	const poolTask = linkedTask
-		? (snapshot?.tasks ?? []).find((t) => t.taskId === linkedTask)
-		: undefined;
-	const batchRunId =
-		poolTask?.batchRunId ??
-		(poolTask ? findBatchRunIdForTask(snapshot, poolTask) : null);
-	const dag =
-		poolTask != null
-			? findDagForRun(snapshot, poolTask.workerRunId, poolTask)
-			: undefined;
-	mountRelationBar(
-		"feature-relations",
-		{
-			featureId: feature.featureId,
-			taskId: linkedTask,
-			batchRunId: batchRunId ?? undefined,
-			workerRunId: poolTask?.workerRunId,
-			dagRunId: dag?.dagRunId ?? poolTask?.dagRunId,
-		},
-		snapshot,
-	);
+	const linkedTasks = (feature.tasks ?? []).map((task) => ({ ...task, ...(snapshot.tasks ?? []).find((entry) => entry.taskId === task.taskId && entry.featureId === feature.featureId), featureId: feature.featureId }));
+	mountTaskRelationPicker("feature-relations", { featureId: feature.featureId }, linkedTasks, snapshot);
 
 	try {
 		metaEl.appendChild(el("h3", "section-heading", "状态与摘要"));
@@ -205,9 +185,11 @@ export async function renderFeatureDetail(featureId) {
 								ac.required ? "是" : "否",
 								ac.status ?? "—",
 								(ac.blockedBy ?? []).join(", ") || "—",
-								(ac.evidence ?? []).length
-									? String((ac.evidence ?? []).length)
-									: "缺失",
+								(() => {
+									if (!(ac.evidence ?? []).length) return "缺失";
+									const details = el("details", "ac-evidence"); details.appendChild(el("summary", null, `${ac.evidence.length} 份证据`));
+									let loaded = false; details.addEventListener("toggle", () => { if (details.open && !loaded) { loaded = true; const body = el("div"); details.appendChild(body); renderInlineArtifactList(body, ac.evidence.map((path, index) => [`证据 ${index + 1}`, path])); } }); return details;
+								})(),
 							],
 						})),
 					),

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

@@ -1,3 +1,4 @@
+import { isPlainNavigationClick, isRowNavigationClick } from "../router.js";
 /** Observe UI view module — Task Pool ops surface (R5 + ops refresh). */
 import { UI_TEXT, POOL_POLL_MS } from "../constants.js";
 import { clearNode, el, reconcileKeyed } from "../dom.js";
@@ -26,6 +27,7 @@ import { uiState } from "../state.js";
 import {
 	sortPoolTasks,
 	matchesPoolStatusFilter,
+	matchesPoolTaskFilter,
 	poolStatusCounts,
 	sortAttentionTasks,
 	collectPlannerReadyTasks,
@@ -125,6 +127,7 @@ function linkTo(path, label, className) {
 	const a = el("a", className || "object-link", label);
 	a.href = inspectPathToCanonicalHref(path);
 	a.addEventListener("click", (e) => {
+		if (!isPlainNavigationClick(e)) return;
 		e.preventDefault();
 		e.stopPropagation();
 		navigate(path);
@@ -264,7 +267,7 @@ export async function renderPool(options = {}) {
 
 	if (updatedAtEl) {
 		updatedAtEl.textContent = snapshot.generatedAt
-			? `投影更新：${formatTs(snapshot.generatedAt)}（advisory）`
+			? `数据更新于 ${formatTs(snapshot.generatedAt)} · 仅提示`
 			: "";
 	}
 
@@ -302,21 +305,12 @@ export async function renderPool(options = {}) {
 	const routeFilters = parseRoute().filters ?? {};
 	const statusFilter = (routeFilters.status ?? "").toLowerCase();
 	const qFilter = (routeFilters.q ?? "").trim().toLowerCase();
-	const filteredTasks = allTasks.filter((task) => {
-		if (statusFilter && !matchesPoolStatusFilter(task.status, statusFilter)) {
-			return false;
-		}
-		if (qFilter) {
-			const hay =
-				`${task.taskId ?? ""} ${task.featureId ?? ""} ${task.workerRunId ?? ""} ${task.failureCategory ?? ""} ${task.recommendedFollowUp ?? ""}`.toLowerCase();
-			if (!hay.includes(qFilter)) return false;
-		}
-		return true;
-	});
+	const filteredTasks = allTasks.filter((task) => matchesPoolTaskFilter(task, routeFilters));
 	const poolPresent = snapshot.taskPool?.present === true;
 	const projectionFailed = Boolean(snapshot.projectionError);
-	const readyItems = collectPlannerReadyTasks(snapshot.features);
-	const attentionTasks = sortAttentionTasks(allTasks);
+	const taskById = new Map(allTasks.map((task) => [taskIdentityKey(task.featureId, task.taskId), task]));
+	const readyItems = collectPlannerReadyTasks(snapshot.features).filter((item) => matchesPoolTaskFilter({ ...item, status: "pending", ...taskById.get(taskIdentityKey(item.featureId, item.taskId)) }, routeFilters));
+	const attentionTasks = sortAttentionTasks(filteredTasks);
 	const counts = poolStatusCounts(allTasks);
 	const health = snapshot.health ?? {};
 
@@ -352,7 +346,7 @@ export async function renderPool(options = {}) {
 					qLabel.appendChild(document.createTextNode("搜索"));
 					const qInput = document.createElement("input");
 					qInput.type = "search";
-					qInput.placeholder = "Task / Feature / run…";
+					qInput.placeholder = "名称 / Task / Feature / run…";
 					qInput.setAttribute("aria-label", "搜索 Task");
 					qInput.dataset.role = "q";
 					qLabel.appendChild(qInput);
@@ -366,14 +360,20 @@ export async function renderPool(options = {}) {
 							}),
 						);
 					});
-					qInput.addEventListener("change", () => {
-						navigate(
-							buildHashPath("/pool", {
-								status: statusSelect.value || undefined,
-								q: qInput.value.trim() || undefined,
-							}),
-						);
-					});
+					let searchTimer;
+					const applySearch = () => {
+						clearTimeout(searchTimer);
+						searchTimer = setTimeout(() => {
+							if (parseRoute().view !== "pool" || !qInput.isConnected) return;
+							navigate(buildHashPath("/pool", { status: statusSelect.value, q: qInput.value.trim() }));
+						}, 220);
+					};
+					qInput.addEventListener("input", (event) => { if (!event.isComposing) applySearch(); });
+					qInput.addEventListener("compositionend", applySearch);
+					const clear = el("button", "btn btn-secondary", "清空筛选");
+					clear.type = "button";
+					clear.addEventListener("click", () => { clearTimeout(searchTimer); qInput.value = ""; statusSelect.value = ""; navigate("/pool"); });
+					wrap.appendChild(clear);
 					wrap.appendChild(statusLabelEl);
 					wrap.appendChild(qLabel);
 					wrap.appendChild(count);
@@ -469,22 +469,31 @@ export async function renderPool(options = {}) {
 					health.timeoutRiskCount ?? 0,
 					(health.timeoutRiskCount ?? 0) > 0 ? "kpi-risk" : "",
 				],
-				["合计", allTasks.length, ""],
+				// 口径与 Ready 不同：Ready 来自 Feature 规划项，此处只数已建 Task。
+				[
+					"已建 Task",
+					allTasks.length,
+					"",
+					"当前已创建的 Task 数；上方 Ready 是 Feature 决策产生的规划项，尚未建 Task，不计入本数。",
+				],
 			];
 			reconcileKeyed(cards, entries, {
 				getKey: ([label]) => label,
-				create: ([label, value, extra]) => {
+				create: ([label, value, extra, title]) => {
 					const card = el("div", `kpi-card${extra ? ` ${extra}` : ""}`);
 					card.appendChild(el("div", "kpi-value", String(value)));
 					card.appendChild(el("div", "kpi-label", label));
+					if (title) card.setAttribute("title", title);
 					return card;
 				},
-				update: (card, [label, value, extra]) => {
+				update: (card, [label, value, extra, title]) => {
 					card.className = `kpi-card${extra ? ` ${extra}` : ""}`;
 					const valueEl = card.querySelector(".kpi-value");
 					const labelEl = card.querySelector(".kpi-label");
 					if (valueEl) valueEl.textContent = String(value);
 					if (labelEl) labelEl.textContent = label;
+					if (title) card.setAttribute("title", title);
+					else card.removeAttribute("title");
 				},
 			});
 		},
@@ -621,7 +630,7 @@ export async function renderPool(options = {}) {
 					create: (task) => {
 						const tr = document.createElement("tr");
 						tr.classList.add("clickable");
-						tr.addEventListener("click", () => navigate(taskPath(task)));
+						tr.addEventListener("click", (event) => { if (isRowNavigationClick(event)) navigate(taskPath(task)); });
 						for (let i = 0; i < 8; i++) tr.appendChild(document.createElement("td"));
 						return tr;
 					},
@@ -703,7 +712,7 @@ export async function renderPool(options = {}) {
 export function startPoolView() {
 	stopPoolAutoPolling();
 	syncPoolToolbar();
-	void renderPool({ reason: "route" }).then(() => {
+	return renderPool({ reason: "route" }).then(() => {
 		if (poolAutoRefreshEnabled()) startPoolAutoPolling();
 	});
 }