@web-auto/webauto 0.1.14 → 0.1.16

package/README.md

@@ -0,0 +1,137 @@
+# @web-auto/webauto
+
+Windows 优先的 WebAuto CLI + Desktop UI 使用说明。
+
+## 1. 安装（Windows）
+
+要求：
+- Node.js 18+（建议 20+）
+- npm 可用
+
+全局安装：
+
+```bat
+npm install -g @web-auto/webauto
+```
+
+验证：
+
+```bat
+webauto --help
+```
+
+## 2. 直接启动 UI
+
+最直接方式：
+
+```bat
+webauto ui console
+```
+
+或用 UI CLI 自动拉起（适合脚本化）：
+
+```bat
+webauto ui cli start --json
+webauto ui cli status --json
+```
+
+说明：
+- 首次启动会自动准备 Desktop runtime 依赖（Electron），不需要手工安装。
+- 启动成功后，UI CLI bridge 默认端口是 `7716`。
+
+## 3. UI CLI 常用命令（模拟真实 UI 操作）
+
+```bat
+webauto ui cli --help
+
+:: 切换到任务页
+webauto ui cli tab --tab tasks --json
+
+:: 输入任务参数
+webauto ui cli input --selector "#task-keyword" --value "deepseek" --json
+webauto ui cli input --selector "#task-target" --value "20" --json
+
+:: 点击执行
+webauto ui cli click --selector "#task-run-ephemeral-btn" --json
+
+:: 读取当前 UI 快照
+webauto ui cli status --json
+webauto ui cli snapshot --json
+
+:: 元素探测
+webauto ui cli probe --selector "#task-likes" --json
+```
+
+任务状态查看（后端状态）：
+
+```bat
+webauto xhs status --json
+webauto xhs status --run-id <runId> --json
+```
+
+## 4. Windows 路径与设置
+
+默认数据目录（未设置环境变量时）：
+- 有 `D:` 盘：`D:\webauto`
+- 无 `D:` 盘：`%USERPROFILE%\.webauto`
+
+可选环境变量：
+- `WEBAUTO_HOME`：显式指定数据根目录（推荐）
+- `WEBAUTO_ROOT` / `WEBAUTO_PORTABLE_ROOT`：兼容旧变量（会归一化到 `.webauto`）
+
+PowerShell 设置示例：
+
+```powershell
+$env:WEBAUTO_HOME = "D:\webauto"
+webauto ui console
+```
+
+CMD 设置示例：
+
+```bat
+set WEBAUTO_HOME=D:\webauto
+webauto ui console
+```
+
+不设置也可以直接用，系统会按默认规则落盘。
+
+## 5. 首次安装常见问题
+
+### 5.1 `Lock file can not be created` / 启动失败
+
+说明：通常是残留的 Electron/Node 进程占用。
+
+```bat
+taskkill /F /IM electron.exe /T
+taskkill /F /IM node.exe /T
+webauto ui console
+```
+
+### 5.2 `ui cli fetch failed`
+
+先确认 UI 已启动并就绪：
+
+```bat
+webauto ui cli start --json
+webauto ui cli status --json
+```
+
+若仍失败，前台启动看日志：
+
+```bat
+webauto ui console --no-daemon
+```
+
+## 6. 资源检查/安装
+
+```bat
+webauto xhs install --check --json
+webauto xhs install --download-browser --json
+webauto xhs install --download-geoip --json
+```
+
+## 7. 开发者（仓库模式）
+
+在仓库中开发请看：
+- `apps/desktop-console/README.md`
+

package/apps/desktop-console/dist/renderer/index.js

