@web-auto/camo 0.1.13 → 0.1.15

package/README.md

@@ -302,7 +302,6 @@ camo container list [profileId]
 ### Autoscript
 
 ```bash
-camo autoscript scaffold xhs-unified [--output <file>] [options]
 camo autoscript validate <file>
 camo autoscript explain <file>
 camo autoscript snapshot <jsonl-file> [--out <snapshot-file>]
@@ -375,55 +374,38 @@ camo container watch xiaohongshu-batch-1 --throttle 500
 ### Autoscript Mode (Subscription + Operations)
 
 ```bash
-# Generate xiaohongshu unified-harvest migration script from webauto phase-unified-harvest
-camo autoscript scaffold xhs-unified \
-  --output ./autoscripts/xiaohongshu/unified-harvest.autoscript.json \
-  --profile xiaohongshu-batch-1 \
-  --keyword "手机膜" \
-  --tab-count 4 \
-  --note-interval 900 \
-  --do-comments \
-  --do-likes \
-  --max-notes 30
-
 # Validate + explain + run
-camo autoscript validate ./autoscripts/xiaohongshu/unified-harvest.autoscript.json
-camo autoscript explain ./autoscripts/xiaohongshu/unified-harvest.autoscript.json
-camo autoscript run ./autoscripts/xiaohongshu/unified-harvest.autoscript.json \
-  --profile xiaohongshu-batch-1 \
-  --jsonl-file ./runs/xhs-unified/run.jsonl \
-  --summary-file ./runs/xhs-unified/run.summary.json
+camo autoscript validate ./autoscripts/my-flow.autoscript.json
+camo autoscript explain ./autoscripts/my-flow.autoscript.json
+camo autoscript run ./autoscripts/my-flow.autoscript.json \
+  --profile my-profile \
+  --jsonl-file ./runs/my-flow/run.jsonl \
+  --summary-file ./runs/my-flow/run.summary.json
 
 # Build snapshot + replay summary from existing JSONL
-camo autoscript snapshot ./runs/xhs-unified/run.jsonl \
-  --out ./runs/xhs-unified/run.snapshot.json
-camo autoscript replay ./runs/xhs-unified/run.jsonl \
-  --summary-file ./runs/xhs-unified/replay.summary.json
+camo autoscript snapshot ./runs/my-flow/run.jsonl \
+  --out ./runs/my-flow/run.snapshot.json
+camo autoscript replay ./runs/my-flow/run.jsonl \
+  --summary-file ./runs/my-flow/replay.summary.json
 
 # Resume from a snapshot (optionally force rerun from a node)
-camo autoscript resume ./autoscripts/xiaohongshu/unified-harvest.autoscript.json \
-  --snapshot ./runs/xhs-unified/run.snapshot.json \
-  --from-node comments_harvest \
-  --profile xiaohongshu-batch-1
+camo autoscript resume ./autoscripts/my-flow.autoscript.json \
+  --snapshot ./runs/my-flow/run.snapshot.json \
+  --from-node some_operation \
+  --profile my-profile
 
 # Mock replay mode for deterministic local debugging
