agentpage 0.0.32 → 0.0.33

package/dist/index.mjs

@@ -10,25 +10,7 @@ const DEFAULT_MAX_ROUNDS = 40;
 const DEFAULT_RECOVERY_WAIT_MS = 100;
 const DEFAULT_ACTION_RECOVERY_ROUNDS = 2;
 const DEFAULT_NOT_FOUND_RETRY_ROUNDS = 2;
-const DEFAULT_NOT_FOUND_RETRY_WAIT_MS = 1e3;
-const DEFAULT_ROUND_STABILITY_WAIT_TIMEOUT_MS = 4e3;
-const DEFAULT_ROUND_STABILITY_WAIT_QUIET_MS = 200;
-const DEFAULT_ROUND_STABILITY_WAIT_LOADING_SELECTORS = [
-	".ant-spin",
-	".ant-spin-spinning",
-	".ant-skeleton",
-	".el-loading-mask",
-	".bk-loading",
-	".bk-spin-loading",
-	".bk-skeleton",
-	".bk-sideslider-loading",
-	".t-loading",
-	".t-skeleton",
-	".t-skeleton__row",
-	"[aria-busy=\"true\"]",
-	".skeleton",
-	".loading"
-];
+const DEFAULT_NOT_FOUND_RETRY_WAIT_MS = 2e3;
 /** 快照起始标记 — 用于在消息中识别快照边界 */
 const SNAPSHOT_START = "<!-- SNAPSHOT_START -->";
 /** 快照结束标记 */
