agentpage 0.0.32 → 0.0.34

package/dist/index.mjs

@@ -154,13 +154,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(" -> ");
 }
 /**
 * 判定是否强制断轮。
@@ -297,7 +295,7 @@ function hasToolError(result) {
 * 4) 返回稳定字符串给 loop，供后续注入消息与统计。
 *
 * 默认参数意图：
-* - `maxDepth=8`: 保留足够层级，减少关键控件被截断。
+* - `maxDepth=12`: 保留更深层级，减少深层组件控件被截断。
 * - `viewportOnly=false`: 优先完整性，避免误判“元素不存在”。
 * - `pruneLayout=true`: 抑制纯布局噪声，降低 token 压力。
 * - `maxNodes=500` / `maxChildren=30`: 控制体积上限，兼顾可读性。
@@ -308,12 +306,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`：节点文本按长度截断，避免长段文案占满上下文。
@@ -328,7 +320,7 @@ function hasToolError(result) {
 async function readPageSnapshot(registry, options) {
 	return toContentString((await registry.dispatch("page_info", {
 		action: "snapshot",
-		maxDepth: options?.maxDepth ?? 8,
+		maxDepth: options?.maxDepth ?? 12,
 		viewportOnly: options?.viewportOnly ?? false,
 		pruneLayout: options?.pruneLayout ?? true,
 		maxNodes: options?.maxNodes ?? 500,
@@ -485,10 +477,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}`));
@@ -980,8 +988,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;
 		}
@@ -989,6 +996,11 @@ async function executeAgentLoop(params) {
 		lastRoundHadError = roundHasError;
 		previousRoundTasks = buildTaskArray(executedTaskCalls);
 		previousRoundPlannedTasks = plannedTasksCurrentRound;
+		if (parsedInstructionState.hasRemainingProtocol && remainingInstruction.trim().length === 0 && !roundHasError) {
+			finalReply = response.text?.trim() || "任务已完成。";
+			if (finalReply) callbacks?.onText?.(finalReply);
+			break;
+		}
 		const idleResult = detectIdleLoop(response.toolCalls.map((tc) => ({
 			name: tc.name,
 			input: tc.input
@@ -1649,7 +1661,13 @@ var ToolRegistry = class {
 
 //#endregion
 //#region src/core/system-prompt.ts
-/** 规范化额外指令。 */
+/**
+* 规范化额外指令：统一转为非空字符串数组。
+*
+* - 单字符串 → 单元素数组
+* - 字符串数组 → 过滤空值
+* - undefined → 空数组
+*/
 function normalizeExtraInstructions(input) {
 	if (!input) return [];
 	return (Array.isArray(input) ? input : [input]).map((s) => s.trim()).filter(Boolean);
@@ -1657,9 +1675,32 @@ function normalizeExtraInstructions(input) {
 /**
 * 构建系统提示词。
 *
-* 约束：
-* - 输出给模型的提示词正文统一为英文。
-* - 中文仅用于源码注释，便于团队维护。
+* 输出结构（按章节顺序）：
+* 1. **Core Rules** — Agent 核心行为规则
+*    - 快照驱动决策：仅基于当前快照 + 剩余任务工作
+*    - 增量消费模型：每轮执行后输出 REMAINING 推进任务
+*    - hash ID 定位：仅交互元素携带 #hashID，非交互元素为上下文
+*    - 事件信号：listeners="..." 标注运行时事件绑定
+*    - 批量执行：同轮完成所有独立可见操作
+*    - 输入顺序：fill/type 前必须先 focus/click 同一目标
+*    - DOM 变化断轮：会改变 DOM 的动作执行后等待下一轮新快照
+*    - 停机规则：任务完成后输出 REMAINING: DONE
+*
+* 2. **Listener Abbrevs** — 事件简写对照表
+*    - 快照中 listeners="clk,inp,chg" 的简写含义
+*    - 与 page-info-tool.ts 的 EVENT_ABBREV 映射一致
+*
+* 3. **Output Contract** — 输出协议
+*    - 每轮返回工具调用 + REMAINING 文本行
+*
+* 4. **Available Tools**（可选） — 当前注册的工具及描述
+*
+* 5. **Reasoning Profile**（可选） — 思考深度配置
+*
+* 6. **Extra Instructions**（可选） — 用户自定义额外指令
+*
+* @param params - 构建参数（工具列表、思考深度、额外指令）
+* @returns 完整的系统提示词字符串（英文）
 */
 function buildSystemPrompt(params = {}) {
 	const sections = [];
@@ -1672,6 +1713,9 @@ function buildSystemPrompt(params = {}) {
 		"  Input: (1) current remaining task, (2) previous round executed actions, (3) actions you execute this round.",
 		"  Output: new remaining task after removing this-round actions.",
 		"- Use only visible targets from snapshot. Use #hashID as selector. Do not guess CSS selectors.",
+		"- Only interactive elements (with events, inputs, buttons, links, etc.) carry #hashID. Elements without #hashID are context-only (labels, headings, text) and cannot be targeted.",
+		"- Snapshot tag in brackets may show ARIA role instead of HTML tag when it better describes the interaction pattern (e.g. [combobox] for input with role=\"combobox\", [slider] for div with role=\"slider\"). Treat the bracket tag as the primary interaction hint.",
+		"- listeners=\"...\" on snapshot indicates bound event handlers (see Listener Abbrevs below). Prefer targets with relevant listeners when multiple candidates look similar.",
 		"- Batch independent visible actions in one round. Do not split one form into many rounds unnecessarily.",
 		"- Strict input order (MANDATORY): before every fill/type/select_option, click or focus the SAME target immediately in the SAME round.",
 		"- Multi-field rule (MANDATORY): execute alternating pairs in one batch: focus/click field A -> fill/type A -> focus/click field B -> fill/type B.",
@@ -1684,7 +1728,6 @@ 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.",
@@ -1796,13 +1839,24 @@ function hasTrackedElementEvents(el) {
 }
 
 //#endregion
-//#region src/web/tools/dom-tool/constants.ts
+//#region src/web/tools/dom-tool.ts
 /**
-* DOM Tool 常量定义。
+* DOM Tool — 浏览器 DOM 操作工具（结合 Playwright 核心交互模式增强）。
 *
-* 包含：input 类型分类、修饰键集合、键码映射、滚动策略。
+* 关键改进（参考 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）。
 */
-/** 默认等待超时（ms） */
 const DEFAULT_WAIT_MS = 1200;
 /** scrollIntoView 轮换策略（参考 Playwright dom.ts） */
 const SCROLL_OPTIONS = [
@@ -1863,9 +1917,16 @@ const KEY_CODE_MAP = {
 	Alt: "AltLeft",
 	Meta: "MetaLeft"
 };
-
-//#endregion
-//#region src/web/tools/dom-tool/query.ts
+const FILL_RELEVANT_EVENTS = new Set([
+	"input",
+	"change",
+	"focus",
+	"blur",
+	"keydown",
+	"click",
+	"mousedown",
+	"pointerdown"
+]);
 let activeRefStore;
 function setActiveRefStore(store) {
 	activeRefStore = store;
@@ -1876,26 +1937,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 +1973,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 +2053,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 +2091,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;
@@ -2092,26 +2135,36 @@ function ensureActionable(el, action, selector, force) {
 		"fill",
 		"type",
 		"clear"
-	].includes(action) && !isEditableElement(el)) return {
-		content: `"${selector}" 不是可编辑元素，无法执行 ${action}`,
-		details: {
-			error: true,
-			code: "UNSUPPORTED_FILL_TARGET",
-			action,
-			selector
-		}
-	};
+	].includes(action) && !isEditableElement(el)) {
+		if (action === "fill" && el.getAttribute("role") === "slider") return null;
+		return {
+			content: `"${selector}" 不是可编辑元素，无法执行 ${action}`,
+			details: {
+				error: true,
+				code: "UNSUPPORTED_FILL_TARGET",
+				action,
+				selector
+			}
+		};
+	}
 	return null;
 }
-
-//#endregion
-//#region src/web/tools/dom-tool/events.ts
 /**
-* DOM Tool — 事件派发与键盘操作。
-*
-* 包含：完整点击事件链、hover 事件链、input/change 派发、
-*       原生 setter 写入、selectText、组合键 press。
+* 为 role=slider 查找关联的数值输入框。
+* 典型场景：Element Plus slider + input-number 同属一个 form-item。
 */
+function findAssociatedSliderInput(slider) {
+	const candidates = [];
+	const formItem = slider.closest(".el-form-item");
+	if (formItem) candidates.push(formItem);
+	let cursor = slider.parentElement;
+	for (let depth = 0; cursor && depth < 4; depth++, cursor = cursor.parentElement) candidates.push(cursor);
+	for (const scope of candidates) {
+		const input = scope.querySelector("input[type=\"number\"], input[role=\"spinbutton\"], .el-input-number input:not([type=\"hidden\"])");
+		if (input instanceof HTMLInputElement && isEditableElement(input) && isElementVisible(input)) return input;
+	}
+	return null;
+}
 function getClickPoint(el) {
 	const r = el.getBoundingClientRect();
 	return {
@@ -2120,7 +2173,7 @@ function getClickPoint(el) {
 	};
 }
 /**
-* 完整点击事件链：
+* 完整点击事件链（参考 Playwright Mouse.click）：
 * pointermove → mousemove → (per clickCount) pointerdown → mousedown → focus → pointerup → mouseup → click
 */
 function dispatchClickEvents(el, clickCount = 1) {
@@ -2206,6 +2259,163 @@ function setNativeValue(el, value) {
 	if (desc?.set) desc.set.call(el, value);
 	else el.value = value;
 }
+function getFillEventSupportScore(el) {
+	let score = 0;
+	if (el.hasAttribute("oninput") || el.hasAttribute("onchange")) score += 80;
+	if (el.hasAttribute("onfocus") || el.hasAttribute("onblur")) score += 60;
+	if (el.hasAttribute("onclick")) score += 40;
+	const tracked = getTrackedElementEvents(el);
+	for (const eventName of tracked) {
+		if (!FILL_RELEVANT_EVENTS.has(eventName)) continue;
+		if (eventName === "input") score += 40;
+		else if (eventName === "change") score += 35;
+		else if (eventName === "focus" || eventName === "blur") score += 28;
+		else if (eventName === "keydown") score += 24;
+		else score += 14;
+	}
+	return score;
+}
+function isCandidateFillTarget(el) {
+	if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement) return !isElementDisabled(el);
+	if (el instanceof HTMLElement && el.isContentEditable) return true;
+	return false;
+}
+function executeFillOnResolvedTarget(target, value, selector, action, sourceHint) {
+	if (target instanceof HTMLInputElement) {
+		const type = target.type.toLowerCase();
+		if (INPUT_BLOCKED_TYPES.has(type)) return {
+			content: `"${selector}" 为 input[type=${type}]，不支持 fill；请使用 click/check 等动作。`,
+			details: {
+				error: true,
+				code: "UNSUPPORTED_FILL_TARGET",
+				action,
+				selector
+			}
+		};
+		if (INPUT_SET_VALUE_TYPES.has(type)) {
+			const finalVal = type === "color" ? value.toLowerCase().trim() : value.trim();
+			target.focus();
+			target.value = finalVal;
+			if (target.value !== finalVal) return {
+				content: `"${selector}" 填写格式不匹配（type=${type}）`,
+				details: {
+					error: true,
+					code: "MALFORMED_VALUE",
+					action,
+					selector
+				}
+			};
+			dispatchInputEvents(target);
+			const suffix = sourceHint ? `（${sourceHint}）` : "";
+			return { content: `已填写 ${describeElement(target)}: "${finalVal}"${suffix}` };
+		}
+		if (type === "number" && Number.isNaN(Number(value.trim()))) return {
+			content: `"${selector}" 为 input[type=number]，无法填写非数字 "${value}"`,
+			details: {
+				error: true,
+				code: "INVALID_NUMBER",
+				action,
+				selector
+			}
+		};
+		scrollIntoViewIfNeeded(target);
+		target.focus();
+		selectText(target);
+		setNativeValue(target, value);
+		dispatchInputEvents(target);
+		if (target.value !== value) return {
+			content: `"${selector}" 填写后值不一致：期望 "${value}"，实际 "${target.value}"`,
+			details: {
+				error: true,
+				code: "FILL_NOT_APPLIED",
+				action,
+				selector
+			}
+		};
+		const suffix = sourceHint ? `（${sourceHint}）` : "";
+		return { content: `已填写 ${describeElement(target)}: "${value}"${suffix}` };
+	}
+	if (target instanceof HTMLTextAreaElement) {
+		scrollIntoViewIfNeeded(target);
+		target.focus();
+		selectText(target);
+		setNativeValue(target, value);
+		dispatchInputEvents(target);
+		const suffix = sourceHint ? `（${sourceHint}）` : "";
+		return { content: `已填写 ${describeElement(target)}: "${value}"${suffix}` };
+	}
+	if (target instanceof HTMLSelectElement) {
+		target.focus();
+		const options = Array.from(target.options);
+		let matched = options.find((o) => o.value === value);
+		if (!matched) {
+			const normalized = value.trim().toLowerCase();
+			matched = options.find((o) => o.text.trim().toLowerCase() === normalized);
+		}
+		if (!matched) return { content: `"${selector}" 下拉框中不存在选项 "${value}"` };
+		target.value = matched.value;
+		dispatchInputEvents(target);
+		const suffix = sourceHint ? `（${sourceHint}）` : "";
+		return { content: `已填写 ${describeElement(target)}: "${value}"${suffix}` };
+	}
+	if (target instanceof HTMLElement && target.isContentEditable) {
+		target.focus();
+		selectText(target);
+		if (value) document.execCommand("insertText", false, value);
+		else document.execCommand("delete", false, void 0);
+		const suffix = sourceHint ? `（${sourceHint}）` : "";
+		return { content: `已填写 ${describeElement(target)}: "${value}"${suffix}` };
+	}
+	return null;
+}
+function guessNearbyFillTarget(anchor, value) {
+	const preferNumeric = Number.isFinite(Number(value));
+	const scopeEntries = [];
+	const formItem = anchor.closest(".el-form-item");
+	if (formItem) scopeEntries.push({
+		scope: formItem,
+		level: 0
+	});
+	let cursor = anchor.parentElement;
+	for (let level = 1; cursor && level <= 4; level++, cursor = cursor.parentElement) scopeEntries.push({
+		scope: cursor,
+		level
+	});
+	const visited = /* @__PURE__ */ new Set();
+	let best = null;
+	for (const { scope, level } of scopeEntries) {
+		const candidates = Array.from(scope.querySelectorAll("input:not([type=\"hidden\"]), textarea, select, [contenteditable=\"true\"], [role=\"spinbutton\"]"));
+		for (const candidate of candidates) {
+			if (!(candidate instanceof Element)) continue;
+			if (visited.has(candidate)) continue;
+			visited.add(candidate);
+			if (!isCandidateFillTarget(candidate)) continue;
+			if (!isElementVisible(candidate)) continue;
+			let score = 100 - level * 18;
+			score += getFillEventSupportScore(candidate);
+			if (candidate instanceof HTMLInputElement) {
+				const type = candidate.type.toLowerCase();
+				if (preferNumeric && (type === "number" || candidate.getAttribute("role") === "spinbutton")) score += 80;
+				if (!preferNumeric && [
+					"text",
+					"",
+					"search",
+					"email",
+					"tel",
+					"url",
+					"password"
+				].includes(type)) score += 36;
+			}
+			if (candidate.getAttribute("placeholder")) score += 8;
+			if (candidate.getAttribute("aria-label")) score += 8;
+			if (!best || score > best.score) best = {
+				el: candidate,
+				score
+			};
+		}
+	}
+	return best?.el ?? null;
+}
 function selectText(el) {
 	if (el instanceof HTMLInputElement) {
 		el.select();
@@ -2288,31 +2498,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 +2563,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 +2577,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 +2597,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 +2605,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." }),
@@ -2544,18 +2683,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,88 +2716,72 @@ function createDomTool() {
 					case "fill": {
 						const value = params.value;
 						if (value === void 0) return { content: "缺少 value 参数" };
-						const target = el;
-						if (target instanceof HTMLInputElement) {
-							const type = target.type.toLowerCase();
-							if (INPUT_BLOCKED_TYPES.has(type)) return {
-								content: `"${selector}" 为 input[type=${type}]，不支持 fill；请使用 click/check 等动作。`,
-								details: {
-									error: true,
-									code: "UNSUPPORTED_FILL_TARGET",
-									action,
-									selector
+						const target = retarget(el, "follow-label");
+						if (target instanceof HTMLElement && target.getAttribute("role") === "slider") {
+							const numericValue = Number(value);
+							if (!Number.isFinite(numericValue)) {
+								const guessed = guessNearbyFillTarget(target, value);
+								if (guessed) {
+									const guessedResult = executeFillOnResolvedTarget(guessed, value, selector, action, "heuristic-nearby-target");
+									if (guessedResult) return guessedResult;
 								}
-							};
-							if (INPUT_SET_VALUE_TYPES.has(type)) {
-								const finalVal = type === "color" ? value.toLowerCase().trim() : value.trim();
-								target.focus();
-								target.value = finalVal;
-								if (target.value !== finalVal) return {
-									content: `"${selector}" 填写格式不匹配（type=${type}）`,
+								return {
+									content: `"${selector}" 为 role=slider，未找到可推断填写目标`,
 									details: {
 										error: true,
-										code: "MALFORMED_VALUE",
+										code: "UNSUPPORTED_FILL_TARGET",
 										action,
 										selector
 									}
 								};
-								dispatchInputEvents(target);
-								return { content: `已填写 ${describeElement(target)}: "${finalVal}"` };
 							}
-							if (type === "number" && isNaN(Number(value.trim()))) return {
-								content: `"${selector}" 为 input[type=number]，无法填写非数字 "${value}"`,
-								details: {
-									error: true,
-									code: "INVALID_NUMBER",
-									action,
-									selector
-								}
-							};
-							scrollIntoViewIfNeeded(target);
-							target.focus();
-							selectText(target);
-							setNativeValue(target, value);
-							dispatchInputEvents(target);
-							if (target.value !== value) return {
-								content: `"${selector}" 填写后值不一致：期望 "${value}"，实际 "${target.value}"`,
+							const linkedInput = findAssociatedSliderInput(target);
+							if (linkedInput) {
+								const filled = executeFillOnResolvedTarget(linkedInput, String(numericValue), selector, action, `from ${describeElement(target)}`);
+								if (filled) return filled;
+							}
+							const min = Number(target.getAttribute("aria-valuemin") ?? "1");
+							const max = Number(target.getAttribute("aria-valuemax") ?? String(target.children.length || 5));
+							const discreteCount = Number.isFinite(max - min + 1) ? Math.max(1, Math.round(max - min + 1)) : target.children.length;
+							const desiredIndex = Math.round(numericValue - min);
+							const children = Array.from(target.children).filter((node) => node instanceof HTMLElement);
+							if (children.length >= discreteCount && desiredIndex >= 0 && desiredIndex < children.length) {
+								const item = children[desiredIndex];
+								scrollIntoViewIfNeeded(item);
+								dispatchClickEvents(item);
+								return { content: `已点击 ${describeElement(item)}，设置 ${describeElement(target)} 值为 ${numericValue}` };
+							}
+							const guessed = guessNearbyFillTarget(target, String(numericValue));
+							if (guessed) {
+								const guessedResult = executeFillOnResolvedTarget(guessed, String(numericValue), selector, action, "heuristic-nearby-target");
+								if (guessedResult) return guessedResult;
+							}
+							return {
+								content: `"${selector}" 为 role=slider，但未找到可写入输入框或可点击离散子项`,
 								details: {
 									error: true,
-									code: "FILL_NOT_APPLIED",
+									code: "UNSUPPORTED_FILL_TARGET",
 									action,
 									selector
 								}
 							};
-							return { content: `已填写 ${describeElement(target)}: "${value}"` };
 						}
-						if (target instanceof HTMLTextAreaElement) {
-							scrollIntoViewIfNeeded(target);
-							target.focus();
-							selectText(target);
-							setNativeValue(target, value);
-							dispatchInputEvents(target);
-							return { content: `已填写 ${describeElement(target)}: "${value}"` };
+						const directFilled = executeFillOnResolvedTarget(target, value, selector, action);
+						if (directFilled) return directFilled;
+						const guessed = guessNearbyFillTarget(target, value);
+						if (guessed) {
+							const guessedResult = executeFillOnResolvedTarget(guessed, value, selector, action, "heuristic-nearby-target");
+							if (guessedResult) return guessedResult;
 						}
-						if (target instanceof HTMLSelectElement) {
-							target.focus();
-							const options = Array.from(target.options);
-							let matched = options.find((o) => o.value === value);
-							if (!matched) {
-								const n = value.trim().toLowerCase();
-								matched = options.find((o) => o.text.trim().toLowerCase() === n);
+						return {
+							content: `"${selector}" 不是可编辑元素，且未在附近找到可推断填写目标`,
+							details: {
+								error: true,
+								code: "UNSUPPORTED_FILL_TARGET",
+								action,
+								selector
 							}
-							if (!matched) return { content: `"${selector}" 下拉框中不存在选项 "${value}"` };
-							target.value = matched.value;
-							dispatchInputEvents(target);
-							return { content: `已填写 ${describeElement(target)}: "${value}"` };
-						}
-						if (target instanceof HTMLElement && target.isContentEditable) {
-							target.focus();
-							selectText(target);
-							if (value) document.execCommand("insertText", false, value);
-							else document.execCommand("delete", false, void 0);
-							return { content: `已填写 ${describeElement(target)}: "${value}"` };
-						}
-						return { content: `"${selector}" 不是可编辑元素` };
+						};
 					}
 					case "select_option": {
 						const value = params.value;
@@ -2725,7 +2843,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 +2903,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) {
@@ -2951,11 +3069,7 @@ const MAX_SNAPSHOT_ATTR_VALUE_LENGTH = 120;
 const MAX_EXPANDED_LIST_CHILDREN = 120;
 /** 定向放宽 children 的硬上限。 */
 const MAX_EXPANDED_CHILDREN_LIMIT = 300;
-/**
-* 事件名 → 快照简写映射。
-* 目的：大幅压缩 listeners="..." 占用的 token，同时保留可读性。
-* 简写规则在 system-prompt 中向模型说明。
-*/
+/** 事件名 → 快照简写映射（压缩 token）。 */
 const EVENT_ABBREV = {
 	click: "clk",
 	dblclick: "dbl",
@@ -2969,14 +3083,10 @@ const EVENT_ABBREV = {
 	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",
@@ -2988,10 +3098,8 @@ const EVENT_ABBREV = {
 	dragstart: "drs",
 	dragend: "dre",
 	drop: "drp",
-	contextmenu: "ctx",
-	resize: "rsz"
+	contextmenu: "ctx"
 };
-/** 将完整事件名转为快照简写（未收录的取前 3 字符）。 */
 function abbrevEvent(name) {
 	return EVENT_ABBREV[name] ?? name.slice(0, 3);
 }
@@ -3036,18 +3144,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 ?? 12;
 	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 +3190,7 @@ function generateSnapshot(root = document.body, options = {}) {
 		"value",
 		"name",
 		"role",
-		"tabindex",
 		"aria-label",
-		"aria-valuenow",
-		"aria-valuemin",
-		"aria-valuemax",
 		"src",
 		"alt",
 		"title",
@@ -3105,7 +3208,6 @@ function generateSnapshot(root = document.body, options = {}) {
 		"LABEL",
 		"SUMMARY"
 	]);
-	/** 常见可交互事件（用于提升元素交互优先级）。 */
 	const INTERACTIVE_EVENTS = new Set([
 		"click",
 		"dblclick",
@@ -3119,11 +3221,51 @@ function generateSnapshot(root = document.body, options = {}) {
 		"change",
 		"keydown",
 		"keyup",
-		"keypress",
 		"submit",
 		"focus",
 		"blur"
 	]);
+	/** 交互性 ARIA role — 需要分配 hash ID 的角色集合 */
+	const INTERACTIVE_ROLES = new Set([
+		"button",
+		"link",
+		"tab",
+		"switch",
+		"slider",
+		"checkbox",
+		"radio",
+		"combobox",
+		"listbox",
+		"option",
+		"menuitem",
+		"textbox",
+		"spinbutton",
+		"searchbox",
+		"treeitem",
+		"gridcell",
+		"scrollbar"
+	]);
+	/**
+	* 事件优先级（值越大越优先）：
+	* 输入链路（input/change/focus/blur） > 点击链路（click/pointer） > 其他事件。
+	*/
+	const EVENT_PRIORITY = {
+		input: 140,
+		change: 130,
+		focus: 120,
+		blur: 110,
+		keydown: 100,
+		keyup: 90,
+		click: 80,
+		dblclick: 70,
+		pointerdown: 60,
+		pointerup: 55,
+		mousedown: 50,
+		mouseup: 45,
+		touchstart: 40,
+		touchend: 35,
+		submit: 30
+	};
 	/** 布尔状态属性 — 只在存在时输出（无值），如 disabled、checked */
 	const BOOLEAN_ATTRS = [
 		"disabled",
@@ -3158,70 +3300,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,25 +3308,60 @@ 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 (hasTrackedElementEvents(el)) 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));
+		const tracked = getTrackedElementEvents(el);
+		if (tracked.length === 0) return false;
+		return tracked.some((name) => INTERACTIVE_EVENTS.has(name));
+	}
+	function getTrackedEventPriorityScore(el) {
+		const tracked = getTrackedElementEvents(el);
+		if (tracked.length === 0) return 0;
+		let score = 0;
+		for (const name of tracked) score += EVENT_PRIORITY[name] ?? 8;
+		return score;
+	}
+	/**
+	* 元素优先级：
+	* 1) 输入控件/按钮等语义控件
+	* 2) 事件追踪优先级（输入、点击、失焦等）
+	* 3) inline 事件与可聚焦能力补充加分
+	*/
+	function getElementPriorityScore(el) {
+		let score = 0;
+		if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement) score += 200;
+		else if (el instanceof HTMLButtonElement || el instanceof HTMLAnchorElement) score += 180;
+		else if (el.getAttribute("role") === "button" || el.getAttribute("role") === "switch" || el.getAttribute("role") === "slider") score += 160;
+		score += getTrackedEventPriorityScore(el);
+		if (el.hasAttribute("onclick")) score += 60;
+		if (el.hasAttribute("oninput") || el.hasAttribute("onchange")) score += 80;
+		if (el.hasAttribute("onfocus") || el.hasAttribute("onblur")) score += 70;
+		if (el.hasAttribute("tabindex")) score += 20;
+		return score;
+	}
+	function orderChildrenByPriority(children) {
+		return children.map((child, index) => ({
+			child,
+			index,
+			interactive: isInteractiveElement(child),
+			score: getElementPriorityScore(child)
+		})).sort((a, b) => {
+			if (a.interactive !== b.interactive) return a.interactive ? -1 : 1;
+			if (b.score !== a.score) return b.score - a.score;
+			return a.index - b.index;
+		}).map((entry) => entry.child);
 	}
 	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;
@@ -3256,6 +3369,22 @@ function generateSnapshot(root = document.body, options = {}) {
 		if (hasInteractiveTrackedEvents(el)) return true;
 		return false;
 	}
+	/**
+	* 判断元素是否需要分配 hash ID（仅交互节点分配，节省 token）。
+	*
+	* 核心依据：元素是否绑定了交互事件（INTERACTIVE_EVENTS 集合）。
+	* 辅助依据：语义交互标签、内联事件、ARIA role、tabindex 等兜底。
+	*/
+	function needsHashId(el) {
+		if (hasInteractiveTrackedEvents(el)) return true;
+		for (const attr of Array.from(el.attributes)) if (attr.name.startsWith("on")) return true;
+		if (INTERACTIVE_TAGS.has(el.tagName)) return true;
+		const role = el.getAttribute("role");
+		if (role && INTERACTIVE_ROLES.has(role)) return true;
+		if (el.hasAttribute("tabindex")) return true;
+		if (el.isContentEditable && el.getAttribute("contenteditable") !== "inherit") return true;
+		return false;
+	}
 	/** 判断是否为“选项列表”容器（时间/下拉/listbox 等）。 */
 	function isOptionListContainer(el) {
 		if (el.getAttribute("role") === "listbox") return true;
@@ -3282,17 +3411,18 @@ 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 "";
 		if (!isInViewport(el, depth)) return "";
 		const indent = "  ".repeat(depth);
 		const tag = el.tagName.toLowerCase();
+		const rawRole = el.getAttribute("role");
+		const useRoleAsTag = !!(rawRole && INTERACTIVE_ROLES.has(rawRole) && rawRole !== tag);
+		const displayTag = useRoleAsTag ? rawRole : tag;
 		const currentPath = `${parentPath}/${tag}${getSiblingIndex(el)}`;
-		const hashId = refStore ? refStore.set(el, currentPath) : void 0;
+		const hashId = refStore && needsHashId(el) ? refStore.set(el, currentPath) : void 0;
 		const attrs = [];
 		const elId = el.getAttribute("id");
 		if (elId) attrs.push(`id="${elId}"`);
@@ -3302,6 +3432,7 @@ function generateSnapshot(root = document.body, options = {}) {
 			if (cls) attrs.push(`class="${cls}"`);
 		}
 		for (const attr of INTERACTIVE_ATTRS) {
+			if (attr === "role" && useRoleAsTag) continue;
 			const val = el.getAttribute(attr);
 			if (val) {
 				const safeVal = sanitizeSnapshotAttrValue(val);
@@ -3347,11 +3478,8 @@ function generateSnapshot(root = document.body, options = {}) {
 			}
 		}
 		directText = directText.trim();
-		if (isEmptyLayoutContainer(el, directText, depth)) {
-			const allChildren = Array.from(el.children);
-			const interactiveChildren = allChildren.filter(isInteractiveElement);
-			const nonInteractiveChildren = allChildren.filter((child) => !isInteractiveElement(child));
-			const orderedChildren = [...interactiveChildren, ...nonInteractiveChildren];
+		if (isEmptyLayoutContainer(el, directText)) {
+			const orderedChildren = orderChildrenByPriority(Array.from(el.children));
 			const childLimit = resolveChildLimit(el, maxChildren, hashId);
 			const selectedChildren = orderedChildren.slice(0, childLimit);
 			const omittedChildren = orderedChildren.length - selectedChildren.length;
@@ -3362,25 +3490,19 @@ function generateSnapshot(root = document.body, options = {}) {
 			}
 			if (childBlocks.length === 0 && omittedChildren <= 0) return "";
 			if (!(childBlocks.length >= 2 || omittedChildren > 0)) return childBlocks.join("\n");
-			const groupLines = [`${"  ".repeat(depth)}([${tag}] collapsed-group`];
+			const groupLines = [`${"  ".repeat(depth)}([${displayTag}] collapsed-group`];
 			for (const block of childBlocks) groupLines.push(indentMultiline(block, 1));
 			if (omittedChildren > 0) groupLines.push(`${"  ".repeat(depth + 1)}... (${omittedChildren} children omitted)`);
 			groupLines.push(`${"  ".repeat(depth)})`);
 			return groupLines.join("\n");
 		}
-		let line = `${indent}[${tag}]`;
+		let line = `${indent}[${displayTag}]`;
 		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}`;
 		const lines = [line];
 		emittedNodes++;
-		const allChildren = Array.from(el.children);
-		const interactiveChildren = allChildren.filter(isInteractiveElement);
-		const nonInteractiveChildren = allChildren.filter((child) => !isInteractiveElement(child));
-		const orderedChildren = [...interactiveChildren, ...nonInteractiveChildren];
+		const orderedChildren = orderChildrenByPriority(Array.from(el.children));
 		const childLimit = resolveChildLimit(el, maxChildren, hashId);
 		const selectedChildren = orderedChildren.slice(0, childLimit);
 		const omittedChildren = orderedChildren.length - selectedChildren.length;
@@ -3392,7 +3514,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 +3558,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: 12)" })),
 			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 +3587,11 @@ function createPageInfoTool() {
 						return { content: JSON.stringify(info, null, 2) };
 					}
 					case "snapshot": {
-						const maxDepth = params.maxDepth ?? 7;
+						const maxDepth = params.maxDepth ?? 12;
 						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;
@@ -3674,14 +3795,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 {
@@ -4025,29 +4139,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();
@@ -4395,7 +4486,7 @@ var WebAgent = class WebAgent {
 		let initialSnapshot;
 		try {
 			const snapshot = generateSnapshot(document.body, {
-				maxDepth: 8,
+				maxDepth: 12,
 				viewportOnly: false,
 				maxNodes: 500,
 				maxChildren: 30,