-camo autoscript mock-run ./autoscripts/xiaohongshu/unified-harvest.autoscript.json \
-  --fixture ./autoscripts/xiaohongshu/fixtures/mock-run.json \
-  --summary-file ./runs/xhs-unified/mock.summary.json
+camo autoscript mock-run ./autoscripts/my-flow.autoscript.json \
+  --fixture ./autoscripts/fixtures/mock-run.json \
+  --summary-file ./runs/my-flow/mock.summary.json
 ```
 
-The xhs-unified scaffold includes anti-risk defaults:
-- operation pacing (`operationMinIntervalMs`, `eventCooldownMs`, `jitterMs`)
-- navigation/tab switch cooldown (`navigationMinIntervalMs`)
-- per-operation timeout budget (`timeoutMs`)
-- multi-tab rotation (`ensure_tab_pool`, `tab_pool_switch_next`)
-
 Example script:
 
 ```json
 {
-  "name": "xhs-login-flow",
-  "profileId": "xiaohongshu-batch-1",
+  "name": "generic-login-flow",
+  "profileId": "my-profile",
   "throttle": 500,
   "subscriptions": [
     { "id": "login_input", "selector": "#login-input" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@web-auto/camo",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Camoufox Browser CLI - Cross-platform browser automation",
   "type": "module",
   "bin": {

package/src/autoscript/action-providers/index.mjs

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

package/src/autoscript/runtime.mjs

@@ -339,15 +339,6 @@ export class AutoscriptRunner {
       'tab_pool_switch_slot',
       'sync_window_viewport',
       'verify_subscriptions',
-      'xhs_submit_search',
-      'xhs_open_detail',
-      'xhs_detail_harvest',
-      'xhs_expand_replies',
-      'xhs_comments_harvest',
-      'xhs_comment_match',
-      'xhs_comment_like',
-      'xhs_comment_reply',
-      'xhs_close_detail',
     ].includes(action)) {
       return 45_000;
     }
@@ -363,6 +354,14 @@ export class AutoscriptRunner {
     return this.getDefaultTimeoutMs(operation);
   }
 
+  resolvePlatform(operation) {
+    const candidate = operation?.params?.platform
+      ?? operation?.platform
+      ?? this.script?.defaults?.platform
+      ?? 'generic';
+    return String(candidate || 'generic').trim().toLowerCase() || 'generic';
+  }
+
   buildTriggerKey(operation, event) {
     const trigger = operation?.trigger || { type: 'startup' };
     if (trigger.type === 'startup') return 'startup';
@@ -477,13 +476,14 @@ export class AutoscriptRunner {
         data: { phase },
       };
     }
+    const platform = this.resolvePlatform(operation);
     const validation = operation.validation || {};
     return validateOperation({
       profileId: this.profileId,
       validationSpec: validation,
       phase,
       context,
-      platform: 'xiaohongshu',
+      platform,
     });
   }
 
@@ -567,11 +567,12 @@ export class AutoscriptRunner {
       return { ok: false, code: 'RECOVERY_NOT_CONFIGURED', message: 'recovery not configured' };
     }
 
+    const platform = this.resolvePlatform(operation);
     const checkpointDoc = await captureCheckpoint({
       profileId: this.profileId,
       containerId: checkpoint.containerId || null,
       selector: operation.params?.selector || null,
-      platform: 'xiaohongshu',
+      platform,
     });
     const baseCheckpoint = checkpointDoc?.data || {};
 
@@ -585,7 +586,7 @@ export class AutoscriptRunner {
           containerId: checkpoint.containerId || null,
           selector: operation.params?.selector || null,
           targetCheckpoint: checkpoint.targetCheckpoint || null,
-          platform: 'xiaohongshu',
+          platform,
         });
         this.log('autoscript:recovery_action', {
           operationId: operation.id,

package/src/commands/autoscript.mjs

@@ -3,7 +3,6 @@ import path from 'node:path';
 import { getDefaultProfile } from '../utils/config.mjs';
 import { explainAutoscript, loadAndValidateAutoscript } from '../autoscript/schema.mjs';
 import { AutoscriptRunner } from '../autoscript/runtime.mjs';
-import { buildXhsUnifiedAutoscript } from '../autoscript/xhs-unified-template.mjs';
 import { safeAppendProgressEvent } from '../events/progress-log.mjs';
 
 function readFlagValue(args, names) {
@@ -31,22 +30,6 @@ function collectPositionals(args, startIndex = 2, valueFlags = new Set(['--profi
   return out;
 }
 
-function readToggleFlag(args, name, fallback) {
-  const on = `--${name}`;
-  const off = `--no-${name}`;
-  if (args.includes(off)) return false;
-  if (args.includes(on)) return true;
-  return fallback;
-}
-
-function readIntegerFlag(args, names, fallback, min = 1) {
-  const raw = readFlagValue(args, names);
-  if (raw === null || raw === undefined || raw === '') return fallback;
-  const num = Number(raw);
-  if (!Number.isFinite(num)) return fallback;
-  return Math.max(min, Math.floor(num));
-}
-
 function appendJsonLine(filePath, payload) {
   if (!filePath) return;
   fs.mkdirSync(path.dirname(filePath), { recursive: true });
@@ -593,89 +576,6 @@ function createMockOperationExecutor(fixture) {
   };
 }
 
-async function handleScaffold(args) {
-  const valueFlags = new Set([
-    '--profile', '-p',
-    '--keyword', '-k',
-    '--env',
-    '--output', '-o',
-    '--output-root',
-    '--throttle',
-    '--tab-count',
-    '--note-interval',
-    '--max-notes',
-    '--max-likes',
-    '--match-mode',
-    '--match-min-hits',
-    '--match-keywords',
-    '--like-keywords',
-    '--reply-text',
-    '--jsonl-file',
-    '--jsonl',
-  ]);
-  const positionals = collectPositionals(args, 2, valueFlags);
-  const template = positionals[0];
-  if (template !== 'xhs-unified') {
-    throw new Error('Usage: camo autoscript scaffold xhs-unified [--output <file>] [options]');
-  }
-
-  const outputPath = readFlagValue(args, ['--output', '-o'])
-    || path.resolve('autoscripts/xiaohongshu/unified-harvest.autoscript.json');
-  const profileId = readFlagValue(args, ['--profile', '-p']) || getDefaultProfile() || 'xiaohongshu-batch-1';
-  const keyword = readFlagValue(args, ['--keyword', '-k']) || '手机膜';
-  const env = readFlagValue(args, ['--env']) || 'debug';
-  const outputRoot = readFlagValue(args, ['--output-root']) || '';
-  const throttle = readIntegerFlag(args, ['--throttle'], 500, 100);
-  const tabCount = readIntegerFlag(args, ['--tab-count'], 4, 1);
-  const noteIntervalMs = readIntegerFlag(args, ['--note-interval'], 900, 200);
-  const maxNotes = readIntegerFlag(args, ['--max-notes'], 30, 1);
-  const maxLikesPerRound = readIntegerFlag(args, ['--max-likes'], 2, 1);
-  const matchMinHits = readIntegerFlag(args, ['--match-min-hits'], 1, 1);
-  const matchMode = readFlagValue(args, ['--match-mode']) || 'any';
-  const matchKeywords = readFlagValue(args, ['--match-keywords']) || keyword;
-  const likeKeywords = readFlagValue(args, ['--like-keywords']) || '';
-  const replyText = readFlagValue(args, ['--reply-text']) || '感谢分享，已关注';
-
-  const script = buildXhsUnifiedAutoscript({
-    profileId,
-    keyword,
-    env,
-    outputRoot,
-    throttle,
-    tabCount,
-    noteIntervalMs,
-    maxNotes,
-    maxLikesPerRound,
-    matchMode,
-    matchMinHits,
-    matchKeywords,
-    likeKeywords,
-    replyText,
-    doHomepage: readToggleFlag(args, 'do-homepage', true),
-    doImages: readToggleFlag(args, 'do-images', false),
-    doComments: readToggleFlag(args, 'do-comments', true),
-    doLikes: readToggleFlag(args, 'do-likes', false),
-    doReply: readToggleFlag(args, 'do-reply', false),
-    doOcr: readToggleFlag(args, 'do-ocr', false),
-    persistComments: readToggleFlag(args, 'persist-comments', true),
-  });
-
-  const resolvedPath = path.resolve(outputPath);
-  fs.mkdirSync(path.dirname(resolvedPath), { recursive: true });
-  fs.writeFileSync(resolvedPath, `${JSON.stringify(script, null, 2)}\n`, 'utf8');
-
-  console.log(JSON.stringify({
-    ok: true,
-    command: 'autoscript.scaffold',
-    template,
-    file: resolvedPath,
-    profileId: script.profileId,
-    operationCount: script.operations.length,
-    subscriptionCount: script.subscriptions.length,
-    hint: `Run: camo autoscript validate ${resolvedPath}`,
-  }, null, 2));
-}
-
 async function handleValidate(args) {
   const filePath = collectPositionals(args)[0];
   if (!filePath) {
@@ -1067,8 +967,6 @@ async function handleMockRun(args) {
 export async function handleAutoscriptCommand(args) {
   const sub = args[1];
   switch (sub) {
-    case 'scaffold':
-      return handleScaffold(args);
     case 'validate':
       return handleValidate(args);
     case 'explain':
@@ -1084,10 +982,9 @@ export async function handleAutoscriptCommand(args) {
     case 'mock-run':
       return handleMockRun(args);
     default:
-      console.log(`Usage: camo autoscript <scaffold|validate|explain|snapshot|replay|run|resume|mock-run> [args]
+      console.log(`Usage: camo autoscript <validate|explain|snapshot|replay|run|resume|mock-run> [args]
 
 Commands:
-  scaffold xhs-unified [--output <file>] [options]          Generate xiaohongshu unified-harvest autoscript
   validate <file>                                   Validate autoscript schema and references
   explain <file>                                    Print normalized graph and defaults
   snapshot <jsonl-file> [--out <snapshot-file>]     Build resumable snapshot from run JSONL

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

@@ -40,14 +40,28 @@ export const XHS_CHECKPOINTS = {
   ],
 };
 
-export async function detectCheckpoint({ profileId, platform = 'xiaohongshu' }) {
-  if (platform !== 'xiaohongshu') {
-    return asErrorPayload('UNSUPPORTED_PLATFORM', `Unsupported platform: ${platform}`);
-  }
-
+export async function detectCheckpoint({ profileId, platform = 'generic' }) {
   try {
     const session = await ensureActiveSession(profileId);
     const resolvedProfile = session.profileId || profileId;
+
+    if (platform !== 'xiaohongshu') {
+      const url = await getCurrentUrl(resolvedProfile);
+      return {
+        ok: true,
+        code: 'CHECKPOINT_DETECTED',
+        message: 'Checkpoint detected',
+        data: {
+          profileId: resolvedProfile,
+          platform,
+          checkpoint: 'unknown',
+          url,
+          signals: [],
+          selectorHits: {},
+        },
+      };
+    }
+
     const [url, snapshot] = await Promise.all([
       getCurrentUrl(resolvedProfile),
       getDomSnapshotByProfile(resolvedProfile),
@@ -103,7 +117,7 @@ export async function captureCheckpoint({
   profileId,
   containerId = null,
   selector = null,
-  platform = 'xiaohongshu',
+  platform = 'generic',
 }) {
   try {
     const session = await ensureActiveSession(profileId);
@@ -139,7 +153,7 @@ export async function restoreCheckpoint({
   containerId = null,
   selector = null,
   targetCheckpoint = null,
-  platform = 'xiaohongshu',
+  platform = 'generic',
 }) {
   try {
     const session = await ensureActiveSession(profileId);

package/src/container/runtime-core/validation.mjs

@@ -9,7 +9,7 @@ import {
   normalizeArray,
 } from './utils.mjs';
 
-async function validatePage(profileId, spec = {}, platform = 'xiaohongshu') {
+async function validatePage(profileId, spec = {}, platform = 'generic') {
   const url = await getCurrentUrl(profileId);
   const includes = normalizeArray(spec.urlIncludes || []);
   const excludes = normalizeArray(spec.urlExcludes || []);
@@ -74,7 +74,7 @@ export async function validateOperation({
   validationSpec = {},
   phase = 'pre',
   context = {},
-  platform = 'xiaohongshu',
+  platform = 'generic',
 }) {
   try {
     const mode = String(validationSpec.mode || 'none').toLowerCase();

package/src/utils/help.mjs

@@ -155,7 +155,6 @@ CONTAINER FILTER & SUBSCRIPTION:
   container list [profileId]                        List visible elements in viewport
 
 AUTOSCRIPT (STRATEGY LAYER):
-  autoscript scaffold xhs-unified [--output <file>]        Generate xiaohongshu unified-harvest autoscript template
   autoscript validate <file>                        Validate autoscript schema and references
   autoscript explain <file>                         Print normalized graph and defaults
   autoscript snapshot <jsonl-file> [--out <snapshot-file>] Build resumable snapshot from run JSONL