@luoyi-dsh/instagram-scroll 1.0.1 → 1.0.6

package/dist/core/scrollDuty.js

@@ -8,76 +8,431 @@
  * ============================================================================
  */
 /**
- * 簡易而實用的評估與推薦語產生器
- * 結合貼文內文關鍵字權重、互動熱度與語意提示進行評分
+ * 正文解析與標籤分離器
+ * 徹底區分貼文真正的正文內容與文末堆砌的標籤 (防止標籤農場誤導)
  */
-function evaluatePost(post, config) {
-    const caption = (post.caption || '').toLowerCase();
-    const tags = config.interestTags || [];
-    let score = 50;
-    // 1. 關鍵字與標籤匹配加分
-    let hitTags = [];
-    for (const tag of tags) {
-        const clean = tag.replace(/^#/, '').toLowerCase().trim();
-        if (clean && caption.includes(clean)) {
-            hitTags.push(clean);
-            score += 12;
+export function parsePostContent(caption = '') {
+    const rawCaption = String(caption || '').trim();
+    // 提取所有 hashtag 與 mention
+    const hashtags = (rawCaption.match(/#[\p{L}\p{N}_]+/gu) || []).map((t) => t.slice(1).toLowerCase());
+    const mentions = (rawCaption.match(/@[\p{L}\p{N}._]+/gu) || []).map((m) => m.slice(1));
+    // 移除所有 #tag 與 @mention，整理出真正的正文文字
+    let cleanBody = rawCaption
+        .replace(/#[\p{L}\p{N}_]+/gu, ' ')
+        .replace(/@[\p{L}\p{N}._]+/gu, ' ')
+        .replace(/[ \t]+/g, ' ')
+        .replace(/\n\s*\n+/g, '\n')
+        .trim();
+    const cleanLength = cleanBody.length;
+    const tagCount = hashtags.length;
+    const tagCharLength = hashtags.reduce((acc, tag) => acc + tag.length, 0);
+    // 判定是否為標籤農場 (Hashtag Spam):
+    // 1. 標籤數量超過 12 個
+    // 2. 標籤總長度超越正文長度且正文字數小於 40 字
+    const isTagSpam = tagCount > 12 || (tagCount >= 6 && tagCharLength > cleanLength && cleanLength < 40);
+    return {
+        rawCaption,
+        cleanBody,
+        hashtags,
+        mentions,
+        tagCount,
+        tagCharLength,
+        cleanLength,
+        isTagSpam,
+    };
+}
+const AIGC_REJECT_KEYWORDS = [
+    'ai生成',
+    'ai 生成',
+    'ai影片',
+    'ai 影片',
+    'ai視頻',
+    'ai 視頻',
+    'ai動畫',
+    'ai 動畫',
+    'ai動漫',
+    'ai 動漫',
+    'ai繪圖',
+    'ai 繪圖',
+    'ai畫',
+    'ai繪畫',
+    'ai算圖',
+    'ai美女',
+    'ai模特',
+    'ai寫作',
+    'ai文章',
+    'ai生成文章',
+    'ai配音',
+    'ai翻唱',
+    'ai漫改',
+    'ai短劇',
+    'aigc',
+    'midjourney',
+    'stable diffusion',
+    'stablediffusion',
+    'comfyui',
+    'sora',
+    'runwayml',
+    'runway gen',
+    'kling ai',
+    'klingai',
+    '可靈',
+    '即夢',
+    'luma dream',
+    'lumalabs',
+    'pika art',
+    'pika labs',
+    'hailuo ai',
+    '海螺ai',
+    'suno ai',
+    'udio',
+    'ai art',
+    'aiart',
+    'aiartist',
+    'ai video',
+    'aivideo',
+    'ai animation',
+    'aianimation',
+    'ai generated',
+    'ai-generated',
+    'aigenerated',
+    'ai girl',
+    'aigirl',
+    'ai artwork',
+    'generated by ai',
+    'made with ai',
+    'created with ai',
+];
+function detectAigcPost(caption = '', username = '') {
+    const textLower = `${caption || ''} ${username || ''}`.toLowerCase();
+    for (const kw of AIGC_REJECT_KEYWORDS) {
+        if (kw && textLower.includes(kw.toLowerCase())) {
+            return kw;
         }
     }
-    // 2. 互動熱度與品質加分
-    const likes = post.like_count || 0;
-    const comments = post.comment_count || 0;
-    if (likes > 500)
-        score += 10;
-    else if (likes > 100)
-        score += 5;
-    if (comments > 20)
-        score += 8;
-    else if (comments > 5)
-        score += 4;
-    // 3. 內文長度加分（有原創詳細說明通常更具乾貨）
-    if (caption.length > 100)
-        score += 8;
-    // 4. 廣告或過濾詞扣分
-    const spamKeywords = ['互粉', '代購', '博彩', '運彩', '兼職', '抽獎', '免費領'];
-    for (const kw of spamKeywords) {
-        if (caption.includes(kw)) {
-            score -= 35;
-        }
-    }
-    score = Math.min(98, Math.max(20, score));
-    const isWorthy = score >= (config.minScore || 75);
-    let reason = '';
-    let commentText = '';
-    const master = (config.masterUsername || '').replace(/^@/, '').trim();
-    if (isWorthy) {
-        if (hitTags.length > 0) {
-            reason = `精準命中主人關注領域 [#${hitTags.join(', #')}]，內容高質且社群互動熱絡 (${likes} 讚, ${comments} 則留言)。`;
-            const hookPhrases = [
-                '這篇思路與案例很不錯，特別推薦你看一下！',
-                '發現這個很對你的胃口，覺得對你手邊專案很有幫助！',
-                '這篇乾貨滿滿，看到覺得不能錯過，推推！',
-                '這篇分析非常到位，特地 @ 你存起來參考！',
-            ];
-            const chosenHook = hookPhrases[Math.floor(Math.random() * hookPhrases.length)];
-            commentText = master ? `@${master} ${chosenHook}` : `這篇乾貨非常精彩，推薦關注！`;
+    const aigcTagRegex = /#(aiart|aivideo|aianimation|aigenerated|midjourney|stablediffusion|sora|runwayml|klingai|pikaart|aigirl|aigc|ai繪圖|ai動畫|ai影片|ai生成)/i;
+    const m = textLower.match(aigcTagRegex);
+    if (m)
+        return m[0];
+    return null;
+}
+/**
+ * 調用共享外部插件訂閱額度 (dsh-plugin-subscriptions / __DSH_INSTAGRAM_LLM__)、宿主 LLM 或自訂 API 進行深度語義內容審查
+ */
+async function callLlmInference(ctx, systemPrompt, userPrompt) {
+    // 0. 優先使用 dsh-instagram-plugin 共享的統一 LLM 引擎 (支援讀取 dsh-plugin-subscriptions 外部額度)
+    const sharedIgLlm = globalThis.__DSH_INSTAGRAM_LLM__;
+    if (sharedIgLlm && typeof sharedIgLlm.callLlmForInstagram === 'function') {
+        try {
+            const sharedCfg = globalThis.__DSH_INSTAGRAM_PLUGIN_CONFIG__ || {};
+            const res = await sharedIgLlm.callLlmForInstagram(ctx, sharedCfg, systemPrompt, userPrompt);
+            if (res && res.trim())
+                return res.trim();
         }
-        else {
-            reason = `熱門高讚貼文 (${likes} 讚)，討論熱烈，具備高參考價值。`;
-            commentText = master ? `@${master} 看到這篇討論很熱絡，分享給你看看！` : '推薦這篇精彩內容！';
+        catch (e) {
+            console.warn(`[ScrollDuty LLM] 共享訂閱 LLM 調用異常: ${e.message}`);
+        }
+    }
+    // 1. 嘗試 DSH 宿主注入的 LLM 服務
+    const llm = (typeof ctx?.get === 'function' ? ctx.get('llm') : null) || ctx?.llm;
+    if (llm) {
+        try {
+            if (typeof llm.chat === 'function') {
+                const res = await llm.chat({
+                    messages: [
+                        { role: 'system', content: systemPrompt },
+                        { role: 'user', content: userPrompt },
+                    ],
+                    temperature: 0.3,
+                });
+                const reply = res?.content || res?.text || (typeof res === 'string' ? res : '');
+                if (reply)
+                    return reply;
+            }
+            if (typeof llm.complete === 'function') {
+                const reply = await llm.complete(`${systemPrompt}\n\n${userPrompt}`);
+                if (reply)
+                    return reply;
+            }
+        }
+        catch (e) {
+            console.warn(`[ScrollDuty LLM] 宿主 ctx.llm 調用異常: ${e.message}`);
+        }
+    }
+    // 2. 檢查備援環境變數 (DeepSeek / OpenAI)
+    const apiKey = process.env.DEEPSEEK_API_KEY || process.env.OPENAI_API_KEY;
+    const baseUrl = process.env.DEEPSEEK_API_BASE || process.env.OPENAI_BASE_URL || 'https://api.deepseek.com';
+    if (apiKey) {
+        try {
+            const resp = await fetch(`${baseUrl}/chat/completions`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: process.env.DEEPSEEK_MODEL || 'deepseek-chat',
+                    messages: [
+                        { role: 'system', content: systemPrompt },
+                        { role: 'user', content: userPrompt },
+                    ],
+                    temperature: 0.3,
+                    response_format: { type: 'json_object' },
+                }),
+            });
+            if (resp.ok) {
+                const data = (await resp.json());
+                return data.choices?.[0]?.message?.content || null;
+            }
+        }
+        catch (err) {
+            console.warn(`[ScrollDuty LLM] 外部 API 調用異常: ${err.message}`);
+        }
+    }
+    return null;
+}
+/**
+ * 嚴密的高精度內容檢驗引擎 (Content Inspection Pipeline)
+ * 解決痛點：「不要隨便推薦、要依據用戶喜歡內容、@ 前要檢查貼文內容、不要只看 tag」
+ */
+export async function inspectAndEvaluatePost(ctx, post, config) {
+    const mcpSvc = globalThis.__DSH_INSTAGRAM_MCP__;
+    const master = (mcpSvc?.config?.masterUsername || config.masterUsername || '').replace(/^@/, '').trim();
+    const parsed = parsePostContent(post.caption || '');
+    const minScore = config.minScore || 80;
+    const minLength = config.minCaptionLength || 30;
+    const userInterests = config.userInterests ||
+        '專注於前沿 AI 技術、開源軟體、全端與前端架構、實用開發工具、優質 UI/UX 設計技巧或實用技術深度解析；喜愛實踐乾貨與原創見解。';
+    // === 第 1 關：正文實質內容字數檢驗 (拒絕無內文或純圖廢文) ===
+    if (parsed.cleanLength < minLength) {
+        return {
+            isWorthy: false,
+            score: 15,
+            reason: '',
+            rejectionReason: `正文有效字數不足 (${parsed.cleanLength} 字 < 門檻 ${minLength} 字)，資訊量過少無實質乾貨內容。`,
+            commentText: '',
+            reviewMethod: 'heuristic',
+        };
+    }
+    // === 第 2 關：標籤農場檢查 (拒絕標籤堆砌蹭熱度) ===
+    if (parsed.isTagSpam) {
+        return {
+            isWorthy: false,
+            score: 20,
+            reason: '',
+            rejectionReason: `判定為標籤農場 (包含 ${parsed.tagCount} 個標籤，標籤佔比過高且正文空洞)。`,
+            commentText: '',
+            reviewMethod: 'heuristic',
+        };
+    }
+    // === 第 2.5 關：嚴格攔截 AI 生成的影片、動畫、繪圖或農場文章 (AIGC Filter) ===
+    const aigcHit = detectAigcPost(parsed.rawCaption, post.user?.username || '');
+    if (aigcHit) {
+        return {
+            isWorthy: false,
+            score: 5,
+            reason: '',
+            rejectionReason: `判定為 AI 生成的影片/動畫/繪圖或文章 (命中 AIGC 特徵詞 [${aigcHit}])，不予推薦。`,
+            commentText: '',
+            reviewMethod: 'heuristic',
+        };
+    }
+    // === 第 3 關：負面詞與廣告過濾 (Negative Keywords / Spam Filter) ===
+    const negativeWords = config.negativeKeywords || [];
+    const rawLower = parsed.rawCaption.toLowerCase();
+    for (const badKw of negativeWords) {
+        const cleanKw = badKw.toLowerCase().trim();
+        if (cleanKw && rawLower.includes(cleanKw)) {
+            return {
+                isWorthy: false,
+                score: 10,
+                reason: '',
+                rejectionReason: `命中排除關鍵字/廣告宣傳詞彙 [${cleanKw}]。`,
+                commentText: '',
+                reviewMethod: 'heuristic',
+            };
+        }
+    }
+    // === 第 4 關：正文實質主題核驗 (不能只看文末 tag) ===
+    const positiveWords = Array.from(new Set([
+        ...(config.positiveKeywords || []),
+        ...(config.fuzzyKeywords || []),
+        ...(config.interestTags || []),
+    ]));
+    const cleanLower = parsed.cleanBody.toLowerCase();
+    const hitBodyKeywords = [];
+    for (const kw of positiveWords) {
+        const cleanKw = kw.toLowerCase().trim();
+        if (cleanKw && cleanLower.includes(cleanKw)) {
+            hitBodyKeywords.push(cleanKw);
+        }
+    }
+    // 若設定要求「正文必須命中用戶偏好」，且正文未命中任何關鍵字，直接退回
+    if (config.requireBodyMatch && hitBodyKeywords.length === 0) {
+        return {
+            isWorthy: false,
+            score: 30,
+            reason: '',
+            rejectionReason: `正文實質內容未提及主人偏好領域關鍵字 (僅文末標籤包含相關字詞，判定為蹭熱度)。`,
+            commentText: '',
+            reviewMethod: 'heuristic',
+        };
+    }
+    // === 第 5 關：LLM 深度語義質檢 (如果環境具備 LLM 能力) ===
+    const sharedCompanion = globalThis.__DSH_INSTAGRAM_LLM__;
+    const moodBlock = typeof sharedCompanion?.buildFeiyuMoodPromptBlock === 'function'
+        ? sharedCompanion.buildFeiyuMoodPromptBlock(true)
+        : '';
+    const antiAiRule = sharedCompanion?.ANTI_AI_FLAVOR_PRIMARY_RULE ||
+        '【第一條件（最高優先級鐵則）：推坑留言絕對不要 AI 味，嚴禁客服腔、總結腔、排比句或機械式吹捧，要像真人朋友隨手分享一樣自然口語】';
+    const systemPrompt = `${antiAiRule}\n${moodBlock ? `${moodBlock}\n` : ''}\n你是一位高品味、眼光極為嚴格的私人內容審查夥伴。
+主人的核心原則是：「絕對不要隨便推薦、必須切合主人喜歡的內容，在留言 @ 主人之前必須深入檢查正文實質內容，嚴禁只看文末的 tag 就隨意推薦」。
+主人的內容偏好定義如下：
+"""
+${userInterests}
+"""
+
+任務要求：
+1. 【最高鐵律】嚴格排除任何「AI 生成的影片、AI 動畫、AI 繪圖/算圖、AI 配音或 AI 生成的農場文章」（例如 Sora、Runway、Midjourney、Stable Diffusion、Kling、可靈、即夢、AIGC 等）。只要貼文是 AI 算圖、AI 生成影片/動畫或 AI 農場文，必須無條件給低分並設 isWorthy: false！
+2. 請審查貼文正文是否深度探討主人喜歡的主題（真實人類原創手繪創作、真實技術開發實踐、開源專案或優質乾貨），還是只是空泛的標籤農場或蹭流量。
+3. 若內容確實極為優秀且深度符合主人喜好，請給出大於等於 ${minScore} 的高分，並撰寫簡短真誠、針對此篇貼文具體乾貨的一句話推坑留言 (不要千篇一律套話)。
+4. 若品質普通、偏題或僅表面蹭熱度，給予低於 ${minScore} 的分數並給出 rejectionReason。
+
+請嚴格輸出 JSON 格式：
+{
+  "isWorthy": boolean,
+  "score": number, // 0-100
+  "summary": "貼文真正主旨簡介 (30字內)",
+  "rejectionReason": "未通過的原因 (若不合格)",
+  "reason": "推薦給主人的實質價值說明 (若合格)",
+  "hookPhrase": "針對本篇內容亮點量身打造的推坑一句話 (若合格，25字內，真誠具體，嚴禁空洞廢話)"
+}`;
+    const userPrompt = `請審查以下 Instagram 貼文：
+- 作者：@${post.user?.username || 'unknown'}
+- 互動數據：${post.like_count || 0} 讚, ${post.comment_count || 0} 則留言
+- 貼文真正正文內容 (已剔除標籤)：
+"""
+${parsed.cleanBody.slice(0, 800)}
+"""
+- 文末標籤清單：#${parsed.hashtags.join(', #')}
+- 正文命中之領域詞：${hitBodyKeywords.join(', ') || '無'}
+
+請依據審查原則進行嚴格評估並以 JSON 返回。`;
+    const llmResponse = await callLlmInference(ctx, systemPrompt, userPrompt);
+    if (llmResponse) {
+        try {
+            const cleanedJson = llmResponse.replace(/^```json\s*/i, '').replace(/\s*```$/i, '').trim();
+            const parsedLlm = JSON.parse(cleanedJson);
+            const score = Number(parsedLlm.score || 0);
+            const isWorthy = Boolean(parsedLlm.isWorthy) && score >= minScore;
+            if (isWorthy) {
+                const rawHook = String(parsedLlm.hookPhrase || parsedLlm.reason || '這篇講得蠻透的，留給你看看').trim();
+                const hook = typeof sharedCompanion?.stripAiFlavorArtifacts === 'function'
+                    ? sharedCompanion.stripAiFlavorArtifacts(rawHook)
+                    : rawHook;
+                const commentText = master ? `@${master} ${hook}` : hook;
+                return {
+                    isWorthy: true,
+                    score,
+                    reason: String(parsedLlm.reason || parsedLlm.summary || '內容深度契合主人關注領域且具備乾貨價值。'),
+                    commentText,
+                    reviewMethod: 'llm',
+                };
+            }
+            else {
+                return {
+                    isWorthy: false,
+                    score,
+                    reason: '',
+                    rejectionReason: String(parsedLlm.rejectionReason || '內容深度未達主人品味標準或主題不符。'),
+                    commentText: '',
+                    reviewMethod: 'llm',
+                };
+            }
+        }
+        catch (e) {
+            console.warn(`[ScrollDuty] LLM 結果 JSON 解析異常: ${e.message}`);
         }
     }
-    return { isWorthy, score, reason, commentText };
+    // === 備援：啟發式嚴密內容質檢 (Heuristic Rule Engine) ===
+    // 當宿主無 LLM 或 LLM 調用異常時，依然嚴守品質底線，絕不隨便推薦！
+    let heuristicScore = 40; // 底分
+    // 正文字數深度加分 (有較長詳細說明通常具備更高乾貨密度)
+    if (parsed.cleanLength > 300)
+        heuristicScore += 18;
+    else if (parsed.cleanLength > 150)
+        heuristicScore += 12;
+    else if (parsed.cleanLength > 60)
+        heuristicScore += 6;
+    // 正文實質命中關鍵詞加分
+    heuristicScore += Math.min(25, hitBodyKeywords.length * 8);
+    // 乾貨排版特徵檢查 (具備條列、步驟或結構化排版)
+    if (/[0-9][.、]|👉|✅|🔹|💡|📌|\n- |\n\* /.test(parsed.cleanBody)) {
+        heuristicScore += 10;
+    }
+    // 社群互動數據適度輔助加分 (最多 12 分，避免高讚垃圾貼文)
+    const likes = post.like_count || 0;
+    const comments = post.comment_count || 0;
+    if (likes > 300)
+        heuristicScore += 6;
+    if (comments > 15)
+        heuristicScore += 6;
+    heuristicScore = Math.min(96, Math.max(10, heuristicScore));
+    const isHeuristicWorthy = heuristicScore >= minScore;
+    if (isHeuristicWorthy) {
+        const reason = `正文實質深度探討 [${hitBodyKeywords.slice(0, 3).join(', ')}]，文字詳實完整 (${parsed.cleanLength} 字)，結構條理分明。`;
+        const hookPhrases = [
+            `這篇關於 ${hitBodyKeywords[0] || '該主題'} 的內容分享非常扎實，特別推薦你看！`,
+            `發現這篇乾貨對你的方向很有啟發，特地 @ 你存起來！`,
+            `這篇思路與案例分析得很透徹，內容很硬核，推推！`,
+        ];
+        const chosenHook = hookPhrases[Math.floor(Math.random() * hookPhrases.length)];
+        const commentText = master ? `@${master} ${chosenHook}` : `這篇乾貨非常精彩，推薦關注！`;
+        return {
+            isWorthy: true,
+            score: heuristicScore,
+            reason,
+            commentText,
+            reviewMethod: 'heuristic',
+        };
+    }
+    else {
+        return {
+            isWorthy: false,
+            score: heuristicScore,
+            reason: '',
+            rejectionReason: `內容乾貨密度評分 (${heuristicScore}) 未達嚴選門檻 (${minScore})。`,
+            commentText: '',
+            reviewMethod: 'heuristic',
+        };
+    }
 }
 export async function executeScrollRound(ctx, config, mcp, ledger, log = console.log) {
-    log('[ScrollDuty] 🚀 開始替主人刷一輪 Instagram...');
-    const master = (config.masterUsername || '').replace(/^@/, '').trim();
+    // 防風控冷卻保護檢查
+    if (ledger.isInCooldown()) {
+        const rem = ledger.getCooldownRemainingSeconds();
+        const reason = ledger.getCooldownReason();
+        const msg = `防風控冷卻保護中（剩餘 ${rem} 秒，原因: ${reason}），暫停本輪滾動瀏覽`;
+        log(`[ScrollDuty] 🚨 ${msg}`);
+        return {
+            ok: true,
+            totalScanned: 0,
+            worthyCount: 0,
+            recommendedCount: 0,
+            recommendations: [],
+            message: msg,
+        };
+    }
+    log('[ScrollDuty] 🚀 開始替主人刷一輪 Instagram (啟動正文內容嚴格審查模式)...');
+    const mcpSvc = globalThis.__DSH_INSTAGRAM_MCP__;
+    const master = (mcpSvc?.config?.masterUsername || config.masterUsername || '').replace(/^@/, '').trim();
     if (!master) {
-        log('[ScrollDuty] ⚠️ 尚未配置主人帳號 (masterUsername)，將僅進行瀏覽紀錄而不留言 @主人。');
+        log('[ScrollDuty] ⚠️ 尚未在 MCP 配置主人帳號 (masterUsername)，將僅進行瀏覽審核而不留言 @主人。');
     }
     const batchSize = Math.max(5, config.batchSize || 15);
+    const maxPerRun = config.maxRecommendsPerRun || 1;
     const candidatePosts = [];
-    // 1. 抓取時間軸首頁動態 (Feed)
+    // 1. 抓取首頁時間軸動態牆 (Feed)
     try {
         log(`[ScrollDuty] 正在滾動時間軸動態牆 (抓取上限: ${batchSize})...`);
         const feedRes = await mcp.igGetTimelineFeed(batchSize);
@@ -88,56 +443,176 @@ export async function executeScrollRound(ctx, config, mcp, ledger, log = console
     }
     catch (e) {
         log(`[ScrollDuty] 獲取時間軸動態異常: ${e.message}`);
+        if (/feedback|action block|checkpoint|rate limit/i.test(e.message)) {
+            ledger.triggerCooldown(config.cooldownOnBlockMinutes || 30, e.message);
+            return {
+                ok: false,
+                totalScanned: 0,
+                worthyCount: 0,
+                recommendedCount: 0,
+                recommendations: [],
+                message: `時間軸獲取異常並觸發風控冷卻: ${e.message}`,
+            };
+        }
     }
-    // 2. 隨機選取一個主人感興趣的標籤進行主題探索 (Explore Tag)
+    // 2A. 模糊搜尋探索 (Fuzzy Search) —— 預設啟用，解決單純 Tags 搜尋返回 0 則貼文問題
+    const useFuzzy = config.fuzzySearchEnabled !== false;
+    const fuzzyWords = (config.fuzzyKeywords && config.fuzzyKeywords.length > 0)
+        ? config.fuzzyKeywords
+        : (config.interestTags || []);
+    if (useFuzzy && fuzzyWords.length > 0) {
+        const randomKeyword = fuzzyWords[Math.floor(Math.random() * fuzzyWords.length)].replace(/^#/, '').trim();
+        if (randomKeyword) {
+            try {
+                log(`[ScrollDuty] 🔎 正在使用模糊搜尋探索關鍵字 "${randomKeyword}"...`);
+                const fuzzyRes = typeof mcp.igFuzzySearchPosts === 'function'
+                    ? await mcp.igFuzzySearchPosts(randomKeyword, 10)
+                    : await mcp.callTool('ig_fuzzy_search_posts', { query: randomKeyword, limit: 10 }, 75000);
+                if (fuzzyRes?.ok && Array.isArray(fuzzyRes.posts)) {
+                    for (const p of fuzzyRes.posts) {
+                        const pk = String(p.pk || p.id || '');
+                        if (pk && !candidatePosts.some((cp) => String(cp.pk || cp.id || '') === pk)) {
+                            candidatePosts.push(p);
+                        }
+                    }
+                    log(`[ScrollDuty] 從模糊搜尋 "${randomKeyword}" 獲取到 ${fuzzyRes.posts.length} 則貼文。`);
+                }
+            }
+            catch (e) {
+                log(`[ScrollDuty] 模糊搜尋探索異常: ${e.message}`);
+                if (/feedback|action block|checkpoint|rate limit/i.test(e.message)) {
+                    ledger.triggerCooldown(config.cooldownOnBlockMinutes || 30, e.message);
+                }
+            }
+        }
+    }
+    // 2B. 主題標籤探索 (Explore Tag) —— 保留功能，由 tagSearchEnabled 按鈕控制開關 (預設關閉)
+    const useTags = config.tagSearchEnabled === true;
     const tags = config.interestTags || [];
-    if (tags.length > 0) {
+    if (useTags && tags.length > 0) {
         const randomTag = tags[Math.floor(Math.random() * tags.length)].replace(/^#/, '').trim();
         try {
-            log(`[ScrollDuty] 正在探索主題標籤 #${randomTag}...`);
+            log(`[ScrollDuty] 🏷️ 正在探索主題標籤 #${randomTag}...`);
             const tagRes = await mcp.igSearchHashtag(randomTag, 10);
             if (tagRes?.ok && Array.isArray(tagRes.posts)) {
-                candidatePosts.push(...tagRes.posts);
+                for (const p of tagRes.posts) {
+                    const pk = String(p.pk || p.id || '');
+                    if (pk && !candidatePosts.some((cp) => String(cp.pk || cp.id || '') === pk)) {
+                        candidatePosts.push(p);
+                    }
+                }
                 log(`[ScrollDuty] 從 #${randomTag} 獲取到 ${tagRes.posts.length} 則主題貼文。`);
             }
         }
         catch (e) {
             log(`[ScrollDuty] 探索標籤異常: ${e.message}`);
+            if (/feedback|action block|checkpoint|rate limit/i.test(e.message)) {
+                ledger.triggerCooldown(config.cooldownOnBlockMinutes || 30, e.message);
+            }
+        }
+    }
+    // 3. 抓取連續短片探索流 (Explore Reels Feed) —— 豐富動態滾動來源，避免時間軸枯竭
+    try {
+        log(`[ScrollDuty] 正在探索熱門短影音 (Reels Feed, 抓取上限: 10)...`);
+        const reelsRes = await mcp.igGetReelsFeed(10);
+        if (reelsRes?.ok && Array.isArray(reelsRes.reels)) {
+            for (const r of reelsRes.reels) {
+                const pk = String(r.pk || r.id || '');
+                if (pk && !candidatePosts.some((cp) => String(cp.pk || cp.id || '') === pk)) {
+                    candidatePosts.push(r);
+                }
+            }
+            log(`[ScrollDuty] 從 Reels 探索流獲取到 ${reelsRes.reels.length} 則連續短片。`);
         }
     }
+    catch (e) {
+        log(`[ScrollDuty] 獲取 Reels 探索流異常: ${e.message}`);
+    }
     let totalScanned = 0;
     let worthyCount = 0;
     let recommendedCount = 0;
     const recommendations = [];
-    // 3. 逐條讀內文進行評估與推薦
+    // 3. 逐條讀內文進行深度內容審查與推薦
     for (const post of candidatePosts) {
-        const postPk = String(post.pk || post.id || '');
+        if (recommendedCount >= maxPerRun) {
+            log(`[ScrollDuty] 達到本輪推坑上限 (${maxPerRun} 則)，結束本輪推薦。`);
+            break;
+        }
+        const postPk = String(post.pk || post.id || '').split('_')[0].trim();
         if (!postPk)
             continue;
         // 跳過已看過的貼文
-        if (ledger.hasSeen(postPk)) {
+        if (ledger.hasSeen(post) || ledger.hasEverSent(post)) {
             continue;
         }
+        ledger.markSeen(post, false);
+        // 模擬人類瀏覽閱讀貼文微延遲
+        const minDelay = config.minPostReadDelaySeconds || 3;
+        const maxDelay = Math.max(minDelay, config.maxPostReadDelaySeconds || 7);
+        const readWaitMs = Math.floor((minDelay + Math.random() * (maxDelay - minDelay)) * 1000);
+        await new Promise((r) => setTimeout(r, readWaitMs));
         totalScanned++;
-        const evalRes = evaluatePost(post, config);
+        const evalRes = await inspectAndEvaluatePost(ctx, post, config);
         if (evalRes.isWorthy) {
             worthyCount++;
-            log(`[ScrollDuty] ⭐ 發現值得內容！作者: @${post.user?.username || 'unknown'}, 評分: ${evalRes.score}/100. 短碼: ${post.code}`);
+            log(`[ScrollDuty] ⭐ 發現極高價值內容！審查機制: [${evalRes.reviewMethod.toUpperCase()}], 評分: ${evalRes.score}/100, 作者: @${post.user?.username || 'unknown'}`);
+            log(`[ScrollDuty] 推薦原因: ${evalRes.reason}`);
             // 檢查是否還能推坑 (每日上限控制)
             const cap = config.dailyRecommendCap || 5;
             if (ledger.canRecommend(cap) && master) {
-                log(`[ScrollDuty] 正在貼文下留言 @${master} 進行推薦...`);
+                if (ledger.hasEverSent(post)) {
+                    log(`[ScrollDuty] ⏭️ 貼文/Reel (${postPk}) 已經在其他任務發送過推坑留言，攔截重複發送！`);
+                    continue;
+                }
+                const botUserLower = String(mcpSvc?.loginStatus?.username || mcpSvc?.config?.username || '').replace(/^@/, '').trim().toLowerCase();
+                try {
+                    const ctxCheck = await mcp.igGetPostContext(postPk, 15);
+                    const existingComments = ctxCheck?.comments || [];
+                    const alreadyCommented = existingComments.some((c) => {
+                        const cu = String(c.user?.username || '').toLowerCase();
+                        const ct = String(c.text || '').toLowerCase();
+                        return (botUserLower && cu === botUserLower) || (master && ct.includes(`@${master.toLowerCase()}`));
+                    });
+                    if (alreadyCommented) {
+                        log(`[ScrollDuty] ⏭️ 偵測到貼文/Reel (${postPk}) 留言區已有機器人或 @${master} 的推坑紀錄，永久標記並跳過重複發送！`);
+                        ledger.markSeen(post, true);
+                        continue;
+                    }
+                }
+                catch { }
+                // @ 前進行最後確認檢查 (Pre-mention Verification)
+                if (!evalRes.commentText || !evalRes.commentText.includes(master)) {
+                    log(`[ScrollDuty] ⚠️ 推坑語句缺少 @${master}，自動補上主人名稱`);
+                    evalRes.commentText = `@${master} ${evalRes.commentText || '這篇分析非常到位，特地推薦你看看！'}`;
+                }
+                log(`[ScrollDuty] 正在貼文下留言推坑: "${evalRes.commentText}"...`);
                 try {
                     const commentRes = await mcp.igPostComment({
                         media_pk: postPk,
                         text: evalRes.commentText,
+                        jitter_min: 6.0,
+                        jitter_max: 15.0,
                     });
+                    if (commentRes?.in_cooldown ||
+                        (commentRes?.error &&
+                            /action block|feedback|checkpoint|please wait|rate limit/i.test(commentRes.error))) {
+                        ledger.triggerCooldown(config.cooldownOnBlockMinutes || 30, commentRes.error || 'Instagram 頻率風控阻擋');
+                        log(`[ScrollDuty] 🚨 偵測到風控或熔斷保護，停止後續推坑！`);
+                        ledger.markSeen(post, true);
+                        break;
+                    }
                     if (commentRes?.ok) {
                         log(`[ScrollDuty] ✅ 成功留言 @${master}！`);
                         recommendedCount++;
                         // 若開啟，順便點讚
                         if (config.likeOnRecommend) {
-                            await mcp.igLikeMedia(postPk).catch(() => { });
+                            const likeRes = await mcp.igLikeMedia(postPk).catch(() => ({}));
+                            if (likeRes?.in_cooldown ||
+                                (likeRes?.error &&
+                                    /action block|feedback|checkpoint|please wait|rate limit/i.test(likeRes.error))) {
+                                ledger.triggerCooldown(config.cooldownOnBlockMinutes || 30, likeRes.error || 'Instagram 點讚風控阻擋');
+                                break;
+                            }
                         }
                         const recItem = {
                             postPk,
@@ -154,24 +629,38 @@ export async function executeScrollRound(ctx, config, mcp, ledger, log = console
                     }
                     else {
                         log(`[ScrollDuty] 留言發布失敗: ${commentRes?.error || '未知原因'}`);
-                        ledger.markSeen(postPk, true);
+                        ledger.markSeen(post, true);
                     }
                 }
                 catch (e) {
                     log(`[ScrollDuty] 留言異常: ${e.message}`);
-                    ledger.markSeen(postPk, true);
+                    ledger.markSeen(post, true);
+                    if (/feedback|action block|checkpoint|rate limit/i.test(e.message)) {
+                        ledger.triggerCooldown(config.cooldownOnBlockMinutes || 30, e.message);
+                        break;
+                    }
                 }
             }
             else {
                 log(`[ScrollDuty] 今日推薦已達上限 (${cap}則) 或未配置主人帳號，僅標記值得並記錄日報。`);
-                ledger.markSeen(postPk, true);
+                ledger.markSeen(post, true);
             }
         }
         else {
-            ledger.markSeen(postPk, false);
+            log(`[ScrollDuty] ⏭️ 未通過內容審核: ${evalRes.rejectionReason || '評分未達標準'}`);
+            ledger.markSeen(post, false);
         }
     }
-    const msg = `本輪滾動瀏覽完畢！共掃描 ${totalScanned} 則新內容，發現 ${worthyCount} 則值得貼文，成功替主人留評推薦 ${recommendedCount} 則。`;
+    let msg = '';
+    if (totalScanned > 0) {
+        msg = `本輪滾動完畢！共掃描 ${totalScanned} 則新內容，經正文與語義嚴格審查，精選 ${worthyCount} 則符合主人偏好，成功留評推薦 ${recommendedCount} 則。`;
+    }
+    else if (candidatePosts.length > 0) {
+        msg = `本輪滾動完畢！共獲取到 ${candidatePosts.length} 則動態，但均為今日已審閱過之內容（帳本已自動去重，避免重複審查與打擾），暫無未看過之新貼文。`;
+    }
+    else {
+        msg = `本輪滾動完畢！未檢索到動態內容（可能是 Instagram 官方暫時無新動態推薦或標籤搜尋受限）。`;
+    }
     log(`[ScrollDuty] 🎉 ${msg}`);
     return {
         ok: true,