@@ -154,13 +136,11 @@ function deriveNextInstruction(text, currentInstruction) {
 */
 function reduceRemainingHeuristically(currentInstruction, executedCount) {
 	if (!currentInstruction.trim() || executedCount <= 0) return currentInstruction;
-	if (!/(->|=>|→|\bthen\b|\band then\b|\bnext\b|\bafter that\b|然后|接着|随后|之后|再)/i.test(currentInstruction)) return currentInstruction;
-	const parts = currentInstruction.replace(/\s+/g, " ").replace(/(->|=>|→)/g, " 然后 ").split(/\s*(?:then|and then|next|after that|然后|接着|随后|之后|再)\s*/gi).map((part) => part.trim()).filter(Boolean);
+	const parts = currentInstruction.replace(/\s+/g, " ").replace(/(->|=>|→)/g, " 然后 ").replace(/[，,。；;]/g, " 然后 ").split(/\s*(?:然后|再|并且|并|接着|随后|之后)\s*/g).map((part) => part.trim()).filter(Boolean);
 	if (parts.length <= 1) return currentInstruction;
-	const consumedSteps = Math.min(Math.max(1, Math.floor(executedCount)), 1);
-	const nextParts = parts.slice(Math.min(consumedSteps, parts.length));
+	const nextParts = parts.slice(Math.min(executedCount, parts.length));
 	if (nextParts.length === 0) return "";
-	return nextParts.join(" 然后 ");
+	return nextParts.join(" -> ");
 }
 /**
 * 判定是否强制断轮。
@@ -183,36 +163,6 @@ function shouldForceRoundBreak(toolName, toolInput) {
 	return toolName === "evaluate";
 }
 /**
-* 判定动作是否可能引发页面结构或状态变化。
-*
-* 用于“轮次后稳定等待”触发条件：
-* - 命中 true：本轮结束后执行加载态 + DOM 静默双重等待
-* - 命中 false：跳过等待，直接进入下一轮
-*/
-function isPotentialDomMutation(toolName, toolInput) {
-	const action = getToolAction(toolInput);
-	if (toolName === "navigate") return true;
-	if (toolName === "evaluate") return true;
-	if (toolName !== "dom") return false;
-	if (!action) return false;
-	return [
-		"click",
-		"fill",
-		"select_option",
-		"clear",
-		"check",
-		"uncheck",
-		"type",
-		"focus",
-		"hover",
-		"scroll",
-		"press",
-		"set_attr",
-		"add_class",
-		"remove_class"
-	].includes(action);
-}
-/**
 * 采集找不到元素任务。
 *
 * 返回 null 表示当前结果不属于“元素未找到”，
@@ -308,12 +258,6 @@ function hasToolError(result) {
 * - `pruneLayout=true` 时：无 id/无语义/无交互/无直接文本的布局容器会被“折叠”，
 *   子节点直接提升输出，减少无意义层级；当同一折叠容器提升出多个相邻节点时，
 *   快照会用括号分组块标记其关联来源（collapsed-group）。
-* - 布局主干保留：浅层结构优先保留（避免页面主骨架被过早折叠导致业务区域缺失）。
-* - 事件信号保留：节点自身存在事件绑定（inline/on* 或 addEventListener 追踪）时优先保留；
-*   中浅层会做受预算约束的子树事件探测，尽量保留潜在可操作链路。
-* - 语义文本保留：包含语义文本的容器优先保留，避免“有意义但非控件”信息被误删。
-* - 噪音过滤：跳过 `svg` 等装饰节点及 `__SVG_SPRITE_NODE__` sprite 容器，
-*   避免图标定义树挤占节点预算。
 * - `maxNodes`：全局节点预算，超限后停止继续遍历并追加 truncation 提示。
 * - `maxChildren`：每个父节点只保留前 N 个子元素，其余用 `... (n children omitted)` 汇总。
 * - `maxTextLength`：节点文本按长度截断，避免长段文案占满上下文。
@@ -485,10 +429,26 @@ function buildCompactMessages(userMessage, trace, latestSnapshot, currentUrl, hi
 		content: `Done steps (do NOT repeat):\n${traceParts.join("\n")}`
 	});
 	const hasErrors = trace.some((e) => hasToolError(e.result));
-	const needsMasterGoalAnchor = activeInstruction.trim().toLowerCase() !== userMessage.trim().toLowerCase();
-	const contextParts = ["## Execution context"];
-	if (needsMasterGoalAnchor) contextParts.push(`Master goal (reference only — do NOT restart from scratch):`, userMessage, "");
-	contextParts.push("Current remaining instruction:", activeInstruction, "", "Task-reduction model:", "Input: current remaining instruction + previous round executed actions + this-round actions.", "Output: new remaining instruction after removing this-round actions.", "Start from visible page state directly. Do NOT restate task. Do NOT output planning text.", "Execute all independent visible sub-tasks in one round.", "Do NOT act on elements not present in this snapshot yet.", "If action changes DOM (open modal/navigate), stop after that batch and continue next round.", "Do NOT call page_info (get_url/get_title/query_all/snapshot).", "For dropdown/select fields, use dom with action=select_option (or fill on a select).", "If a needed list shows `... (N children omitted)` under a specific container, output `SNAPSHOT_HINT: EXPAND_CHILDREN #<containerRef>` and wait for next round snapshot.", "Build the minimal action array from current snapshot to finish this remaining instruction in one round whenever possible.", "For deterministic increase/decrease controls, compute delta from current visible value and issue exactly that many clicks in one round (e.g., +2 => two increase clicks). Do not overshoot then undo.", "Stop rule: once requested state is reached, stop tool calls. If verification is needed, verify once and then output REMAINING: DONE.", allowAgentUiInteraction ? "User explicitly asked to operate AutoPilot UI. You may interact with chat input/send/dock only as requested." : "Do NOT interact with any AI chat UI elements (chat input, send button, dock). Only operate on the actual page content.");
+	const contextParts = [
+		"## Execution context",
+		"Current remaining instruction:",
+		activeInstruction,
+		"",
+		"Task-reduction model:",
+		"Input: current remaining instruction + previous round executed actions + this-round actions.",
+		"Output: new remaining instruction after removing this-round actions.",
+		"Start from visible page state directly. Do NOT restate task. Do NOT output planning text.",
+		"Execute all independent visible sub-tasks in one round.",
+		"Do NOT act on elements not present in this snapshot yet.",
+		"If action changes DOM (open modal/navigate), stop after that batch and continue next round.",
+		"Do NOT call page_info (get_url/get_title/query_all/snapshot).",
+		"For dropdown/select fields, use dom with action=select_option (or fill on a select).",
+		"If a needed list shows `... (N children omitted)` under a specific container, output `SNAPSHOT_HINT: EXPAND_CHILDREN #<containerRef>` and wait for next round snapshot.",
+		"Build the minimal action array from current snapshot to finish this remaining instruction in one round whenever possible.",
+		"For deterministic increase/decrease controls, compute delta from current visible value and issue exactly that many clicks in one round (e.g., +2 => two increase clicks). Do not overshoot then undo.",
+		"Stop rule: once requested state is reached, stop tool calls. If verification is needed, verify once and then output REMAINING: DONE.",
+		allowAgentUiInteraction ? "User explicitly asked to operate AutoPilot UI. You may interact with chat input/send/dock only as requested." : "Do NOT interact with any AI chat UI elements (chat input, send button, dock). Only operate on the actual page content."
+	];
 	if (hasErrors) contextParts.push("", "The last step failed. Retry with a different approach, or skip and continue with other visible targets.");
 	else contextParts.push("", "If the goal is fully done, reply with a short summary (no tool calls).");
 	if (previousRoundTasks && previousRoundTasks.length > 0) contextParts.push("", "Previous round planned task array (already executed):", ...previousRoundTasks.map((task, index) => `${index + 1}. ${task}`));
@@ -736,7 +696,7 @@ function detectIdleLoop(toolCalls, consecutiveReadOnlyRounds) {
 * - 达到 `maxRounds`
 */
 async function executeAgentLoop(params) {
-	const { client, registry, systemPrompt, message, initialSnapshot, history, dryRun = false, maxRounds = DEFAULT_MAX_ROUNDS, roundStabilityWait, callbacks } = params;
+	const { client, registry, systemPrompt, message, initialSnapshot, history, dryRun = false, maxRounds = DEFAULT_MAX_ROUNDS, callbacks } = params;
 	const tools = registry.getDefinitions();
 	const allToolCalls = [];
 	const fullToolTrace = [];
@@ -757,12 +717,6 @@ async function executeAgentLoop(params) {
 	let lastRoundHadError = false;
 	let protocolViolationHint;
 	const snapshotExpandRefIds = /* @__PURE__ */ new Set();
-	const effectiveRoundStabilityWait = {
-		enabled: roundStabilityWait?.enabled ?? true,
-		timeoutMs: Math.max(200, Math.floor(roundStabilityWait?.timeoutMs ?? DEFAULT_ROUND_STABILITY_WAIT_TIMEOUT_MS)),
-		quietMs: Math.max(50, Math.floor(roundStabilityWait?.quietMs ?? DEFAULT_ROUND_STABILITY_WAIT_QUIET_MS)),
-		loadingSelectors: [...new Set([...DEFAULT_ROUND_STABILITY_WAIT_LOADING_SELECTORS, ...roundStabilityWait?.loadingSelectors ?? []].map((selector) => selector.trim()).filter(Boolean))]
-	};
 	let recoveryCount = 0;
 	let redundantInterceptCount = 0;
 	let pendingNotFoundRetry;
@@ -794,30 +748,6 @@ async function executeAgentLoop(params) {
 		} : void 0);
 		recordSnapshotStats(pageContext.latestSnapshot);
 	};
-	/**
-	* 轮次后稳定等待（双重等待）。
-	*
-	* 顺序固定为：
-	* 1) 等待 loading 指示器隐藏
-	* 2) 等待 DOM quiet window
-	*/
-	const runRoundStabilityBarrier = async () => {
-		if (!effectiveRoundStabilityWait.enabled) return;
-		if (!registry.has("wait")) return;
-		const timeout = effectiveRoundStabilityWait.timeoutMs;
-		const loadingSelector = effectiveRoundStabilityWait.loadingSelectors.join(", ");
-		if (loadingSelector) await registry.dispatch("wait", {
-			action: "wait_for_selector",
-			selector: loadingSelector,
-			state: "hidden",
-			timeout
-		});
-		await registry.dispatch("wait", {
-			action: "wait_for_stable",
-			timeout,
-			quietMs: effectiveRoundStabilityWait.quietMs
-		});
-	};
 	if (pageContext.latestSnapshot) recordSnapshotStats(pageContext.latestSnapshot);
 	/**
 	* 追加工具轨迹。
@@ -933,7 +863,6 @@ async function executeAgentLoop(params) {
 			break;
 		}
 		let roundHasError = false;
-		let roundHasPotentialDomMutation = false;
 		const executedTaskCalls = [];
 		const roundMissingTasks = [];
 		for (const tc of response.toolCalls) {
@@ -964,7 +893,6 @@ async function executeAgentLoop(params) {
 			const missingTask = collectMissingTask(tc.name, tc.input, result);
 			if (missingTask) roundMissingTasks.push(missingTask);
 			if (result.details && typeof result.details === "object") roundHasError = roundHasError || Boolean(result.details.error);
-			if (!hasToolError(result) && isPotentialDomMutation(tc.name, tc.input)) roundHasPotentialDomMutation = true;
 			if (tc.name === "page_info" && getToolAction(tc.input) === "snapshot") {
 				pageContext.latestSnapshot = toContentString(result.content);
 				recordSnapshotStats(pageContext.latestSnapshot);
@@ -980,8 +908,7 @@ async function executeAgentLoop(params) {
 		else pendingNotFoundRetry = void 0;
 		if (parsedInstructionState.hasRemainingProtocol) remainingInstruction = parsedInstructionState.nextInstruction;
 		else {
-			const heuristicProgressUnits = executedTaskCalls.length > 0 ? 1 : 0;
-			const nextByHeuristic = reduceRemainingHeuristically(remainingInstruction, heuristicProgressUnits);
+			const nextByHeuristic = reduceRemainingHeuristically(remainingInstruction, executedTaskCalls.length);
 			if (nextByHeuristic !== remainingInstruction) remainingInstruction = nextByHeuristic;
 			else roundHasError = true;
 		}
@@ -999,7 +926,6 @@ async function executeAgentLoop(params) {
 			break;
 		}
 		consecutiveReadOnlyRounds = idleResult;
-		if (roundHasPotentialDomMutation) await runRoundStabilityBarrier();
 		await refreshSnapshot();
 	}
 	const resultMessages = [...history ?? [], {
@@ -1684,16 +1610,12 @@ function buildSystemPrompt(params = {}) {
 		"- If an action will change DOM (open modal, navigate), stop after that action batch and continue next round with new snapshot.",
 		"- Do NOT call page_info (snapshot/query/get_url/get_title). Snapshot is already provided every round.",
 		"- For dropdown/select, use dom action=select_option (or fill on select).",
-		"- Always cross-check planned actions against the original goal to avoid task drift (e.g., do not confuse create issue vs create repository).",
 		"- If a required list shows `... (N children omitted)` under a specific container, request focused expansion by outputting `SNAPSHOT_HINT: EXPAND_CHILDREN #<containerRef>`.",
 		"- After outputting snapshot expansion hint, wait for the next refreshed snapshot before further scrolling/clicking on that list.",
 		"- Verification whitelist: do NOT use get_text/get_attr to verify input/select values unless the user explicitly asks for verification.",
 		"- Stop rule: when the requested state is achieved, stop calling tools. If verification is requested, verify once and then return REMAINING: DONE (no repeated get_text/get_attr on the same target).",
 		"- Do NOT interact with AutoPilot UI unless user explicitly asks.",
 		"",
-		"## Listener Abbrevs",
-		"clk=click dbl=dblclick mdn=mousedown mup=mouseup mmv=mousemove mov=mouseover mot=mouseout men=mouseenter mlv=mouseleave pdn=pointerdown pup=pointerup pmv=pointermove tst=touchstart ted=touchend kdn=keydown kup=keyup inp=input chg=change sub=submit fcs=focus blr=blur scl=scroll whl=wheel drg=drag drs=dragstart dre=dragend drp=drop ctx=contextmenu",
-		"",
 		"## Output Contract",
 		"- Return tool calls for this round.",
 		"- Also include one plain text line:",
@@ -1721,89 +1643,25 @@ function buildSystemPrompt(params = {}) {
 }
 
 //#endregion
-//#region src/web/event-listener-tracker.ts
-const elementEventMap = /* @__PURE__ */ new WeakMap();
-let installed = false;
-let originalAddEventListener;
-let originalRemoveEventListener;
-function normalizeEventType(type) {
-	if (typeof type !== "string") return null;
-	return type.trim().toLowerCase() || null;
-}
-function canTrackElementTarget(target) {
-	if (typeof Element === "undefined") return false;
-	return target instanceof Element;
-}
-function trackElementEvent(target, type) {
-	if (!canTrackElementTarget(target)) return;
-	const prev = elementEventMap.get(target);
-	if (prev) {
-		prev.add(type);
-		return;
-	}
-	elementEventMap.set(target, new Set([type]));
-}
-function untrackElementEvent(target, type) {
-	if (!canTrackElementTarget(target)) return;
-	const prev = elementEventMap.get(target);
-	if (!prev) return;
-	prev.delete(type);
-	if (prev.size === 0) elementEventMap.delete(target);
-}
-/**
-* 安装全局监听追踪补丁（幂等）。
-*/
-function installEventListenerTracking() {
-	if (installed) return;
-	if (typeof EventTarget === "undefined") return;
-	const proto = EventTarget.prototype;
-	const nativeAdd = proto.addEventListener;
-	const nativeRemove = proto.removeEventListener;
-	if (typeof nativeAdd !== "function" || typeof nativeRemove !== "function") return;
-	originalAddEventListener = nativeAdd;
-	originalRemoveEventListener = nativeRemove;
-	proto.addEventListener = function patchedAddEventListener(type, listener, options) {
-		originalAddEventListener?.call(this, type, listener, options);
-		try {
-			const normalizedType = normalizeEventType(type);
-			if (!normalizedType || listener == null) return;
-			trackElementEvent(this, normalizedType);
-		} catch {}
-	};
-	proto.removeEventListener = function patchedRemoveEventListener(type, listener, options) {
-		originalRemoveEventListener?.call(this, type, listener, options);
-		try {
-			const normalizedType = normalizeEventType(type);
-			if (!normalizedType || listener == null) return;
-			untrackElementEvent(this, normalizedType);
-		} catch {}
-	};
-	installed = true;
-}
-/**
-* 读取元素已记录的事件名（排序后返回，便于稳定输出）。
-*/
-function getTrackedElementEvents(el) {
-	const set = elementEventMap.get(el);
-	if (!set || set.size === 0) return [];
-	return Array.from(set).sort();
-}
-/**
-* 判断元素是否存在至少一个被追踪到的事件绑定。
-*/
-function hasTrackedElementEvents(el) {
-	return (elementEventMap.get(el)?.size ?? 0) > 0;
-}
-
-//#endregion
-//#region src/web/tools/dom-tool/constants.ts
+//#region src/web/tools/dom-tool.ts
 /**
-* DOM Tool 常量定义。
+* DOM Tool — 浏览器 DOM 操作工具（结合 Playwright 核心交互模式增强）。
+*
+* 关键改进（参考 Playwright）：
+* 1. retarget — 点击时自动重定向到 button/link/label.control
+* 2. scrollIntoView 多策略 — 4 种 block 对齐轮换，解决 sticky 遮挡
+* 3. stable 检查 — rAF 逐帧检测元素位置稳定后再操作
+* 4. hit-target 验证 — elementsFromPoint 检查是否被遮挡
+* 5. 完整点击事件链 — pointermove→pointerdown→mousedown→pointerup→mouseup→click
+* 6. check/uncheck 通过 click — 先检查→click 切换→验证状态
+* 7. press 组合键 — 支持 Control+a, Shift+Enter 等修饰键
+* 8. fill 分类型 — date/color/range 走 setValue，text 类走 selectAll+原生写入
+* 9. 自定义下拉增强 — 更广泛的 option 选择器 + 等待弹出
+* 10. ARIA disabled — 检查祖先链 aria-disabled
 *
-* 包含：input 类型分类、修饰键集合、键码映射、滚动策略。
+* 运行环境：浏览器 Content Script（直接访问 DOM，无 CDP）。
 */
-/** 默认等待超时（ms） */
-const DEFAULT_WAIT_MS = 1200;
+const DEFAULT_WAIT_MS = 2e3;
 /** scrollIntoView 轮换策略（参考 Playwright dom.ts） */
 const SCROLL_OPTIONS = [
 	void 0,
@@ -1863,9 +1721,6 @@ const KEY_CODE_MAP = {
 	Alt: "AltLeft",
 	Meta: "MetaLeft"
 };
-
-//#endregion
-//#region src/web/tools/dom-tool/query.ts
 let activeRefStore;
 function setActiveRefStore(store) {
 	activeRefStore = store;
@@ -1876,26 +1731,15 @@ function getActiveRefStore() {
 function sleep(ms) {
 	return new Promise((r) => setTimeout(r, ms));
 }
-/**
-* 查询元素：优先 RefStore hash，回退 CSS 选择器。
-* 支持复合 hash 选择器（如 "#hashID .child-class"）——先解析 hash 根，再在其子树内 querySelector。
-*/
+/** 查询元素：优先 RefStore hash，回退 CSS 选择器 */
 function queryElement(selector) {
 	try {
 		if (selector.startsWith("#") && activeRefStore) {
-			const spaceIdx = selector.indexOf(" ");
-			const hashPart = spaceIdx > 0 ? selector.slice(1, spaceIdx) : selector.slice(1);
-			const rest = spaceIdx > 0 ? selector.slice(spaceIdx + 1).trim() : "";
-			if (activeRefStore.has(hashPart)) {
-				const root = activeRefStore.get(hashPart);
-				if (!root || !root.isConnected) {
-					activeRefStore.delete(hashPart);
-					return `未找到 ref "#${hashPart}" 对应的元素（可能已被移除或快照已过期）`;
-				}
-				if (!rest) return root;
-				const child = root.querySelector(rest);
-				if (!child) return `在 #${hashPart} 内未找到匹配 "${rest}" 的子元素`;
-				return child;
+			const id = selector.slice(1);
+			if (activeRefStore.has(id)) {
+				const el = activeRefStore.get(id);
+				if (!el) return `未找到 ref "${selector}" 对应的元素（可能已被移除或快照已过期）`;
+				return el;
 			}
 		}
 		const el = document.querySelector(selector);
@@ -1923,30 +1767,6 @@ function resolveWaitMs(params) {
 	if (typeof waitSeconds === "number" && Number.isFinite(waitSeconds)) return Math.max(0, Math.floor(waitSeconds * 1e3));
 	return DEFAULT_WAIT_MS;
 }
-/** 生成元素的简洁描述字符串，用于工具调用结果的可读输出。 */
-function describeElement(el) {
-	const tag = el.tagName.toLowerCase();
-	const id = el.id ? `#${el.id}` : "";
-	const cls = el.className && typeof el.className === "string" ? el.className.trim().split(/\s+/).filter(Boolean).slice(0, 3).map((c) => `.${c}`).join("") : "";
-	const text = el instanceof HTMLSelectElement ? el.selectedOptions[0]?.textContent?.trim().slice(0, 40) ?? "" : el.textContent?.trim().slice(0, 40) ?? "";
-	const textHint = text ? ` "${text}"` : "";
-	const hints = [];
-	for (const attr of [
-		"type",
-		"name",
-		"placeholder",
-		"href",
-		"role"
-	]) {
-		const v = el.getAttribute(attr);
-		if (v) hints.push(`${attr}=${v}`);
-	}
-	if (el instanceof HTMLSelectElement && el.value) hints.push(`val=${el.value}`);
-	return `<${tag}${id}${cls}>${textHint}${hints.length > 0 ? ` [${hints.join(", ")}]` : ""}`;
-}
-
-//#endregion
-//#region src/web/tools/dom-tool/actionability.ts
 /** 检查元素样式可见性（处理 checkVisibility / details 折叠 / visibility） */
 function isStyleVisible(el, style) {
 	style = style ?? window.getComputedStyle(el);
@@ -2027,6 +1847,23 @@ function checkElementStable(el, timeoutMs = 800) {
 		requestAnimationFrame(check);
 	});
 }
+/**
+* 将目标重定向到关联的交互控件。
+* - button-link：非交互元素→最近 button/[role=button]/a/[role=link]
+* - follow-label：label→control + 非交互→button/[role=button]/[role=checkbox]/[role=radio]
+*/
+function retarget(el, mode) {
+	if (mode === "none") return el;
+	if (!el.matches("input, textarea, select") && !el.isContentEditable) if (mode === "button-link") el = el.closest("button, [role=button], a, [role=link]") || el;
+	else el = el.closest("button, [role=button], [role=checkbox], [role=radio]") || el;
+	if (mode === "follow-label") {
+		if (!el.matches("a, input, textarea, button, select, [role=link], [role=button], [role=checkbox], [role=radio]") && !el.isContentEditable) {
+			const label = el.closest("label");
+			if (label?.control) el = label.control;
+		}
+	}
+	return el;
+}
 function scrollIntoViewIfNeeded(el, retry = 0) {
 	if (retry === 0 && "scrollIntoViewIfNeeded" in el) {
 		el.scrollIntoViewIfNeeded(true);
@@ -2048,7 +1885,7 @@ function checkHitTarget(el) {
 	if (topEl === el || el.contains(topEl) || topEl.contains(el)) return null;
 	const sharedLabel = topEl.closest("label");
 	if (sharedLabel && sharedLabel.contains(el)) return null;
-	return `<${topEl.tagName.toLowerCase()}${topEl.id ? `#${topEl.id}` : ""}>`;
+	return describeElement(topEl);
 }
 function ensureActionable(el, action, selector, force) {
 	if (force) return null;
@@ -2103,15 +1940,6 @@ function ensureActionable(el, action, selector, force) {
 	};
 	return null;
 }
-
-//#endregion
-//#region src/web/tools/dom-tool/events.ts
-/**
-* DOM Tool — 事件派发与键盘操作。
-*
-* 包含：完整点击事件链、hover 事件链、input/change 派发、
-*       原生 setter 写入、selectText、组合键 press。
-*/
 function getClickPoint(el) {
 	const r = el.getBoundingClientRect();
 	return {
@@ -2120,7 +1948,7 @@ function getClickPoint(el) {
 	};
 }
 /**
-* 完整点击事件链：
+* 完整点击事件链（参考 Playwright Mouse.click）：
 * pointermove → mousemove → (per clickCount) pointerdown → mousedown → focus → pointerup → mouseup → click
 */
 function dispatchClickEvents(el, clickCount = 1) {
@@ -2288,31 +2116,25 @@ function executePress(el, key) {
 		...modState
 	}));
 }
-
-//#endregion
-//#region src/web/tools/dom-tool/resolve.ts
-/**
-* DOM Tool — 目标解析与归一化。
-*
-* 包含：retarget、checkable 目标归一化、pointer action 代理、
-*       表单项控件重定向、editable 穿透。
-*/
-/**
-* 将目标重定向到关联的交互控件。
-* - button-link：非交互元素→最近 button/[role=button]/a/[role=link]
-* - follow-label：label→control + 非交互→button/[role=button]/[role=checkbox]/[role=radio]
-*/
-function retarget(el, mode) {
-	if (mode === "none") return el;
-	if (!el.matches("input, textarea, select") && !el.isContentEditable) if (mode === "button-link") el = el.closest("button, [role=button], a, [role=link]") || el;
-	else el = el.closest("button, [role=button], [role=checkbox], [role=radio]") || el;
-	if (mode === "follow-label") {
-		if (!el.matches("a, input, textarea, button, select, [role=link], [role=button], [role=checkbox], [role=radio]") && !el.isContentEditable) {
-			const label = el.closest("label");
-			if (label?.control) el = label.control;
-		}
+function describeElement(el) {
+	const tag = el.tagName.toLowerCase();
+	const id = el.id ? `#${el.id}` : "";
+	const cls = el.className && typeof el.className === "string" ? el.className.trim().split(/\s+/).filter(Boolean).slice(0, 3).map((c) => `.${c}`).join("") : "";
+	const text = el instanceof HTMLSelectElement ? el.selectedOptions[0]?.textContent?.trim().slice(0, 40) ?? "" : el.textContent?.trim().slice(0, 40) ?? "";
+	const textHint = text ? ` "${text}"` : "";
+	const hints = [];
+	for (const attr of [
+		"type",
+		"name",
+		"placeholder",
+		"href",
+		"role"
+	]) {
+		const v = el.getAttribute(attr);
+		if (v) hints.push(`${attr}=${v}`);
 	}
-	return el;
+	if (el instanceof HTMLSelectElement && el.value) hints.push(`val=${el.value}`);
+	return `<${tag}${id}${cls}>${textHint}${hints.length > 0 ? ` [${hints.join(", ")}]` : ""}`;
 }
 function getChecked(el) {
 	if (el instanceof HTMLInputElement && (el.type === "checkbox" || el.type === "radio")) return el.checked;
@@ -2359,30 +2181,6 @@ function resolvePointerActionTarget(el) {
 	return el;
 }
 /**
-* 点击目标上卷：当命中文本/装饰子节点时，优先上卷到最近可点击祖先。
-*
-* 典型场景：
-* - 列表项文本本身无 click，但父级容器（如 .g-pointer）有点击语义
-* - 事件委托绑定在祖先，子节点点击命中不稳定
-*/
-function resolveClickableAncestorTarget(el) {
-	const isSelfClickable = (node) => {
-		if (node.matches("a, button, input, textarea, select, summary, [role=button], [role=link], [role=menuitem]")) return true;
-		if (node.hasAttribute("onclick")) return true;
-		const tabIndexAttr = node.getAttribute("tabindex");
-		if (tabIndexAttr !== null && tabIndexAttr !== "-1") return true;
-		if (getTrackedElementEvents(node).some((name) => name === "click" || name === "pointerdown" || name === "mousedown")) return true;
-		return false;
-	};
-	if (isSelfClickable(el)) return el;
-	let ancestor = el.parentElement;
-	for (let depth = 0; ancestor && depth < 6; depth++, ancestor = ancestor.parentElement) {
-		if (!isElementVisible(ancestor)) continue;
-		if (isSelfClickable(ancestor)) return ancestor;
-	}
-	return el;
-}
-/**
 * 当命中表单项说明 label（如 Element Plus el-form-item__label）时，
 * 自动重定向到同一表单项中的首个可交互控件。
 */
@@ -2397,35 +2195,6 @@ function resolveFormItemControlTarget(el) {
 	if (control && isElementVisible(control)) return control;
 	return el;
 }
-/**
-* 穿透包裹容器，查找内部可编辑子元素。
-* 覆盖 UI 框架常见模式：wrapper div 包裹真实 input/textarea。
-* 若自身已可编辑则直接返回；否则在子树中搜索第一个可编辑且可见的控件。
-* 对 role=slider/spinbutton 等 ARIA widget：向上逐级查找最近容器中的关联 input。
-*/
-function resolveEditableTarget(el) {
-	if (isEditableElement(el)) return el;
-	const inner = el.querySelector("input:not([type=\"hidden\"]), textarea, select, [contenteditable=\"true\"]");
-	if (inner && isEditableElement(inner) && isElementVisible(inner)) return inner;
-	const role = el.getAttribute("role");
-	if (role === "slider" || role === "spinbutton") {
-		let ancestor = el.parentElement;
-		for (let depth = 0; ancestor && depth < 5; depth++, ancestor = ancestor.parentElement) {
-			const input = ancestor.querySelector("input[type=\"number\"], input[role=\"spinbutton\"], input:not([type=\"hidden\"])");
-			if (input instanceof HTMLInputElement && isEditableElement(input) && isElementVisible(input)) return input;
-		}
-	}
-	return el;
-}
-
-//#endregion
-//#region src/web/tools/dom-tool/dropdown.ts
-/**
-* DOM Tool — 自定义下拉增强。
-*
-* 包含：全局可见 option 查找、下拉弹出等待。
-*/
-/** 在全局可见 option 节点中按文本匹配（精确 → 包含） */
 function findVisibleOptionByText(text) {
 	const target = text.trim().toLowerCase();
 	if (!target) return null;
@@ -2446,7 +2215,6 @@ function findVisibleOptionByText(text) {
 	for (const n of visible) if (n.textContent?.trim().toLowerCase().includes(target)) return n;
 	return null;
 }
-/** 轮询等待下拉弹出层出现 */
 async function waitForDropdownPopup(maxWait = 500) {
 	const start = Date.now();
 	while (Date.now() - start < maxWait) {
@@ -2455,33 +2223,22 @@ async function waitForDropdownPopup(maxWait = 500) {
 		await sleep(50);
 	}
 }
-
-//#endregion
-//#region src/web/tools/dom-tool/index.ts
-/**
-* DOM Tool — 浏览器 DOM 操作工具入口（结合 Playwright 核心交互模式增强）。
-*
-* 关键能力：
-* 1. retarget — 点击时自动重定向到 button/link/label.control
-* 2. scrollIntoView 多策略 — 4 种 block 对齐轮换，解决 sticky 遮挡
-* 3. stable 检查 — rAF 逐帧检测元素位置稳定后再操作
-* 4. hit-target 验证 — elementsFromPoint 检查是否被遮挡
-* 5. 完整点击事件链 — pointermove→pointerdown→mousedown→pointerup→mouseup→click
-* 6. check/uncheck 通过 click — 先检查→click 切换→验证状态
-* 7. press 组合键 — 支持 Control+a, Shift+Enter 等修饰键
-* 8. fill 分类型 — date/color/range 走 setValue，text 类走 selectAll+原生写入
-* 9. 自定义下拉增强 — 更广泛的 option 选择器 + 等待弹出
-* 10. ARIA disabled — 检查祖先链 aria-disabled
-*
-* 运行环境：浏览器 Content Script（直接访问 DOM，无 CDP）。
-*/
 function createDomTool() {
 	return {
 		name: "dom",
 		description: [
 			"Perform DOM operations on the current page.",
 			"Actions: click, fill, select_option, clear, check, uncheck, type, focus, hover, scroll, press, get_text, get_attr, set_attr, add_class, remove_class.",
-			"fill auto-resolves wrapper → inner input. check/uncheck toggles via click. press supports combos (Control+a). scroll supports steps for repeated scrolling."
+			"Input/Select rule: before each fill/type/select_option, click or focus the same target immediately in the same round.",
+			"For multiple fields, use alternating pairs in one batch: focus/click A -> fill/type A -> focus/click B -> fill/type B.",
+			"Use the hash ID from DOM snapshot (e.g. #a1b2c) as selector.",
+			"press supports combo keys like 'Control+a', 'Shift+Enter'.",
+			"check/uncheck is done via click — state change is verified after action.",
+			"Ordinal/index rule: treat visual order as 1-based when the instruction says 'the Nth item' (e.g. 4th star = 4th visible icon from left to right), and avoid off-by-one mistakes.",
+			"Disambiguation rule: distinguish descriptive text/labels from actionable options. Do not click nearby label/help text; click the actual interactive option/control item (icon/button/option) that changes state.",
+			"Unknown/complex components: if a container element (e.g. role=slider, rating, custom widget) has multiple child icons/items in the snapshot but you don't know how to operate it directly, try clicking the appropriate child element instead. For example, a rating component with 5 star icon children — click the 4th icon child to set 4 stars. A slider with a runway — clicking the runway at the right position may work. Always prefer interacting with visible children when the parent container doesn't respond to fill/click as expected.",
+			"fill supports role=slider elements: use fill with a numeric value on a role=slider container (rating/slider) to set its value programmatically.",
+			"For wheel/virtualized pickers where target option is not visible yet, use scroll on the picker column first, then click/select the newly visible option. scroll supports steps for repeated scrolling in one call."
 		].join(" "),
 		schema: Type.Object({
 			action: Type.String({ description: "DOM action: click | fill | select_option | clear | check | uncheck | type | focus | hover | scroll | press | get_text | get_attr | set_attr | add_class | remove_class." }),
@@ -2496,7 +2253,7 @@ function createDomTool() {
 			deltaY: Type.Optional(Type.Number({ description: "Vertical scroll delta for scroll action. Positive = down, negative = up." })),
 			deltaX: Type.Optional(Type.Number({ description: "Horizontal scroll delta for scroll action." })),
 			steps: Type.Optional(Type.Number({ description: "Repeat count for scroll action (default 1, max 20)." })),
-			waitMs: Type.Optional(Type.Number({ description: "Wait timeout in ms before action (default: 1200)." })),
+			waitMs: Type.Optional(Type.Number({ description: "Wait timeout in ms before action (default: 2000)." })),
 			waitSeconds: Type.Optional(Type.Number({ description: "Wait timeout in seconds (fallback for waitMs)." })),
 			force: Type.Optional(Type.Boolean({ description: "Skip actionability checks (default false)." }))
 		}),
@@ -2544,18 +2301,13 @@ function createDomTool() {
 				el = r;
 			}
 			if (action === "check" || action === "uncheck") el = resolveCheckableTarget(el);
-			if ([
-				"fill",
-				"type",
-				"clear"
-			].includes(action)) el = resolveEditableTarget(retarget(el, "follow-label"));
-			const actionabilityTarget = action === "click" || action === "check" || action === "uncheck" ? resolvePointerActionTarget(resolveClickableAncestorTarget(resolveFormItemControlTarget(el))) : el;
+			const actionabilityTarget = action === "click" || action === "check" || action === "uncheck" ? resolvePointerActionTarget(resolveFormItemControlTarget(el)) : el;
 			try {
 				const checkResult = ensureActionable(actionabilityTarget, action, selector, force);
 				if (checkResult) return checkResult;
 				switch (action) {
 					case "click": {
-						const target = resolvePointerActionTarget(resolveClickableAncestorTarget(resolveFormItemControlTarget(retarget(el, force ? "none" : "button-link"))));
+						const target = resolvePointerActionTarget(resolveFormItemControlTarget(retarget(el, force ? "none" : "button-link")));
 						const clickCount = typeof params.clickCount === "number" ? params.clickCount : 1;
 						if (target instanceof HTMLOptionElement) {
 							const parent = target.parentElement;
@@ -2582,7 +2334,7 @@ function createDomTool() {
 					case "fill": {
 						const value = params.value;
 						if (value === void 0) return { content: "缺少 value 参数" };
-						const target = el;
+						const target = retarget(el, "follow-label");
 						if (target instanceof HTMLInputElement) {
 							const type = target.type.toLowerCase();
 							if (INPUT_BLOCKED_TYPES.has(type)) return {
@@ -2725,7 +2477,7 @@ function createDomTool() {
 						return { content: `已选择 ${describeElement(target)}: value="${selected.value}", label="${selected.text.trim()}"` };
 					}
 					case "clear": {
-						const target = el;
+						const target = retarget(el, "follow-label");
 						if (target instanceof HTMLInputElement || target instanceof HTMLTextAreaElement) {
 							scrollIntoViewIfNeeded(target);
 							target.focus();
@@ -2785,7 +2537,7 @@ function createDomTool() {
 					case "type": {
 						const value = params.value;
 						if (value === void 0) return { content: "缺少 value 参数" };
-						const target = el;
+						const target = retarget(el, "follow-label");
 						scrollIntoViewIfNeeded(target);
 						if (target instanceof HTMLElement) target.focus();
 						for (const char of value) {
@@ -2952,50 +2704,6 @@ const MAX_EXPANDED_LIST_CHILDREN = 120;
 /** 定向放宽 children 的硬上限。 */
 const MAX_EXPANDED_CHILDREN_LIMIT = 300;
 /**
-* 事件名 → 快照简写映射。
-* 目的：大幅压缩 listeners="..." 占用的 token，同时保留可读性。
-* 简写规则在 system-prompt 中向模型说明。
-*/
-const EVENT_ABBREV = {
-	click: "clk",
-	dblclick: "dbl",
-	mousedown: "mdn",
-	mouseup: "mup",
-	mousemove: "mmv",
-	mouseover: "mov",
-	mouseout: "mot",
-	mouseenter: "men",
-	mouseleave: "mlv",
-	pointerdown: "pdn",
-	pointerup: "pup",
-	pointermove: "pmv",
-	pointerenter: "pen",
-	pointerleave: "plv",
-	touchstart: "tst",
-	touchend: "ted",
-	touchmove: "tmv",
-	keydown: "kdn",
-	keyup: "kup",
-	keypress: "kpr",
-	input: "inp",
-	change: "chg",
-	submit: "sub",
-	focus: "fcs",
-	blur: "blr",
-	scroll: "scl",
-	wheel: "whl",
-	drag: "drg",
-	dragstart: "drs",
-	dragend: "dre",
-	drop: "drp",
-	contextmenu: "ctx",
-	resize: "rsz"
-};
-/** 将完整事件名转为快照简写（未收录的取前 3 字符）。 */
-function abbrevEvent(name) {
-	return EVENT_ABBREV[name] ?? name.slice(0, 3);
-}
-/**
 * 规整快照属性值，避免把长 base64/data URL 原样注入快照。
 */
 function sanitizeSnapshotAttrValue(value) {
@@ -3036,18 +2744,17 @@ function sanitizeSnapshotAttrValue(value) {
 */
 function generateSnapshot(root = document.body, options = {}) {
 	const opts = typeof options === "number" ? { maxDepth: options } : options;
-	const maxDepth = opts.maxDepth ?? 7;
+	const maxDepth = opts.maxDepth ?? 6;
 	const viewportOnly = opts.viewportOnly ?? true;
 	const pruneLayout = opts.pruneLayout ?? true;
-	const maxNodes = opts.maxNodes ?? 280;
-	const maxChildren = opts.maxChildren ?? 32;
+	const maxNodes = opts.maxNodes ?? 220;
+	const maxChildren = opts.maxChildren ?? 25;
 	const maxTextLength = opts.maxTextLength ?? 40;
 	const expandOptionLists = opts.expandOptionLists ?? false;
 	const expandedChildrenLimit = Math.min(MAX_EXPANDED_CHILDREN_LIMIT, Math.max(1, opts.expandedChildrenLimit ?? MAX_EXPANDED_LIST_CHILDREN));
 	const expandChildrenRefSet = new Set((opts.expandChildrenRefs ?? []).map((ref) => ref.trim().replace(/^#/, "")).filter(Boolean));
 	let emittedNodes = 0;
 	let truncatedByNodeBudget = false;
-	const emittedRefIds = /* @__PURE__ */ new Set();
 	const refStore = opts.refStore;
 	const SKIP_TAGS = new Set([
 		"SCRIPT",
@@ -3083,11 +2790,7 @@ function generateSnapshot(root = document.body, options = {}) {
 		"value",
 		"name",
 		"role",
-		"tabindex",
 		"aria-label",
-		"aria-valuenow",
-		"aria-valuemin",
-		"aria-valuemax",
 		"src",
 		"alt",
 		"title",
@@ -3105,25 +2808,6 @@ function generateSnapshot(root = document.body, options = {}) {
 		"LABEL",
 		"SUMMARY"
 	]);
-	/** 常见可交互事件（用于提升元素交互优先级）。 */
-	const INTERACTIVE_EVENTS = new Set([
-		"click",
-		"dblclick",
-		"mousedown",
-		"mouseup",
-		"pointerdown",
-		"pointerup",
-		"touchstart",
-		"touchend",
-		"input",
-		"change",
-		"keydown",
-		"keyup",
-		"keypress",
-		"submit",
-		"focus",
-		"blur"
-	]);
 	/** 布尔状态属性 — 只在存在时输出（无值），如 disabled、checked */
 	const BOOLEAN_ATTRS = [
 		"disabled",
@@ -3158,70 +2842,6 @@ function generateSnapshot(root = document.body, options = {}) {
 		if (rect.width === 0 && rect.height === 0) return false;
 		return true;
 	}
-	/** 统一标签名键值（HTML/SVG 在不同环境可能大小写不一致）。 */
-	function getTagKey(el) {
-		return (el.tagName || "").toUpperCase();
-	}
-	/** 判断元素是否存在绑定事件（inline 或 addEventListener 追踪）。 */
-	function hasBoundEvents(el) {
-		if (hasTrackedElementEvents(el)) return true;
-		for (const attr of Array.from(el.attributes)) if (attr.name.startsWith("on")) return true;
-		return false;
-	}
-	/**
-	* 轻量检测：当前容器浅层子树里是否出现事件绑定节点。
-	* 仅用于是否保留布局容器，预算受控避免再次吞掉整页层级。
-	*/
-	function hasBoundEventsInShallowSubtree(el, scanBudget = 48, maxTreeDepth = 2) {
-		const queue = Array.from(el.children).map((node) => ({
-			node,
-			depth: 1
-		}));
-		let scanned = 0;
-		while (queue.length > 0) {
-			const current = queue.shift();
-			if (!current) continue;
-			if (hasBoundEvents(current.node)) return true;
-			scanned += 1;
-			if (scanned >= scanBudget) return false;
-			if (current.depth >= maxTreeDepth) continue;
-			for (const child of Array.from(current.node.children)) queue.push({
-				node: child,
-				depth: current.depth + 1
-			});
-		}
-		return false;
-	}
-	/** 判断文本是否具有语义信息（过滤纯符号/超短噪音）。 */
-	function isSemanticText(text) {
-		const normalized = text.replace(/\s+/g, "").trim();
-		if (!normalized) return false;
-		if (normalized.length < 2) return false;
-		return /[\p{Script=Han}A-Za-z0-9]/u.test(normalized);
-	}
-	/** 在子树内查找语义文本（浅层限流，避免额外大开销）。 */
-	function hasSemanticTextInSubtree(el, scanBudget = 180) {
-		const stack = Array.from(el.children);
-		let scanned = 0;
-		while (stack.length > 0) {
-			const current = stack.pop();
-			if (!current) continue;
-			let directText = "";
-			for (let i = 0; i < current.childNodes.length; i++) {
-				const node = current.childNodes[i];
-				if (node.nodeType === Node.TEXT_NODE) {
-					const t = node.textContent?.trim();
-					if (t) directText += t + " ";
-				}
-			}
-			if (isSemanticText(directText.trim())) return true;
-			scanned += 1;
-			if (scanned >= scanBudget) return false;
-			const children = Array.from(current.children);
-			for (let i = children.length - 1; i >= 0; i--) stack.push(children[i]);
-		}
-		return false;
-	}
 	/**
 	* 判断元素是否为「无意义布局容器」（智能剪枝候选）。
 	* 满足所有条件时返回 true：
@@ -3230,30 +2850,21 @@ function generateSnapshot(root = document.body, options = {}) {
 	* 3. 没有交互属性（href/role/aria-label/onclick 等）
 	* 4. 没有直接文本内容
 	*/
-	function isEmptyLayoutContainer(el, directText, depth) {
+	function isEmptyLayoutContainer(el, directText) {
 		if (!pruneLayout) return false;
-		if (depth <= 2) return false;
-		if (!LAYOUT_TAGS.has(getTagKey(el))) return false;
+		if (!LAYOUT_TAGS.has(el.tagName)) return false;
 		if (el.getAttribute("id")) return false;
 		if (el.getAttribute("role") || el.getAttribute("aria-label")) return false;
-		if (hasBoundEvents(el)) return false;
-		if (depth <= 4 && hasBoundEventsInShallowSubtree(el)) return false;
-		if (isSemanticText(directText) || hasSemanticTextInSubtree(el)) return false;
+		for (const attr of Array.from(el.attributes)) if (attr.name.startsWith("on")) return false;
 		if (directText) return false;
 		return true;
 	}
-	function hasInteractiveTrackedEvents(el) {
-		const trackedEvents = getTrackedElementEvents(el);
-		if (trackedEvents.length === 0) return false;
-		return trackedEvents.some((eventName) => INTERACTIVE_EVENTS.has(eventName));
-	}
 	function isInteractiveElement(el) {
-		if (INTERACTIVE_TAGS.has(getTagKey(el))) return true;
+		if (INTERACTIVE_TAGS.has(el.tagName)) return true;
 		if (el.hasAttribute("onclick")) return true;
 		if (el.hasAttribute("role")) return true;
 		if (el.hasAttribute("tabindex")) return true;
 		if (el.hasAttribute("aria-label")) return true;
-		if (hasInteractiveTrackedEvents(el)) return true;
 		return false;
 	}
 	/** 判断是否为“选项列表”容器（时间/下拉/listbox 等）。 */
@@ -3282,9 +2893,7 @@ function generateSnapshot(root = document.body, options = {}) {
 			return "";
 		}
 		if (depth > maxDepth) return "";
-		const tagKey = getTagKey(el);
-		if (SKIP_TAGS.has(tagKey)) return "";
-		if (el.getAttribute("id") === "__SVG_SPRITE_NODE__") return "";
+		if (SKIP_TAGS.has(el.tagName)) return "";
 		if (el.hasAttribute("data-autopilot-ignore")) return "";
 		const style = window.getComputedStyle(el);
 		if (style.display === "none" || style.visibility === "hidden") return "";
@@ -3316,12 +2925,6 @@ function generateSnapshot(root = document.body, options = {}) {
 			if (!attrs.includes("readonly")) attrs.push("readonly");
 		}
 		if (el.hasAttribute("onclick")) attrs.push("onclick");
-		const trackedEvents = getTrackedElementEvents(el);
-		if (trackedEvents.length > 0) {
-			const preview = trackedEvents.slice(0, 6).map(abbrevEvent).join(",");
-			const suffix = trackedEvents.length > 6 ? ",..." : "";
-			attrs.push(`listeners="${preview}${suffix}"`);
-		}
 		const testId = el.getAttribute("data-testid") || el.getAttribute("data-test-id");
 		if (testId) {
 			const safeTestId = sanitizeSnapshotAttrValue(testId).slice(0, 25);
@@ -3347,7 +2950,7 @@ function generateSnapshot(root = document.body, options = {}) {
 			}
 		}
 		directText = directText.trim();
-		if (isEmptyLayoutContainer(el, directText, depth)) {
+		if (isEmptyLayoutContainer(el, directText)) {
 			const allChildren = Array.from(el.children);
 			const interactiveChildren = allChildren.filter(isInteractiveElement);
 			const nonInteractiveChildren = allChildren.filter((child) => !isInteractiveElement(child));
@@ -3371,10 +2974,8 @@ function generateSnapshot(root = document.body, options = {}) {
 		let line = `${indent}[${tag}]`;
 		if (directText) line += ` "${directText.slice(0, maxTextLength)}"`;
 		if (attrs.length) line += ` ${attrs.join(" ")}`;
-		if (hashId) {
-			line += ` #${hashId}`;
-			emittedRefIds.add(hashId);
-		} else line += ` ref="${currentPath}"`;
+		if (hashId) line += ` #${hashId}`;
+		else line += ` ref="${currentPath}"`;
 		const lines = [line];
 		emittedNodes++;
 		const allChildren = Array.from(el.children);
@@ -3392,7 +2993,6 @@ function generateSnapshot(root = document.body, options = {}) {
 		return lines.join("\n");
 	}
 	const output = walk(root, 0, "") || "(空页面)";
-	refStore?.prune(emittedRefIds);
 	if (!truncatedByNodeBudget) return output;
 	return `${output}\n... (snapshot truncated: maxNodes=${maxNodes})`;
 }
@@ -3437,11 +3037,11 @@ function createPageInfoTool() {
 		schema: Type.Object({
 			action: Type.String({ description: "Info action: get_url | get_title | get_selection | get_viewport | snapshot | query_all" }),
 			selector: Type.Optional(Type.String({ description: "CSS selector for query_all action" })),
-			maxDepth: Type.Optional(Type.Number({ description: "Max depth for snapshot (default: 7)" })),
+			maxDepth: Type.Optional(Type.Number({ description: "Max depth for snapshot (default: 6)" })),
 			viewportOnly: Type.Optional(Type.Boolean({ description: "Only snapshot elements visible in viewport (default: true)" })),
 			pruneLayout: Type.Optional(Type.Boolean({ description: "Collapse empty layout containers like div/span (default: true)" })),
-			maxNodes: Type.Optional(Type.Number({ description: "Maximum nodes to include in snapshot (default: 280)" })),
-			maxChildren: Type.Optional(Type.Number({ description: "Maximum children per element (default: 32)" })),
+			maxNodes: Type.Optional(Type.Number({ description: "Maximum nodes to include in snapshot (default: 220)" })),
+			maxChildren: Type.Optional(Type.Number({ description: "Maximum children per element (default: 25)" })),
 			maxTextLength: Type.Optional(Type.Number({ description: "Maximum text length per node (default: 40)" })),
 			expandOptionLists: Type.Optional(Type.Boolean({ description: "Expand option-list containers to avoid child truncation (default: false)" })),
 			expandChildrenRefs: Type.Optional(Type.Array(Type.String({ description: "Hash refs to expand child truncation for (e.g. #abc123)" }))),
@@ -3466,11 +3066,11 @@ function createPageInfoTool() {
 						return { content: JSON.stringify(info, null, 2) };
 					}
 					case "snapshot": {
-						const maxDepth = params.maxDepth ?? 7;
+						const maxDepth = params.maxDepth ?? 6;
 						const viewportOnly = params.viewportOnly ?? true;
 						const pruneLayout = params.pruneLayout ?? true;
-						const maxNodes = params.maxNodes ?? 280;
-						const maxChildren = params.maxChildren ?? 32;
+						const maxNodes = params.maxNodes ?? 220;
+						const maxChildren = params.maxChildren ?? 25;
 						const maxTextLength = params.maxTextLength ?? 40;
 						const expandOptionLists = params.expandOptionLists ?? false;
 						const expandChildrenRefs = Array.isArray(params.expandChildrenRefs) ? params.expandChildrenRefs.filter((ref) => typeof ref === "string") : void 0;
@@ -3620,7 +3220,7 @@ function createNavigateTool() {
 * - hash selector（如 #abc123）优先通过 RefStore 解析。
 * - 可见性语义与 dom-tool 保持一致（参考 Playwright 风格）。
 */
-const DEFAULT_TIMEOUT = 6e3;
+const DEFAULT_TIMEOUT = 1e4;
 const POLL_INTERVAL_MS = 80;
 const STABLE_TICK_MS = 50;
 const OBSERVER_OPTIONS = {
@@ -3674,14 +3274,7 @@ function resolveSelector(selector) {
 		const store = getActiveRefStore();
 		if (store) {
 			const id = selector.slice(1);
-			if (store.has(id)) {
-				const el = store.get(id);
-				if (!el || !el.isConnected) {
-					store.delete(id);
-					return null;
-				}
-				return el;
-			}
+			if (store.has(id)) return store.get(id) ?? null;
 		}
 	}
 	try {
@@ -3819,7 +3412,7 @@ function createWaitTool() {
 			selector: Type.Optional(Type.String({ description: "CSS selector for wait_for_selector/wait_for_hidden" })),
 			state: Type.Optional(Type.String({ description: "Selector state for wait_for_selector: attached | visible | hidden | detached (default: attached)" })),
 			text: Type.Optional(Type.String({ description: "Text to wait for in wait_for_text" })),
-			timeout: Type.Optional(Type.Number({ description: "Timeout in milliseconds (default: 6000)" })),
+			timeout: Type.Optional(Type.Number({ description: "Timeout in milliseconds (default: 10000)" })),
 			quietMs: Type.Optional(Type.Number({ description: "Quiet window for wait_for_stable in milliseconds (default: 300)" }))
 		}),
 		execute: async (params) => {
@@ -4025,29 +3618,6 @@ var RefStore = class {
 	has(id) {
 		return this.map.has(id);
 	}
-	/** 删除指定 hash ID 映射，返回是否删除成功。 */
-	delete(id) {
-		return this.map.delete(id);
-	}
-	/**
-	* 清理失效引用：
-	* - 仅保留 keepIds 中的映射（若提供）
-	* - 自动移除已脱离文档（isConnected=false）的元素
-	*
-	* @returns 被移除的映射数量
-	*/
-	prune(keepIds) {
-		let removed = 0;
-		for (const [id, el] of this.map.entries()) {
-			const shouldKeepById = keepIds ? keepIds.has(id) : true;
-			const isConnected = el.isConnected;
-			if (!shouldKeepById || !isConnected) {
-				this.map.delete(id);
-				removed++;
-			}
-		}
-		return removed;
-	}
 	/** 清空所有映射 */
 	clear() {
 		this.map.clear();
@@ -4179,7 +3749,6 @@ function registerToolHandler(executors) {
 *   │  └──────────┘  └────────────┘  └──────────────┘ │
 *   └──────────────────────────────────────────────────┘
 */
-installEventListenerTracking();
 var WebAgent = class WebAgent {
 	/** 默认系统提示词 key（兼容旧版 setSystemPrompt(prompt)）。 */
 	static DEFAULT_SYSTEM_PROMPT_KEY = "default";
@@ -4212,8 +3781,6 @@ var WebAgent = class WebAgent {
 	autoSnapshot;
 	/** 快照选项 */
 	snapshotOptions;
-	/** 轮次后稳定等待配置 */
-	roundStabilityWait;
 	/** 工具注册表实例 — 每个 WebAgent 拥有独立的工具集 */
 	registry = new ToolRegistry();
 	/** 事件回调 — 绑定后可实时获取 Agent 进度，用于 UI 展示 */
@@ -4230,7 +3797,6 @@ var WebAgent = class WebAgent {
 		this.memory = options.memory ?? false;
 		this.autoSnapshot = options.autoSnapshot ?? true;
 		this.snapshotOptions = options.snapshotOptions ?? {};
-		this.roundStabilityWait = options.roundStabilityWait;
 		if (typeof options.systemPrompt === "string") this.setSystemPrompt(options.systemPrompt);
 		else if (options.systemPrompt && typeof options.systemPrompt === "object") this.setSystemPrompts(options.systemPrompt);
 	}
@@ -4423,7 +3989,6 @@ var WebAgent = class WebAgent {
 			history: this.memory ? this.history : void 0,
 			dryRun: this.dryRun,
 			maxRounds: this.maxRounds,
-			roundStabilityWait: this.roundStabilityWait,
 			callbacks: wrappedCallbacks
 		});
 		if (this.memory) this.history = result.messages;