@web-auto/webauto 0.1.3 → 0.1.6

package/dist/modules/xiaohongshu/app/src/xiaohongshu/app/src/blocks/Phase34CloseDetailBlock.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Phase 3-4 Block: 关闭详情页（返回搜索页）
+ *
+ * 职责：从详情页安全返回搜索结果页
+ */
+export interface CloseDetailInput {
+    profile?: string;
+    unifiedApiUrl?: string;
+}
+export interface CloseDetailOutput {
+    success: boolean;
+    finalUrl: string;
+}
+export declare function execute(input: CloseDetailInput): Promise<CloseDetailOutput>;
+//# sourceMappingURL=Phase34CloseDetailBlock.d.ts.map

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

@@ -0,0 +1,41 @@
+/**
+ * Phase 3-4 Block: 关闭详情页（返回搜索页）
+ *
+ * 职责：从详情页安全返回搜索结果页
+ */
+async function controllerAction(action, payload, apiUrl) {
+    const res = await fetch(`${apiUrl}/v1/controller/action`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ action, payload }),
+        signal: AbortSignal.timeout(20000),
+    });
+    const data = await res.json().catch(() => ({}));
+    return data.data || data;
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function execute(input) {
+    const { profile = 'xiaohongshu_fresh', unifiedApiUrl = 'http://127.0.0.1:7701', } = input;
+    console.log(`[Phase34CloseDetail] ESC 返回搜索页`);
+    // 系统 ESC 返回
+    await controllerAction('keyboard:press', {
+        profileId: profile,
+        key: 'Escape',
+    }, unifiedApiUrl);
+    // 等待导航完成
+    await delay(1500);
+    // 验证已返回搜索页
+    const finalUrl = await controllerAction('browser:execute', {
+        profile,
+        script: 'window.location.href'
+    }, unifiedApiUrl).then(res => res?.result || res?.data?.result || '');
+    const success = finalUrl.includes('/search_result');
+    console.log(`[Phase34CloseDetail] 完成: success=${success} url=${finalUrl}`);
+    return {
+        success,
+        finalUrl,
+    };
+}
+//# sourceMappingURL=Phase34CloseDetailBlock.js.map

package/dist/modules/xiaohongshu/app/src/xiaohongshu/app/src/blocks/Phase34CloseTabsBlock.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Phase 3-4 Block: 关闭所有打开的 Tab
+ *
+ * 职责：
+ * 1. 接收 Tab 列表
+ * 2. 循环调用 browser:close_page 关闭每个 Tab
+ * 3. 返回关闭结果
+ */
+export interface CloseTabsInput {
+    sessionId: string;
+    tabs?: Array<{
+        pageId?: number;
+    }>;
+    unifiedApiUrl?: string;
+}
+export interface CloseTabsOutput {
+    success: boolean;
+    closedCount: number;
+    failedCount: number;
+    errors?: Array<{
+        pageId?: number;
+        error: string;
+    }>;
+}
+export declare function execute(input: CloseTabsInput): Promise<CloseTabsOutput>;
+//# sourceMappingURL=Phase34CloseTabsBlock.d.ts.map

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

@@ -0,0 +1,44 @@
+/**
+ * Phase 3-4 Block: 关闭所有打开的 Tab
+ *
+ * 职责：
+ * 1. 接收 Tab 列表
+ * 2. 循环调用 browser:close_page 关闭每个 Tab
+ * 3. 返回关闭结果
+ */
+import { controllerAction } from '../utils/controllerAction.js';
+export async function execute(input) {
+    const { sessionId, tabs = [], unifiedApiUrl = 'http://127.0.0.1:7701' } = input;
+    console.log(`[Phase34CloseTabs] 关闭 ${tabs.length} 个 Tab`);
+    let closedCount = 0;
+    let failedCount = 0;
+    const errors = [];
+    for (const tab of tabs) {
+        if (!tab?.pageId) {
+            console.warn(`[Phase34CloseTabs] 跳过无效 Tab: ${JSON.stringify(tab)}`);
+            continue;
+        }
+        try {
+            await controllerAction('browser:close_page', {
+                profile: sessionId,
+                pageId: tab.pageId
+            }, unifiedApiUrl);
+            closedCount++;
+            console.log(`[Phase34CloseTabs] 已关闭 Tab pageId=${tab.pageId}`);
+        }
+        catch (err) {
+            failedCount++;
+            const errorMsg = err?.message || String(err);
+            errors.push({ pageId: tab.pageId, error: errorMsg });
+            console.warn(`[Phase34CloseTabs] 关闭失败 pageId=${tab.pageId}: ${errorMsg}`);
+        }
+    }
+    console.log(`[Phase34CloseTabs] 完成: 成功 ${closedCount}, 失败 ${failedCount}`);
+    return {
+        success: failedCount === 0,
+        closedCount,
+        failedCount,
+        errors: errors.length > 0 ? errors : undefined
+    };
+}
+//# sourceMappingURL=Phase34CloseTabsBlock.js.map

