@web-auto/webauto 0.1.3 → 0.1.6

package/dist/modules/xiaohongshu/app/src/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/xiaohongshu/app/src/blocks/Phase34PersistDetailBlock.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Phase 3-4 Block: 持久化详情内容
+ *
+ * 职责：
+ * - 创建目录：~/.webauto/download/xiaohongshu/{env}/{keyword}/{noteId}/
+ * - 下载图片到 images/ 目录
+ * - 生成 README.md（含相对路径引用）
+ */
+export interface PersistDetailInput {
+    noteId: string;
+    detail: {
+        title?: string;
+        content?: string;
+        authorName?: string;
+        authorId?: string;
+        publishTime?: string;
+        images?: string[];
+    };
+    keyword: string;
+    env?: string;
+    unifiedApiUrl?: string;
+}
+export interface PersistDetailOutput {
+    success: boolean;
+    noteDir: string;
+    readmePath: string;
+    imagesDir: string;
+    imageCount: number;
+    error?: string;
+}
+export declare function execute(input: PersistDetailInput): Promise<PersistDetailOutput>;
+//# sourceMappingURL=Phase34PersistDetailBlock.d.ts.map

package/dist/modules/xiaohongshu/app/src/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

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

@@ -0,0 +1,35 @@
+/**
+ * Phase 3-4 Block: 处理单条笔记（详情 + 评论）
+ *
+ * 职责：
+ * - 打开详情页（使用 safeUrl）
+ * - 提取详情内容
+ * - 采集评论（支持分批）
+ * - 持久化结果
+ * - 返回搜索页
+ */
+export interface ProcessSingleNoteInput {
+    noteId: string;
+    safeUrl: string;
+    searchUrl: string;
+    keyword: string;
+    env?: string;
+    profile?: string;
+    unifiedApiUrl?: string;
+    maxCommentRounds?: number;
+    commentBatchSize?: number;
+    timeoutMs?: number;
+    maxRetries?: number;
+}
+export interface ProcessSingleNoteOutput {
+    success: boolean;
+    noteId: string;
+    detail: any;
+    comments: any[];
+    noteDir?: string;
+    readmePath?: string;
+    error?: string;
+    retryCount?: number;
+}
+export declare function execute(input: ProcessSingleNoteInput): Promise<ProcessSingleNoteOutput>;
+//# sourceMappingURL=Phase34ProcessSingleNoteBlock.d.ts.map

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

@@ -0,0 +1,114 @@
+/**
+ * Phase 3-4 Block: 处理单条笔记（详情 + 评论）
+ *
+ * 职责：
+ * - 打开详情页（使用 safeUrl）
+ * - 提取详情内容
+ * - 采集评论（支持分批）
+ * - 持久化结果
+ * - 返回搜索页
+ */
+import { execute as openDetail } from './Phase34OpenDetailBlock.js';
+import { execute as extractDetail } from './Phase34ExtractDetailBlock.js';
+import { execute as collectComments } from './Phase34CollectCommentsBlock.js';
+import { execute as persistDetail } from './Phase34PersistDetailBlock.js';
+import { execute as closeDetail } from './Phase34CloseDetailBlock.js';
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function withTimeout(promise, timeoutMs, errorMessage) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const result = await Promise.race([
+            promise,
+            new Promise((_, reject) => {
+                controller.signal.addEventListener('abort', () => reject(new Error(errorMessage)));
+            })
+        ]);
+        clearTimeout(timer);
+        return result;
+    }
+    catch (err) {
+        clearTimeout(timer);
+        throw err;
+    }
+}
+export async function execute(input) {
+    const { noteId, safeUrl, searchUrl, keyword, env = 'download', profile = 'xiaohongshu_fresh', unifiedApiUrl = 'http://127.0.0.1:7701', maxCommentRounds = 50, commentBatchSize = 50, timeoutMs = 180000, maxRetries = 2, } = input;
+    console.log(`[Phase34ProcessSingleNote] 开始处理: ${noteId}`);
+    let retryCount = 0;
+    let lastError;
+    for (retryCount = 0; retryCount <= maxRetries; retryCount++) {
+        if (retryCount > 0) {
+            console.log(`[Phase34ProcessSingleNote] 重试 ${retryCount}/${maxRetries}: ${noteId}`);
+            await delay(2000);
+        }
+        try {
+            // 1. 打开详情页（带超时）
+            await withTimeout(openDetail({ noteId, safeUrl, profile, unifiedApiUrl }), 30000, '打开详情页超时');
+            // 2. 提取详情内容（带超时）
+            const detailResult = await withTimeout(extractDetail({ noteId, profile, unifiedApiUrl }), 30000, '提取详情超时');
+            if (!detailResult.success) {
+                throw new Error(`提取详情失败: ${detailResult.error || 'unknown'}`);
+            }
+            // 3. 采集评论（带超时）
+            const commentsResult = await withTimeout(collectComments({
+                sessionId: profile,
+                maxRounds: maxCommentRounds,
+                batchSize: commentBatchSize,
+                unifiedApiUrl,
+            }), timeoutMs, '采集评论超时');
+            // 4. 持久化详情（带超时）
+            const persistResult = await withTimeout(persistDetail({
+                noteId,
+                detail: detailResult.detail || {},
+                keyword,
+                env,
+                unifiedApiUrl,
+            }), 60000, '持久化详情超时');
+            // 5. 返回搜索页（无论成功失败都要返回）
+            try {
+                await closeDetail({ profile, unifiedApiUrl });
+                await delay(1000);
+            }
+            catch (err) {
+                console.warn(`[Phase34ProcessSingleNote] 返回搜索页失败: ${err.message}`);
+            }
+            console.log(`[Phase34ProcessSingleNote] ✅ 完成: ${noteId} (重试${retryCount}次)`);
+            return {
+                success: true,
+                noteId,
+                detail: detailResult.detail || null,
+                comments: commentsResult.comments,
+                noteDir: persistResult.noteDir,
+                readmePath: persistResult.readmePath,
+                retryCount,
+            };
+        }
+        catch (err) {
+            lastError = err.message;
+            console.error(`[Phase34ProcessSingleNote] ❌ 尝试${retryCount + 1}失败: ${noteId}`, err.message);
+            // 失败也要返回搜索页
+            try {
+                await closeDetail({ profile, unifiedApiUrl });
+                await delay(1000);
+            }
+            catch (closeErr) {
+                console.warn(`[Phase34ProcessSingleNote] 返回搜索页失败: ${closeErr.message}`);
+            }
+            if (retryCount >= maxRetries) {
+                break;
+            }
+        }
+    }
+    return {
+        success: false,
+        noteId,
+        detail: null,
+        comments: [],
+        error: lastError || '未知错误',
+        retryCount,
+    };
+}
+//# sourceMappingURL=Phase34ProcessSingleNoteBlock.js.map

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

