@web-auto/webauto 0.1.1 → 0.1.2

package/dist/modules/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/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/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/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/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/blocks/Phase34OpenTabsBlock.js

@@ -0,0 +1,109 @@
+/**
+ * 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
+ */
+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;
+}
+async function listPages(profile, apiUrl) {
+    const res = await controllerAction('browser:page:list', { profileId: profile }, apiUrl);
+    if (res?.error) {
+        console.warn(`[Phase34OpenTabs] page:list error: ${res.error}`);
+    }
+    return res?.pages || res?.data?.pages || [];
+}
+async function getInputMode(apiUrl) {
+    const res = await controllerAction('system:input-mode:get', {}, apiUrl).catch(() => null);
+    const mode = String(res?.data?.mode || res?.mode || 'system').trim().toLowerCase();
+    return mode === 'protocol' ? 'protocol' : 'system';
+}
+async function openTab(profile, apiUrl, inputMode) {
+    const maxRetries = 4;
+    for (let attempt = 1; attempt <= maxRetries; attempt += 1) {
+        const before = await listPages(profile, apiUrl);
+        const beforeCount = before.length;
+        const tryCountIncrease = async (waitMs = 450) => {
+            await new Promise((r) => setTimeout(r, waitMs));
+            const after = await listPages(profile, apiUrl);
+            return after.length > beforeCount;
+        };
+        if (inputMode === 'protocol') {
+            await controllerAction('browser:page:new', { profileId: profile }, apiUrl).catch(() => null);
+            if (await tryCountIncrease(350))
+                return;
+            await controllerAction('browser:execute', { profile, script: 'window.open("about:blank", "_blank"); true;' }, apiUrl).catch(() => null);
+            if (await tryCountIncrease(350))
+                return;
+            await controllerAction('browser:page:switch', { profileId: profile, index: 0 }, apiUrl).catch(() => null);
+            await controllerAction('system:shortcut', { app: 'camoufox', shortcut: 'new-tab' }, apiUrl).catch(() => null);
+            if (await tryCountIncrease(500)) {
+                console.log('[Phase34OpenTabs] protocol fallback -> system shortcut succeeded');
+                return;
+            }
+        }
+        else {
+            await controllerAction('browser:page:switch', { profileId: profile, index: 0 }, apiUrl).catch(() => null);
+            await controllerAction('system:shortcut', { app: 'camoufox', shortcut: 'new-tab' }, apiUrl).catch(() => null);
+            if (await tryCountIncrease(500))
+                return;
+        }
+        console.warn(`[Phase34OpenTabs] ${inputMode} open-tab attempt ${attempt}/${maxRetries} failed (count=${beforeCount})`);
+    }
+    throw new Error('open_tab_failed_after_retries');
+}
+export async function execute(input) {
+    const { profile = 'xiaohongshu_fresh', tabCount = 4, unifiedApiUrl = 'http://127.0.0.1:7701', } = input;
+    const requiredTotal = tabCount + 1; // tab0=搜索页 + tab1~4=帖子页
+    console.log(`[Phase34OpenTabs] 确保固定 tab 池: ${requiredTotal} 个 (0=搜索页, 1-${tabCount}=帖子页)`);
+    const inputMode = await getInputMode(unifiedApiUrl);
+    console.log(`[Phase34OpenTabs] input mode: ${inputMode}`);
+    let existing = await listPages(profile, unifiedApiUrl);
+    if (!existing.length) {
+        console.log('[Phase34OpenTabs] 未检测到 session，尝试创建会话');
+        await controllerAction('session:create', { profile, url: 'https://www.xiaohongshu.com' }, unifiedApiUrl);
+        await new Promise(r => setTimeout(r, 800));
+        existing = await listPages(profile, unifiedApiUrl);
+    }
+    const currentCount = existing.length;
+    console.log(`[Phase34OpenTabs] 当前已有 ${currentCount} 个 tab`);
+    const needed = Math.max(0, requiredTotal - currentCount);
+    if (needed > 0) {
+        console.log(`[Phase34OpenTabs] 需要补齐 ${needed} 个 tab`);
+        for (let i = 0; i < needed; i++) {
+            await openTab(profile, unifiedApiUrl, inputMode);
+            console.log(`[Phase34OpenTabs] 新 tab ${currentCount + i + 1} 已打开`);
+        }
+    }
+    else {
+        console.log(`[Phase34OpenTabs] tab 数量已满足，无需新开`);
+    }
+    // 验证最终 tab 池
+    const finalPages = await listPages(profile, unifiedApiUrl);
+    console.log(`[Phase34OpenTabs] 最终 tab 池: ${finalPages.length} 个`);
+    finalPages.forEach((p, i) => {
+        const role = i === 0 ? '(搜索页)' : `(帖子页-${i})`;
+        console.log(`  [${i}] index=${p.index} ${role} url=${p.url?.substring(0, 60)}`);
+    });
+    // 返回固定 tab 索引池（跳过 tab0，返回 tab1~4）
+    const tabs = finalPages.slice(1, requiredTotal).map((p) => ({
+        index: p.index,
+        pageId: undefined,
+    }));
+    console.log(`[Phase34OpenTabs] 固定帖子页 tab 索引: [${tabs.map(t => t.index).join(', ')}]`);
+    return {
+        tabs,
+        currentTab: 0,
+    };
+}
+//# sourceMappingURL=Phase34OpenTabsBlock.js.map

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

