@web-auto/webauto 0.1.7 → 0.1.9

package/modules/camo-runtime/src/autoscript/action-providers/xhs/interaction.mjs

@@ -59,12 +59,10 @@ function buildCollectLikeTargetsScript() {
       const className = String(node.className || '').toLowerCase();
       const ariaPressed = String(node.getAttribute?.('aria-pressed') || '').toLowerCase();
       const text = String(node.textContent || '');
-      const useNode = node.querySelector('use');
-      const useHref = String(useNode?.getAttribute?.('xlink:href') || useNode?.getAttribute?.('href') || '').toLowerCase();
-      return className.includes('like-active')
+      const hasActiveClass = /(?:^|\\s)like-active(?:\\s|$)/.test(className);
+      return hasActiveClass
         || ariaPressed === 'true'
-        || /已赞|取消赞/.test(text)
-        || useHref.includes('liked');
+        || /已赞|取消赞/.test(text);
     };
     const readText = (item, selectors) => {
       for (const selector of selectors) {
@@ -164,7 +162,7 @@ function buildCollectLikeTargetsScript() {
   })()`;
 }
 
-function buildClickLikeByIndexScript(index, highlight) {
+function buildClickLikeByIndexScript(index, highlight, skipAlreadyCheck = false) {
   return `(async () => {
     const idx = Number(${JSON.stringify(index)});
     const items = Array.from(document.querySelectorAll('.comment-item'));
@@ -190,18 +188,16 @@ function buildClickLikeByIndexScript(index, highlight) {
       const className = String(node.className || '').toLowerCase();
       const ariaPressed = String(node.getAttribute?.('aria-pressed') || '').toLowerCase();
       const text = String(node.textContent || '');
-      const useNode = node.querySelector('use');
-      const useHref = String(useNode?.getAttribute?.('xlink:href') || useNode?.getAttribute?.('href') || '').toLowerCase();
-      return className.includes('like-active')
+      const hasActiveClass = /(?:^|\\s)like-active(?:\\s|$)/.test(className);
+      return hasActiveClass
         || ariaPressed === 'true'
-        || /已赞|取消赞/.test(text)
-        || useHref.includes('liked');
+        || /已赞|取消赞/.test(text);
     };
 
     const likeControl = findLikeControl(item);
     if (!likeControl) return { clicked: false, reason: 'like_control_not_found', index: idx };
     const beforeLiked = isAlreadyLiked(likeControl);
-    if (beforeLiked) {
+    if (beforeLiked && !${skipAlreadyCheck ? 'true' : 'false'}) {
       return { clicked: false, alreadyLiked: true, reason: 'already_liked', index: idx };
     }
     item.scrollIntoView({ behavior: 'auto', block: 'center' });
@@ -216,7 +212,7 @@ function buildClickLikeByIndexScript(index, highlight) {
     await new Promise((resolve) => setTimeout(resolve, 220));
     return {
       clicked: true,
-      alreadyLiked: false,
+      alreadyLiked: beforeLiked,
       likedAfter: isAlreadyLiked(likeControl),
       reason: 'clicked',
       index: idx,
@@ -244,6 +240,7 @@ export async function executeCommentLikeOperation({ profileId, params = {} }) {
   const saveEvidence = params.saveEvidence !== false;
   const persistLikeState = params.persistLikeState !== false;
   const persistComments = params.persistComments === true || params.persistCollectedComments === true;
+  const fallbackPickOne = params.pickOneIfNoNew !== false;
 
   const stateRaw = await runEvaluateScript({
     profileId,
@@ -273,7 +270,8 @@ export async function executeCommentLikeOperation({ profileId, params = {} }) {
   const likedSignatures = persistLikeState ? await loadLikedSignatures(output.likeStatePath) : new Set();
   const likedComments = [];
   const matchedByStateCount = Number(collected.matchedByStateCount || 0);
-  const useStateMatches = matchedByStateCount > 0;
+  // If explicit like rules are provided, honor them instead of inheriting state matches.
+  const useStateMatches = matchedByStateCount > 0 && rules.length === 0;
 
   let hitCount = 0;
   let likedCount = 0;
@@ -411,6 +409,136 @@ export async function executeCommentLikeOperation({ profileId, params = {} }) {
     });
   }
 
+  if (!dryRun && fallbackPickOne && likedCount < maxLikes) {
+    for (const row of rows) {
+      if (likedCount >= maxLikes) break;
+      if (!row || typeof row !== 'object') continue;
+      const text = normalizeText(row.text);
+      if (!text) continue;
+
+      const signature = makeLikeSignature({
+        noteId: output.noteId,
+        userId: String(row.userId || ''),
+        userName: String(row.userName || ''),
+        text,
+      });
+      if (!row.hasLikeControl) {
+        missingLikeControl += 1;
+        continue;
+      }
+
+      hitCount += 1;
+      if (row.alreadyLiked) {
+        alreadyLikedSkipped += 1;
+        if (persistLikeState && signature) {
+          likedSignatures.add(signature);
+          await appendLikedSignature(output.likeStatePath, signature, {
+            noteId: output.noteId,
+            userId: String(row.userId || ''),
+            userName: String(row.userName || ''),
+            reason: 'already_liked_fallback',
+          }).catch(() => null);
+        }
+        continue;
+      }
+
+      const beforePath = saveEvidence
+        ? await captureScreenshotToFile({
+          profileId,
+          filePath: path.join(evidenceDir, `like-before-fallback-idx-${String(row.index).padStart(3, '0')}-${Date.now()}.png`),
+        })
+        : null;
+      const clickRaw = await runEvaluateScript({
+        profileId,
+        script: buildClickLikeByIndexScript(row.index, highlight, true),
+        highlight: false,
+      });
+      const clickResult = extractEvaluateResultData(clickRaw) || {};
+      const afterPath = saveEvidence
+        ? await captureScreenshotToFile({
+          profileId,
+          filePath: path.join(evidenceDir, `like-after-fallback-idx-${String(row.index).padStart(3, '0')}-${Date.now()}.png`),
+        })
+        : null;
+
+      if (clickResult.alreadyLiked) {
+        alreadyLikedSkipped += 1;
+        if (persistLikeState && signature) {
+          likedSignatures.add(signature);
+          await appendLikedSignature(output.likeStatePath, signature, {
+            noteId: output.noteId,
+            userId: String(row.userId || ''),
+            userName: String(row.userName || ''),
+            reason: 'already_liked_after_click_fallback',
+          }).catch(() => null);
+        }
+        continue;
+      }
+      if (!clickResult.clicked) {
+        clickFailed += 1;
+        continue;
+      }
+      if (!clickResult.likedAfter) {
+        if (clickResult.alreadyLiked) {
+          // Fallback proof path: toggle back to keep original state, but keep one verified candidate.
+          await runEvaluateScript({
+            profileId,
+            script: buildClickLikeByIndexScript(row.index, false, true),
+            highlight: false,
+          }).catch(() => null);
+          likedCount += 1;
+          likedComments.push({
+            index: Number(row.index),
+            userId: String(row.userId || ''),
+            userName: String(row.userName || ''),
+            content: text,
+            timestamp: String(row.timestamp || ''),
+            matchedRule: 'fallback_already_liked_verified',
+            screenshots: {
+              before: beforePath,
+              after: afterPath,
+            },
+          });
+          if (persistLikeState && signature) {
+            likedSignatures.add(signature);
+            await appendLikedSignature(output.likeStatePath, signature, {
+              noteId: output.noteId,
+              userId: String(row.userId || ''),
+              userName: String(row.userName || ''),
+              reason: 'already_liked_verified',
+            }).catch(() => null);
+          }
+          break;
+        }
+        verifyFailed += 1;
+        continue;
+      }
+
+      likedCount += 1;
+      if (persistLikeState && signature) {
+        likedSignatures.add(signature);
+        await appendLikedSignature(output.likeStatePath, signature, {
+          noteId: output.noteId,
+          userId: String(row.userId || ''),
+          userName: String(row.userName || ''),
+          reason: 'liked_fallback',
+        }).catch(() => null);
+      }
+      likedComments.push({
+        index: Number(row.index),
+        userId: String(row.userId || ''),
+        userName: String(row.userName || ''),
+        content: text,
+        timestamp: String(row.timestamp || ''),
+        matchedRule: 'fallback_first_available',
+        screenshots: {
+          before: beforePath,
+          after: afterPath,
+        },
+      });
+    }
+  }
+
   const skippedCount = missingLikeControl + clickFailed + verifyFailed;
   const likedTotal = likedCount + dedupSkipped + alreadyLikedSkipped;
   const hitCheckOk = likedTotal + skippedCount === hitCount;

package/modules/camo-runtime/src/autoscript/action-providers/xhs/search.mjs

@@ -213,6 +213,12 @@ export function buildOpenDetailScript(params = {}) {
       '.note-detail-mask .interaction-container',
       '.note-detail-mask .comments-container',
     ];
+    const searchSelectors = [
+      '.note-item',
+      '.search-result-list',
+      '#search-input',
+      '.feeds-page',
+    ];
     const isVisible = (node) => {
       if (!node || !(node instanceof HTMLElement)) return false;
       const style = window.getComputedStyle(node);
@@ -221,7 +227,16 @@ export function buildOpenDetailScript(params = {}) {
       const rect = node.getBoundingClientRect();
       return rect.width > 1 && rect.height > 1;
     };
-    const isDetailReady = () => detailSelectors.some((selector) => isVisible(document.querySelector(selector)));
+    const hasVisible = (selectors) => selectors.some((selector) => isVisible(document.querySelector(selector)));
+    const isDetailReady = () => {
+      const detailVisible = hasVisible(detailSelectors);
+      if (!detailVisible) return false;
+      const href = String(window.location.href || '');
+      const isDetailUrl = href.includes('/explore/') && !href.includes('/search_result');
+      if (isDetailUrl) return true;
+      const searchVisible = hasVisible(searchSelectors);
+      return !searchVisible;
+    };
 
     next.cover.scrollIntoView({ behavior: 'auto', block: 'center' });
     await new Promise((resolve) => setTimeout(resolve, 140));

package/modules/camo-runtime/src/autoscript/action-providers/xhs.mjs

@@ -253,6 +253,109 @@ async function readXhsRuntimeState(profileId) {
   }
 }
 
+function buildAssertLoggedInScript(params = {}) {
+  const selectors = Array.isArray(params.loginSelectors) && params.loginSelectors.length > 0
+    ? params.loginSelectors.map((item) => String(item || '').trim()).filter(Boolean)
+    : [
+      '.login-container',
+      '.login-dialog',
+      '#login-container',
+    ];
+  const loginPattern = String(
+    params.loginPattern || '登录|扫码|验证码|手机号|请先登录|注册|sign\\s*in',
+  ).trim();
+
+  return `(() => {
+    const guardSelectors = ${JSON.stringify(selectors)};
+    const loginPattern = new RegExp(${JSON.stringify(loginPattern || '登录|扫码|验证码|手机号|请先登录|注册|sign\\\\s*in')}, 'i');
+
+    const normalize = (value) => String(value || '').replace(/\\s+/g, ' ').trim();
+    const isVisible = (node) => {
+      if (!(node instanceof HTMLElement)) return false;
+      const style = window.getComputedStyle(node);
+      if (!style) return false;
+      if (style.display === 'none' || style.visibility === 'hidden' || Number(style.opacity || '1') === 0) return false;
+      const rect = node.getBoundingClientRect();
+      return rect.width > 0 && rect.height > 0;
+    };
+
+    const guardNodes = guardSelectors.flatMap((selector) => Array.from(document.querySelectorAll(selector)));
+    const visibleGuardNodes = guardNodes.filter((node) => isVisible(node));
+    const guardTexts = visibleGuardNodes
+      .slice(0, 10)
+      .map((node) => normalize(node.textContent || ''))
+      .filter(Boolean);
+    const mergedGuardText = guardTexts.join(' ');
+    const hasLoginText = loginPattern.test(mergedGuardText);
+    const loginUrl = /\\/login|signin|passport|account\\/login/i.test(String(location.href || ''));
+
+    let accountId = '';
+    try {
+      const initialState = (typeof window !== 'undefined' && window.__INITIAL_STATE__) || null;
+      const rawUserInfo = initialState && initialState.user && initialState.user.userInfo
+        ? (
+          (initialState.user.userInfo._rawValue && typeof initialState.user.userInfo._rawValue === 'object' && initialState.user.userInfo._rawValue)
+          || (initialState.user.userInfo._value && typeof initialState.user.userInfo._value === 'object' && initialState.user.userInfo._value)
+          || (typeof initialState.user.userInfo === 'object' ? initialState.user.userInfo : null)
+        )
+        : null;
+      accountId = normalize(rawUserInfo?.user_id || rawUserInfo?.userId || '');
+    } catch {}
+
+    if (!accountId) {
+      const selfAnchor = Array.from(document.querySelectorAll('a[href*="/user/profile/"]'))
+        .find((node) => {
+          const text = normalize(node.textContent || '');
+          const title = normalize(node.getAttribute('title') || '');
+          const aria = normalize(node.getAttribute('aria-label') || '');
+          return ['我', '我的', '个人主页', '我的主页'].includes(text)
+            || ['我', '我的', '个人主页', '我的主页'].includes(title)
+            || ['我', '我的', '个人主页', '我的主页'].includes(aria);
+        });
+      if (selfAnchor) {
+        const href = normalize(selfAnchor.getAttribute('href') || '');
+        const matched = href.match(/\\/user\\/profile\\/([^/?#]+)/);
+        if (matched && matched[1]) accountId = normalize(matched[1]);
+      }
+    }
+
+    const hasAccountSignal = Boolean(accountId);
+    const hasLoginGuard = (visibleGuardNodes.length > 0 && hasLoginText) || loginUrl;
+
+    return {
+      hasLoginGuard,
+      hasAccountSignal,
+      accountId: accountId || null,
+      url: String(location.href || ''),
+      visibleGuardCount: visibleGuardNodes.length,
+      guardTextPreview: mergedGuardText.slice(0, 240),
+      loginUrl,
+      hasLoginText,
+      guardSelectors,
+    };
+  })()`;
+}
+
+async function executeAssertLoggedInOperation({ profileId, params = {} }) {
+  const highlight = params.highlight !== false;
+  const payload = await runEvaluateScript({
+    profileId,
+    script: buildAssertLoggedInScript(params),
+    highlight,
+  });
+  const data = extractEvaluateResultData(payload) || {};
+  if (data?.hasLoginGuard === true) {
+    const code = String(params.code || 'LOGIN_GUARD_DETECTED').trim() || 'LOGIN_GUARD_DETECTED';
+    return asErrorPayload('OPERATION_FAILED', code, { guard: data });
+  }
+  return {
+    ok: true,
+    code: 'OPERATION_DONE',
+    message: 'xhs_assert_logged_in done',
+    data,
+  };
+}
+
 async function handleRaiseError({ params }) {
   const code = String(params.code || params.message || 'AUTOSCRIPT_ABORT').trim();
   return asErrorPayload('OPERATION_FAILED', code || 'AUTOSCRIPT_ABORT');
@@ -314,6 +417,7 @@ async function executeCommentsHarvestOperation({ profileId, params = {} }) {
 
 const XHS_ACTION_HANDLERS = {
   raise_error: handleRaiseError,
+  xhs_assert_logged_in: executeAssertLoggedInOperation,
   xhs_submit_search: executeSubmitSearchOperation,
   xhs_open_detail: executeOpenDetailOperation,
   xhs_detail_harvest: createEvaluateHandler('xhs_detail_harvest done', buildDetailHarvestScript),

package/modules/camo-runtime/src/autoscript/runtime.mjs

@@ -340,6 +340,7 @@ export class AutoscriptRunner {
       'sync_window_viewport',
       'verify_subscriptions',
       'xhs_submit_search',
+      'xhs_assert_logged_in',
       'xhs_open_detail',
       'xhs_detail_harvest',
       'xhs_expand_replies',
@@ -359,10 +360,19 @@ export class AutoscriptRunner {
 
   resolveTimeoutMs(operation) {
     const pacing = this.resolvePacing(operation);
-    const disableTimeout = Boolean(
-      operation?.disableTimeout ?? this.script?.defaults?.disableTimeout,
-    );
-    if (disableTimeout) return 0;
+    const operationDisableTimeout = operation?.disableTimeout;
+    if (operationDisableTimeout === true) return 0;
+
+    const rawOperationTimeout = operation?.timeoutMs ?? operation?.pacing?.timeoutMs;
+    const hasOperationTimeout = Number.isFinite(Number(rawOperationTimeout))
+      && Number(rawOperationTimeout) > 0;
+    const defaultDisableTimeout = Boolean(this.script?.defaults?.disableTimeout);
+
+    // Keep default "no-timeout" mode, but allow operation-level timeout to opt in.
+    if (defaultDisableTimeout && operationDisableTimeout !== false && !hasOperationTimeout) {
+      return 0;
+    }
+
     if (pacing.timeoutMs === 0) return 0;
     if (Number.isFinite(pacing.timeoutMs) && pacing.timeoutMs > 0) return pacing.timeoutMs;
     return this.getDefaultTimeoutMs(operation);

package/modules/camo-runtime/src/autoscript/schema.mjs

@@ -126,10 +126,19 @@ function normalizeSubscription(item, index, defaults) {
   const id = toTrimmedString(item.id) || `subscription_${index + 1}`;
   const selector = toTrimmedString(item.selector);
   if (!selector) return null;
+  const pageUrlIncludes = toArray(item.pageUrlIncludes || item.urlIncludes)
+    .map((value) => toTrimmedString(value))
+    .filter(Boolean);
+  const pageUrlExcludes = toArray(item.pageUrlExcludes || item.urlExcludes)
+    .map((value) => toTrimmedString(value))
+    .filter(Boolean);
   const events = toArray(item.events).map((name) => toTrimmedString(name)).filter(Boolean);
   return {
     id,
     selector,
+    visible: item.visible === false ? false : true,
+    pageUrlIncludes,
+    pageUrlExcludes,
     events: events.length > 0 ? events : ['appear', 'exist', 'disappear', 'change'],
     dependsOn: toArray(item.dependsOn).map((x) => toTrimmedString(x)).filter(Boolean),
     retry: normalizeRetry(item.retry, defaults.retry),

package/modules/camo-runtime/src/autoscript/xhs-unified-template.mjs

@@ -575,7 +575,14 @@ export function buildXhsUnifiedAutoscript(rawOptions = {}) {
       { id: 'home_search_input', selector: '#search-input, input.search-input', events: ['appear', 'exist', 'disappear'] },
       { id: 'home_search_button', selector: '.input-button, .input-button .search-icon', events: ['exist'] },
       { id: 'search_result_item', selector: '.note-item', events: ['appear', 'exist', 'change'] },
-      { id: 'detail_modal', selector: '.note-detail-mask, .note-detail-page, .note-detail-dialog, .note-detail-mask .detail-container, .note-detail-mask .media-container, .note-detail-mask .note-scroller, .note-detail-mask .note-content, .note-detail-mask .interaction-container, .note-detail-mask .comments-container', events: ['appear', 'exist', 'disappear'] },
+      {
+        id: 'detail_modal',
+        selector: 'body',
+        visible: false,
+        pageUrlIncludes: ['/explore/'],
+        pageUrlExcludes: ['/search_result'],
+        events: ['appear', 'exist', 'disappear'],
+      },
       { id: 'detail_comment_item', selector: '.comment-item, [class*="comment-item"]', events: ['appear', 'exist', 'change'] },
       { id: 'detail_show_more', selector: '.note-detail-mask .show-more, .note-detail-mask .reply-expand, .note-detail-mask [class*="expand"], .note-detail-page .show-more, .note-detail-page .reply-expand, .note-detail-page [class*="expand"]', events: ['appear', 'exist'] },
       { id: 'detail_discover_button', selector: 'a[href*="/explore?channel_id=homefeed_recommend"]', events: ['appear', 'exist'] },
@@ -884,7 +891,7 @@ export function buildXhsUnifiedAutoscript(rawOptions = {}) {
       },
       {
         id: 'abort_on_login_guard',
-        action: 'raise_error',
+        action: 'xhs_assert_logged_in',
         params: { code: 'LOGIN_GUARD_DETECTED' },
         trigger: 'login_guard.appear',
         once: false,

package/modules/camo-runtime/src/container/runtime-core/checkpoint.mjs

@@ -40,6 +40,105 @@ export const XHS_CHECKPOINTS = {
   ],
 };
 
+function extractEvaluateResult(payload) {
+  if (!payload || typeof payload !== 'object') return {};
+  if (payload.result && typeof payload.result === 'object') return payload.result;
+  if (payload.data && typeof payload.data === 'object') return payload.data;
+  return payload;
+}
+
+async function detectXhsLoginSignal(profileId) {
+  const script = `(() => {
+    const normalize = (value) => String(value || '').replace(/\\s+/g, ' ').trim();
+    const selectors = ${JSON.stringify(XHS_CHECKPOINTS.login_guard)};
+    const isVisible = (node) => {
+      if (!(node instanceof HTMLElement)) return false;
+      const style = window.getComputedStyle(node);
+      if (!style) return false;
+      if (style.display === 'none' || style.visibility === 'hidden' || Number(style.opacity || '1') === 0) return false;
+      const rect = node.getBoundingClientRect();
+      return rect.width > 0 && rect.height > 0;
+    };
+    const nodes = selectors.flatMap((selector) => Array.from(document.querySelectorAll(selector)));
+    const visibleNodes = nodes.filter((node) => isVisible(node));
+    const guardText = visibleNodes
+      .slice(0, 10)
+      .map((node) => normalize(node.textContent || ''))
+      .filter(Boolean)
+      .join(' ');
+    const hasLoginText = /登录|扫码|验证码|手机号|请先登录|注册|sign\\s*in/i.test(guardText);
+    const loginUrl = /\\/login|signin|passport|account\\/login/i.test(String(location.href || ''));
+
+    let accountId = '';
+    try {
+      const initialState = (typeof window !== 'undefined' && window.__INITIAL_STATE__) || null;
+      const rawUserInfo = initialState && initialState.user && initialState.user.userInfo
+        ? (
+          (initialState.user.userInfo._rawValue && typeof initialState.user.userInfo._rawValue === 'object' && initialState.user.userInfo._rawValue)
+          || (initialState.user.userInfo._value && typeof initialState.user.userInfo._value === 'object' && initialState.user.userInfo._value)
+          || (typeof initialState.user.userInfo === 'object' ? initialState.user.userInfo : null)
+        )
+        : null;
+      accountId = normalize(rawUserInfo?.user_id || rawUserInfo?.userId || '');
+    } catch {}
+
+    if (!accountId) {
+      const selfAnchor = Array.from(document.querySelectorAll('a[href*="/user/profile/"]'))
+        .find((node) => {
+          const text = normalize(node.textContent || '');
+          const title = normalize(node.getAttribute('title') || '');
+          const aria = normalize(node.getAttribute('aria-label') || '');
+          return ['我', '我的', '个人主页', '我的主页'].includes(text)
+            || ['我', '我的', '个人主页', '我的主页'].includes(title)
+            || ['我', '我的', '个人主页', '我的主页'].includes(aria);
+        });
+      if (selfAnchor) {
+        const href = normalize(selfAnchor.getAttribute('href') || '');
+        const matched = href.match(/\\/user\\/profile\\/([^/?#]+)/);
+        if (matched && matched[1]) accountId = normalize(matched[1]);
+      }
+    }
+
+    const hasAccountSignal = Boolean(accountId);
+    const hasLoginGuard = (visibleNodes.length > 0 && hasLoginText) || loginUrl;
+    return {
+      hasLoginGuard,
+      hasLoginText,
+      hasAccountSignal,
+      accountId: accountId || null,
+      visibleGuardCount: visibleNodes.length,
+      guardTextPreview: guardText.slice(0, 240),
+      loginUrl,
+    };
+  })()`;
+
+  try {
+    const ret = await callAPI('evaluate', { profileId, script });
+    const data = extractEvaluateResult(ret);
+    return {
+      hasLoginGuard: data?.hasLoginGuard === true,
+      hasLoginText: data?.hasLoginText === true,
+      hasAccountSignal: data?.hasAccountSignal === true,
+      accountId: String(data?.accountId || '').trim() || null,
+      visibleGuardCount: Math.max(0, Number(data?.visibleGuardCount || 0) || 0),
+      guardTextPreview: String(data?.guardTextPreview || '').trim(),
+      loginUrl: data?.loginUrl === true,
+      ok: true,
+    };
+  } catch {
+    return {
+      hasLoginGuard: false,
+      hasLoginText: false,
+      hasAccountSignal: false,
+      accountId: null,
+      visibleGuardCount: 0,
+      guardTextPreview: '',
+      loginUrl: false,
+      ok: false,
+    };
+  }
+}
+
 export async function detectCheckpoint({ profileId, platform = 'xiaohongshu' }) {
   if (platform !== 'xiaohongshu') {
     return asErrorPayload('UNSUPPORTED_PLATFORM', `Unsupported platform: ${platform}`);
@@ -72,10 +171,16 @@ export async function detectCheckpoint({ profileId, platform = 'xiaohongshu' })
     addCount('login_guard', XHS_CHECKPOINTS.login_guard);
     addCount('risk_control', XHS_CHECKPOINTS.risk_control);
 
+    const loginSignal = await detectXhsLoginSignal(resolvedProfile);
+    const loginGuardBySelector = signals.some((item) => item.startsWith('login_guard:'));
+    const loginGuardConfirmed = loginSignal.ok
+      ? loginSignal.hasLoginGuard
+      : loginGuardBySelector;
+
     let checkpoint = 'unknown';
     if (!url || !url.includes('xiaohongshu.com')) checkpoint = 'offsite';
     else if (isCheckpointRiskUrl(url)) checkpoint = 'risk_control';
-    else if (signals.some((item) => item.startsWith('login_guard:'))) checkpoint = 'login_guard';
+    else if (loginGuardConfirmed) checkpoint = 'login_guard';
     else if (signals.some((item) => item.startsWith('comments_ready:'))) checkpoint = 'comments_ready';
     else if (signals.some((item) => item.startsWith('detail_ready:'))) checkpoint = 'detail_ready';
     else if (signals.some((item) => item.startsWith('search_ready:'))) checkpoint = 'search_ready';
@@ -92,6 +197,7 @@ export async function detectCheckpoint({ profileId, platform = 'xiaohongshu' })
         url,
         signals,
         selectorHits: counter,
+        loginSignal,
       },
     };
   } catch (err) {

package/modules/camo-runtime/src/container/runtime-core/subscription.mjs

@@ -18,8 +18,22 @@ export async function watchSubscriptions({
       const id = String(item.id || `sub_${index + 1}`);
       const selector = String(item.selector || '').trim();
       if (!selector) return null;
+      const visible = item.visible !== false;
+      const pageUrlIncludes = normalizeArray(item.pageUrlIncludes || item.urlIncludes)
+        .map((value) => String(value || '').trim())
+        .filter(Boolean);
+      const pageUrlExcludes = normalizeArray(item.pageUrlExcludes || item.urlExcludes)
+        .map((value) => String(value || '').trim())
+        .filter(Boolean);
       const events = normalizeArray(item.events).map((name) => String(name).trim()).filter(Boolean);
-      return { id, selector, events: events.length > 0 ? new Set(events) : null };
+      return {
+        id,
+        selector,
+        visible,
+        pageUrlIncludes,
+        pageUrlExcludes,
+        events: events.length > 0 ? new Set(events) : null,
+      };
     })
     .filter(Boolean);
 
@@ -40,9 +54,17 @@ export async function watchSubscriptions({
     try {
       const snapshot = await getDomSnapshotByProfile(resolvedProfile);
       const ts = new Date().toISOString();
+      const currentUrl = String(snapshot?.__url || '');
       for (const item of items) {
         const prev = state.get(item.id) || { exists: false, stateSig: '', appearCount: 0 };
-        const elements = notifier.findElements(snapshot, { css: item.selector });
+        const includeOk = item.pageUrlIncludes.length === 0
+          || item.pageUrlIncludes.some((token) => currentUrl.includes(token));
+        const excludeHit = item.pageUrlExcludes.length > 0
+          && item.pageUrlExcludes.some((token) => currentUrl.includes(token));
+        const pageUrlMatched = includeOk && !excludeHit;
+        const elements = pageUrlMatched
+          ? notifier.findElements(snapshot, { css: item.selector, visible: item.visible })
+          : [];
         const exists = elements.length > 0;
         const stateSig = elements.map((node) => node.path).sort().join(',');
         const changed = stateSig !== prev.stateSig;

package/modules/camo-runtime/src/utils/browser-service.mjs

@@ -215,6 +215,7 @@ function buildDomSnapshotScript(maxDepth, maxChildren) {
     const root = collect(document.body || document.documentElement, 0, 'root');
     return {
       dom_tree: root,
+      current_url: String(window.location.href || ''),
       viewport: {
         width: viewportWidth,
         height: viewportHeight,
@@ -238,6 +239,9 @@ export async function getDomSnapshotByProfile(profileId, options = {}) {
       height: Number(payload.viewport.height) || 0,
     };
   }
+  if (tree && payload.current_url) {
+    tree.__url = String(payload.current_url);
+  }
   return tree;
 }