@@ -0,0 +1,34 @@
+/**
+ * Phase 3-4 Block: 链接前置校验
+ *
+ * 职责：
+ * 1. 确认当前在搜索结果页
+ * 2. 读取 phase2-links.jsonl
+ * 3. 过滤有效链接（safeUrl 含 xsec_token）
+ */
+export interface ValidateLinksInput {
+    keyword: string;
+    env?: string;
+    linksPath?: string;
+    shardIndex?: number;
+    shardCount?: number;
+    shardBy?: 'noteId-hash' | 'index-mod';
+    maxNotes?: number;
+    profile?: string;
+    unifiedApiUrl?: string;
+}
+export interface ValidateLinksOutput {
+    success: boolean;
+    links: Array<{
+        noteId: string;
+        safeUrl: string;
+        searchUrl: string;
+        ts: string;
+    }>;
+    error?: string;
+    totalCount: number;
+    validCount: number;
+    currentUrl: string;
+}
+export declare function execute(input: ValidateLinksInput): Promise<ValidateLinksOutput>;
+//# sourceMappingURL=Phase34ValidateLinksBlock.d.ts.map

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

@@ -0,0 +1,90 @@
+/**
+ * Phase 3-4 Block: 链接前置校验
+ *
+ * 职责：
+ * 1. 确认当前在搜索结果页
+ * 2. 读取 phase2-links.jsonl
+ * 3. 过滤有效链接（safeUrl 含 xsec_token）
+ */
+import os from 'node:os';
+import path from 'node:path';
+import { normalizeShard, shardFilterByIndexMod, shardFilterByNoteIdHash, } from './helpers/sharding.js';
+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 readJsonl(filePath) {
+    const { readFile } = await import('node:fs/promises');
+    try {
+        const content = await readFile(filePath, 'utf8');
+        return content
+            .trim()
+            .split('\n')
+            .filter((line) => line.trim())
+            .map((line) => JSON.parse(line));
+    }
+    catch {
+        return [];
+    }
+}
+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');
+}
+export async function execute(input) {
+    const { keyword, env = 'debug', linksPath, shardIndex, shardCount, shardBy = 'noteId-hash', maxNotes, profile = 'xiaohongshu_fresh', unifiedApiUrl = 'http://127.0.0.1:7701', } = input;
+    console.log('[Phase34ValidateLinks] 开始校验链接...');
+    // Phase34 只依赖 phase2-links.jsonl，不依赖 .collect-state.json
+    // .collect-state.json 只是 phase2 内部重入状态管理
+    const currentUrl = await controllerAction('browser:execute', {
+        profile,
+        script: 'window.location.href',
+    }, unifiedApiUrl).then((res) => res?.result || res?.data?.result || '');
+    console.log(`[Phase34ValidateLinks] 当前页面: ${currentUrl}`);
+    // 读取 phase2-links.jsonl
+    const defaultPath = path.join(resolveDownloadRoot(), 'xiaohongshu', env, keyword, 'phase2-links.jsonl');
+    const targetPath = linksPath || defaultPath;
+    console.log(`[Phase34ValidateLinks] 读取链接文件: ${targetPath}`);
+    const allLinks = await readJsonl(targetPath);
+    if (allLinks.length === 0) {
+        console.warn('[Phase34ValidateLinks] 链接文件为空或不存在');
+    }
+    console.log(`[Phase34ValidateLinks] 总链接数: ${allLinks.length}`);
+    // 过滤有效链接：safeUrl 必须包含 xsec_token
+    const validLinks = allLinks.filter((item) => {
+        const hasToken = typeof item?.safeUrl === 'string' && item.safeUrl.includes('xsec_token');
+        return hasToken;
+    });
+    const cappedLimit = Number.isFinite(Number(maxNotes)) ? Math.max(1, Math.floor(Number(maxNotes))) : null;
+    const cappedLinks = cappedLimit ? validLinks.slice(0, cappedLimit) : validLinks;
+    const shard = normalizeShard({ index: shardIndex, count: shardCount, by: shardBy });
+    const sharded = shard
+        ? shard.by === 'index-mod'
+            ? shardFilterByIndexMod(cappedLinks, shard)
+            : shardFilterByNoteIdHash(cappedLinks, shard)
+        : cappedLinks;
+    console.log(`[Phase34ValidateLinks] 有效链接数: ${validLinks.length}`);
+    if (cappedLimit) {
+        console.log(`[Phase34ValidateLinks] 全局上限: ${cappedLimit} -> ${cappedLinks.length} 条`);
+    }
+    if (shard) {
+        console.log(`[Phase34ValidateLinks] Shard(${shard.by}): ${shard.index}/${shard.count} -> ${sharded.length} 条`);
+    }
+    return {
+        success: true,
+        links: sharded,
+        totalCount: allLinks.length,
+        validCount: sharded.length,
+        currentUrl,
+    };
+}
+//# sourceMappingURL=Phase34ValidateLinksBlock.js.map

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