package/dist/modules/xiaohongshu/app/src/xiaohongshu/app/src/blocks/Phase34CollectCommentsBlock.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Phase 3-4 Block: 采集评论
+ *
+ * 职责：
+ * 1. 展开评论区（系统级点击 comment_button）
+ * 2. 批量采集可见评论（comment_item extract）
+ * 3. 点击“展开更多”+评论区滚动加载
+ * 4. 返回去重后的评论数组
+ */
+export interface CollectCommentsInput {
+    sessionId?: string;
+    unifiedApiUrl?: string;
+    maxRounds?: number;
+    batchSize?: number;
+}
+export interface CollectCommentsOutput {
+    success: boolean;
+    comments: Array<{
+        userName: string;
+        userId: string;
+        content: string;
+        time: string;
+        likeCount: number;
+    }>;
+    totalCollected: number;
+    error?: string;
+}
+export declare function execute(input: CollectCommentsInput): Promise<CollectCommentsOutput>;
+//# sourceMappingURL=Phase34CollectCommentsBlock.d.ts.map

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

@@ -0,0 +1,150 @@
+/**
+ * Phase 3-4 Block: 采集评论
+ *
+ * 职责：
+ * 1. 展开评论区（系统级点击 comment_button）
+ * 2. 批量采集可见评论（comment_item extract）
+ * 3. 点击“展开更多”+评论区滚动加载
+ * 4. 返回去重后的评论数组
+ */
+import { ensureCommentsOpened, extractVisibleComments, isCommentEnd, scrollComments, expandAllVisibleReplyButtons, } from './helpers/xhsComments.js';
+import { controllerAction, delay } from '../utils/controllerAction.js';
+async function isCommentEmpty(sessionId, apiUrl) {
+    const res = await controllerAction('container:operation', {
+        containerId: 'xiaohongshu_detail.comment_section.empty_state',
+        operationId: 'extract',
+        sessionId,
+        config: { max_items: 1, visibleOnly: true },
+    }, apiUrl).catch(() => null);
+    const extracted = Array.isArray(res?.extracted) ? res.extracted : [];
+    return extracted.length > 0;
+}
+function toNormalizedComment(item) {
+    return {
+        userName: String(item.user_name || ''),
+        userId: String(item.user_id || ''),
+        content: String(item.text || '').replace(/\s+/g, ' ').trim(),
+        time: String(item.timestamp || ''),
+        likeCount: 0,
+    };
+}
+export async function execute(input) {
+    const { sessionId = 'xiaohongshu_fresh', unifiedApiUrl = 'http://127.0.0.1:7701', maxRounds = 0, batchSize = 0, } = input;
+    const roundLimit = Number.isFinite(Number(maxRounds)) && Number(maxRounds) > 0
+        ? Math.floor(Number(maxRounds))
+        : Number.POSITIVE_INFINITY;
+    const batchLimit = Number.isFinite(Number(batchSize)) && Number(batchSize) > 0
+        ? Math.floor(Number(batchSize))
+        : Number.POSITIVE_INFINITY;
+    console.log(`[Phase34CollectComments] 开始采集评论 (batchSize=${Number.isFinite(batchLimit) ? batchLimit : 'unlimited'}, maxRounds=${Number.isFinite(roundLimit) ? roundLimit : 'unlimited'})`);
+    const allComments = [];
+    const seen = new Set();
+    let round = 0;
+    let noNewCount = 0;
+    let expandNoClickStreak = 0;
+    const MAX_NO_NEW = 3;
+    // 1) 展开评论区（允许已展开/无按钮时继续尝试 extract）
+    try {
+        await ensureCommentsOpened(sessionId, unifiedApiUrl);
+    }
+    catch (err) {
+        console.warn(`[Phase34CollectComments] 评论区展开异常: ${err?.message || String(err)}`);
+    }
+    await delay(800);
+    while (round < roundLimit) {
+        round += 1;
+        const empty = await isCommentEmpty(sessionId, unifiedApiUrl);
+        if (empty) {
+            console.log('[Phase34CollectComments] 评论区空状态，停止采集');
+            break;
+        }
+        const expandNow = await expandAllVisibleReplyButtons(sessionId, unifiedApiUrl, {
+            maxPasses: 6,
+            maxClicksPerPass: 12,
+        }).catch(() => ({ clicked: 0, passes: 0, remaining: 0, detected: 0 }));
+        if (expandNow.clicked > 0 || expandNow.remaining > 0) {
+            console.log(`[Phase34CollectComments] Round ${round}: 先展开可见回复 clicked=${expandNow.clicked} remaining=${expandNow.remaining}`);
+            await delay(320);
+        }
+        const remaining = Number.isFinite(batchLimit)
+            ? Math.max(1, batchLimit - allComments.length)
+            : 200;
+        const visible = await extractVisibleComments(sessionId, unifiedApiUrl, Math.min(200, remaining));
+        const prev = allComments.length;
+        for (const item of visible) {
+            const normalized = toNormalizedComment(item);
+            if (!normalized.content)
+                continue;
+            const key = `${normalized.userId}:${normalized.content}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            allComments.push(normalized);
+        }
+        const newCount = allComments.length - prev;
+        console.log(`[Phase34CollectComments] Round ${round}: 可见${visible.length} 新增${newCount} 总计${allComments.length}`);
+        if (newCount > 0) {
+            noNewCount = 0;
+        }
+        else {
+            noNewCount += 1;
+            console.log(`[Phase34CollectComments] 无新评论计数: ${noNewCount}/${MAX_NO_NEW}`);
+        }
+        if (Number.isFinite(batchLimit) && allComments.length >= batchLimit) {
+            console.log(`[Phase34CollectComments] 已达到批次大小 ${batchLimit}，停止采集`);
+            break;
+        }
+        const endReached = await isCommentEnd(sessionId, unifiedApiUrl).catch(() => false);
+        if (endReached) {
+            console.log('[Phase34CollectComments] 检测到评论区底部，停止采集');
+            break;
+        }
+        if (noNewCount >= MAX_NO_NEW) {
+            console.log(`[Phase34CollectComments] 连续 ${MAX_NO_NEW} 轮无新增，停止采集`);
+            break;
+        }
+        // 滚动前先把视口内“展开回复”按钮点完，再决定是否滚动。
+        const expandBeforeScroll = await expandAllVisibleReplyButtons(sessionId, unifiedApiUrl, {
+            maxPasses: 8,
+            maxClicksPerPass: 15,
+        }).catch(() => ({ clicked: 0, passes: 0, remaining: 0, detected: 0 }));
+        if (expandBeforeScroll.clicked > 0) {
+            expandNoClickStreak = 0;
+            console.log(`[Phase34CollectComments] Round ${round}: 滚动前展开 clicked=${expandBeforeScroll.clicked} remaining=${expandBeforeScroll.remaining}，先重采当前视口`);
+            await delay(420);
+            continue;
+        }
+        if (expandBeforeScroll.remaining > 0) {
+            expandNoClickStreak += 1;
+            console.log(`[Phase34CollectComments] Round ${round}: 检测到 remaining=${expandBeforeScroll.remaining} 但点击为0 (streak=${expandNoClickStreak})`);
+            if (expandNoClickStreak < 2) {
+                await delay(420);
+                continue;
+            }
+            console.log('[Phase34CollectComments] 展开按钮无法点击，强制执行滚动以避免卡住');
+        }
+        else {
+            expandNoClickStreak = 0;
+        }
+        let scrolled = null;
+        try {
+            console.log(`[Phase34CollectComments] Round ${round}: 无可展开按钮，执行滚动`);
+            scrolled = await scrollComments(sessionId, unifiedApiUrl, 650);
+        }
+        catch {
+            scrolled = null;
+        }
+        if (scrolled?.success === false) {
+            console.log('[Phase34CollectComments] 评论区滚动失败，停止采集');
+            break;
+        }
+        await delay(900);
+    }
+    console.log(`[Phase34CollectComments] 完成，共采集 ${allComments.length} 条评论`);
+    return {
+        success: true,
+        comments: allComments,
+        totalCollected: allComments.length,
+    };
+}
+//# sourceMappingURL=Phase34CollectCommentsBlock.js.map

package/dist/modules/xiaohongshu/app/src/xiaohongshu/app/src/blocks/Phase34ExtractDetailBlock.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Phase 3-4 Block: 提取详情内容
+ *
+ * 职责：
+ * 1. 容器匹配详情页内容区域
+ * 2. 高亮验证内容可见
+ * 3. 容器操作提取标题、正文、作者、图片
+ * 4. 返回结构化数据 + anchor
+ */
+export interface ExtractDetailInput {
+    noteId: string;
+    profile?: string;
+    unifiedApiUrl?: string;
+}
+export interface ExtractDetailOutput {
+    success: boolean;
+    noteId: string;
+    detail?: {
+        title: string;
+        content: string;
+        authorName: string;
+        authorId: string;
+        publishTime: string;
+        images: string[];
+    };
+    anchor?: {
+        containerId: string;
+        rect: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    };
+    error?: string;
+}
+export declare function execute(input: ExtractDetailInput): Promise<ExtractDetailOutput>;
+//# sourceMappingURL=Phase34ExtractDetailBlock.d.ts.map

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

@@ -0,0 +1,117 @@
+/**
+ * Phase 3-4 Block: 提取详情内容
+ *
+ * 职责：
+ * 1. 容器匹配详情页内容区域
+ * 2. 高亮验证内容可见
+ * 3. 容器操作提取标题、正文、作者、图片
+ * 4. 返回结构化数据 + anchor
+ */
+async function controllerAction(action, payload, apiUrl) {
+    const res = await fetch(`${apiUrl}/v1/controller/action`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ action, payload }),
+        signal: AbortSignal.timeout(20000),
+    });
+    const data = await res.json().catch(() => ({}));
+    return data.data || data;
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function execute(input) {
+    const { noteId, profile = 'xiaohongshu_fresh', unifiedApiUrl = 'http://127.0.0.1:7701', } = input;
+    console.log(`[Phase34ExtractDetail] 提取详情: ${noteId}`);
+    // 1. 验证当前在详情页
+    const currentUrl = await controllerAction('browser:execute', {
+        profile,
+        script: 'window.location.href',
+    }, unifiedApiUrl).then(res => res?.result || res?.data?.result || '');
+    if (!currentUrl.includes(`/explore/${noteId}`)) {
+        return {
+            success: false,
+            noteId,
+            error: `当前不在详情页: ${currentUrl}`,
+        };
+    }
+    // 2. 容器匹配内容区域（以 container-library 为准）
+    const contentContainerId = 'xiaohongshu_detail.content';
+    const headerContainerId = 'xiaohongshu_detail.header';
+    const galleryContainerId = 'xiaohongshu_detail.gallery';
+    // 3. 高亮验证
+    const highlightResult = await controllerAction('container:operation', {
+        containerId: contentContainerId,
+        operationId: 'highlight',
+        sessionId: profile,
+    }, unifiedApiUrl);
+    if (!highlightResult?.success) {
+        return {
+            success: false,
+            noteId,
+            error: `内容区域不可用: ${contentContainerId}`,
+        };
+    }
+    await delay(500);
+    // 4. 提取正文（包含 title/text）
+    const contentResult = await controllerAction('container:operation', {
+        containerId: contentContainerId,
+        operationId: 'extract',
+        sessionId: profile,
+        config: { fields: ['title', 'text'] },
+    }, unifiedApiUrl).catch(() => null);
+    const contentRow = Array.isArray(contentResult?.extracted) ? contentResult.extracted[0] : (contentResult?.data?.extracted?.[0] ?? null);
+    const title = String(contentRow?.title || '');
+    const content = String(contentRow?.text || '');
+    // 5. 提取作者
+    const headerResult = await controllerAction('container:operation', {
+        containerId: headerContainerId,
+        operationId: 'extract',
+        sessionId: profile,
+        config: { fields: ['author_name', 'author_link'] },
+    }, unifiedApiUrl).catch(() => null);
+    const headerRow = Array.isArray(headerResult?.extracted) ? headerResult.extracted[0] : (headerResult?.data?.extracted?.[0] ?? null);
+    const authorName = String(headerRow?.author_name || '');
+    const authorLink = String(headerRow?.author_link || '');
+    let authorId = '';
+    try {
+        if (authorLink) {
+            const u = new URL(authorLink, 'https://www.xiaohongshu.com');
+            authorId = u.pathname.split('/').filter(Boolean).slice(-1)[0] || '';
+        }
+    }
+    catch {
+        authorId = '';
+    }
+    // 6. 提取图片
+    const galleryResult = await controllerAction('container:operation', {
+        containerId: galleryContainerId,
+        operationId: 'extract',
+        sessionId: profile,
+        config: { fields: ['images'] },
+    }, unifiedApiUrl).catch(() => null);
+    const galleryRow = Array.isArray(galleryResult?.extracted)
+        ? galleryResult.extracted[0]
+        : (galleryResult?.data?.extracted?.[0] ?? null);
+    const images = Array.isArray(galleryRow?.images) ? galleryRow.images : (galleryRow?.images ? [galleryRow.images] : []);
+    // 8. 获取 anchor（用于调试）
+    const rect = highlightResult?.anchor?.rect || highlightResult?.rect;
+    console.log(`[Phase34ExtractDetail] ✅ 提取完成: 标题="${title.slice(0, 20)}..." 图片=${images.length}张`);
+    return {
+        success: true,
+        noteId,
+        detail: {
+            title,
+            content,
+            authorName,
+            authorId,
+            publishTime: new Date().toISOString(),
+            images: Array.isArray(images) ? images : [images],
+        },
+        anchor: {
+            containerId: contentContainerId,
+            rect: rect || { x: 0, y: 0, width: 0, height: 0 },
+        },
+    };
+}
+//# sourceMappingURL=Phase34ExtractDetailBlock.js.map

package/dist/modules/xiaohongshu/app/src/xiaohongshu/app/src/blocks/Phase34OpenDetailBlock.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Phase 3-4 Block: 打开详情页
+ *
+ * 职责：
+ * 1. 使用 safeUrl 打开详情页（禁止构造 URL）
+ * 2. 等待页面加载完成
+ * 3. 高亮验证内容区域可见
+ */
+export interface OpenDetailInput {
+    noteId: string;
+    safeUrl: string;
+    profile?: string;
+    unifiedApiUrl?: string;
+}
+export interface OpenDetailOutput {
+    success: boolean;
+    noteId: string;
+    currentUrl: string;
+    anchor?: {
+        containerId: string;
+        rect: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    };
+}
+export declare function execute(input: OpenDetailInput): Promise<OpenDetailOutput>;
+//# sourceMappingURL=Phase34OpenDetailBlock.d.ts.map

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

@@ -0,0 +1,102 @@
+/**
+ * Phase 3-4 Block: 打开详情页
+ *
+ * 职责：
+ * 1. 使用 safeUrl 打开详情页（禁止构造 URL）
+ * 2. 等待页面加载完成
+ * 3. 高亮验证内容区域可见
+ */
+async function controllerAction(action, payload, apiUrl) {
+    const res = await fetch(`${apiUrl}/v1/controller/action`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ action, payload }),
+        signal: AbortSignal.timeout(30000),
+    });
+    const data = await res.json().catch(() => ({}));
+    return data.data || data;
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function getViewportHeight(profile, apiUrl) {
+    try {
+        const res = await controllerAction('browser:execute', {
+            profile,
+            script: 'window.innerHeight',
+        }, apiUrl);
+        const h = Number(res?.result || res?.data?.result || res?.data || 0);
+        return Number.isFinite(h) && h > 0 ? h : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+export async function execute(input) {
+    const { noteId, safeUrl, profile = 'xiaohongshu_fresh', unifiedApiUrl = 'http://127.0.0.1:7701', } = input;
+    console.log(`[Phase34OpenDetail] 打开详情页: ${noteId}`);
+    // 1. 校验 safeUrl 包含 xsec_token
+    if (!safeUrl.includes('xsec_token')) {
+        throw new Error(`[Phase34OpenDetail] safeUrl 缺少 xsec_token: ${safeUrl}`);
+    }
+    // 2. 使用 browser:goto 导航到详情页
+    const gotoResult = await controllerAction('browser:goto', {
+        profile,
+        url: safeUrl,
+    }, unifiedApiUrl);
+    // controllerAction 返回形态可能是：
+    // - { ok: true }
+    // - { success: true, data: { ok: true } }
+    // - { success: false, error: ... }
+    // 这里把 browser-service 的底层错误透传出来，避免 “unknown” 无法诊断。
+    const okFlag = gotoResult?.ok === true ||
+        gotoResult?.data?.ok === true ||
+        gotoResult?.success === true;
+    const gotoOk = Boolean(okFlag);
+    if (!gotoOk) {
+        const detail = gotoResult?.data?.error || gotoResult?.error || JSON.stringify(gotoResult);
+        throw new Error(`[Phase34OpenDetail] 导航失败: ${detail}`);
+    }
+    // 3. 等待页面加载完成
+    await delay(3000);
+    // 4. 验证当前 URL 匹配 noteId
+    const currentUrl = await controllerAction('browser:execute', {
+        profile,
+        script: 'window.location.href',
+    }, unifiedApiUrl).then(res => res?.result || res?.data?.result || '');
+    if (!currentUrl.includes(noteId)) {
+        throw new Error(`[Phase34OpenDetail] URL 不匹配，期望 ${noteId}，实际 ${currentUrl}`);
+    }
+    // 5. 高亮验证内容区域可见
+    // 容器命名以 container-library 为准：详情正文容器为 xiaohongshu_detail.content。
+    const highlightResult = await controllerAction('container:operation', {
+        containerId: 'xiaohongshu_detail.content',
+        operationId: 'highlight',
+        sessionId: profile,
+    }, unifiedApiUrl);
+    if (highlightResult?.success === false) {
+        throw new Error(`[Phase34OpenDetail] 内容区域不可见: xiaohongshu_detail.content`);
+    }
+    // 6. 视口保护：只做“可见性/有尺寸”校验，不强制要求完全在视口内。
+    // 说明：在 Camoufox + 多窗口情况下，window.innerHeight 可能固定较小（如 707），
+    // 但页面仍可正常交互。强制 in-viewport 会导致误判并中断。
+    const rect = highlightResult?.anchor?.rect || highlightResult?.rect;
+    if (rect) {
+        const width = Number(rect.width ?? (rect.x2 - rect.x1));
+        const height = Number(rect.height ?? (rect.y2 - rect.y1));
+        if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) {
+            throw new Error(`[Phase34OpenDetail] 内容区域 rect 无效: ${JSON.stringify(rect)}`);
+        }
+        const viewportHeightRaw = await getViewportHeight(profile, unifiedApiUrl);
+        console.log(`[Phase34OpenDetail] rect ok (w=${width}, h=${height}), viewportHeight=${viewportHeightRaw}`);
+    }
+    await delay(500);
+    console.log(`[Phase34OpenDetail] ✅ 详情页加载完成: ${noteId}`);
+    return {
+        success: true,
+        noteId,
+        currentUrl,
+        anchor: highlightResult?.anchor,
+    };
+}
+//# sourceMappingURL=Phase34OpenDetailBlock.js.map

package/dist/modules/xiaohongshu/app/src/xiaohongshu/app/src/blocks/Phase34OpenTabsBlock.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Phase 3-4 Block: 确保固定 Tab 池（5 个：0=搜索页, 1-4=帖子详情页）
+ *
+ * 职责：
+ * 1. 检查当前 tab 数量，若不足 5 个则补齐到 5 个
+ * 2. 返回固定 tab 池索引 [0, 1, 2, 3, 4]（0 保留给搜索页，1-4 用于帖子轮转）
+ * 3. 确保后续轮转使用固定 tab，不再开新 tab
+ */
+export interface OpenTabsInput {
+    profile?: string;
+    tabCount?: number;
+    unifiedApiUrl?: string;
+}
+export interface TabInfo {
+    index: number;
+    pageId?: number;
+}
+export interface OpenTabsOutput {
+    tabs: TabInfo[];
+    currentTab: number;
+}
+export declare function execute(input: OpenTabsInput): Promise<OpenTabsOutput>;
+//# sourceMappingURL=Phase34OpenTabsBlock.d.ts.map