webtape 1.7.0

package/README.md

@@ -0,0 +1,99 @@
+# 🚀 WebTape Receiver：让网页自动化像录屏一样简单
+
+**WebTape Receiver** 是 [WebTape](https://github.com/FurtherBank/WebTape) 生态中的核心动力引擎。  
+
+它能将你在浏览器中的操作，瞬间转化为可直接运行且**不依赖网站 Open API 和浏览器手动操作**的自动化脚本。
+
+不再需要抓包、不再需要分析复杂的 API 文档、不再需要手动处理 Cookie。你只需在浏览器里点一点，剩下的交给 WebTape。
+
+---
+
+## ✨ 核心价值：录制即自动化集成
+
+通过 WebTape 插件录制你的业务操作，Receiver 会自动接收并保存所有网络请求。  
+
+配合 AI 分析，它能直接理解你在网站上的操作，并将这些操作流程编写成**可以自动化运行的**`request.js`脚本，用于快速将网页操作以命令行、Agent 等形式自动化。
+
+其中：
+- 可自动复用你电脑 Chrome 浏览器的登录状态（Cookie），个人场景下运行无需额外网站登录过程。
+- 对于上层业务流程，AI 会深度梳理接口间的调用链路，及其中输入和流转过程中的参数字段关系，帮你从繁琐的逆向工程和拼代码中解脱出来。
+
+这使得你可以将生成的函数快速集成到自己的工具、爬虫或 Agent 中：  
+
+让需要打开浏览器的操作可以**完全自动化**，  
+让自动化 API 调用可以**不限于网站 Open API**，**只要日常浏览器使用能通的 API，自动化都可以通**
+
+无论是获取私有接口数据，还是执行复杂的业务流程，都能像调用本地函数一样简单。
+
+---
+
+## 🛠️ 快速上手
+
+### 第一步：安装
+> 如果你还没有安装 Node.js，请先参考 [Node.js 安装指南](https://nodejs.org/zh-cn/download/package-manager) 安装 Node 和 npm。
+
+只需一行命令，开启你的自动化之旅：
+
+```bash
+npm install -g webtape-receiver
+```
+
+### 第二步：启动服务
+启动你的专属 Webhook 接收服务器：
+```bash
+webtape-receiver serve
+```
+*首次启动，将自动创建默认工作区在你的**桌面 `WebTape` 文件夹**下。*
+
+### 第三步：配置插件
+在 WebTape Chrome 插件中，将 Webhook 地址设置为：
+`http://localhost:5643/webhook`
+
+---
+
+## WIP 视频演示
+
+### 场景：从网页操作到自动化脚本生成
+
+| 阶段 | 操作 | 核心产出 |
+| :--- | :--- | :--- |
+| **1. 接收** | 终端运行 `webtape-receiver serve`，插件端点击导出。 | 录制数据自动进入 `recordings/` 目录。 |
+| **2. 分析** | 运行 `webtape-receiver analyze <session>`。 | AI 自动生成 `analysis_report.md` 业务文档。 |
+| **3. 生成** | AI 根据 `AGENTS.md` 规则编写代码。 | 自动生成 `request.js`，包含封装好的业务函数。 |
+| **4. 集成** | 在你的项目中 `import { xxx } from './request.js'`。 | **无需逆向工程**，直接实现网页功能自动化。 |
+
+## 📂 你的自动化工作区 (Workspace)
+
+当你运行 `serve` 命令时，系统会自动为你准备好一切：
+- **recordings/**：安全存储你所有的录制会话。
+- **AGENTS.md**：内置 AI 分析规则，确保你的 AI 助手（如 Cursor）能精准理解业务逻辑。
+- **自动环境配置**：自动初始化 Node.js 环境并安装必要依赖，确保生成的脚本开箱即用。
+
+---
+
+## 💡 使用场景
+
+- **数据采集**：无需研究复杂的反爬和登录校验，直接复用浏览器的登录态获取数据。
+- **业务自动化**：将重复的网页操作转化为脚本，定时运行或集成到你的工作流中。
+- **AI Agent 增强**：为你的 AI 助手提供直接操作真实业务接口的能力。
+
+---
+
+## ⚠️ 温馨提示 (macOS 用户)
+生成的 request 代码最终基于`chrome-cookies-secure`库获取本机 Chrome 浏览器的 Cookie 信息，  
+macOS 在第一次运行时会弹出安全提示。
+
+
+
+- **操作**：请输入你的 **Mac 开机密码**。
+- **建议**：请务必点击 **“始终允许” (Always Allow)**，以获得最流畅的自动化体验。
+
+---
+
+## 📄 开源协议
+基于 **MIT** 协议开源。
+
+---
+
+**准备好释放网页自动化的潜力了吗？**  
+[立即开始使用 WebTape](https://github.com/FurtherBank/WebTape)

package/dist/analyzer.d.ts

@@ -0,0 +1,27 @@
+import type { WorkspacePaths } from "./workspace.js";
+export type AnalyzerBackend = "cursor" | "claude" | "none";
+export declare const VALID_BACKENDS: readonly AnalyzerBackend[];
+export interface AnalyzeOptions {
+    backend: AnalyzerBackend;
+    workspace: WorkspacePaths;
+    sessionDir: string;
+    model?: string;
+    /** Callback for real-time log output */
+    onLog?: (line: string) => void;
+}
+export interface AnalyzeResult {
+    /** Whether the analysis report was successfully created */
+    success: boolean;
+    /** Expected report path */
+    reportPath: string;
+    /** Session name */
+    sessionName: string;
+    /** Analysis duration in milliseconds */
+    duration?: number;
+}
+/**
+ * Run AI analysis on a recording session.
+ * Returns an AnalyzeResult indicating whether the report was created.
+ */
+export declare function analyzeRecording(opts: AnalyzeOptions): Promise<AnalyzeResult>;
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3D,eAAO,MAAM,cAAc,EAAE,SAAS,eAAe,EAI3C,CAAC;AASX,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,cAAc,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,aAAa,CAAC,CAsBxB"}

package/dist/analyzer.js

@@ -0,0 +1,128 @@
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join, relative } from "node:path";
+export const VALID_BACKENDS = [
+    "cursor",
+    "claude",
+    "none",
+];
+/**
+ * Build the analysis instruction for a specific recording session.
+ */
+function buildInstruction(sessionName) {
+    return `"请先阅读 recordings/${sessionName}/_context.md 了解录制数据全貌，然后按照 AGENTS.md 中的指示完成分析，并将报告文件保存到对应位置。如需查看被截断的完整请求/响应体，请查阅 requests/ 和 responses/ 目录下的原始文件。"`;
+}
+/**
+ * Run AI analysis on a recording session.
+ * Returns an AnalyzeResult indicating whether the report was created.
+ */
+export async function analyzeRecording(opts) {
+    const { backend, workspace, sessionDir, model } = opts;
+    const sessionName = relative(workspace.recordings, sessionDir);
+    const reportPath = join(workspace.recordings, sessionName, "analysis_report.md");
+    const startTime = Date.now();
+    if (backend === "cursor") {
+        await runCursor(workspace.root, sessionName, model, opts.onLog);
+    }
+    else if (backend === "claude") {
+        await runClaude(workspace.root, sessionName, opts.onLog);
+    }
+    else {
+        throw new Error(`Unsupported analyzer backend: ${backend}`);
+    }
+    const duration = Date.now() - startTime;
+    const success = existsSync(reportPath);
+    return { success, reportPath, sessionName, duration };
+}
+/**
+ * Run analysis via `agent` CLI (Cursor).
+ * cwd is the workspace root so the agent reads AGENTS.md.
+ */
+async function runCursor(workspaceRoot, sessionName, model, onLog) {
+    return new Promise((resolve, reject) => {
+        const instruction = buildInstruction(sessionName);
+        const args = [instruction, "--print", "--trust", "--yolo"];
+        if (model) {
+            args.push("--model", model);
+        }
+        const child = execFile("agent", args, {
+            cwd: workspaceRoot,
+            maxBuffer: 10 * 1024 * 1024,
+            timeout: 5 * 60 * 1000,
+        }, (error, _stdout, stderr) => {
+            if (error) {
+                if (stderr) {
+                    console.error("[analyzer] agent stderr:", stderr);
+                }
+                reject(new Error(`agent failed: ${error.message}`));
+                return;
+            }
+            resolve();
+        });
+        if (onLog) {
+            child.stdout?.on("data", (data) => {
+                const lines = data.toString().split("\n");
+                for (const line of lines) {
+                    if (line.trim())
+                        onLog(line.trim());
+                }
+            });
+            child.stderr?.on("data", (data) => {
+                const lines = data.toString().split("\n");
+                for (const line of lines) {
+                    if (line.trim())
+                        onLog(line.trim());
+                }
+            });
+        }
+        child.on("error", (err) => {
+            reject(new Error(`Failed to launch agent: ${err.message}. ` +
+                "Ensure the Cursor `agent` CLI is on your PATH."));
+        });
+    });
+}
+/**
+ * Run analysis via `claude` CLI (Claude Code).
+ * cwd is the workspace root so claude reads AGENTS.md.
+ */
+async function runClaude(workspaceRoot, sessionName, onLog) {
+    return new Promise((resolve, reject) => {
+        const instruction = buildInstruction(sessionName);
+        const args = ["-p", instruction];
+        const child = execFile("claude", args, {
+            cwd: workspaceRoot,
+            maxBuffer: 10 * 1024 * 1024,
+            timeout: 5 * 60 * 1000,
+        }, (error, _stdout, stderr) => {
+            if (error) {
+                if (stderr) {
+                    console.error("[analyzer] claude stderr:", stderr);
+                }
+                reject(new Error(`claude failed: ${error.message}`));
+                return;
+            }
+            resolve();
+        });
+        if (onLog) {
+            child.stdout?.on("data", (data) => {
+                const lines = data.toString().split("\n");
+                for (const line of lines) {
+                    if (line.trim())
+                        onLog(line.trim());
+                }
+            });
+            child.stderr?.on("data", (data) => {
+                const lines = data.toString().split("\n");
+                for (const line of lines) {
+                    if (line.trim())
+                        onLog(line.trim());
+                }
+            });
+        }
+        child.on("error", (err) => {
+            reject(new Error(`Failed to launch claude: ${err.message}. ` +
+                "Ensure Claude Code is installed and the `claude` CLI is on your PATH."));
+        });
+    });
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,36 @@
+import type { AnalyzerBackend } from './analyzer.js';
+export interface WebtapeConfig {
+    aiBackend?: AnalyzerBackend;
+    aiModel?: string;
+}
+/**
+ * Load the persisted configuration, returning an empty object if none exists.
+ */
+export declare function loadConfig(): WebtapeConfig;
+/**
+ * Save the configuration to disk (merges with existing).
+ */
+export declare function saveConfig(partial: Partial<WebtapeConfig>): WebtapeConfig;
+interface SelectOption<T> {
+    label: string;
+    value: T;
+    hint?: string;
+}
+/**
+ * Show an interactive list that the user navigates with arrow keys.
+ * Returns the selected value, or null if the user pressed ESC.
+ */
+export declare function selectItem<T>(title: string, options: SelectOption<T>[], initialIndex?: number): Promise<T | null>;
+/**
+ * Run the interactive configuration wizard.
+ * Steps through each config item in sequence; ESC exits without saving.
+ * Returns the saved config, or null if aborted.
+ */
+export declare function runConfigWizard(): Promise<WebtapeConfig | null>;
+/**
+ * Prompt for AI backend interactively.
+ * Used by the serve command when no backend is configured yet.
+ */
+export declare function promptAiBackend(): Promise<AnalyzerBackend>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAKrD,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,aAAa,CAQ1C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAQzE;AAMD,UAAU,YAAY,CAAC,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA0BD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,YAAY,SAAI,GACf,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAkDnB;AAwBD;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAuCrE;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,CAGhE"}

package/dist/config.js

@@ -0,0 +1,158 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import chalk from 'chalk';
+const CONFIG_DIR = join(homedir(), '.webtape-receiver');
+const CONFIG_PATH = join(CONFIG_DIR, 'config.json');
+/**
+ * Load the persisted configuration, returning an empty object if none exists.
+ */
+export function loadConfig() {
+    if (!existsSync(CONFIG_PATH))
+        return {};
+    try {
+        return JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));
+    }
+    catch (err) {
+        console.warn('Failed to parse config file, using defaults:', err.message);
+        return {};
+    }
+}
+/**
+ * Save the configuration to disk (merges with existing).
+ */
+export function saveConfig(partial) {
+    const current = loadConfig();
+    const merged = { ...current, ...partial };
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    writeFileSync(CONFIG_PATH, JSON.stringify(merged, null, 2), 'utf-8');
+    return merged;
+}
+/** Re-render the selector list in-place by moving the cursor up and overwriting. */
+function renderSelector(title, options, cursor, isFirst) {
+    const lineCount = options.length + 2; // blank line + title + options
+    if (!isFirst) {
+        process.stdout.write(`\x1b[${lineCount}A`); // move up
+        process.stdout.write('\x1b[0J'); // clear to end of screen
+    }
+    process.stdout.write(`\n  ${chalk.bold(title)}\n`);
+    for (let i = 0; i < options.length; i++) {
+        const opt = options[i];
+        const hint = opt.hint ? chalk.gray(`  ${opt.hint}`) : '';
+        if (i === cursor) {
+            process.stdout.write(`  ${chalk.cyan('❯')} ${chalk.cyan(opt.label)}${hint}\n`);
+        }
+        else {
+            process.stdout.write(`    ${chalk.dim(opt.label)}${hint}\n`);
+        }
+    }
+}
+/**
+ * Show an interactive list that the user navigates with arrow keys.
+ * Returns the selected value, or null if the user pressed ESC.
+ */
+export async function selectItem(title, options, initialIndex = 0) {
+    if (!process.stdin.isTTY) {
+        // Non-interactive fallback: return first/current option silently
+        return options[Math.max(0, Math.min(initialIndex, options.length - 1))].value;
+    }
+    let cursor = Math.max(0, Math.min(initialIndex, options.length - 1));
+    renderSelector(title, options, cursor, true);
+    return new Promise((resolve) => {
+        const { stdin } = process;
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.setEncoding('utf-8');
+        const cleanup = () => {
+            stdin.removeListener('data', onData);
+            stdin.setRawMode(false);
+            stdin.pause();
+        };
+        const onData = (key) => {
+            if (key === '\x1b[A') {
+                // Up arrow — previous option
+                cursor = (cursor - 1 + options.length) % options.length;
+                renderSelector(title, options, cursor, false);
+            }
+            else if (key === '\x1b[B') {
+                // Down arrow — next option
+                cursor = (cursor + 1) % options.length;
+                renderSelector(title, options, cursor, false);
+            }
+            else if (key === '\r' || key === '\n') {
+                // Enter — confirm selection
+                cleanup();
+                process.stdout.write('\n');
+                resolve(options[cursor].value);
+            }
+            else if (key === '\x1b') {
+                // ESC — abort
+                cleanup();
+                process.stdout.write('\n');
+                resolve(null);
+            }
+            else if (key === '\x03') {
+                // Ctrl+C
+                cleanup();
+                process.stdout.write('\n');
+                process.exit(0);
+            }
+        };
+        stdin.on('data', onData);
+    });
+}
+const CONFIG_STEPS = [
+    {
+        key: 'aiBackend',
+        title: '请选择 AI 分析后端 / Select AI analysis backend',
+        options: [
+            { label: 'cursor', value: 'cursor', hint: 'Cursor Agent  (agent …)' },
+            { label: 'claude', value: 'claude', hint: 'Claude Code   (claude -p …)' },
+            { label: '不分析', value: 'none', hint: '仅接收并保存录制数据，不自动运行 AI 分析' },
+        ],
+    },
+];
+/**
+ * Run the interactive configuration wizard.
+ * Steps through each config item in sequence; ESC exits without saving.
+ * Returns the saved config, or null if aborted.
+ */
+export async function runConfigWizard() {
+    const current = loadConfig();
+    const result = { ...current };
+    console.log('');
+    console.log(chalk.bold.cyan('  ⚙️  WebTape 配置向导'));
+    console.log(chalk.gray('  ↑↓ 选择  Enter 确认  Esc 退出'));
+    console.log(chalk.gray('  ─────────────────────────────────'));
+    for (const step of CONFIG_STEPS) {
+        const currentVal = result[step.key];
+        const initialIdx = step.options.findIndex((o) => o.value === currentVal);
+        const selected = await selectItem(step.title, step.options, initialIdx >= 0 ? initialIdx : 0);
+        if (selected === null) {
+            console.log(chalk.gray('  已取消，配置未更改。\n'));
+            return null;
+        }
+        result[step.key] = selected;
+    }
+    const saved = saveConfig(result);
+    console.log(chalk.green('  ✅ 配置已保存:'));
+    for (const step of CONFIG_STEPS) {
+        const val = saved[step.key];
+        if (val !== undefined) {
+            console.log(`    ${chalk.green(step.key)}  ${val}`);
+        }
+    }
+    console.log('');
+    return saved;
+}
+/**
+ * Prompt for AI backend interactively.
+ * Used by the serve command when no backend is configured yet.
+ */
+export async function promptAiBackend() {
+    const result = await runConfigWizard();
+    return (result?.aiBackend ?? 'cursor');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/context.d.ts

@@ -0,0 +1,4 @@
+import type { WebTapePayload } from './types.js';
+export declare function extractSiteUrl(payload: WebTapePayload): string;
+export declare function renderAnalysisContext(payload: WebTapePayload, siteUrl: string): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EAKf,MAAM,YAAY,CAAC;AAoSpB,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAK9D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CActF"}