@@ -0,0 +1,111 @@
+/**
+ * Phase 3 Block: 闂備浇宕垫慨鏉懨洪妶鍥ｅ亾濮樼厧鐏︽い銏＄懇楠炲鎮欏▓鎸庨敜闂備礁婀遍崕銈夊垂娴ｅ喚鏉介梻鍌欑劍鐎笛呯矙閹存繐鑰挎繛鎾次焑ract闂?
+ *
+ * 闂傚倷鑳堕崢褍鐣烽鍕剹濞撴埃鍋撻柟顖氳嫰铻栭柛娑卞枟濞?
+ * - 闂傚倷鑳堕幊鎾绘倶濮樿泛绠伴柛婵勫劜椤洟鏌熺€电校闁哄棙绮撻弻鈥崇暤椤斿吋鍣洪柟灞傚€濋弻锝夋偐閸欏銈梻鍌氬鐎氭澘鐣烽弴锛勭杸闁哄倽顔婄花鑽ょ磼閻愵剚绶叉い锕佷含缁牓宕滈崫绔慹Url闂傚倷鐒︾€笛呯矙閹达附鍤愭い鏍ㄧ矋瀹曟煡鏌嶈閸撴瑩鈥旈崘顔嘉ч柛顐亜濞堫參姊?xsec_token闂?
+ * - 闂備浇顕х换鎺楀磻閻愯娲冀椤愶綆娼熼梺鐟邦嚟婵數鈧碍宀搁弻娑㈠即閵娿儲鐝梺鍝ュ枎閻楁捇寮?
+ * - 濠电姷鏁告慨鎾晝閵夆晜鍤岄柣鎰靛墯閸欏繘鏌嶉崫鍕殲閻庢碍宀搁弻娑㈠即閵娿儲鐝梺鍝ュ枎閻楁捇寮诲☉銏犲唨妞ゆ劑鍨诲▓銈囩磽娴ｄ粙鍝虹紒璇插閸掓帡妫冨☉鎺擃潔闂佸啿鐏堥弲娑欑閹岀唵閻犺櫣灏ㄥ銉╂煟閿曗偓閻栧ジ寮诲☉姗嗘僵闁绘挸绨肩花濠氭⒑閸涘浼曢柛銉ｅ妿閸欏棗顪冮妶鍡橆梿闁稿鍔欓獮妤呮偄閸忚偐鍘介梺闈涱焾閸庨亶顢旈鍕厽闁挎洍鍋撴繛瀵稿厴楠?
+ * - 婵犲痉鏉库偓鏇㈠磹閸︻厽绠掗梺璇查閻忔氨鏁敓鐘茬畺婵炲棙鍨堕崗婊堟煕濞戝崬鐏辨繛绮瑰亾闂傚倷绀佸﹢閬嶁€﹂崼銉嬪洭鎮界粙璺唶闂佺懓澧庨弲顐㈢暤娓氣偓閺屾盯骞橀懠顒夋М婵炲濯崹鍫曞蓟濞戙垹绠ｉ柨婵嗘噹閹偤姊虹粙娆惧劀缂佹彃娼￠獮?
+ * - 闂傚倷娴囬～澶愬箚鐏炲墽顩叉繝濠傚幘閻熼偊娼ㄩ柍褜鍓熼獮蹇涘礃椤旇棄浠奸柣蹇曞仜婢т粙鏁嶅鈧鍝劽虹紒妯衡枏闂佸憡鏌ㄩ鍥嚍闁稁鏁嗗〒姘处椤旀棃鎮楅崗澶婁壕闂佸憡鍔︽禍婵嬶綖瀹ュ鈷戦柟绋挎捣閳藉鏌ｅΔ浣瑰磳闁诡喚鏁婚、娆撴偩瀹€濠冮敜婵＄偑鍊栧濠氬储瑜旇矾?闂傚倷鑳剁划顖炲礉濡ゅ懌鈧焦绻濋崟顓犵効闂佸湱澧楀妯兼喆閿曞倸绠归柟纰卞幖閻忥絿绱掗埀?
+ */
+export interface InteractRoundStats {
+    round: number;
+    visible: number;
+    harvestedNew: number;
+    harvestedTotal: number;
+    ruleHits: number;
+    hitTotal?: number;
+    skippedTotal?: number;
+    likedTotalActual?: number;
+    hitCheckOk?: boolean;
+    gateBlocked: number;
+    dedupSkipped: number;
+    alreadyLikedSkipped: number;
+    notVisibleSkipped: number;
+    nestedParentSkipped?: number;
+    clickFailed: number;
+    verifyFailed: number;
+    newLikes: number;
+    likedTotal: number;
+    reachedBottom: boolean;
+    endReason?: string;
+    ms: number;
+}
+export interface InteractInput {
+    sessionId: string;
+    noteId: string;
+    safeUrl: string;
+    likeKeywords: string[];
+    maxLikesPerRound?: number;
+    dryRun?: boolean;
+    unifiedApiUrl?: string;
+    keyword?: string;
+    env?: string;
+    reuseCurrentDetail?: boolean;
+    commentsAlreadyOpened?: boolean;
+    collectComments?: boolean;
+    persistCollectedComments?: boolean;
+    commentsFilePath?: string;
+    evidenceDir?: string;
+    onRound?: (stats: InteractRoundStats) => void;
+}
+export interface InteractOutput {
+    success: boolean;
+    noteId: string;
+    likedCount: number;
+    scannedCount: number;
+    hitCount?: number;
+    skippedCount?: number;
+    likedTotal?: number;
+    hitCheckOk?: boolean;
+    mismatchEvidence?: {
+        postScreenshot?: string | null;
+    };
+    errorEvidence?: {
+        screenshot?: string | null;
+    };
+    likedComments: Array<{
+        index: number;
+        userId: string;
+        userName: string;
+        content: string;
+        timestamp: string;
+        screenshots?: {
+            before?: string | null;
+            after?: string | null;
+        };
+        matchedRule?: string;
+    }>;
+    commentsAdded?: number;
+    commentsTotal?: number;
+    commentsPath?: string;
+    evidenceDir?: string;
+    dedupSkipped?: number;
+    alreadyLikedSkipped?: number;
+    reachedBottom: boolean;
+    stopReason?: string;
+    error?: string;
+}
+export type LikeRule = {
+    kind: 'contains';
+    include: string;
+    raw: string;
+} | {
+    kind: 'and';
+    includeA: string;
+    includeB: string;
+    raw: string;
+} | {
+    kind: 'include_without';
+    include: string;
+    exclude: string;
+    raw: string;
+};
+export declare function compileLikeRules(likeKeywords: string[]): LikeRule[];
+export declare function matchLikeText(textRaw: string, rules: LikeRule[]): {
+    ok: boolean;
+    reason: string;
+    matchedRule?: string;
+};
+export declare function execute(input: InteractInput): Promise<InteractOutput>;
+//# sourceMappingURL=Phase3InteractBlock.d.ts.map