@@ -2870,10 +2870,6 @@ function renderTasksPanel(root, ctx2) {
   }
   async function saveTask(runImmediately = false) {
     const data = collectFormData();
-    if (runImmediately && data.scheduleMode === "immediate") {
-      await runWithoutSave();
-      return;
-    }
     saveBtn.disabled = true;
     runBtn.disabled = true;
     runEphemeralBtn.disabled = true;
@@ -3212,6 +3208,7 @@ function renderDashboard(root, ctx2) {
   let stoppedAt = null;
   let elapsedTimer = null;
   let statePollTimer = null;
+  let accountLabelPollTimer = null;
   let unsubscribeState = null;
   let unsubscribeCmd = null;
   const contextRun = ctx2?.xhsCurrentRun && typeof ctx2.xhsCurrentRun === "object" ? ctx2.xhsCurrentRun : null;
@@ -3225,6 +3222,10 @@ function renderDashboard(root, ctx2) {
   const maxLogs = 500;
   const maxRecentErrors = 8;
   const maxLikedLinks = 30;
+  const accountLabelByProfile = /* @__PURE__ */ new Map();
+  let accountLabelRefreshInFlight = false;
+  let accountLabelRefreshedAt = 0;
+  const accountLabelRefreshTtlMs = 15e3;
   const initialTaskId = String(contextRun?.taskId || ctx2?.activeTaskConfigId || "").trim();
   if (initialTaskId) {
     taskConfigId.textContent = initialTaskId;
@@ -3241,14 +3242,49 @@ function renderDashboard(root, ctx2) {
     const text = String(value ?? "").trim();
     return text.length > 0 && text !== "-";
   };
+  const resolveAccountLabel = (profileIdLike) => {
+    const profileId = String(profileIdLike || "").trim();
+    if (!profileId) return "-";
+    return accountLabelByProfile.get(profileId) || profileId;
+  };
+  const applyAccountLabel = (profileIdLike) => {
+    const profileId = String(profileIdLike || "").trim();
+    if (!profileId) return;
+    activeProfileId = profileId;
+    taskAccount.textContent = resolveAccountLabel(profileId);
+    if (!accountLabelByProfile.has(profileId)) {
+      void refreshAccountLabels(true);
+    }
+  };
+  async function refreshAccountLabels(force = false) {
+    if (accountLabelRefreshInFlight) return;
+    if (!force && Date.now() - accountLabelRefreshedAt < accountLabelRefreshTtlMs) return;
+    if (typeof ctx2.api?.cmdRunJson !== "function") return;
+    if (typeof ctx2.api?.pathJoin !== "function") return;
+    accountLabelRefreshInFlight = true;
+    try {
+      const rows = await listAccountProfiles(ctx2.api, { platform: "xiaohongshu" });
+      accountLabelByProfile.clear();
+      for (const row of rows) {
+        const profileId = String(row?.profileId || "").trim();
+        if (!profileId) continue;
+        const label = String(row?.alias || row?.name || profileId).trim() || profileId;
+        accountLabelByProfile.set(profileId, label);
+      }
+      accountLabelRefreshedAt = Date.now();
+      if (activeProfileId) {
+        taskAccount.textContent = resolveAccountLabel(activeProfileId);
+      }
+    } catch {
+    } finally {
+      accountLabelRefreshInFlight = false;
+    }
+  }
   if (contextRun) {
     if (hasRenderableValue(contextRun.keyword)) taskKeyword.textContent = String(contextRun.keyword);
     if (Number(contextRun.target) > 0) taskTarget.textContent = String(Number(contextRun.target));
     if (hasRenderableValue(contextRun.profileId)) {
-      const aliases = ctx2.api?.settings?.profileAliases || {};
-      const profileId = String(contextRun.profileId);
-      taskAccount.textContent = aliases[profileId] || profileId;
-      activeProfileId = profileId;
+      applyAccountLabel(contextRun.profileId);
     }
     if (hasRenderableValue(contextRun.taskId)) taskConfigId.textContent = String(contextRun.taskId);
     const startedAtTs = Date.parse(String(contextRun.startedAt || ""));
@@ -3454,6 +3490,18 @@ function renderDashboard(root, ctx2) {
     clearInterval(statePollTimer);
     statePollTimer = null;
   }
+  function startAccountLabelPoll() {
+    if (accountLabelPollTimer) return;
+    accountLabelPollTimer = setInterval(() => {
+      if (paused) return;
+      void refreshAccountLabels(false);
+    }, 3e4);
+  }
+  function stopAccountLabelPoll() {
+    if (!accountLabelPollTimer) return;
+    clearInterval(accountLabelPollTimer);
+    accountLabelPollTimer = null;
+  }
   function addLog(line, type = "info") {
     const ts = (/* @__PURE__ */ new Date()).toLocaleTimeString("zh-CN", { hour12: false });
     const logLine = createEl("div", { className: "log-line" });
@@ -3549,9 +3597,7 @@ function renderDashboard(root, ctx2) {
       taskTarget.textContent = String(state.target);
     }
     if (state.profileId) {
-      const aliases = ctx2.api?.settings?.profileAliases || {};
-      taskAccount.textContent = aliases[state.profileId] || state.profileId;
-      activeProfileId = String(state.profileId || "").trim();
+      applyAccountLabel(state.profileId);
     }
     const taskId = String(state.taskId || state.scheduleTaskId || state.configTaskId || "").trim();
     if (taskId) {
@@ -3636,7 +3682,7 @@ function renderDashboard(root, ctx2) {
       resetDashboardForNewRun("\u65B0\u4EFB\u52A1\u542F\u52A8", ts);
       if (payload.keyword) taskKeyword.textContent = String(payload.keyword);
       if (payload.maxNotes) taskTarget.textContent = String(payload.maxNotes);
-      if (payload.profileId) activeProfileId = String(payload.profileId || "").trim();
+      if (payload.profileId) applyAccountLabel(payload.profileId);
       if (payload.taskId) {
         const taskId = String(payload.taskId || "").trim();
         if (taskId) {
@@ -3788,9 +3834,7 @@ function renderDashboard(root, ctx2) {
     if (summary.keyword) taskKeyword.textContent = String(summary.keyword);
     if (assigned) taskTarget.textContent = String(assigned);
     if (profile?.profileId) {
-      const aliases = ctx2.api?.settings?.profileAliases || {};
-      taskAccount.textContent = aliases[profile.profileId] || profile.profileId;
-      activeProfileId = String(profile.profileId || "").trim();
+      applyAccountLabel(profile.profileId);
     }
     const runId = String(profile?.runId || summary?.runId || "").trim();
     if (runId) {
@@ -3930,8 +3974,7 @@ function renderDashboard(root, ctx2) {
           taskTarget.textContent = String(config.target || 50);
         }
         if (!hasRenderableValue(contextRun?.profileId) && config.lastProfileId) {
-          const aliases = ctx2.api?.settings?.profileAliases || {};
-          taskAccount.textContent = aliases[config.lastProfileId] || config.lastProfileId;
+          applyAccountLabel(config.lastProfileId);
         }
         const taskId = String(contextRun?.taskId || config.taskId || ctx2?.activeTaskConfigId || "").trim();
         if (taskId) {
@@ -4008,14 +4051,17 @@ function renderDashboard(root, ctx2) {
     }
   };
   renderRunSummary();
+  void refreshAccountLabels(true);
   loadTaskInfo();
   subscribeToUpdates();
   fetchCurrentState();
   startStatePoll();
+  startAccountLabelPoll();
   startElapsedTimer();
   return () => {
     stopElapsedTimer();
     stopStatePoll();
+    stopAccountLabelPoll();
     if (unsubscribeState) unsubscribeState();
     if (unsubscribeCmd) unsubscribeCmd();
     if (unsubscribeBus) unsubscribeBus();

package/apps/webauto/entry/flow-gate.mjs

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+import minimist from 'minimist';
+import {
+  listPlatformFlowGates,
+  loadFlowGateDoc,
+  patchPlatformFlowGate,
+  resetPlatformFlowGate,
+  resolveFlowGatePath,
+  resolvePlatformFlowGate,
+} from './lib/flow-gate.mjs';
+
+function normalizePlatform(value) {
+  const text = String(value || '').trim().toLowerCase();
+  if (!text) return 'xiaohongshu';
+  if (text === 'xhs') return 'xiaohongshu';
+  return text;
+}
+
+function toJsonMode(argv) {
+  return argv.json === true || argv.j === true;
+}
+
+function printHelp() {
+  console.log([
+    'Usage: node apps/webauto/entry/flow-gate.mjs <get|list|set|reset|path> [options]',
+    'Options:',
+    '  --platform <name>       平台名（默认 xiaohongshu）',
+    '  --patch-json <json>     set 动作补丁 JSON（对象）',
+    '  --json                  输出 JSON',
+    '',
+    'Examples:',
+    '  node apps/webauto/entry/flow-gate.mjs get --platform xiaohongshu --json',
+    '  node apps/webauto/entry/flow-gate.mjs list --json',
+    '  node apps/webauto/entry/flow-gate.mjs set --platform xiaohongshu --patch-json \'{"noteInterval":{"minMs":2600,"maxMs":5200}}\' --json',
+    '  node apps/webauto/entry/flow-gate.mjs reset --platform xiaohongshu --json',
+  ].join('\n'));
+}
+
+function parsePatchJson(raw) {
+  const text = String(raw || '').trim();
+  if (!text) throw new Error('missing --patch-json');
+  let parsed = null;
+  try {
+    parsed = JSON.parse(text);
+  } catch (error) {
+    throw new Error(`invalid --patch-json: ${error?.message || String(error)}`);
+  }
+  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+    throw new Error('--patch-json must be object JSON');
+  }
+  return parsed;
+}
+
+async function main() {
+  const argv = minimist(process.argv.slice(2), {
+    boolean: ['help', 'h', 'json', 'j'],
+    string: ['platform', 'patch-json'],
+  });
+  if (argv.help || argv.h) {
+    printHelp();
+    return;
+  }
+
+  const action = String(argv._[0] || 'get').trim().toLowerCase();
+  const platform = normalizePlatform(argv.platform);
+  const jsonMode = toJsonMode(argv);
+  const path = resolveFlowGatePath();
+
+  if (action === 'path') {
+    if (jsonMode) {
+      console.log(JSON.stringify({ ok: true, path }, null, 2));
+    } else {
+      console.log(path);
+    }
+    return;
+  }
+
+  if (action === 'get') {
+    const gate = await resolvePlatformFlowGate(platform);
+    if (jsonMode) {
+      console.log(JSON.stringify({ ok: true, platform, path, gate }, null, 2));
+    } else {
+      console.log(`[flow-gate] platform=${platform}`);
+      console.log(JSON.stringify(gate, null, 2));
+      console.log(`[flow-gate] file=${path}`);
+    }
+    return;
+  }
+
+  if (action === 'list') {
+    const gates = await listPlatformFlowGates();
+    if (jsonMode) {
+      console.log(JSON.stringify({ ok: true, path, platforms: gates }, null, 2));
+    } else {
+      console.log(JSON.stringify(gates, null, 2));
+      console.log(`[flow-gate] file=${path}`);
+    }
+    return;
+  }
+
+  if (action === 'set') {
+    const patch = parsePatchJson(argv['patch-json']);
+    const gate = await patchPlatformFlowGate(platform, patch);
+    if (jsonMode) {
+      console.log(JSON.stringify({ ok: true, action, platform, path, gate }, null, 2));
+    } else {
+      console.log(`[flow-gate] updated platform=${platform}`);
+      console.log(JSON.stringify(gate, null, 2));
+      console.log(`[flow-gate] file=${path}`);
+    }
+    return;
+  }
+
+  if (action === 'reset') {
+    const gate = await resetPlatformFlowGate(platform);
+    if (jsonMode) {
+      console.log(JSON.stringify({ ok: true, action, platform, path, gate }, null, 2));
+    } else {
+      console.log(`[flow-gate] reset platform=${platform}`);
+      console.log(JSON.stringify(gate, null, 2));
+      console.log(`[flow-gate] file=${path}`);
+    }
+    return;
+  }
+
+  if (action === 'show-doc') {
+    const doc = await loadFlowGateDoc();
+    if (jsonMode) console.log(JSON.stringify({ ok: true, path, doc }, null, 2));
+    else console.log(JSON.stringify(doc, null, 2));
+    return;
+  }
+
+  throw new Error(`unknown action: ${action}`);
+}
+
+main().catch((err) => {
+  console.error(err?.message || String(err));
+  process.exit(1);
+});