@@ -0,0 +1,117 @@
+/**
+ * Phase 3-4 Block: 持久化详情内容
+ *
+ * 职责：
+ * - 创建目录：~/.webauto/download/xiaohongshu/{env}/{keyword}/{noteId}/
+ * - 下载图片到 images/ 目录
+ * - 生成 README.md（含相对路径引用）
+ */
+import { promises as fs } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+function resolveDownloadRoot() {
+    const custom = process.env.WEBAUTO_DOWNLOAD_ROOT || process.env.WEBAUTO_DOWNLOAD_DIR;
+    if (custom && custom.trim())
+        return custom;
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    return path.join(home, '.webauto', 'download');
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function ensureDir(dir) {
+    await fs.mkdir(dir, { recursive: true });
+}
+async function downloadImage(url, destPath, timeout = 30000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}`);
+        }
+        const buffer = Buffer.from(await response.arrayBuffer());
+        await fs.writeFile(destPath, buffer);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function getFileExtension(url) {
+    const match = url.match(/\\.([a-z0-9]+)(?:\\?|$)/i);
+    return match ? `.${match[1].toLowerCase()}` : '.jpg';
+}
+export async function execute(input) {
+    const { noteId, detail, keyword, env = 'download', unifiedApiUrl = 'http://127.0.0.1:7701', } = input;
+    console.log(`[Phase34PersistDetail] 持久化: ${noteId}`);
+    try {
+        // 1. 创建目录结构
+        const baseDir = path.join(resolveDownloadRoot(), 'xiaohongshu', env, keyword, noteId);
+        const imagesDir = path.join(baseDir, 'images');
+        const readmePath = path.join(baseDir, 'README.md');
+        await ensureDir(baseDir);
+        await ensureDir(imagesDir);
+        // 2. 下载图片
+        const images = detail.images || [];
+        let downloadedCount = 0;
+        for (let i = 0; i < images.length; i++) {
+            try {
+                const imgUrl = images[i];
+                const ext = getFileExtension(imgUrl);
+                const destPath = path.join(imagesDir, `${i}${ext}`);
+                console.log(`[Phase34PersistDetail] 下载图片 ${i + 1}/${images.length}: ${imgUrl.slice(0, 60)}...`);
+                await downloadImage(imgUrl, destPath);
+                downloadedCount++;
+                // 避免请求过快
+                if (i < images.length - 1) {
+                    await delay(200);
+                }
+            }
+            catch (err) {
+                console.warn(`[Phase34PersistDetail] 图片下载失败 [${i}]: ${err.message}`);
+            }
+        }
+        // 3. 生成 README.md
+        const lines = [];
+        lines.push(`# ${detail.title || '无标题'}`);
+        lines.push('');
+        lines.push(`## 元数据`);
+        lines.push(`- **Note ID**: ${noteId}`);
+        lines.push(`- **作者**: ${detail.authorName || '未知'} (${detail.authorId || 'N/A'})`);
+        lines.push(`- **发布时间**: ${detail.publishTime || '未知'}`);
+        lines.push(`- **原始链接**: \`https://www.xiaohongshu.com/explore/${noteId}\``);
+        lines.push('');
+        lines.push(`## 正文`);
+        lines.push(detail.content || '无正文内容');
+        lines.push('');
+        if (downloadedCount > 0) {
+            lines.push(`## 图片 (${downloadedCount}张)`);
+            for (let i = 0; i < downloadedCount; i++) {
+                lines.push(`![图片${i + 1}](./images/${i}.jpg)`);
+            }
+            lines.push('');
+        }
+        const readmeContent = lines.join('\\n');
+        await fs.writeFile(readmePath, readmeContent, 'utf8');
+        console.log(`[Phase34PersistDetail] ✅ 持久化完成: ${baseDir}`);
+        return {
+            success: true,
+            noteDir: baseDir,
+            readmePath,
+            imagesDir,
+            imageCount: downloadedCount,
+        };
+    }
+    catch (err) {
+        console.error(`[Phase34PersistDetail] ❌ 失败: ${err.message}`);
+        return {
+            success: false,
+            noteDir: '',
+            readmePath: '',
+            imagesDir: '',
+            imageCount: 0,
+            error: err.message,
+        };
+    }
+}
+//# sourceMappingURL=Phase34PersistDetailBlock.js.map