webtape 1.7.0

package/dist/install.d.ts

@@ -0,0 +1,17 @@
+/**
+ * webtape install — registers the Native Messaging host with Chrome/Edge/Brave
+ * and opens the Chrome Web Store page for the extension.
+ *
+ * The host manifest is written to the OS-specific NativeMessagingHosts directory.
+ * After installation, Chrome will spawn the webtape binary on-demand whenever
+ * the extension calls chrome.runtime.connectNative('com.webtape.receiver').
+ */
+export declare const HOST_NAME = "com.webtape.receiver";
+/** Chrome Web Store extension URL — update when published */
+export declare const CWS_URL = "https://chrome.google.com/webstore/detail/webtape/pending";
+export interface InstallOptions {
+    extensionId?: string;
+    openStore?: boolean;
+}
+export declare function runInstall(opts?: InstallOptions): Promise<void>;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,eAAO,MAAM,SAAS,yBAAyB,CAAC;AAEhD,6DAA6D;AAC7D,eAAO,MAAM,OAAO,8DACyC,CAAC;AAuK9D,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,UAAU,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmEzE"}

package/dist/install.js

@@ -0,0 +1,235 @@
+/**
+ * webtape install — registers the Native Messaging host with Chrome/Edge/Brave
+ * and opens the Chrome Web Store page for the extension.
+ *
+ * The host manifest is written to the OS-specific NativeMessagingHosts directory.
+ * After installation, Chrome will spawn the webtape binary on-demand whenever
+ * the extension calls chrome.runtime.connectNative('com.webtape.receiver').
+ */
+import { writeFileSync, mkdirSync, existsSync, chmodSync, readFileSync, } from 'node:fs';
+import { join } from 'node:path';
+import { homedir, platform } from 'node:os';
+import { execSync, execFile } from 'node:child_process';
+import chalk from 'chalk';
+export const HOST_NAME = 'com.webtape.receiver';
+/** Chrome Web Store extension URL — update when published */
+export const CWS_URL = 'https://chrome.google.com/webstore/detail/webtape/pending';
+/**
+ * Paths where Chrome (and Chromium-family browsers) look for NativeMessagingHosts
+ * on each OS.
+ */
+function getNativeMessagingDirs() {
+    const os = platform();
+    const home = homedir();
+    if (os === 'darwin') {
+        return [
+            {
+                label: 'Chrome',
+                path: join(home, 'Library', 'Application Support', 'Google', 'Chrome', 'NativeMessagingHosts'),
+            },
+            {
+                label: 'Chromium',
+                path: join(home, 'Library', 'Application Support', 'Chromium', 'NativeMessagingHosts'),
+            },
+            {
+                label: 'Brave',
+                path: join(home, 'Library', 'Application Support', 'BraveSoftware', 'Brave-Browser', 'NativeMessagingHosts'),
+            },
+            {
+                label: 'Edge',
+                path: join(home, 'Library', 'Application Support', 'Microsoft Edge', 'NativeMessagingHosts'),
+            },
+        ];
+    }
+    if (os === 'linux') {
+        return [
+            {
+                label: 'Chrome',
+                path: join(home, '.config', 'google-chrome', 'NativeMessagingHosts'),
+            },
+            {
+                label: 'Chromium',
+                path: join(home, '.config', 'chromium', 'NativeMessagingHosts'),
+            },
+            {
+                label: 'Brave',
+                path: join(home, '.config', 'BraveSoftware', 'Brave-Browser', 'NativeMessagingHosts'),
+            },
+            {
+                label: 'Edge',
+                path: join(home, '.config', 'microsoft-edge', 'NativeMessagingHosts'),
+            },
+        ];
+    }
+    if (os === 'win32') {
+        // On Windows, registration goes to the registry; we write a helper manifest
+        // to APPDATA and then set the registry key.
+        return [
+            {
+                label: 'Windows (APPDATA)',
+                path: join(process.env.APPDATA ?? join(home, 'AppData', 'Roaming'), 'WebTape', 'NativeMessagingHosts'),
+            },
+        ];
+    }
+    return [];
+}
+/**
+ * Resolve the absolute path to the webtape executable (i.e. this process).
+ */
+function resolveExecutablePath() {
+    // When installed via npm -g, `process.execPath` is node and argv[1] is the script.
+    // We want the wrapper script (the `bin` entry), not node itself.
+    // The npm bin wrapper lives adjacent to node or in npm's bin dir.
+    try {
+        const result = execSync('which webtape', { encoding: 'utf-8' }).trim();
+        if (result && existsSync(result))
+            return result;
+    }
+    catch {
+        // fall through
+    }
+    // Fallback: use node + the current script as the host command
+    return process.argv[1];
+}
+/**
+ * Build the Native Messaging host manifest JSON.
+ */
+function buildManifest(executablePath, extensionId) {
+    const os = platform();
+    if (os === 'win32') {
+        return {
+            name: HOST_NAME,
+            description: 'WebTape Native Messaging Host',
+            path: executablePath,
+            type: 'stdio',
+            allowed_origins: [`chrome-extension://${extensionId}/`],
+        };
+    }
+    return {
+        name: HOST_NAME,
+        description: 'WebTape Native Messaging Host',
+        path: executablePath,
+        type: 'stdio',
+        allowed_origins: [`chrome-extension://${extensionId}/`],
+    };
+}
+function writeWindowsRegistry(manifestPath) {
+    try {
+        execSync(`reg add "HKCU\\Software\\Google\\Chrome\\NativeMessagingHosts\\${HOST_NAME}" /ve /d "${manifestPath}" /f`, { stdio: 'ignore' });
+        console.log(chalk.green('    ✓ Chrome (Registry)'));
+    }
+    catch {
+        console.log(chalk.yellow('    ⚠ 无法写入 Chrome 注册表，请手动添加'));
+    }
+    try {
+        execSync(`reg add "HKCU\\Software\\Microsoft\\Edge\\NativeMessagingHosts\\${HOST_NAME}" /ve /d "${manifestPath}" /f`, { stdio: 'ignore' });
+        console.log(chalk.green('    ✓ Edge (Registry)'));
+    }
+    catch {
+        // Edge is optional
+    }
+}
+function openUrl(url) {
+    const os = platform();
+    try {
+        if (os === 'darwin')
+            execFile('open', [url]);
+        else if (os === 'win32')
+            execFile('cmd', ['/c', 'start', '', url]);
+        else
+            execFile('xdg-open', [url]);
+    }
+    catch {
+        // Best effort
+    }
+}
+/**
+ * Read the extension ID from the built manifest file (if available in the
+ * package root — used for development). In production the user provides it
+ * or it defaults to the published ID.
+ */
+function readExtensionIdFromManifest() {
+    // Walk up from __dirname to find the root manifest.json
+    let dir = new URL('..', import.meta.url).pathname;
+    for (let i = 0; i < 5; i++) {
+        const candidate = join(dir, 'manifest.json');
+        if (existsSync(candidate)) {
+            try {
+                const json = JSON.parse(readFileSync(candidate, 'utf-8'));
+                if (json.key) {
+                    // CRX key → ID derivation is non-trivial; skip for now
+                    return null;
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+        dir = join(dir, '..');
+    }
+    return null;
+}
+export async function runInstall(opts = {}) {
+    console.log('');
+    console.log(chalk.bold.cyan('  🔧 WebTape — 安装 Native Messaging Host'));
+    console.log(chalk.gray('  ─────────────────────────────────────────'));
+    console.log('');
+    const extensionId = opts.extensionId ?? readExtensionIdFromManifest() ?? 'PENDING_EXTENSION_ID';
+    const executablePath = resolveExecutablePath();
+    const manifest = buildManifest(executablePath, extensionId);
+    const manifestJson = JSON.stringify(manifest, null, 2);
+    const os = platform();
+    console.log(`  ${chalk.green('可执行文件')}  ${executablePath}`);
+    console.log(`  ${chalk.green('扩展 ID')}    ${extensionId}`);
+    console.log('');
+    const dirs = getNativeMessagingDirs();
+    if (os === 'win32') {
+        // On Windows: write a single manifest file and register in the registry
+        const winDir = dirs[0].path;
+        mkdirSync(winDir, { recursive: true });
+        const manifestPath = join(winDir, `${HOST_NAME}.json`);
+        writeFileSync(manifestPath, manifestJson, 'utf-8');
+        console.log(chalk.green(`  ✓ 已写入 manifest → ${manifestPath}`));
+        console.log('');
+        console.log('  正在写入 Windows 注册表…');
+        writeWindowsRegistry(manifestPath);
+    }
+    else {
+        console.log('  正在写入 NativeMessagingHosts manifest…');
+        console.log('');
+        for (const dir of dirs) {
+            try {
+                mkdirSync(dir.path, { recursive: true });
+                const manifestPath = join(dir.path, `${HOST_NAME}.json`);
+                writeFileSync(manifestPath, manifestJson, 'utf-8');
+                console.log(chalk.green(`    ✓ ${dir.label}: ${manifestPath}`));
+            }
+            catch (err) {
+                console.log(chalk.gray(`    - ${dir.label}: 跳过 (${err.message})`));
+            }
+        }
+        // Ensure the executable is executable
+        try {
+            chmodSync(executablePath, 0o755);
+        }
+        catch {
+            // ignore
+        }
+    }
+    console.log('');
+    console.log(chalk.green('  ✅ Native Messaging Host 注册完成'));
+    console.log('');
+    if (opts.openStore !== false) {
+        console.log(chalk.cyan('  正在打开 Chrome 插件安装页…'));
+        openUrl(CWS_URL);
+        console.log(chalk.gray('  请在浏览器中点击"添加到 Chrome"完成插件安装。'));
+        console.log('');
+        console.log(chalk.gray('  提示：如果浏览器没有自动打开，请手动访问:'));
+        console.log(chalk.cyan(`  ${CWS_URL}`));
+    }
+    console.log('');
+    console.log(chalk.bold('  安装完成！'));
+    console.log(chalk.gray('  录制时直接点击插件图标，无需任何额外操作。'));
+    console.log('');
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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

package/dist/native-host.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Native Messaging host entry point.
+ *
+ * Chrome spawns this process on-demand when the extension calls
+ * chrome.runtime.connectNative('com.webtape.receiver').
+ *
+ * Protocol: each message is prefixed with a 4-byte little-endian length (uint32).
+ * Chrome manages the process lifecycle; we exit after handling the message.
+ */
+export declare function runNativeHost(): Promise<void>;
+/**
+ * Run analysis for a session directory (called from the detached subprocess).
+ */
+export declare function runDetachedAnalysis(sessionDir: string, backend: string, model?: string): Promise<void>;
+//# sourceMappingURL=native-host.d.ts.map

package/dist/native-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-host.d.ts","sourceRoot":"","sources":["../src/native-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2DH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CA0DnD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/native-host.js

@@ -0,0 +1,129 @@
+/**
+ * Native Messaging host entry point.
+ *
+ * Chrome spawns this process on-demand when the extension calls
+ * chrome.runtime.connectNative('com.webtape.receiver').
+ *
+ * Protocol: each message is prefixed with a 4-byte little-endian length (uint32).
+ * Chrome manages the process lifecycle; we exit after handling the message.
+ */
+import { resolveWorkspaceRoot, ensureWorkspace } from './workspace.js';
+import { saveRecording } from './storage.js';
+import { analyzeRecording } from './analyzer.js';
+import { loadConfig } from './config.js';
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+const VERSION = '1.7.0';
+function readNativeMessage() {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let headerBuf = Buffer.alloc(0);
+        let expectedLen = null;
+        let body = Buffer.alloc(0);
+        process.stdin.on('data', (chunk) => {
+            if (expectedLen === null) {
+                headerBuf = Buffer.concat([headerBuf, chunk]);
+                if (headerBuf.length >= 4) {
+                    expectedLen = headerBuf.readUInt32LE(0);
+                    body = headerBuf.slice(4);
+                }
+            }
+            else {
+                body = Buffer.concat([body, chunk]);
+            }
+            if (expectedLen !== null && body.length >= expectedLen) {
+                resolve(body.slice(0, expectedLen));
+            }
+        });
+        process.stdin.on('error', reject);
+        process.stdin.on('end', () => {
+            if (expectedLen === null || body.length < expectedLen) {
+                reject(new Error('stdin closed before full message received'));
+            }
+        });
+    });
+}
+function writeNativeMessage(obj) {
+    const json = JSON.stringify(obj);
+    const buf = Buffer.from(json, 'utf-8');
+    const header = Buffer.alloc(4);
+    header.writeUInt32LE(buf.length, 0);
+    process.stdout.write(Buffer.concat([header, buf]));
+}
+function getHostScriptPath() {
+    return fileURLToPath(import.meta.url);
+}
+export async function runNativeHost() {
+    let payload;
+    try {
+        const raw = await readNativeMessage();
+        const msg = JSON.parse(raw.toString('utf-8'));
+        if (msg.type === 'ping') {
+            writeNativeMessage({ type: 'pong', version: VERSION });
+            process.exit(0);
+        }
+        if (msg.type !== 'recording') {
+            writeNativeMessage({ type: 'error', error: `Unknown message type: ${msg.type}` });
+            process.exit(1);
+        }
+        payload = msg.payload;
+    }
+    catch (err) {
+        writeNativeMessage({ type: 'error', error: String(err) });
+        process.exit(1);
+    }
+    let sessionDir;
+    try {
+        const workspaceRoot = resolveWorkspaceRoot();
+        const workspace = ensureWorkspace(workspaceRoot, VERSION);
+        sessionDir = saveRecording(workspace, payload);
+        writeNativeMessage({ type: 'received', session: sessionDir });
+    }
+    catch (err) {
+        writeNativeMessage({ type: 'error', error: String(err) });
+        process.exit(1);
+    }
+    // Spawn a detached child process to run AI analysis so the native host
+    // can exit immediately (Chrome does not need to keep it alive).
+    const config = loadConfig();
+    const backend = config.aiBackend ?? 'cursor';
+    if (backend !== 'none') {
+        try {
+            const hostScript = getHostScriptPath();
+            const child = spawn(process.execPath, [hostScript, '--analyze', sessionDir, '--backend', backend, ...(config.aiModel ? ['--model', config.aiModel] : [])], {
+                detached: true,
+                stdio: 'ignore',
+                env: process.env,
+            });
+            child.unref();
+        }
+        catch (_err) {
+            // Analysis spawn failure is non-fatal; data is already saved
+        }
+    }
+    process.exit(0);
+}
+/**
+ * Run analysis for a session directory (called from the detached subprocess).
+ */
+export async function runDetachedAnalysis(sessionDir, backend, model) {
+    const workspaceRoot = resolveWorkspaceRoot();
+    const workspace = ensureWorkspace(workspaceRoot, VERSION);
+    if (!existsSync(sessionDir)) {
+        process.exit(1);
+    }
+    try {
+        await analyzeRecording({
+            backend: backend,
+            workspace,
+            sessionDir,
+            model,
+        });
+    }
+    catch (_err) {
+        process.exit(1);
+    }
+    process.exit(0);
+}
+//# sourceMappingURL=native-host.js.map

package/dist/native-host.js.map

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

package/dist/rules.d.ts

@@ -0,0 +1,59 @@
+/**
+ * webtape-receiver 接收/呈现层规则 — 集中管理
+ *
+ * ┌─────────────────────────────────────────────────────────────────────┐
+ * │ 边界说明                                                           │
+ * │                                                                     │
+ * │ 插件层（根目录 rules.js）       → 控制「采集什么」                 │
+ * │   哪些网络请求要录制、哪些用户操作要捕获、时间窗口参数、           │
+ * │   A11y 树过滤等。                                                   │
+ * │                                                                     │
+ * │ 接收层（本文件）                → 控制「如何呈现」                 │
+ * │   导出 JSON / _context.md 综述时的头噪音过滤、body 截断阈值、     │
+ * │   协议过滤（只在 context 中展示 HTTPS/WSS）、时间线加工规则        │
+ * │  （如移除首个误捕获 CLICK）、cookie 脱敏等。                       │
+ * └─────────────────────────────────────────────────────────────────────┘
+ */
+/** 精确匹配的噪音 header 名（全部小写）— 请求+响应均适用 */
+export declare const NOISE_HEADERS: Set<string>;
+/** 仅请求：浏览器几乎总会带的头，context 中不展示 */
+export declare const NOISE_HEADERS_REQUEST_ONLY: Set<string>;
+/** 仅响应：CDN/网关追踪、耗时类，对业务链综述价值低 */
+export declare const NOISE_HEADERS_RESPONSE_ONLY: Set<string>;
+/** 前缀匹配的噪音 header 名（全部小写） */
+export declare const NOISE_HEADER_PREFIXES: string[];
+/**
+ * 判断一个 header 是否为噪音（应在 context 综述中过滤掉）。
+ * @param role 传入 `request` / `response` 时可应用按侧过滤（如 UA、content-type、eo-*）。
+ */
+export declare function isNoiseHeader(name: string, role?: 'request' | 'response'): boolean;
+/**
+ * 需要脱敏渲染的 header 名 → 处理策略。
+ * - 'cookie'     → 只显示 cookie 名称列表，不显示值
+ * - 'set-cookie' → 只提示存在
+ */
+export declare const SENSITIVE_HEADER_RULES: Record<string, 'cookie_names' | 'presence_only'>;
+/** header 值的最大显示长度，超出截断 */
+export declare const HEADER_VALUE_MAX_LENGTH = 300;
+/** body 全文展示阈值（JS 字符串 .length），不超过则完整写入 context */
+export declare const BODY_FULL_LIMIT = 1000;
+/** 超过 BODY_FULL_LIMIT 时，依据 UTF-8 字节数选择提示语气 */
+export declare const BODY_OVERSIZE_HINT_LT_LARGE: number;
+export declare const BODY_OVERSIZE_HINT_LT_HUGE: number;
+/**
+ * 不允许出现在 context 综述中的协议。
+ * 即：纯 http / ws 的请求会被过滤掉（只保留 https / wss 等）。
+ */
+export declare const DISALLOWED_PROTOCOLS: Set<string>;
+/**
+ * 判断 URL 对应的协议是否允许出现在 context 综述中。
+ * 返回 true 表示允许（即非 http/ws）。
+ */
+export declare function isAllowedProtocol(url: string): boolean;
+/**
+ * 是否移除时间线中第一个 CLICK 操作。
+ * 录制启动时用户点击"开始录制"按钮通常会被 content script 捕获为第一个 CLICK，
+ * 属于误捕获，应在呈现时剔除。
+ */
+export declare const STRIP_FIRST_CLICK = true;
+//# sourceMappingURL=rules.d.ts.map

package/dist/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,uCAAuC;AACvC,eAAO,MAAM,aAAa,aAOxB,CAAC;AAEH,kCAAkC;AAClC,eAAO,MAAM,0BAA0B,aAErC,CAAC;AAEH,iCAAiC;AACjC,eAAO,MAAM,2BAA2B,aAEtC,CAAC;AAEH,6BAA6B;AAC7B,eAAO,MAAM,qBAAqB,UAIjC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAC5B,OAAO,CAUT;AAMD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAGnF,CAAC;AAEF,2BAA2B;AAC3B,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAM3C,mDAAmD;AACnD,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,8CAA8C;AAC9C,eAAO,MAAM,2BAA2B,QAAY,CAAC;AACrD,eAAO,MAAM,0BAA0B,QAAa,CAAC;AAMrD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,aAA4B,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOtD;AAMD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC"}

package/dist/rules.js

@@ -0,0 +1,115 @@
+/**
+ * webtape-receiver 接收/呈现层规则 — 集中管理
+ *
+ * ┌─────────────────────────────────────────────────────────────────────┐
+ * │ 边界说明                                                           │
+ * │                                                                     │
+ * │ 插件层（根目录 rules.js）       → 控制「采集什么」                 │
+ * │   哪些网络请求要录制、哪些用户操作要捕获、时间窗口参数、           │
+ * │   A11y 树过滤等。                                                   │
+ * │                                                                     │
+ * │ 接收层（本文件）                → 控制「如何呈现」                 │
+ * │   导出 JSON / _context.md 综述时的头噪音过滤、body 截断阈值、     │
+ * │   协议过滤（只在 context 中展示 HTTPS/WSS）、时间线加工规则        │
+ * │  （如移除首个误捕获 CLICK）、cookie 脱敏等。                       │
+ * └─────────────────────────────────────────────────────────────────────┘
+ */
+// =========================================================================
+// 1. Header Noise Filtering — context 综述中过滤掉的无关请求/响应头
+// =========================================================================
+/** 精确匹配的噪音 header 名（全部小写）— 请求+响应均适用 */
+export const NOISE_HEADERS = new Set([
+    'accept-encoding', 'accept-language', 'cache-control', 'connection',
+    'content-length', 'content-type', 'dnt', 'etag', 'if-modified-since',
+    'if-none-match', 'keep-alive', 'pragma', 'server', 'vary', 'date', 'age',
+    'expires', 'last-modified', 'transfer-encoding', 'x-powered-by',
+    'x-request-id', 'x-frame-options', 'x-content-type-options',
+    'x-xss-protection',
+]);
+/** 仅请求：浏览器几乎总会带的头，context 中不展示 */
+export const NOISE_HEADERS_REQUEST_ONLY = new Set([
+    'accept', 'origin', 'referer', 'user-agent', 'x-requested-with',
+]);
+/** 仅响应：CDN/网关追踪、耗时类，对业务链综述价值低 */
+export const NOISE_HEADERS_RESPONSE_ONLY = new Set([
+    'server-timing', 'x-req-id', 'x-server-cost',
+]);
+/** 前缀匹配的噪音 header 名（全部小写） */
+export const NOISE_HEADER_PREFIXES = [
+    'sec-', 'content-security-policy', 'strict-transport-security',
+    'access-control-', 'permissions-policy', 'cross-origin-',
+    'report-to', 'nel', ':',
+];
+/**
+ * 判断一个 header 是否为噪音（应在 context 综述中过滤掉）。
+ * @param role 传入 `request` / `response` 时可应用按侧过滤（如 UA、content-type、eo-*）。
+ */
+export function isNoiseHeader(name, role) {
+    const lower = name.toLowerCase();
+    if (NOISE_HEADERS.has(lower))
+        return true;
+    if (NOISE_HEADER_PREFIXES.some((p) => lower.startsWith(p)))
+        return true;
+    if (role === 'request' && NOISE_HEADERS_REQUEST_ONLY.has(lower))
+        return true;
+    if (role === 'response') {
+        if (NOISE_HEADERS_RESPONSE_ONLY.has(lower))
+            return true;
+        if (lower.startsWith('eo-'))
+            return true;
+    }
+    return false;
+}
+// =========================================================================
+// 2. Cookie / Sensitive Header Rendering — 脱敏规则
+// =========================================================================
+/**
+ * 需要脱敏渲染的 header 名 → 处理策略。
+ * - 'cookie'     → 只显示 cookie 名称列表，不显示值
+ * - 'set-cookie' → 只提示存在
+ */
+export const SENSITIVE_HEADER_RULES = {
+    cookie: 'cookie_names',
+    'set-cookie': 'presence_only',
+};
+/** header 值的最大显示长度，超出截断 */
+export const HEADER_VALUE_MAX_LENGTH = 300;
+// =========================================================================
+// 3. Body Rendering — context 中的 body 长度阈值与超大提示档位（按字节）
+// =========================================================================
+/** body 全文展示阈值（JS 字符串 .length），不超过则完整写入 context */
+export const BODY_FULL_LIMIT = 1000;
+/** 超过 BODY_FULL_LIMIT 时，依据 UTF-8 字节数选择提示语气 */
+export const BODY_OVERSIZE_HINT_LT_LARGE = 20 * 1024;
+export const BODY_OVERSIZE_HINT_LT_HUGE = 500 * 1024;
+// =========================================================================
+// 4. Protocol Filtering — context 综述中只展示安全协议的请求
+// =========================================================================
+/**
+ * 不允许出现在 context 综述中的协议。
+ * 即：纯 http / ws 的请求会被过滤掉（只保留 https / wss 等）。
+ */
+export const DISALLOWED_PROTOCOLS = new Set(['http:', 'ws:']);
+/**
+ * 判断 URL 对应的协议是否允许出现在 context 综述中。
+ * 返回 true 表示允许（即非 http/ws）。
+ */
+export function isAllowedProtocol(url) {
+    try {
+        const protocol = new URL(url).protocol.toLowerCase();
+        return !DISALLOWED_PROTOCOLS.has(protocol);
+    }
+    catch {
+        return false;
+    }
+}
+// =========================================================================
+// 5. Timeline Processing — 时间线加工规则
+// =========================================================================
+/**
+ * 是否移除时间线中第一个 CLICK 操作。
+ * 录制启动时用户点击"开始录制"按钮通常会被 content script 捕获为第一个 CLICK，
+ * 属于误捕获，应在呈现时剔除。
+ */
+export const STRIP_FIRST_CLICK = true;
+//# sourceMappingURL=rules.js.map

package/dist/rules.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,32 @@
+import { type IncomingMessage, type ServerResponse } from 'node:http';
+import type { WorkspacePaths } from './workspace.js';
+import type { WebTapePayload } from './types.js';
+import { type AnalyzerBackend, type AnalyzeResult } from './analyzer.js';
+/** 单次 webhook 收包后、启动 AI 之前的处理耗时（接收/解析 + 落盘与生成 _context.md） */
+export interface ReceivePersistMetrics {
+    /** 读取 HTTP 正文 */
+    readBodyMs: number;
+    /** JSON.parse 与 meta/content 校验 */
+    parseValidateMs: number;
+    /** saveRecording：写 requests/responses/snapshots/index.json 与 _context.md */
+    persistMs: number;
+    /** 以上三项之和，即非 AI 链路总耗时 */
+    totalNonAiMs: number;
+}
+export interface ServerOptions {
+    port: number;
+    workspace: WorkspacePaths;
+    autoAnalyze: boolean;
+    analyzerBackend: AnalyzerBackend;
+    analyzerModel?: string;
+    onReceive?: (sessionDir: string, payload: WebTapePayload, metrics: ReceivePersistMetrics) => void;
+    onAnalyzeLog?: (line: string) => void;
+    onAnalyzeDone?: (result: AnalyzeResult) => void;
+    onError?: (err: Error) => void;
+}
+export declare function createWebhookServer(opts: ServerOptions): {
+    start: () => Promise<void>;
+    stop: () => Promise<void>;
+    server: import("http").Server<typeof IncomingMessage, typeof ServerResponse>;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAGpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAoB,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAE3F,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,cAAc,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAClG,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAiCD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa;;;;EA6FtD"}