@web-auto/webauto 0.1.8 → 0.1.11

package/bin/webauto.mjs

@@ -2,11 +2,67 @@
 import minimist from 'minimist';
 import { spawn } from 'node:child_process';
 import { existsSync, writeFileSync, readFileSync, mkdirSync } from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const STATE_FILE = path.join(process.env.HOME || process.env.USERPROFILE || '.', '.webauto', 'cli-state.json');
+
+function normalizePathForPlatform(raw, platform = process.platform) {
+  const input = String(raw || '').trim();
+  const isWinPath = platform === 'win32' || /^[A-Za-z]:[\\/]/.test(input);
+  const pathApi = isWinPath ? path.win32 : path;
+  return isWinPath ? pathApi.normalize(input) : path.resolve(input);
+}
+
+function normalizeLegacyWebautoRoot(raw, platform = process.platform) {
+  const pathApi = platform === 'win32' ? path.win32 : path;
+  const resolved = normalizePathForPlatform(raw, platform);
+  const base = pathApi.basename(resolved).toLowerCase();
+  return (base === '.webauto' || base === 'webauto')
+    ? resolved
+    : pathApi.join(resolved, '.webauto');
+}
+
+function resolveWebautoHome(env = process.env, platform = process.platform) {
+  const explicitHome = String(env.WEBAUTO_HOME || '').trim();
+  if (explicitHome) return normalizePathForPlatform(explicitHome, platform);
+
+  const legacyRoot = String(env.WEBAUTO_ROOT || env.WEBAUTO_PORTABLE_ROOT || '').trim();
+  if (legacyRoot) return normalizeLegacyWebautoRoot(legacyRoot, platform);
+
+  const homeDir = platform === 'win32'
+    ? (env.USERPROFILE || os.homedir())
+    : (env.HOME || os.homedir());
+  if (platform === 'win32') {
+    try {
+      if (existsSync('D:\\')) return 'D:\\webauto';
+    } catch {
+      // ignore drive detection errors
+    }
+    return path.win32.join(homeDir, '.webauto');
+  }
+  return path.join(homeDir, '.webauto');
+}
+
+function applyDefaultRuntimeEnv() {
+  if (!String(process.env.WEBAUTO_REPO_ROOT || '').trim()) {
+    process.env.WEBAUTO_REPO_ROOT = ROOT;
+  }
+  if (isGlobalInstall() && !String(process.env.WEBAUTO_SKIP_BUILD_CHECK || '').trim()) {
+    process.env.WEBAUTO_SKIP_BUILD_CHECK = '1';
+  }
+  if (
+    !String(process.env.WEBAUTO_HOME || '').trim()
+    && !String(process.env.WEBAUTO_ROOT || process.env.WEBAUTO_PORTABLE_ROOT || '').trim()
+  ) {
+    process.env.WEBAUTO_HOME = resolveWebautoHome();
+  }
+}
+
+applyDefaultRuntimeEnv();
+
+const STATE_FILE = path.join(resolveWebautoHome(), 'cli-state.json');
 
 function loadState() {
   try {
@@ -78,6 +134,17 @@ function uiConsoleScriptPath() {
   return path.join(ROOT, 'apps', 'desktop-console', 'entry', 'ui-console.mjs');
 }
 
+function readRootVersion() {
+  try {
+    const pkg = JSON.parse(readFileSync(path.join(ROOT, 'package.json'), 'utf8'));
+    return String(pkg.version || '').trim() || '0.0.0';
+  } catch {
+    return '0.0.0';
+  }
+}
+
+const ROOT_VERSION = readRootVersion();
+
 function printMainHelp() {
   console.log(`webauto CLI
 
@@ -100,10 +167,14 @@ Core Commands:
   webauto xhs unified [xhs options...]
   webauto xhs status [--run-id <id>] [--json]
   webauto xhs orchestrate [xhs options...]
+  webauto version [--json]
+  webauto version bump [patch|minor|major]
 
 Build & Release:
   webauto build:dev        # Local link mode
-  webauto build:release    # Full release gate (tests/build/pack)
+  webauto build:release    # Full release gate (默认自动 bump patch 版本)
+  webauto build:release -- --bump minor
+  webauto build:release -- --no-bump
   webauto build:release -- --skip-tests
   webauto build:release -- --skip-pack
 
@@ -132,6 +203,7 @@ Tips:
   - account 命令会转发到 apps/webauto/entry/account.mjs
   - schedule 命令会转发到 apps/webauto/entry/schedule.mjs
   - 全量参数请看: webauto xhs --help
+  - 当前 CLI 版本: ${ROOT_VERSION}
 `);
 }
 
@@ -342,6 +414,21 @@ Examples:
 `);
 }
 
+function printVersionHelp() {
+  console.log(`webauto version
+
+Usage:
+  webauto version [--json]
+  webauto version bump [patch|minor|major] [--json]
+
+Examples:
+  webauto version
+  webauto version --json
+  webauto version bump
+  webauto version bump minor
+`);
+}
+
 function exists(p) {
   try {
     return existsSync(p);
@@ -454,6 +541,7 @@ async function ensureDepsAndBuild() {
 }
 
 async function uiConsole({ build, install, checkOnly, noDaemon }) {
+  console.log(`[webauto] version ${ROOT_VERSION}`);
   const okServices = checkServicesBuilt();
   const okDeps = checkDesktopConsoleDeps();
   const okUiBuilt = checkDesktopConsoleBuilt();
@@ -517,12 +605,14 @@ async function uiConsole({ build, install, checkOnly, noDaemon }) {
 async function main() {
   const rawArgv = process.argv.slice(2);
   const args = minimist(process.argv.slice(2), {
-    boolean: ['help', 'build', 'install', 'check', 'full', 'link', 'skip-tests', 'skip-pack', 'no-daemon'],
+    boolean: ['help', 'build', 'install', 'check', 'full', 'link', 'skip-tests', 'skip-pack', 'no-daemon', 'no-bump', 'json'],
+    string: ['bump'],
     alias: { h: 'help' },
   });
 
   const cmd = String(args._[0] || '').trim();
   const sub = String(args._[1] || '').trim();
+  const noDaemon = rawArgv.includes('--no-daemon') || rawArgv.includes('--foreground') || args['no-daemon'] === true;
 
   if (args.help) {
     if (cmd === 'account') {
@@ -551,6 +641,10 @@ async function main() {
       printXhsHelp();
       return;
     }
+    if (cmd === 'version') {
+      printVersionHelp();
+      return;
+    }
     printMainHelp();
     return;
   }
@@ -560,11 +654,37 @@ async function main() {
       build: false,
       install: false,
       checkOnly: false,
-      noDaemon: args['no-daemon'] === true,
+      noDaemon,
     });
     return;
   }
 
+  if (cmd === 'version') {
+    const jsonMode = args.json === true;
+    const action = String(args._[1] || '').trim();
+    if (!action) {
+      const out = { name: '@web-auto/webauto', version: ROOT_VERSION };
+      if (jsonMode) console.log(JSON.stringify(out, null, 2));
+      else console.log(`@web-auto/webauto v${ROOT_VERSION}`);
+      return;
+    }
+    if (action !== 'bump') {
+      console.error(`Unknown version action: ${action}`);
+      printVersionHelp();
+      process.exit(2);
+    }
+    const bumpType = String(args._[2] || args.bump || 'patch').trim().toLowerCase();
+    if (!['patch', 'minor', 'major'].includes(bumpType)) {
+      console.error(`Unsupported bump type: ${bumpType}`);
+      process.exit(2);
+    }
+    const script = path.join(ROOT, 'scripts', 'bump-version.mjs');
+    const cmdArgs = [script, bumpType];
+    if (jsonMode) cmdArgs.push('--json');
+    await run(process.execPath, cmdArgs);
+    return;
+  }
+
   // build:dev - local development mode
   if (cmd === 'build:dev') {
     console.log('[webauto] Running local dev setup...');
@@ -580,8 +700,20 @@ async function main() {
   if (cmd === 'build:release') {
     const skipTests = args['skip-tests'] === true;
     const skipPack = args['skip-pack'] === true;
+    const noBump = args['no-bump'] === true;
+    const bumpType = String(args.bump || 'patch').trim().toLowerCase();
+    if (!['patch', 'minor', 'major'].includes(bumpType)) {
+      console.error(`Unsupported --bump value: ${bumpType}`);
+      process.exit(2);
+    }
     console.log('[webauto] Running release gate...');
     const npm = npmRunner();
+    if (!noBump) {
+      const bumpScript = path.join(ROOT, 'scripts', 'bump-version.mjs');
+      await run(process.execPath, [bumpScript, bumpType]);
+    } else {
+      console.log('[webauto] Skip version bump (--no-bump)');
+    }
     await run(npm.cmd, [...npm.prefix, 'run', 'prebuild']);
     if (!skipTests) {
       await run(npm.cmd, [...npm.prefix, 'run', 'test:ci']);
@@ -608,7 +740,7 @@ async function main() {
       build: args.build === true,
       install: args.install === true,
       checkOnly: args.check === true,
-      noDaemon: args['no-daemon'] === true,
+      noDaemon,
     });
     return;
   }

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

@@ -213,6 +213,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,
@@ -235,6 +236,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;
 }
 export async function getViewportByProfile(profileId) {

package/dist/services/unified-api/server.js

@@ -274,11 +274,13 @@ class UnifiedApiServer {
                         return existing;
                     const profileId = String(seed?.profileId || 'unknown').trim() || 'unknown';
                     const keyword = String(seed?.keyword || '').trim();
+                    const uiTriggerId = String(seed?.uiTriggerId || seed?.triggerId || '').trim();
                     const phase = normalizeTaskPhase(seed?.phase);
                     return this.taskRegistry.createTask({
                         runId: normalizedRunId,
                         profileId,
                         keyword,
+                        uiTriggerId,
                         phase,
                     });
                 };
@@ -290,6 +292,7 @@ class UnifiedApiServer {
                     const phase = normalizeTaskPhase(payload?.phase);
                     const profileId = String(payload?.profileId || '').trim();
                     const keyword = String(payload?.keyword || '').trim();
+                    const uiTriggerId = String(payload?.uiTriggerId || payload?.triggerId || '').trim();
                     const details = payload?.details && typeof payload.details === 'object' ? payload.details : undefined;
                     const patch = {};
                     if (phase !== 'unknown')
@@ -298,6 +301,8 @@ class UnifiedApiServer {
                         patch.profileId = profileId;
                     if (keyword)
                         patch.keyword = keyword;
+                    if (uiTriggerId)
+                        patch.uiTriggerId = uiTriggerId;
                     if (details)
                         patch.details = details;
                     if (Object.keys(patch).length > 0) {

package/dist/services/unified-api/task-state.js

@@ -11,6 +11,7 @@ class TaskStateRegistry {
             runId: partial.runId,
             profileId: partial.profileId,
             keyword: partial.keyword,
+            uiTriggerId: partial.uiTriggerId ? String(partial.uiTriggerId).trim() : undefined,
             phase: partial.phase || 'unknown',
             status: 'starting',
             progress: { total: 0, processed: 0, failed: 0 },
@@ -22,6 +23,7 @@ class TaskStateRegistry {
                 imagesDownloaded: 0,
                 ocrProcessed: 0,
             },
+            createdAt: now,
             startedAt: now,
             updatedAt: now,
             details: {

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),