@web-auto/webauto 0.1.13 → 0.1.15

package/apps/webauto/entry/xhs-status.mjs

@@ -60,9 +60,11 @@ function extractErrorEvents(events = [], limit = 20) {
   for (const event of events) {
     const payload = event?.data && typeof event.data === 'object' ? event.data : event;
     const type = asText(payload?.type || payload?.event || '').toLowerCase();
+    if (type.includes('operation_progress')) continue;
     const hasErrorType = type.includes('error') || type.includes('fail');
+    const hasExplicitError = Boolean(payload?.error);
     const errText = asText(payload?.error || payload?.message || payload?.reason || '');
-    if (!hasErrorType && !errText) continue;
+    if (!hasErrorType && !hasExplicitError) continue;
     items.push({
       ts: asText(payload?.timestamp || payload?.ts || ''),
       type: type || 'error',

package/apps/webauto/entry/xhs-unified.mjs

@@ -13,6 +13,7 @@ import { listAccountProfiles, markProfileInvalid } from './lib/account-store.mjs
 import { listProfilesForPool } from './lib/profilepool.mjs';
 import { runCamo } from './lib/camo-cli.mjs';
 import { publishBusEvent } from './lib/bus-publish.mjs';
+import { resolvePlatformFlowGate } from './lib/flow-gate.mjs';
 
 function nowIso() {
   return new Date().toISOString();
@@ -45,6 +46,13 @@ function parseNonNegativeInt(value, fallback = 0) {
   return Math.max(0, Math.floor(num));
 }
 
+function pickRandomInt(min, max) {
+  const floorMin = Math.max(0, Math.floor(Number(min) || 0));
+  const floorMax = Math.max(floorMin, Math.floor(Number(max) || 0));
+  if (floorMax <= floorMin) return floorMin;
+  return floorMin + Math.floor(Math.random() * (floorMax - floorMin + 1));
+}
+
 function parseProfiles(argv) {
   const profile = String(argv.profile || '').trim();
   const profilesRaw = String(argv.profiles || '').trim();
@@ -301,7 +309,7 @@ function createTaskReporter(seed = {}) {
   };
 }
 
-function buildTemplateOptions(argv, profileId, overrides = {}) {
+async function buildTemplateOptions(argv, profileId, overrides = {}) {
   const keyword = String(argv.keyword || argv.k || '').trim();
   const env = String(argv.env || 'prod').trim() || 'prod';
   const inputMode = String(argv['input-mode'] || 'protocol').trim() || 'protocol';
@@ -309,9 +317,63 @@ function buildTemplateOptions(argv, profileId, overrides = {}) {
   const ocrCommand = String(argv['ocr-command'] || '').trim();
   const maxNotes = parseIntFlag(argv['max-notes'] ?? argv.target, 30, 1);
   const maxComments = parseNonNegativeInt(argv['max-comments'], 0);
-  const throttle = parseIntFlag(argv.throttle, 500, 100);
-  const tabCount = parseIntFlag(argv['tab-count'], 4, 1);
-  const noteIntervalMs = parseIntFlag(argv['note-interval'], 900, 200);
+  let flowGate = null;
+  try {
+    flowGate = await resolvePlatformFlowGate('xiaohongshu');
+  } catch {
+    flowGate = null;
+  }
+
+  const throttleMin = parseIntFlag(flowGate?.throttle?.minMs, 900, 100);
+  const throttleMax = parseIntFlag(flowGate?.throttle?.maxMs, 1800, throttleMin);
+  const noteIntervalMin = parseIntFlag(flowGate?.noteInterval?.minMs, 2200, 200);
+  const noteIntervalMax = parseIntFlag(flowGate?.noteInterval?.maxMs, 4200, noteIntervalMin);
+  const tabCountDefault = parseIntFlag(flowGate?.tabPool?.tabCount, 1, 1);
+  const tabOpenDelayMin = parseIntFlag(flowGate?.tabPool?.openDelayMinMs, 1400, 0);
+  const tabOpenDelayMax = parseIntFlag(flowGate?.tabPool?.openDelayMaxMs, 2800, tabOpenDelayMin);
+  const submitMethodDefault = String(flowGate?.submitSearch?.method || 'click').trim().toLowerCase() || 'click';
+  const submitActionDelayMinDefault = parseIntFlag(flowGate?.submitSearch?.actionDelayMinMs, 180, 20);
+  const submitActionDelayMaxDefault = parseIntFlag(flowGate?.submitSearch?.actionDelayMaxMs, 620, submitActionDelayMinDefault);
+  const submitSettleMinDefault = parseIntFlag(flowGate?.submitSearch?.settleMinMs, 1200, 60);
+  const submitSettleMaxDefault = parseIntFlag(flowGate?.submitSearch?.settleMaxMs, 2600, submitSettleMinDefault);
+  const openDetailPreClickMinDefault = parseIntFlag(flowGate?.openDetail?.preClickMinMs, 220, 60);
+  const openDetailPreClickMaxDefault = parseIntFlag(flowGate?.openDetail?.preClickMaxMs, 700, openDetailPreClickMinDefault);
+  const openDetailPollDelayMinDefault = parseIntFlag(flowGate?.openDetail?.pollDelayMinMs, 130, 80);
+  const openDetailPollDelayMaxDefault = parseIntFlag(flowGate?.openDetail?.pollDelayMaxMs, 320, openDetailPollDelayMinDefault);
+  const openDetailPostOpenMinDefault = parseIntFlag(flowGate?.openDetail?.postOpenMinMs, 420, 120);
+  const openDetailPostOpenMaxDefault = parseIntFlag(flowGate?.openDetail?.postOpenMaxMs, 1100, openDetailPostOpenMinDefault);
+  const commentsScrollStepMinDefault = parseIntFlag(flowGate?.commentsHarvest?.scrollStepMin, 280, 120);
+  const commentsScrollStepMaxDefault = parseIntFlag(flowGate?.commentsHarvest?.scrollStepMax, 420, commentsScrollStepMinDefault);
+  const commentsSettleMinDefault = parseIntFlag(flowGate?.commentsHarvest?.settleMinMs, 280, 80);
+  const commentsSettleMaxDefault = parseIntFlag(flowGate?.commentsHarvest?.settleMaxMs, 820, commentsSettleMinDefault);
+  const defaultOperationMinIntervalDefault = parseIntFlag(flowGate?.pacing?.defaultOperationMinIntervalMs, 1200, 0);
+  const defaultEventCooldownDefault = parseIntFlag(flowGate?.pacing?.defaultEventCooldownMs, 700, 0);
+  const defaultPacingJitterDefault = parseIntFlag(flowGate?.pacing?.defaultJitterMs, 900, 0);
+  const navigationMinIntervalDefault = parseIntFlag(flowGate?.pacing?.navigationMinIntervalMs, 2200, 0);
+
+  const throttle = parseIntFlag(argv.throttle, pickRandomInt(throttleMin, throttleMax), 100);
+  const tabCount = parseIntFlag(argv['tab-count'], tabCountDefault, 1);
+  const noteIntervalMs = parseIntFlag(argv['note-interval'], pickRandomInt(noteIntervalMin, noteIntervalMax), 200);
+  const tabOpenDelayMs = parseIntFlag(argv['tab-open-delay'], pickRandomInt(tabOpenDelayMin, tabOpenDelayMax), 0);
+  const submitMethod = String(argv['search-submit-method'] || submitMethodDefault).trim().toLowerCase() || 'click';
+  const submitActionDelayMinMs = parseIntFlag(argv['submit-action-delay-min'], submitActionDelayMinDefault, 20);
+  const submitActionDelayMaxMs = parseIntFlag(argv['submit-action-delay-max'], submitActionDelayMaxDefault, submitActionDelayMinMs);
+  const submitSettleMinMs = parseIntFlag(argv['submit-settle-min'], submitSettleMinDefault, 60);
+  const submitSettleMaxMs = parseIntFlag(argv['submit-settle-max'], submitSettleMaxDefault, submitSettleMinMs);
+  const openDetailPreClickMinMs = parseIntFlag(argv['open-detail-preclick-min'], openDetailPreClickMinDefault, 60);
+  const openDetailPreClickMaxMs = parseIntFlag(argv['open-detail-preclick-max'], openDetailPreClickMaxDefault, openDetailPreClickMinMs);
+  const openDetailPollDelayMinMs = parseIntFlag(argv['open-detail-poll-min'], openDetailPollDelayMinDefault, 80);
+  const openDetailPollDelayMaxMs = parseIntFlag(argv['open-detail-poll-max'], openDetailPollDelayMaxDefault, openDetailPollDelayMinMs);
+  const openDetailPostOpenMinMs = parseIntFlag(argv['open-detail-postopen-min'], openDetailPostOpenMinDefault, 120);
+  const openDetailPostOpenMaxMs = parseIntFlag(argv['open-detail-postopen-max'], openDetailPostOpenMaxDefault, openDetailPostOpenMinMs);
+  const commentsScrollStepMin = parseIntFlag(argv['comments-scroll-step-min'], commentsScrollStepMinDefault, 120);
+  const commentsScrollStepMax = parseIntFlag(argv['comments-scroll-step-max'], commentsScrollStepMaxDefault, commentsScrollStepMin);
+  const commentsSettleMinMs = parseIntFlag(argv['comments-settle-min'], commentsSettleMinDefault, 80);
+  const commentsSettleMaxMs = parseIntFlag(argv['comments-settle-max'], commentsSettleMaxDefault, commentsSettleMinMs);
+  const defaultOperationMinIntervalMs = parseIntFlag(argv['operation-min-interval'], defaultOperationMinIntervalDefault, 0);
+  const defaultEventCooldownMs = parseIntFlag(argv['event-cooldown'], defaultEventCooldownDefault, 0);
+  const defaultPacingJitterMs = parseIntFlag(argv['pacing-jitter'], defaultPacingJitterDefault, 0);
+  const navigationMinIntervalMs = parseIntFlag(argv['navigation-min-interval'], navigationMinIntervalDefault, 0);
   const maxLikesPerRound = parseNonNegativeInt(argv['max-likes'], 0);
   const matchMode = String(argv['match-mode'] || 'any').trim() || 'any';
   const matchMinHits = parseIntFlag(argv['match-min-hits'], 1, 1);
@@ -348,7 +410,27 @@ function buildTemplateOptions(argv, profileId, overrides = {}) {
     outputRoot,
     throttle,
     tabCount,
+    tabOpenDelayMs,
     noteIntervalMs,
+    submitMethod,
+    submitActionDelayMinMs,
+    submitActionDelayMaxMs,
+    submitSettleMinMs,
+    submitSettleMaxMs,
+    openDetailPreClickMinMs,
+    openDetailPreClickMaxMs,
+    openDetailPollDelayMinMs,
+    openDetailPollDelayMaxMs,
+    openDetailPostOpenMinMs,
+    openDetailPostOpenMaxMs,
+    commentsScrollStepMin,
+    commentsScrollStepMax,
+    commentsSettleMinMs,
+    commentsSettleMaxMs,
+    defaultOperationMinIntervalMs,
+    defaultEventCooldownMs,
+    defaultPacingJitterMs,
+    navigationMinIntervalMs,
     maxNotes,
     maxComments,
     maxLikesPerRound,
@@ -524,6 +606,7 @@ async function runProfile(spec, argv, baseOverrides = {}) {
     'xhs.unified.stop_screenshot',
     'xhs.unified.profile_failed',
     'autoscript:operation_done',
+    'autoscript:operation_progress',
     'autoscript:operation_error',
     'autoscript:operation_terminal',
     'autoscript:operation_recovery_failed',
@@ -542,7 +625,24 @@ async function runProfile(spec, argv, baseOverrides = {}) {
   if (spec.seedCollectMaxRounds !== undefined && spec.seedCollectMaxRounds !== null) {
     overrides.seedCollectMaxRounds = parseNonNegativeInt(spec.seedCollectMaxRounds, 0);
   }
-  const options = buildTemplateOptions(argv, profileId, overrides);
+  const options = await buildTemplateOptions(argv, profileId, overrides);
+  console.log(JSON.stringify({
+    event: 'xhs.unified.flow_gate',
+    profileId,
+    throttle: options.throttle,
+    noteIntervalMs: options.noteIntervalMs,
+    tabCount: options.tabCount,
+    tabOpenDelayMs: options.tabOpenDelayMs,
+    submitMethod: options.submitMethod,
+    submitActionDelayMinMs: options.submitActionDelayMinMs,
+    submitActionDelayMaxMs: options.submitActionDelayMaxMs,
+    submitSettleMinMs: options.submitSettleMinMs,
+    submitSettleMaxMs: options.submitSettleMaxMs,
+    commentsScrollStepMin: options.commentsScrollStepMin,
+    commentsScrollStepMax: options.commentsScrollStepMax,
+    commentsSettleMinMs: options.commentsSettleMinMs,
+    commentsSettleMaxMs: options.commentsSettleMaxMs,
+  }));
   const script = buildXhsUnifiedAutoscript(options);
   const normalized = normalizeAutoscript(script, `xhs-unified:${profileId}`);
   const validation = validateAutoscript(normalized);
@@ -601,6 +701,7 @@ async function runProfile(spec, argv, baseOverrides = {}) {
       || eventName === 'autoscript:stop'
       || eventName === 'autoscript:impact'
       || eventName === 'autoscript:operation_start'
+      || eventName === 'autoscript:operation_progress'
       || eventName === 'autoscript:operation_done'
       || eventName === 'autoscript:operation_error'
       || eventName === 'autoscript:operation_recovery_failed'
@@ -1281,6 +1382,11 @@ async function main() {
       '  --seed-collect-rounds <n>    首账号预采样滚动轮数（默认6）',
       '  --search-serial-key <key>    搜索阶段串行锁key（默认自动生成）',
       '  --shared-harvest-path <path> 共享harvest去重列表路径（默认自动生成）',
+      '  --search-submit-method <m>   搜索提交方式 click|enter|form（默认 flow-gate）',
+      '  --tab-open-delay <ms>        新开 tab 间隔（默认 flow-gate 区间随机）',
+      '  --operation-min-interval <ms> 基础操作最小间隔（默认 flow-gate）',
+      '  --event-cooldown <ms>        基础事件冷却（默认 flow-gate）',
+      '  --pacing-jitter <ms>         基础抖动区间（默认 flow-gate）',
     ].join('\n'));
     return;
   }

package/bin/webauto.mjs

@@ -108,6 +108,7 @@ function resolveOnPath(candidates) {
 function wrapWindowsRunner(cmdPath, prefix = []) {
   if (process.platform !== 'win32') return { cmd: cmdPath, prefix };
   const lower = String(cmdPath || '').toLowerCase();
+  const quotedCmdPath = /\s/.test(String(cmdPath || '')) ? `"${cmdPath}"` : cmdPath;
   if (lower.endsWith('.ps1')) {
     return {
       cmd: 'powershell.exe',
@@ -117,7 +118,7 @@ function wrapWindowsRunner(cmdPath, prefix = []) {
   if (lower.endsWith('.cmd') || lower.endsWith('.bat')) {
     return {
       cmd: 'cmd.exe',
-      prefix: ['/d', '/s', '/c', cmdPath, ...prefix],
+      prefix: ['/d', '/s', '/c', quotedCmdPath, ...prefix],
     };
   }
   return { cmd: cmdPath, prefix };
@@ -125,9 +126,9 @@ function wrapWindowsRunner(cmdPath, prefix = []) {
 
 function npmRunner() {
   if (process.platform !== 'win32') return { cmd: 'npm', prefix: [] };
-  const npmNames = ['npm.cmd', 'npm.exe', 'npm.bat', 'npm.ps1'];
-  const resolved = resolveOnPath(npmNames) || 'npm.cmd';
-  return wrapWindowsRunner(resolved);
+  // Always prefer PATH-resolved npm.cmd to avoid space-path quoting issues
+  // like "C:\Program Files\..." when invoking via cmd /c.
+  return wrapWindowsRunner('npm.cmd');
 }
 
 function uiConsoleScriptPath() {
@@ -166,6 +167,7 @@ Core Commands:
   webauto xhs install [--download-browser] [--download-geoip] [--ensure-backend]
   webauto xhs unified [xhs options...]
   webauto xhs status [--run-id <id>] [--json]
+  webauto xhs gate <get|list|set|reset|path> [--platform <name>] [--patch-json <json>] [--json]
   webauto xhs orchestrate [xhs options...]
   webauto version [--json]
   webauto version bump [patch|minor|major]
@@ -265,12 +267,14 @@ Usage:
   webauto xhs install [--download-browser] [--download-geoip] [--ensure-backend] [--install|--reinstall|--uninstall] [--browser|--geoip|--all]
   webauto xhs unified --profile <id> --keyword <kw> [options...]
   webauto xhs status [--run-id <id>] [--json]
+  webauto xhs gate <get|list|set|reset|path> [--platform <name>] [--patch-json <json>] [--json]
   webauto xhs orchestrate --profile <id> --keyword <kw> [options...]
 
 Subcommands:
   install      运行资源管理（兼容旧入口），支持检查/安装/卸载/重装 camoufox、geoip，按需拉起 backend
   unified      运行统一脚本（搜索 + 打开详情 + 评论抓取 + 点赞）
   status       查询当前任务状态与错误摘要（支持 runId 详情）
+  gate         管理平台流控参数（默认配置可修改并自动生效）
   orchestrate  运行编排入口（默认调用 unified 模式）
 
 Unified Required:
@@ -285,8 +289,8 @@ Unified Common Options:
   --concurrency <n>        并行度（默认=账号数）
   --plan-only              仅生成分片计划，不执行
   --tab-count <n>          轮询 tab 数，默认 4
-  --throttle <ms>          操作节流，默认 500
-  --note-interval <ms>     帖子间等待，默认 900
+  --throttle <ms>          操作节流（默认走 flow-gate 平台配置并随机化）
+  --note-interval <ms>     帖子间等待（默认走 flow-gate 平台配置并随机化）
   --env <name>             输出环境目录，默认 debug
   --output-root <path>     自定义输出根目录
   --dry-run                干跑（禁用点赞/回复）
@@ -331,6 +335,10 @@ Standard Workflows:
      webauto xhs status
      webauto xhs status --run-id <runId> --json
 
+  7) 查看/修改流控 gate（按平台隔离）
+     webauto xhs gate get --platform xiaohongshu --json
+     webauto xhs gate set --platform xiaohongshu --patch-json '{"noteInterval":{"minMs":2600,"maxMs":5200}}' --json
+
 Output:
   默认目录: ~/.webauto/download/xiaohongshu/<env>/<keyword>/
   典型产物:
@@ -477,17 +485,12 @@ async function runInDir(dir, cmd, args) {
 }
 
 function checkDesktopConsoleDeps() {
-  if (isGlobalInstall()) return true;
-  // Check for electron in various locations:
-  // 1. Global npm root (when installed globally alongside webauto)
-  // 2. Package's own node_modules
-  // 3. apps/desktop-console/node_modules (local dev)
-  const globalRoot = path.resolve(ROOT, '..', '..');
-  return (
-    exists(path.join(globalRoot, 'electron')) ||
-    exists(path.join(ROOT, 'node_modules', 'electron')) ||
-    exists(path.join(ROOT, 'apps', 'desktop-console', 'node_modules', 'electron'))
-  );
+  const electronName = process.platform === 'win32' ? 'electron.exe' : 'electron';
+  const candidates = [
+    path.join(ROOT, 'node_modules', 'electron', 'dist', electronName),
+    path.join(ROOT, 'apps', 'desktop-console', 'node_modules', 'electron', 'dist', electronName),
+  ];
+  return candidates.some((p) => exists(p));
 }
 
 function checkDesktopConsoleBuilt() {
@@ -510,6 +513,15 @@ async function ensureDepsAndBuild() {
 
   // Global package should already ship renderer build.
   if (isGlobalInstall()) {
+    if (!checkDesktopConsoleDeps()) {
+      console.log('[webauto] Installing desktop-console runtime dependencies...');
+      const npm = npmRunner();
+      await run(npm.cmd, [...npm.prefix, '--prefix', appDir, '--workspaces=false', 'install', '--omit=dev']);
+    }
+    if (!checkDesktopConsoleDeps()) {
+      console.error('❌ electron runtime installation failed for desktop-console.');
+      process.exit(1);
+    }
     if (!checkDesktopConsoleBuilt()) {
       console.error('❌ desktop-console dist missing from package. Please reinstall @web-auto/webauto.');
       process.exit(1);
@@ -540,62 +552,80 @@ async function ensureDepsAndBuild() {
   console.log('[webauto] Setup complete!');
 }
 
-async function uiConsole({ build, install, checkOnly, noDaemon }) {
-  console.log(`[webauto] version ${ROOT_VERSION}`);
-  const okServices = checkServicesBuilt();
-  const okDeps = checkDesktopConsoleDeps();
-  const okUiBuilt = checkDesktopConsoleBuilt();
-
-  if (checkOnly) {
-    console.log(`[check] repoRoot: ${ROOT}`);
-    console.log(`[check] dist/services: ${okServices ? 'OK' : 'MISSING'}`);
-    console.log(`[check] desktop-console deps: ${okDeps ? 'OK' : 'MISSING'}`);
-    console.log(`[check] desktop-console dist: ${okUiBuilt ? 'OK' : 'MISSING'}`);
-    console.log(`[check] isGlobalInstall: ${isGlobalInstall()}`);
-    return;
-  }
+async function ensureUiRuntimeReady({ build, install }) {
+  let okServices = checkServicesBuilt();
+  let okDeps = checkDesktopConsoleDeps();
+  let okUiBuilt = checkDesktopConsoleBuilt();
 
-  // For global install, auto-setup on first run
   if (isGlobalInstall()) {
     const state = loadState();
     const pkgJson = JSON.parse(readFileSync(path.join(ROOT, 'package.json'), 'utf-8'));
-    if (!state.initialized || state.version !== pkgJson.version) {
+    if (!state.initialized || state.version !== pkgJson.version || !okDeps || !okUiBuilt) {
       await ensureDepsAndBuild();
+      okDeps = checkDesktopConsoleDeps();
+      okUiBuilt = checkDesktopConsoleBuilt();
     }
-  } else {
-    // Local dev mode - require explicit build
-    if (!okServices) {
-      if (!build) {
-        console.error('❌ missing dist/ (services/modules). Run: npm run build:services');
-        process.exit(2);
-      }
-      const npm = npmRunner();
-      await run(npm.cmd, [...npm.prefix, 'run', 'build:services']);
+  } else if (!okServices) {
+    if (!build) {
+      console.error('❌ missing dist/ (services/modules). Run: npm run build:services');
+      process.exit(2);
     }
+    const npm = npmRunner();
+    await run(npm.cmd, [...npm.prefix, 'run', 'build:services']);
+    okServices = checkServicesBuilt();
   }
 
   if (!okDeps) {
-    // For global install, okDeps is always true since we check global electron
-    // For local dev, require explicit --install or --build
-    if (!isGlobalInstall() && !install && !build) {
-      console.error('❌ missing apps/desktop-console/node_modules. Run: npm --prefix apps/desktop-console install');
+    if (isGlobalInstall()) {
+      console.error('❌ electron runtime missing from installed package after setup.');
       process.exit(2);
     }
-    if (!isGlobalInstall()) {
-      const npm = npmRunner();
-      await runInDir(path.join(ROOT, 'apps', 'desktop-console'), npm.cmd, [...npm.prefix, 'install']);
+    if (!install && !build) {
+      console.error('❌ missing apps/desktop-console/node_modules. Run: npm --prefix apps/desktop-console install');
+      process.exit(2);
     }
+    const npm = npmRunner();
+    await runInDir(path.join(ROOT, 'apps', 'desktop-console'), npm.cmd, [...npm.prefix, 'install']);
+    okDeps = checkDesktopConsoleDeps();
   }
 
   if (!okUiBuilt) {
+    if (isGlobalInstall()) {
+      console.error('❌ missing apps/desktop-console/dist in installed package after setup.');
+      process.exit(2);
+    }
     if (!build) {
       console.error('❌ missing apps/desktop-console/dist. Run: npm --prefix apps/desktop-console run build');
       process.exit(2);
     }
     const npm = npmRunner();
     await runInDir(path.join(ROOT, 'apps', 'desktop-console'), npm.cmd, [...npm.prefix, 'run', 'build']);
+    okUiBuilt = checkDesktopConsoleBuilt();
+  }
+
+  if (!okDeps || !okUiBuilt || (!isGlobalInstall() && !okServices)) {
+    console.error('❌ ui runtime prerequisites are not ready');
+    process.exit(2);
+  }
+}
+
+async function uiConsole({ build, install, checkOnly, noDaemon }) {
+  console.log(`[webauto] version ${ROOT_VERSION}`);
+  const okServices = checkServicesBuilt();
+  const okDeps = checkDesktopConsoleDeps();
+  const okUiBuilt = checkDesktopConsoleBuilt();
+
+  if (checkOnly) {
+    console.log(`[check] repoRoot: ${ROOT}`);
+    console.log(`[check] dist/services: ${okServices ? 'OK' : 'MISSING'}`);
+    console.log(`[check] desktop-console deps: ${okDeps ? 'OK' : 'MISSING'}`);
+    console.log(`[check] desktop-console dist: ${okUiBuilt ? 'OK' : 'MISSING'}`);
+    console.log(`[check] isGlobalInstall: ${isGlobalInstall()}`);
+    return;
   }
 
+  await ensureUiRuntimeReady({ build, install });
+
   const uiScript = uiConsoleScriptPath();
   const uiArgs = [];
   if (noDaemon) uiArgs.push('--no-daemon');
@@ -746,6 +776,10 @@ async function main() {
   }
 
   if (cmd === 'ui' && sub === 'cli') {
+    await ensureUiRuntimeReady({
+      build: args.build === true,
+      install: args.install === true,
+    });
     const script = path.join(ROOT, 'apps', 'desktop-console', 'entry', 'ui-cli.mjs');
     await run(process.execPath, [script, ...rawArgv.slice(2)]);
     return;
@@ -842,6 +876,12 @@ async function main() {
       return;
     }
 
+    if (sub === 'gate') {
+      const script = path.join(ROOT, 'apps', 'webauto', 'entry', 'flow-gate.mjs');
+      await run(process.execPath, [script, ...rawArgv.slice(2)]);
+      return;
+    }
+
     if (sub === 'orchestrate') {
       const script = path.join(ROOT, 'apps', 'webauto', 'entry', 'xhs-orchestrate.mjs');
       await run(process.execPath, [script, ...rawArgv.slice(2)]);

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

@@ -1,9 +1,58 @@
 #!/usr/bin/env node
-import { execSync } from 'node:child_process';
+import { execSync, spawnSync } from 'node:child_process';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
 import { BROWSER_SERVICE_URL, loadConfig, setRepoRoot } from './config.mjs';
+const requireFromHere = createRequire(import.meta.url);
+const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
+function resolveNodeBin() {
+    const explicit = String(process.env.WEBAUTO_NODE_BIN || '').trim();
+    if (explicit)
+        return explicit;
+    const npmNode = String(process.env.npm_node_execpath || '').trim();
+    if (npmNode)
+        return npmNode;
+    return process.execPath;
+}
+function resolveCamoCliEntry() {
+    try {
+        const resolved = requireFromHere.resolve('@web-auto/camo/bin/camo.mjs');
+        if (resolved && fs.existsSync(resolved))
+            return resolved;
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+function runCamoCli(args = [], options = {}) {
+    const entry = resolveCamoCliEntry();
+    if (!entry) {
+        return {
+            ok: false,
+            code: null,
+            stdout: '',
+            stderr: '@web-auto/camo/bin/camo.mjs not found',
+            entry: null,
+        };
+    }
+    const ret = spawnSync(resolveNodeBin(), [entry, ...args], {
+        encoding: 'utf8',
+        windowsHide: true,
+        stdio: options.stdio || 'pipe',
+        env: { ...process.env, ...(options.env || {}) },
+    });
+    return {
+        ok: ret.status === 0,
+        code: ret.status,
+        stdout: String(ret.stdout || ''),
+        stderr: String(ret.stderr || ''),
+        entry,
+    };
+}
 export async function callAPI(action, payload = {}) {
     const r = await fetch(`${BROWSER_SERVICE_URL}/command`, {
         method: 'POST',
@@ -319,20 +368,13 @@ function scanCommonRepoRoots() {
 }
 export function findRepoRootCandidate() {
     const cfg = loadConfig();
+    const cwdRoot = walkUpForRepoRoot(process.cwd());
+    const moduleRoot = walkUpForRepoRoot(MODULE_DIR);
     const candidates = [
         process.env.WEBAUTO_REPO_ROOT,
-        process.cwd(),
         cfg.repoRoot,
-        path.join('/Volumes', 'extension', 'code', 'webauto'),
-        path.join('/Volumes', 'extension', 'code', 'WebAuto'),
-        path.join(os.homedir(), 'Documents', 'github', 'webauto'),
-        path.join(os.homedir(), 'Documents', 'github', 'WebAuto'),
-        path.join(os.homedir(), 'github', 'webauto'),
-        path.join(os.homedir(), 'github', 'WebAuto'),
-        path.join('C:', 'code', 'webauto'),
-        path.join('C:', 'code', 'WebAuto'),
-        path.join('C:', 'Users', os.userInfo().username, 'code', 'webauto'),
-        path.join('C:', 'Users', os.userInfo().username, 'code', 'WebAuto'),
+        moduleRoot,
+        cwdRoot,
     ].filter(Boolean);
     for (const root of candidates) {
         if (!hasContainerLibrary(root))
@@ -343,20 +385,6 @@ export function findRepoRootCandidate() {
         }
         return resolved;
     }
-    const walked = walkUpForRepoRoot(process.cwd());
-    if (walked) {
-        if (cfg.repoRoot !== walked) {
-            setRepoRoot(walked);
-        }
-        return walked;
-    }
-    const scanned = scanCommonRepoRoots();
-    if (scanned) {
-        if (cfg.repoRoot !== scanned) {
-            setRepoRoot(scanned);
-        }
-        return scanned;
-    }
     return null;
 }
 export function detectCamoufoxPath() {
@@ -381,12 +409,7 @@ export function detectCamoufoxPath() {
 export function ensureCamoufox() {
     if (detectCamoufoxPath())
         return;
-    console.log('Camoufox is not found. Installing...');
-    execSync('npx --yes --package=camoufox camoufox fetch', { stdio: 'inherit' });
-    if (!detectCamoufoxPath()) {
-        throw new Error('Camoufox install finished but executable was not detected');
-    }
-    console.log('Camoufox installed.');
+    throw new Error('Camoufox is not installed. Run: webauto xhs install --download-browser');
 }
 export async function ensureBrowserService() {
     if (await checkBrowserService())
@@ -398,20 +421,17 @@ export async function ensureBrowserService() {
     }
     if (provider === 'camo') {
         const repoRoot = findRepoRootCandidate();
-        if (repoRoot) {
-            try {
-                execSync(`npx --yes @web-auto/camo config repo-root ${JSON.stringify(repoRoot)}`, { stdio: 'ignore' });
-            }
-            catch {
-                // best-effort only; init will still try using current config
-            }
+        if (!repoRoot) {
+            throw new Error('WEBAUTO_REPO_ROOT is not set and no valid repo root was found');
         }
-        try {
-            console.log('Starting browser backend via camo init...');
-            execSync('npx --yes @web-auto/camo init', { stdio: 'inherit' });
+        const configRet = runCamoCli(['config', 'repo-root', repoRoot], { stdio: 'pipe' });
+        if (!configRet.ok) {
+            throw new Error(`camo config repo-root failed: ${configRet.stderr.trim() || configRet.stdout.trim() || `exit ${configRet.code ?? 'null'}`}`);
         }
-        catch (error) {
-            throw new Error(`camo init failed: ${error?.message || String(error)}`);
+        console.log('Starting browser backend via camo init...');
+        const initRet = runCamoCli(['init'], { stdio: 'inherit' });
+        if (!initRet.ok) {
+            throw new Error(`camo init failed: ${initRet.stderr.trim() || initRet.stdout.trim() || `exit ${initRet.code ?? 'null'}`}`);
         }
         for (let i = 0; i < 20; i += 1) {
             await new Promise((r) => setTimeout(r, 400));

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

@@ -1,9 +1,20 @@
 import { executeXhsAutoscriptOperation, isXhsAutoscriptAction } from './xhs.mjs';
 
-export async function executeAutoscriptAction({ profileId, action, params = {} }) {
+export async function executeAutoscriptAction({
+  profileId,
+  action,
+  params = {},
+  operation = null,
+  context = {},
+}) {
   if (isXhsAutoscriptAction(action)) {
-    return executeXhsAutoscriptOperation({ profileId, action, params });
+    return executeXhsAutoscriptOperation({
+      profileId,
+      action,
+      params,
+      operation,
+      context,
+    });
   }
   return null;
 }
-