@web-auto/webauto 0.1.1 → 0.1.2

package/dist/modules/xiaohongshu/app/src/blocks/Phase2SearchBlock.js

@@ -0,0 +1,703 @@
+/**
+ * Phase 2 Block: 执行搜索
+ *
+ * 职责：通过容器系统执行搜索操作（全系统级操作）
+ */
+import { detectXhsCheckpoint, ensureXhsCheckpoint } from '../utils/checkpoints.js';
+import { controllerAction, delay } from '../utils/controllerAction.js';
+function isDebugArtifactsEnabled() {
+    return (process.env.WEBAUTO_DEBUG === '1' ||
+        process.env.WEBAUTO_DEBUG_ARTIFACTS === '1' ||
+        process.env.WEBAUTO_DEBUG_SCREENSHOT === '1');
+}
+// controllerAction/delay are shared utilities (with a safer timeout) to avoid
+// per-block drift that breaks regression flows.
+async function readSearchInputValue(profile, unifiedApiUrl) {
+    const value = await controllerAction('browser:execute', {
+        profile,
+        script: `(() => {
+        const root =
+          document.querySelector('#search-input') ||
+          document.querySelector("input[type='search']") ||
+          document.querySelector("input[placeholder*='搜索'], input[placeholder*='关键字']");
+        if (!root) return null;
+
+        // 兼容：站点更新后 #search-input 可能是 wrapper/div，而不是 input
+        const el =
+          ('value' in root)
+            ? root
+            : (root.querySelector('input, textarea, [contenteditable="true"], [contenteditable=""]') || root);
+
+        try {
+          if (el && typeof el === 'object' && 'value' in el) {
+            // @ts-ignore
+            const v = el.value;
+            return typeof v === 'string' ? v : String(v ?? '');
+          }
+          const text = (el && 'textContent' in el) ? (el.textContent ?? '') : '';
+          return typeof text === 'string' ? text : String(text ?? '');
+        } catch {
+          return null;
+        }
+      })()`,
+    }, unifiedApiUrl).then((res) => res?.result || res?.data?.result || null);
+    return typeof value === 'string' ? value : null;
+}
+async function readActiveInputValue(profile, unifiedApiUrl) {
+    const value = await controllerAction('browser:execute', {
+        profile,
+        script: `(() => {
+        const el = document.activeElement;
+        if (!el) return null;
+        const input = (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement)
+          ? el
+          : (el.querySelector?.('input, textarea') || el);
+        if (input && 'value' in input) {
+          // @ts-ignore
+          const v = input.value;
+          return typeof v === 'string' ? v : String(v ?? '');
+        }
+        const text = (input && 'textContent' in input) ? (input.textContent ?? '') : '';
+        return typeof text === 'string' ? text : String(text ?? '');
+      })()`,
+    }, unifiedApiUrl).then((res) => res?.result || res?.data?.result || null);
+    return typeof value === 'string' ? value : null;
+}
+async function probeSearchInputState(profile, unifiedApiUrl, keyword) {
+    const state = await controllerAction('browser:execute', {
+        profile,
+        script: `(() => {
+        const norm = (v) => (typeof v === 'string' ? v.trim() : String(v ?? '').trim());
+        const editableSelector = "input, textarea, [contenteditable='true'], [contenteditable=''], [role='textbox']";
+        const toValue = (el) => {
+          try {
+            if (!el) return '';
+            if ('value' in el) {
+              const v = el.value;
+              return typeof v === 'string' ? v : String(v ?? '');
+            }
+            const t = el.textContent ?? '';
+            return typeof t === 'string' ? t : String(t ?? '');
+          } catch {
+            return '';
+          }
+        };
+        const isVisible = (el) => {
+          try {
+            if (!el || !el.getBoundingClientRect) return false;
+            const r = el.getBoundingClientRect();
+            if (!(r.width > 0 && r.height > 0)) return false;
+            return r.bottom >= 0 && r.right >= 0 && r.top <= window.innerHeight && r.left <= window.innerWidth;
+          } catch {
+            return false;
+          }
+        };
+        const descriptor = (el) => {
+          const bits = [
+            el?.id || '',
+            el?.className || '',
+            el?.getAttribute?.('name') || '',
+            el?.getAttribute?.('placeholder') || '',
+            el?.getAttribute?.('aria-label') || '',
+            el?.getAttribute?.('data-placeholder') || '',
+          ]
+            .map((x) => String(x || '').toLowerCase())
+            .filter(Boolean);
+          return bits.join(' ');
+        };
+        const hasSearchHint = (el) => /search|搜索|关键/.test(descriptor(el));
+        const activeElement = document.activeElement;
+        const activeEditable = activeElement && (activeElement.matches?.(editableSelector)
+          ? activeElement
+          : activeElement.querySelector?.(editableSelector));
+
+        /** @type {Array<{value: string, source: string, score: number}>} */
+        const candidates = [];
+        const seen = new Set();
+        const pushCandidate = (el, source) => {
+          if (!el || seen.has(el)) return;
+          seen.add(el);
+          if (!isVisible(el)) return;
+          const value = toValue(el);
+          const rect = el.getBoundingClientRect?.() || { top: 9999, width: 0 };
+          const score =
+            (el === activeEditable ? 80 : 0) +
+            (hasSearchHint(el) ? 40 : 0) +
+            (rect.top < 180 ? 20 : 0) +
+            (rect.width > 120 ? 10 : 0);
+          candidates.push({ value: String(value || ''), source, score });
+        };
+
+        if (activeEditable) pushCandidate(activeEditable, 'active');
+
+        const root = document.querySelector('#search-input');
+        if (root) {
+          const nested = root.matches?.(editableSelector)
+            ? root
+            : root.querySelector?.(editableSelector);
+          if (nested) pushCandidate(nested, 'search_root');
+        }
+
+        const primary = document.querySelectorAll(
+          "#search-input, input[type='search'], input[placeholder*='搜索'], input[placeholder*='关键字'], input[aria-label*='搜索'], input[name*='search']",
+        );
+        primary.forEach((node, idx) => {
+          const el = node.matches?.(editableSelector)
+            ? node
+            : node.querySelector?.(editableSelector);
+          if (el) pushCandidate(el, \`primary_\${idx + 1}\`);
+        });
+
+        const editable = document.querySelectorAll(editableSelector);
+        editable.forEach((node, idx) => {
+          pushCandidate(node, \`editable_\${idx + 1}\`);
+        });
+
+        candidates.sort((a, b) => b.score - a.score);
+        const normalizedKeyword = norm(keyword);
+        const exact = candidates.find((c) => norm(c.value) === normalizedKeyword) || null;
+        const nonEmpty = candidates.find((c) => norm(c.value).length > 0) || null;
+        const best = exact || nonEmpty || candidates[0] || null;
+        const activeValue = activeEditable ? toValue(activeEditable) : null;
+
+        return {
+          ok: !!exact,
+          value: best ? String(best.value || '') : null,
+          source: best ? String(best.source || '') : null,
+          activeValue: typeof activeValue === 'string' ? activeValue : (activeValue == null ? null : String(activeValue)),
+          candidates: candidates.slice(0, 5).map((c) => \`\${c.source}:\${String(c.value || '').slice(0, 60)}\`),
+        };
+      })()`,
+    }, unifiedApiUrl).then((res) => res?.result || res?.data?.result || null);
+    return {
+        ok: Boolean(state?.ok),
+        value: typeof state?.value === 'string' ? state.value : null,
+        source: typeof state?.source === 'string' ? state.source : null,
+        activeValue: typeof state?.activeValue === 'string' ? state.activeValue : null,
+        candidates: Array.isArray(state?.candidates) ? state.candidates.map((x) => String(x)) : [],
+    };
+}
+async function systemFillSearchInputValue(profile, unifiedApiUrl, keyword) {
+    // System-level requirement: prefer keyboard/mouse. `browser:execute` is JS mutation and should be avoided.
+    // We implement a system-level "fill" as: select-all + delete + type (with retries).
+    const trySelectAllDeleteType = async (modifier) => {
+        await controllerAction('keyboard:down', { profileId: profile, key: modifier }, unifiedApiUrl).catch(() => { });
+        await controllerAction('keyboard:press', { profileId: profile, key: 'A' }, unifiedApiUrl).catch(() => { });
+        await controllerAction('keyboard:up', { profileId: profile, key: modifier }, unifiedApiUrl).catch(() => { });
+        await delay(60);
+        await controllerAction('keyboard:press', { profileId: profile, key: 'Backspace' }, unifiedApiUrl).catch(() => { });
+        await delay(60);
+        await controllerAction('keyboard:type', { profileId: profile, text: keyword, delay: 70 }, unifiedApiUrl).catch(() => { });
+    };
+    const checkBoth = async () => {
+        const probe = await probeSearchInputState(profile, unifiedApiUrl, keyword).catch(() => null);
+        if (probe?.ok) {
+            return { ok: true, source: probe.source || 'probeSearchInputState', value: probe.value || '' };
+        }
+        const v1 = await readSearchInputValue(profile, unifiedApiUrl).catch(() => null);
+        if (v1 && v1.trim() === keyword)
+            return { ok: true, source: 'readSearchInputValue', value: v1 };
+        const v2 = await readActiveInputValue(profile, unifiedApiUrl).catch(() => null);
+        if (v2 && v2.trim() === keyword)
+            return { ok: true, source: 'readActiveInputValue', value: v2 };
+        return { ok: false, value: probe?.value || v1 || v2 || '' };
+    };
+    // Try a few times; Camoufox can drop events if focus is flaky.
+    for (let i = 0; i < 3; i++) {
+        await trySelectAllDeleteType('Meta');
+        await delay(250);
+        const c1 = await checkBoth();
+        if (c1.ok)
+            return { ok: true, method: 'meta', source: c1.source };
+        await trySelectAllDeleteType('Control');
+        await delay(250);
+        const c2 = await checkBoth();
+        if (c2.ok)
+            return { ok: true, method: 'control', source: c2.source };
+    }
+    const finalCheck = await checkBoth();
+    return { ok: false, reason: `mismatch:${String(finalCheck.value ?? '')}` };
+}
+async function submitHomeSearchViaContainer(profile, unifiedApiUrl) {
+    // Fallback only: do NOT type keyword again (it can append duplicated text).
+    // Just click search button once.
+    try {
+        await controllerAction('container:operation', { containerId: 'xiaohongshu_home.search_button', operationId: 'click', sessionId: profile, timeoutMs: 10000 }, unifiedApiUrl).catch(() => { });
+        console.log('[Phase2Search] submit via click fallback');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function canSubmitSearch(profile, unifiedApiUrl, keyword) {
+    const probe = await probeSearchInputState(profile, unifiedApiUrl, keyword).catch(() => null);
+    if (probe?.ok) {
+        return {
+            ok: true,
+            value: probe.value ?? null,
+            source: probe.source ?? 'probeSearchInputState',
+            activeValue: probe.activeValue ?? null,
+            candidates: Array.isArray(probe.candidates) ? probe.candidates : [],
+        };
+    }
+    const value = await readSearchInputValue(profile, unifiedApiUrl).catch(() => null);
+    if (typeof value === 'string' && value.trim() === keyword)
+        return { ok: true, value, source: 'readSearchInputValue', activeValue: null, candidates: [] };
+    const activeValue = await readActiveInputValue(profile, unifiedApiUrl).catch(() => null);
+    if (typeof activeValue === 'string' && activeValue.trim() === keyword)
+        return { ok: true, value: activeValue, source: 'readActiveInputValue', activeValue, candidates: [] };
+    return {
+        ok: false,
+        value: (probe?.value ?? value ?? activeValue ?? null),
+        source: (probe?.source ?? null),
+        activeValue: (probe?.activeValue ?? activeValue ?? null),
+        candidates: Array.isArray(probe?.candidates) ? probe.candidates : [],
+    };
+}
+async function browserFillSearchInputValue(profile, unifiedApiUrl, keyword, searchInputContainerId) {
+    const selector = "#search-input input, #search-input textarea, #search-input [contenteditable='true'], input[type='search'], input[placeholder*='鎼滅储'], input[placeholder*='鍏抽敭'], input[aria-label*='鎼滅储']";
+    const fillRes = await controllerAction('browser:fill', { profile, selector, text: keyword }, unifiedApiUrl).catch((e) => ({ success: false, error: String(e?.message || e || 'browser_fill_failed') }));
+    const fillOk = Boolean(fillRes?.success ?? fillRes?.ok ?? false);
+    const fillErr = String(fillRes?.error || '').trim();
+    console.log(`[Phase2Search] protocol fill: selector="${selector}" success=${fillOk}${fillErr ? ` error=${fillErr}` : ''}`);
+    if (fillOk) {
+        return { success: true, mode: 'browser:fill', selector };
+    }
+    if (searchInputContainerId !== 'dom_fallback_search_input') {
+        const typeRes = await controllerAction('container:operation', {
+            containerId: searchInputContainerId,
+            operationId: 'type',
+            sessionId: profile,
+            config: {
+                text: keyword,
+                value: keyword,
+                clear_first: true,
+                human_typing: true,
+                pause_after: 300,
+            },
+        }, unifiedApiUrl).catch((e) => ({ success: false, error: String(e?.message || e || 'container_type_failed') }));
+        const typeOk = Boolean(typeRes?.success ?? typeRes?.ok ?? false);
+        const typeErr = String(typeRes?.error || '').trim();
+        console.log(`[Phase2Search] protocol input: container_type success=${typeOk}${typeErr ? ` error=${typeErr}` : ''}`);
+        if (typeOk) {
+            const ok = await canSubmitSearch(profile, unifiedApiUrl, keyword).catch(() => ({ ok: false }));
+            if (ok?.ok)
+                return { success: true, mode: 'container:type', selector };
+        }
+    }
+    // Fallback: system-level input
+    if (searchInputContainerId !== 'dom_fallback_search_input') {
+        await controllerAction('container:operation', { containerId: searchInputContainerId, operationId: 'click', sessionId: profile }, unifiedApiUrl).catch(() => { });
+    }
+    await delay(200);
+    await clearSearchInput(profile, unifiedApiUrl);
+    await delay(120);
+    await controllerAction('keyboard:type', { profileId: profile, text: keyword }, unifiedApiUrl).catch(() => { });
+    await delay(200);
+    const ok = await canSubmitSearch(profile, unifiedApiUrl, keyword).catch(() => ({ ok: false }));
+    return { success: !!ok?.ok, mode: 'keyboard:type', selector };
+}
+async function clearSearchInput(profile, unifiedApiUrl) {
+    // Step 1: JS-based clear first (most reliable for Camoufox/Firefox)
+    const jsCleared = await controllerAction('browser:execute', {
+        profile,
+        script: `(() => {
+        const root = document.querySelector('#search-input') ||
+          document.querySelector("input[type='search']") ||
+          document.querySelector("input[placeholder*='搜索'], input[placeholder*='关键字']");
+        if (!root) return false;
+        root.value = '';
+        root.dispatchEvent(new Event('input', { bubbles: true }));
+        root.dispatchEvent(new Event('change', { bubbles: true }));
+        return true;
+      })()`,
+    }, unifiedApiUrl).then(res => res?.result || res?.data?.result || false).catch(() => false);
+    await delay(100);
+    const v1 = await readSearchInputValue(profile, unifiedApiUrl);
+    if (!v1 || !v1.trim())
+        return;
+    // Step 2+: Fallback to system keyboard if needed
+    const tryCombo = async (combo) => {
+        const mod = combo.startsWith('Meta') ? 'Meta' : 'Control';
+        await controllerAction('keyboard:down', { profileId: profile, key: mod }, unifiedApiUrl).catch(() => { });
+        await controllerAction('keyboard:press', { profileId: profile, key: 'A' }, unifiedApiUrl).catch(() => { });
+        await controllerAction('keyboard:up', { profileId: profile, key: mod }, unifiedApiUrl).catch(() => { });
+        await delay(80);
+        // Use both Delete and Backspace to cover different input implementations.
+        await controllerAction('keyboard:press', { profileId: profile, key: 'Backspace' }, unifiedApiUrl).catch(() => { });
+        await controllerAction('keyboard:press', { profileId: profile, key: 'Delete' }, unifiedApiUrl).catch(() => { });
+    };
+    // 1) Cmd+A (Mac) then delete
+    await tryCombo('Meta+A');
+    await delay(120);
+    let v = await readSearchInputValue(profile, unifiedApiUrl);
+    if (!v || !v.trim())
+        return;
+    // 2) Ctrl+A then delete
+    await tryCombo('Control+A');
+    await delay(120);
+    v = await readSearchInputValue(profile, unifiedApiUrl);
+    if (!v || !v.trim())
+        return;
+    // 3) Fallback: repeated Backspace
+    for (let i = 0; i < 80; i++) {
+        await controllerAction('keyboard:press', { profileId: profile, key: 'Backspace' }, unifiedApiUrl).catch(() => { });
+        if (i % 10 === 0) {
+            await delay(40);
+            v = await readSearchInputValue(profile, unifiedApiUrl);
+            if (!v || !v.trim())
+                return;
+        }
+    }
+}
+export async function execute(input) {
+    const { keyword, profile = 'xiaohongshu_fresh', unifiedApiUrl = 'http://127.0.0.1:7701', } = input;
+    const debugArtifactsEnabled = isDebugArtifactsEnabled();
+    console.log(`[Phase2Search] 执行搜索(容器驱动): ${keyword}`);
+    // Ensure we are in a safe starting state (home/search). Recover from detail/comments if needed.
+    const ensureRes = await ensureXhsCheckpoint({
+        sessionId: profile,
+        target: 'search_ready',
+        serviceUrl: unifiedApiUrl,
+        timeoutMs: 15000,
+        allowOneLevelUpFallback: true,
+    });
+    if (!ensureRes.success && ensureRes.reached !== 'home_ready' && ensureRes.reached !== 'search_ready') {
+        throw new Error(`[Phase2Search] ensure checkpoint failed: reached=${ensureRes.reached} url=${ensureRes.url}`);
+    }
+    let currentUrl = await controllerAction('browser:execute', { profile, script: 'window.location.href' }, unifiedApiUrl).then((res) => res?.result || res?.data?.result || '');
+    // 开发期硬门禁：每个大环节开始先定位，不做容错兜底。
+    const det = await detectXhsCheckpoint({ sessionId: profile, serviceUrl: unifiedApiUrl });
+    console.log(`[Phase2Search] locate: checkpoint=${det.checkpoint} url=${det.url}`);
+    if (det.checkpoint === 'risk_control' || det.checkpoint === 'login_guard' || det.checkpoint === 'offsite') {
+        throw new Error(`[Phase2Search] hard_stop checkpoint=${det.checkpoint} url=${det.url}`);
+    }
+    async function waitCheckpoint(maxWaitMs) {
+        const start = Date.now();
+        let last = det;
+        while (Date.now() - start < maxWaitMs) {
+            await delay(500);
+            last = await detectXhsCheckpoint({ sessionId: profile, serviceUrl: unifiedApiUrl });
+            if (last.checkpoint !== 'detail_ready' && last.checkpoint !== 'comments_ready')
+                return last;
+        }
+        return last;
+    }
+    async function exitDetailOrCommentsState() {
+        let d = await detectXhsCheckpoint({ sessionId: profile, serviceUrl: unifiedApiUrl });
+        if (d.checkpoint !== 'detail_ready' && d.checkpoint !== 'comments_ready')
+            return d;
+        // 详情/评论态：先尝试点击关闭按钮（更贴近用户行为），然后等待状态变化。
+        console.log('[Phase2Search] 处于详情/评论态，尝试点击关闭按钮关闭详情页...');
+        try {
+            const r = await controllerAction('container:operation', { containerId: 'xiaohongshu_detail.close_button', operationId: 'click', sessionId: profile, timeoutMs: 15000 }, unifiedApiUrl);
+            console.log(`[Phase2Search] close_button click: success=${Boolean(r?.success !== false)}`);
+        }
+        catch {
+            console.log('[Phase2Search] close_button click failed (ignored)');
+        }
+        d = await waitCheckpoint(8000);
+        if (d.checkpoint !== 'detail_ready' && d.checkpoint !== 'comments_ready')
+            return d;
+        // 若仍在详情/评论态：使用 ESC 退出（系统级），每次后等待状态稳定。
+        for (let i = 0; i < 2; i += 1) {
+            console.log(`[Phase2Search] still in ${d.checkpoint}, press ESC to exit (round=${i + 1})`);
+            await controllerAction('keyboard:press', { profileId: profile, key: 'Escape' }, unifiedApiUrl);
+            d = await waitCheckpoint(8000);
+            if (d.checkpoint !== 'detail_ready' && d.checkpoint !== 'comments_ready')
+                return d;
+        }
+        // 最终仍失败：留证据（截图长度），停止（不刷新）。
+        let shotLen = 0;
+        if (isDebugArtifactsEnabled()) {
+            const shot = await controllerAction('browser:screenshot', { profileId: profile, fullPage: false }, unifiedApiUrl).then((res) => res?.data || res?.result || res?.data?.data || '');
+            shotLen = typeof shot === 'string' ? shot.length : 0;
+        }
+        throw new Error(`[Phase2Search] 关闭详情页后仍未回到搜索/首页（checkpoint=${d.checkpoint}）。停止（避免刷新）。URL=${d.url} screenshot_len=${shotLen}`);
+    }
+    // If starting from detail/comments state, exit to a stable checkpoint before doing anything else.
+    if (det.checkpoint === 'detail_ready' || det.checkpoint === 'comments_ready') {
+        await exitDetailOrCommentsState();
+    }
+    // 检查当前页面是否可搜索（优先用 DOM signals，禁止任何刷新/导航）
+    const domCheck = await controllerAction('browser:execute', {
+        profile,
+        script: `(function(){
+      const root =
+        document.querySelector('#search-input') ||
+        document.querySelector('input[type="search"]') ||
+        document.querySelector('input[placeholder*="搜索"], input[placeholder*="关键字"]');
+      const el = root && ('value' in root)
+        ? root
+        : (root ? (root.querySelector('input, textarea, [contenteditable="true"], [contenteditable=""]') || root) : null);
+      const rect = el && el.getBoundingClientRect ? el.getBoundingClientRect() : null;
+      const hasSearchInput = !!el && !!rect && rect.width > 0 && rect.height > 0;
+      const hasDetailMask = !!document.querySelector('.detail-mask, .note-detail-mask, .content-mask');
+      return {
+        hasSearchInput,
+        hasDetailMask,
+        rect: rect ? { x1: rect.left, y1: rect.top, x2: rect.right, y2: rect.bottom } : null,
+        url: window.location.href,
+      };
+    })()`,
+    }, unifiedApiUrl).then(res => res?.result || res?.data?.result || {});
+    const hasSearchInput = Boolean(domCheck?.hasSearchInput);
+    const hasDetailMask = Boolean(domCheck?.hasDetailMask);
+    const domRect = domCheck?.rect || null;
+    // Priority 1: If detail mask exists or we're still in detail/comments, close the modal.
+    // NOTE: On XHS, ESC is unreliable in Camoufox; prefer clicking the close button (system click via container).
+    if (hasDetailMask || det.checkpoint === 'detail_ready' || det.checkpoint === 'comments_ready') {
+        console.log('[Phase2Search] 处于详情/评论态，尝试点击关闭按钮关闭详情页...');
+        // Best-effort click the close button by container operation (system-level click).
+        // If container is missing (layout changed), we fail fast (no refresh) with evidence.
+        const clickRes = await controllerAction('container:operation', { containerId: 'xiaohongshu_detail.modal_shell', operationId: 'click', sessionId: profile }, unifiedApiUrl);
+        console.log(`[Phase2Search] close_button click: success=${Boolean(clickRes?.success)}`);
+        await delay(1500);
+        const detAfterClose = await detectXhsCheckpoint({ sessionId: profile, serviceUrl: unifiedApiUrl });
+        if (detAfterClose.checkpoint !== 'search_ready' && detAfterClose.checkpoint !== 'home_ready') {
+            throw new Error(`[Phase2Search] 关闭详情页后仍未回到搜索/首页（checkpoint=${detAfterClose.checkpoint}）。停止（避免刷新）。URL=${currentUrl}`);
+        }
+    }
+    // Priority 2: Without search input we cannot search
+    if (!hasSearchInput) {
+        throw new Error(`[Phase2Search] 未检测到搜索输入框，无法执行搜索。URL=${currentUrl}`);
+    }
+    const probeHighlight = async (containerId) => {
+        try {
+            const res = await controllerAction('container:operation', { containerId, operationId: 'highlight', sessionId: profile }, unifiedApiUrl);
+            return res?.success ? res : null;
+        }
+        catch {
+            return null;
+        }
+    };
+    // Do not infer page type from URL (XHS can keep /explore/<id> while showing search UI).
+    // Instead, probe containers first; if all fail, fallback to DOM detection (no refresh/goto).
+    let searchInputContainerId = '';
+    let highlightResult = null;
+    let useDomFallback = false;
+    const preferredOrder = det.checkpoint === 'search_ready'
+        ? ['xiaohongshu_search.search_bar', 'xiaohongshu_home.search_input']
+        : ['xiaohongshu_home.search_input', 'xiaohongshu_search.search_bar'];
+    for (const candidate of preferredOrder) {
+        highlightResult = await probeHighlight(candidate);
+        if (highlightResult) {
+            searchInputContainerId = candidate;
+            break;
+        }
+    }
+    // Fallback: if container highlight fails, use DOM rect (no refresh/goto)
+    if (!searchInputContainerId && domRect) {
+        useDomFallback = true;
+        searchInputContainerId = 'dom_fallback_search_input';
+        highlightResult = { success: true, data: { rect: domRect } };
+        console.log('[Phase2Search] 容器 highlight 失败，使用 DOM rect 作为搜索框');
+    }
+    if (!searchInputContainerId) {
+        throw new Error(`[Phase2Search] 未识别页面状态，无法定位搜索框。当前 URL: ${currentUrl}`);
+    }
+    const isSearchResult = searchInputContainerId === 'xiaohongshu_search.search_bar';
+    const isHome = searchInputContainerId === 'xiaohongshu_home.search_input' || searchInputContainerId === 'dom_fallback_search_input';
+    console.log(`[Phase2Search] 当前页面: ${isSearchResult ? 'search_result' : 'home'}，使用容器 ${searchInputContainerId}`);
+    // 验证搜索框可用性（先高亮确认）
+    if (!highlightResult) {
+        console.log(`[Phase2Search] highlight start: ${searchInputContainerId}`);
+        highlightResult = await controllerAction('container:operation', { containerId: searchInputContainerId, operationId: 'highlight', sessionId: profile }, unifiedApiUrl);
+    }
+    console.log(`[Phase2Search] highlight done: success=${Boolean(highlightResult?.success)}`);
+    if (!highlightResult?.success) {
+        throw new Error(`[Phase2Search] 搜索框不可用: ${searchInputContainerId}`);
+    }
+    await delay(500);
+    // Camoufox: prefer system-level coordinate click to reliably focus inputs.
+    // Using container:operation click can hang in some cases.
+    const anchor = highlightResult?.data || highlightResult;
+    const rect = anchor?.rect;
+    if (rect?.x1 !== undefined && rect?.y1 !== undefined && rect?.x2 !== undefined && rect?.y2 !== undefined) {
+        const width = Number(rect.x2) - Number(rect.x1);
+        const height = Number(rect.y2) - Number(rect.y1);
+        if (!Number.isFinite(width) || !Number.isFinite(height) || width < 8 || height < 8) {
+            console.log(`[Phase2Search] rect invalid for coordinate click (w=${width}, h=${height}), fallback to container click`);
+            if (!useDomFallback) {
+                await controllerAction('container:operation', { containerId: searchInputContainerId, operationId: 'click', sessionId: profile, timeoutMs: 10000 }, unifiedApiUrl).catch(() => { });
+            }
+            await delay(260);
+        }
+        else {
+            const cx = (Number(rect.x1) + Number(rect.x2)) / 2;
+            const cy = (Number(rect.y1) + Number(rect.y2)) / 2;
+            console.log(`[Phase2Search] mouse:click at (${cx.toFixed(1)}, ${cy.toFixed(1)})`);
+            await controllerAction('mouse:click', { profileId: profile, x: cx, y: cy, clicks: 1 }, unifiedApiUrl);
+            // Give the input time to receive focus in Camoufox.
+            await delay(300);
+            // Try selecting text via mouse (more reliable than keyboard shortcuts on some builds).
+            await controllerAction('mouse:click', { profileId: profile, x: cx, y: cy, clicks: 2 }, unifiedApiUrl).catch(() => { });
+            await delay(200);
+        }
+    }
+    else {
+        console.warn(`[Phase2Search] missing rect for system click, fallback to container click`);
+        if (!useDomFallback) {
+            await controllerAction('container:operation', { containerId: searchInputContainerId, operationId: 'click', sessionId: profile, timeoutMs: 10000 }, unifiedApiUrl).catch(() => { });
+            await delay(260);
+        }
+    }
+    // If the input already contains the same keyword, do not force clearing.
+    // Camoufox sometimes ignores deletion events in certain states; treat "already correct" as success.
+    const beforeClear = await readSearchInputValue(profile, unifiedApiUrl).catch(() => null);
+    const inputAlreadyMatches = typeof beforeClear === 'string' && beforeClear.trim() === keyword;
+    if (inputAlreadyMatches) {
+        console.log('[Phase2Search] input already matches keyword, will clear and retype to ensure focus');
+    }
+    // Always clear and type to ensure focus and input state
+    // Force clear via JS first (most reliable)
+    await controllerAction('browser:execute', {
+        profile,
+        script: `(() => {
+          const root = document.querySelector('#search-input') ||
+            document.querySelector("input[type='search']") ||
+            document.querySelector("input[placeholder*='搜索'], input[placeholder*='关键字']");
+          if (root) {
+            root.value = '';
+            root.dispatchEvent(new Event('input', { bubbles: true }));
+          }
+          return true;
+        })()`,
+    }, unifiedApiUrl).catch(() => { });
+    await delay(100);
+    await clearSearchInput(profile, unifiedApiUrl);
+    const clearedValue = await readSearchInputValue(profile, unifiedApiUrl);
+    if (typeof clearedValue === 'string' && clearedValue.trim() && clearedValue.trim() !== keyword) {
+        let shotLen = 0;
+        if (debugArtifactsEnabled) {
+            const shot = await controllerAction('browser:screenshot', { profileId: profile, fullPage: false }, unifiedApiUrl).then((res) => res?.data || res?.result || res?.data?.data || '');
+            shotLen = typeof shot === 'string' ? shot.length : 0;
+        }
+        throw new Error(`[Phase2Search] 清空输入框失败（组合键 + 退格后仍有残留）。value="${clearedValue}" screenshot_len=${shotLen}`);
+    }
+    // Camoufox: keyboard typing can be flaky (focus/IME). Use a fill-style set + input/change events.
+    const fillRes = await browserFillSearchInputValue(profile, unifiedApiUrl, keyword, searchInputContainerId);
+    const fillSuccess = Boolean(fillRes?.success !== false);
+    console.log(`[Phase2Search] browser:fill done: success=${fillSuccess}`);
+    if (!fillSuccess) {
+        const fallback = await systemFillSearchInputValue(profile, unifiedApiUrl, keyword);
+        console.log(`[Phase2Search] keyboard fill fallback: ok=${Boolean(fallback?.ok)} reason=${fallback?.reason || ''}`);
+    }
+    await delay(450);
+    // If we skipped typing, the input already contains keyword; proceed to submit.
+    // 强制验证：提交前必须确认 input 值等于 keyword，否则直接失败（不点击搜索按钮）
+    const canSubmit = await canSubmitSearch(profile, unifiedApiUrl, keyword);
+    const beforeSubmitValue = await readSearchInputValue(profile, unifiedApiUrl).catch(() => null);
+    const activeBeforeSubmitValue = await readActiveInputValue(profile, unifiedApiUrl).catch(() => null);
+    console.log(`[Phase2Search] Before submit: input value="${String(beforeSubmitValue)}" active="${String(activeBeforeSubmitValue)}" keyword="${keyword}" probe=${String(canSubmit.source)} candidates=${(canSubmit.candidates || []).join(' | ')}`);
+    if (String(canSubmit.activeValue || activeBeforeSubmitValue || '') !== String(keyword) && searchInputContainerId !== 'dom_fallback_search_input') {
+        await controllerAction('container:operation', { containerId: searchInputContainerId, operationId: 'click', sessionId: profile }, unifiedApiUrl).catch(() => { });
+        await delay(300);
+    }
+    if (!canSubmit.ok) {
+        let shotLen = 0;
+        if (debugArtifactsEnabled) {
+            const shot = await controllerAction('browser:screenshot', { profileId: profile, fullPage: false }, unifiedApiUrl).then((res) => res?.data || res?.result || res?.data?.data || '');
+            shotLen = typeof shot === 'string' ? shot.length : 0;
+        }
+        throw new Error(`[Phase2Search] 提交前 input 值不等于关键字：expected="${keyword}" actual="${String(canSubmit.value)}" source=${String(canSubmit.source)} active="${String(canSubmit.activeValue)}" candidates=${(canSubmit.candidates || []).join(' | ')} screenshot_len=${shotLen}。停止执行（不点击搜索按钮）。`);
+    }
+    if (isHome) {
+        // Trigger Enter first; fallback to click only when Enter does not navigate to search result.
+        console.log('[Phase2Search] submit via Enter');
+        await controllerAction('keyboard:press', { profileId: profile, key: 'Enter' }, unifiedApiUrl).catch(() => { });
+        await delay(1200);
+        const afterEnter = await detectXhsCheckpoint({ sessionId: profile, serviceUrl: unifiedApiUrl });
+        if (afterEnter.checkpoint !== 'search_ready') {
+            const ok = await submitHomeSearchViaContainer(profile, unifiedApiUrl);
+            if (!ok) {
+                console.log('[Phase2Search] submit via search_button failed');
+            }
+        }
+        else {
+            console.log('[Phase2Search] Enter submit accepted, skip click fallback');
+        }
+    }
+    else {
+        // search_result：single Enter submit only
+        await controllerAction('keyboard:press', { profileId: profile, key: 'Enter' }, unifiedApiUrl).catch(() => { });
+    }
+    // 等待搜索结果页加载：最多 15 秒。
+    // 注意：XHS 在 Camoufox 下可能出现“URL 仍停留 /explore/<id>，但 DOM 已是搜索结果页”的壳页行为。
+    // 这里仅做节奏控制，最终成功判定仍以 DOM/容器信号为准。
+    await delay(15000);
+    // 验证是否到达搜索结果页（不依赖 URL，使用 DOM + checkpoint），失败则最多重试 3 次 Enter 提交
+    let finalUrl = currentUrl;
+    let success = false;
+    for (let attempt = 1; attempt <= 3; attempt += 1) {
+        const checkpoint = await detectXhsCheckpoint({ sessionId: profile, serviceUrl: unifiedApiUrl });
+        const pageCheck = await controllerAction('browser:execute', {
+            profile,
+            script: `(function(){
+        const hasTabs = !!document.querySelector('.tabs, .filter-tabs, [role="tablist"]');
+        const hasResultList = !!document.querySelector('.feeds-container, .search-result-list, .note-list');
+        const hasSearchInput = !!document.querySelector('#search-input, input[type="search"]');
+        return {
+          hasTabs,
+          hasResultList,
+          hasSearchInput,
+          url: window.location.href,
+        };
+      })()`,
+        }, unifiedApiUrl).then(res => res?.result || res?.data?.result || null);
+        finalUrl = pageCheck?.url || finalUrl;
+        const urlStr = String(finalUrl || '');
+        const urlLooksSearch = urlStr.includes('/search_result') || urlStr.includes('search_result');
+        success = checkpoint.checkpoint === 'search_ready' && Boolean(pageCheck?.hasSearchInput) && (pageCheck?.hasTabs || pageCheck?.hasResultList || urlLooksSearch);
+        console.log(`[Phase2Search] 完成: success=${success} checkpoint=${checkpoint.checkpoint} url=${finalUrl} hasTabs=${pageCheck?.hasTabs} hasResultList=${pageCheck?.hasResultList} attempt=${attempt}`);
+        if (success)
+            break;
+        if (attempt < 3) {
+            console.log(`[Phase2Search] retry search submit (attempt=${attempt + 1})`);
+            // 重新聚焦输入框（系统级点击）再输入关键字，避免焦点丢失
+            try {
+                const rect = await controllerAction('browser:execute', {
+                    profile,
+                    script: `(function(){
+            const el = document.querySelector('#search-input') || document.querySelector('input[type="search"]') || document.querySelector('input[placeholder*="搜索"], input[placeholder*="关键字"]');
+            if (!el) return null;
+            const r = el.getBoundingClientRect();
+            return { x1: r.left, y1: r.top, x2: r.right, y2: r.bottom };
+          })()`,
+                }, unifiedApiUrl).then(res => res?.result || res?.data?.result || null);
+                if (rect && rect.x1 !== undefined) {
+                    const cx = (Number(rect.x1) + Number(rect.x2)) / 2;
+                    const cy = (Number(rect.y1) + Number(rect.y2)) / 2;
+                    await controllerAction('mouse:click', { profileId: profile, x: cx, y: cy, clicks: 1 }, unifiedApiUrl).catch(() => { });
+                    await delay(200);
+                }
+            }
+            catch {
+                // ignore refocus errors
+            }
+            await systemFillSearchInputValue(profile, unifiedApiUrl, keyword).catch(() => { });
+            await delay(300);
+            await controllerAction('keyboard:press', { profileId: profile, key: 'Enter' }, unifiedApiUrl);
+            await delay(5000);
+        }
+    }
+    if (!success) {
+        const ensureFinal = await ensureXhsCheckpoint({
+            sessionId: profile,
+            target: 'search_ready',
+            serviceUrl: unifiedApiUrl,
+            timeoutMs: 12000,
+            allowOneLevelUpFallback: false,
+        });
+        success = ensureFinal.success && ensureFinal.reached === 'search_ready';
+        finalUrl = ensureFinal.url || finalUrl;
+        console.log(`[Phase2Search] ensure final: success=${success} reached=${ensureFinal.reached} url=${finalUrl}`);
+    }
+    return {
+        success,
+        finalUrl,
+        keyword,
+    };
+}
+//# sourceMappingURL=Phase2SearchBlock.js.map