preflite 1.1.3 → 1.1.6

package/dist/mcp/server.js

@@ -13,8 +13,6 @@ import { loadPreflightUserConfig } from "./userConfig.js";
 import { compileVisualFlow, validateVisualFlow } from "./visual-flow/index.js";
 import { registerExplorationTools } from "./exploration/index.js";
 import { createMidsceneSessionFromResourceId, ensureIosWdaStarted } from "./exploration/tools-session.js";
-import { NetworkMockService } from "./network-mocks/NetworkMockService.js";
-import { proxyHostForPlatform } from "./network-mocks/device-proxy.js";
 import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 const MCP_SAFE_WAIT_MS = 45_000;
@@ -29,7 +27,6 @@ export function createPreflightMcpServer(options = {}) {
     const runtime = new AgentRuntimeManager({ projectRoot, agentBaseUrl, client, env: process.env, runtimeRoot: options.runtimeRoot, loadConfigEnv });
     const liveBaseUrl = `http://127.0.0.1:${livePort}`;
     const runManager = new RunManager(client, liveBaseUrl);
-    const networkMockService = new NetworkMockService();
     let liveServerStarted;
     const server = new McpServer({ name: "Preflight", version: "0.1.0" });
     server.registerTool("agent_health", {
@@ -133,29 +130,6 @@ export function createPreflightMcpServer(options = {}) {
         const parsed = validateVisualFlow(input.visualFlow);
         if (!parsed.ok)
             return jsonResult(parsed);
-        const hasNetworkMocks = (parsed.value.networkMocks?.length ?? 0) > 0;
-        let mocksStarted = false;
-        if (hasNetworkMocks && input.resourceId) {
-            const deviceId = input.resourceId.includes(":") ? input.resourceId.split(":")[1] : input.resourceId;
-            const platform = input.platform.toLowerCase();
-            try {
-                await networkMockService.start({
-                    rules: parsed.value.networkMocks,
-                    platform,
-                    deviceId,
-                });
-                mocksStarted = true;
-            }
-            catch (err) {
-                return jsonResult({
-                    ok: false,
-                    message: `启动网络 mock 失败: ${err instanceof Error ? err.message : String(err)}`,
-                });
-            }
-        }
-        else if (hasNetworkMocks && !input.resourceId) {
-            // Mocks defined but no device — note for manual setup
-        }
         liveServerStarted ??= startLiveViewer(livePort, runManager).then((viewer) => {
             runManager.setLiveBaseUrl(viewer.baseUrl);
         });
@@ -175,16 +149,9 @@ export function createPreflightMcpServer(options = {}) {
             return jsonResult({
                 ...started,
                 visualFlow: parsed.value,
-                ...(mocksStarted ? { networkMocksActive: true } : {}),
             });
         }
         const result = await runManager.waitForRun(started.runId, safeMcpWaitMs(input.timeoutMs), RUN_POLL_INTERVAL_MS);
-        if (mocksStarted) {
-            try {
-                await networkMockService.stop();
-            }
-            catch { /* cleanup */ }
-        }
         return jsonResult(result);
     });
     server.registerTool("watch_run", {
@@ -208,13 +175,6 @@ export function createPreflightMcpServer(options = {}) {
         const summary = waitForCompletion
             ? await runManager.waitForRun(runId, safeMcpWaitMs(timeoutMs), RUN_POLL_INTERVAL_MS)
             : await runManager.watchRun(runId, MCP_SAFE_WAIT_MS);
-        // Auto-cleanup mocks on terminal state
-        if (["SUCCESS", "FAILED", "CANCELLED"].includes(summary.status) && networkMockService.isRunning()) {
-            try {
-                await networkMockService.stop();
-            }
-            catch { /* cleanup */ }
-        }
         return jsonResult(summary);
     });
     server.registerTool("cancel_run", {
@@ -228,13 +188,6 @@ export function createPreflightMcpServer(options = {}) {
     }, async ({ runId, reason }) => {
         await runtime.ensureStarted();
         const result = await runManager.cancelRun(runId, "model", reason ?? "no reason given");
-        // Clean up network mocks if they were auto-started for this run
-        if (networkMockService.isRunning()) {
-            try {
-                await networkMockService.stop();
-            }
-            catch { /* cleanup */ }
-        }
         return jsonResult(result);
     });
     server.registerTool("save_report", {
@@ -272,162 +225,6 @@ export function createPreflightMcpServer(options = {}) {
         const result = await readReport(reportDir);
         return jsonResult(result);
     });
-    server.registerTool("start_network_mocks", {
-        title: "Start Network Mocks",
-        description: "Start the network mock HTTP/HTTPS proxy server and configure the device to route traffic through it. " +
-            "Matching requests return mock responses; non-matching traffic is forwarded transparently. " +
-            "Automatically generates a Root CA certificate for HTTPS MITM interception. " +
-            "Use before a test run to mock API responses that the app depends on. " +
-            "Currently supports Android emulator (iOS simulator deferred to phase 2).",
-        inputSchema: {
-            platform: z.enum(["ANDROID", "IOS"]).describe("Device platform"),
-            resourceId: z.string().describe("Device resource ID from list_devices (e.g., android:emulator-5554)"),
-            port: z.number().int().positive().optional().describe("Preferred port (e.g., to match existing device proxy config)"),
-            rules: z.array(z.object({
-                urlPattern: z.string().describe("Substring to match against the full request URL"),
-                method: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH"]).optional().describe("HTTP method to match (default: any)"),
-                responses: z.array(z.object({
-                    status: z.number().int().min(100).max(599).optional().describe("HTTP status code (default: 200)"),
-                    body: z.string().describe("Response body, typically a JSON string"),
-                    requestBodyMatch: z.record(z.string()).optional().describe("Key-value pairs that must match in the request body"),
-                    callIndex: z.number().int().positive().optional().describe("Only match on the nth call (1-based, for stateful sequences)"),
-                    headers: z.record(z.string()).optional().describe("Optional response headers"),
-                    delay: z.number().int().min(0).optional().describe("Delay in ms before responding"),
-                })),
-                description: z.string().optional().describe("Human-readable description"),
-            })),
-        },
-    }, async (input) => {
-        await runtime.ensureStarted();
-        const platform = input.platform.toLowerCase();
-        const deviceId = input.resourceId.includes(":") ? input.resourceId.split(":")[1] : input.resourceId;
-        const rules = input.rules.map((r) => ({
-            urlPattern: r.urlPattern,
-            ...(r.method ? { method: r.method } : {}),
-            responses: r.responses.map((resp) => ({
-                ...(resp.status != null ? { status: resp.status } : {}),
-                body: resp.body,
-                ...(resp.requestBodyMatch ? { requestBodyMatch: resp.requestBodyMatch } : {}),
-                ...(resp.callIndex != null ? { callIndex: resp.callIndex } : {}),
-                ...(resp.headers ? { headers: resp.headers } : {}),
-                ...(resp.delay != null ? { delay: resp.delay } : {}),
-            })),
-            ...(r.description ? { description: r.description } : {}),
-        }));
-        return jsonResult(await networkMockService.start({ rules, platform, deviceId, preferredPort: input.port }));
-    });
-    server.registerTool("stop_network_mocks", {
-        title: "Stop Network Mocks",
-        description: "Stop the network mock server and remove device proxy configuration. " +
-            "Call this after the test completes to restore normal network traffic.",
-    }, async () => jsonResult(await networkMockService.stop()));
-    server.registerTool("get_network_mock_status", {
-        title: "Get Network Mock Status",
-        description: "Get the current network mock server status and per-rule call statistics. " +
-            "Use to verify that mocks are being hit as expected during a test.",
-    }, async () => jsonResult(networkMockService.getStats()));
-    server.registerTool("update_network_mock_rules", {
-        title: "Update Network Mock Rules",
-        description: "Hot-reload mock rules without stopping the server. " +
-            "Use to change mock responses mid-test without restarting the proxy.",
-        inputSchema: {
-            rules: z.array(z.object({
-                urlPattern: z.string(),
-                method: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH"]).optional(),
-                responses: z.array(z.object({
-                    status: z.number().int().min(100).max(599).optional(),
-                    body: z.string(),
-                    requestBodyMatch: z.record(z.string()).optional(),
-                    callIndex: z.number().int().positive().optional(),
-                    headers: z.record(z.string()).optional(),
-                    delay: z.number().int().min(0).optional(),
-                })),
-                description: z.string().optional(),
-            })),
-        },
-    }, async ({ rules }) => {
-        const parsed = rules.map((r) => ({
-            urlPattern: r.urlPattern,
-            ...(r.method ? { method: r.method } : {}),
-            responses: r.responses.map((resp) => ({
-                ...(resp.status != null ? { status: resp.status } : {}),
-                body: resp.body,
-                ...(resp.requestBodyMatch ? { requestBodyMatch: resp.requestBodyMatch } : {}),
-                ...(resp.callIndex != null ? { callIndex: resp.callIndex } : {}),
-                ...(resp.headers ? { headers: resp.headers } : {}),
-                ...(resp.delay != null ? { delay: resp.delay } : {}),
-            })),
-            ...(r.description ? { description: r.description } : {}),
-        }));
-        networkMockService.updateRules(parsed);
-        return jsonResult({ ok: true, updated: parsed.length });
-    });
-    server.registerTool("get_root_ca_cert", {
-        title: "Get Root CA Certificate",
-        description: "Export the Preflight MITM Root CA certificate (PEM format). " +
-            "Install this certificate on your iOS/Android device to enable HTTPS interception. " +
-            "iOS: Send the cert to the device (e.g. AirDrop), open it, go to Settings > Profile Downloaded > Install. " +
-            "Then Settings > General > About > Certificate Trust Settings > Enable full trust for 'Preflight Mock CA'. " +
-            "Android: Settings > Security > Encryption & credentials > Install a certificate > CA certificate. " +
-            "Only available when network mocks are running.",
-    }, async () => {
-        const cert = networkMockService.getRootCACert();
-        if (!cert)
-            return jsonResult({ ok: false, message: "network mocks not running — call start_network_mocks first" });
-        return { content: [{ type: "text", text: cert }] };
-    });
-    server.registerTool("get_mobile_config", {
-        title: "Get iOS Mobile Config",
-        description: "Generate an iOS .mobileconfig profile that installs the CA certificate AND configures the WiFi proxy " +
-            "in one step. Send this file to the iOS device (e.g. AirDrop), open it to install. " +
-            "After installation, go to Settings > General > About > Certificate Trust Settings > enable 'Preflight Mock CA'. " +
-            "The proxy host will be auto-detected as this machine's local IP. " +
-            "Only available when network mocks are running.",
-    }, async () => {
-        if (!networkMockService.isRunning()) {
-            return jsonResult({ ok: false, message: "network mocks not running — call start_network_mocks first" });
-        }
-        const port = networkMockService.getStats().port;
-        if (!port)
-            return jsonResult({ ok: false, message: "mock server port unknown" });
-        const proxyHost = proxyHostForPlatform("ios") === "127.0.0.1" ? "172.23.166.53" : proxyHostForPlatform("ios");
-        const config = networkMockService.generateMobileConfig(proxyHost, port);
-        if (!config)
-            return jsonResult({ ok: false, message: "failed to generate mobileconfig" });
-        return { content: [{ type: "text", text: config }] };
-    });
-    server.registerTool("start_recording", {
-        title: "Start Network Recording",
-        description: "Start recording network traffic through the mock proxy. All requests and responses are captured " +
-            "and can be exported as mock rules via export_recorded_rules. Network mocks must already be running.",
-    }, async () => {
-        if (!networkMockService.isRunning()) {
-            return jsonResult({ ok: false, message: "network mocks not running — call start_network_mocks first" });
-        }
-        networkMockService.setRecording(true);
-        return jsonResult({ ok: true, message: "Recording started" });
-    });
-    server.registerTool("stop_recording", {
-        title: "Stop Network Recording",
-        description: "Stop recording and return the count of captured requests.",
-    }, async () => {
-        if (!networkMockService.isRunning()) {
-            return jsonResult({ ok: false, message: "network mocks not running" });
-        }
-        const count = networkMockService.getRecordedCount();
-        networkMockService.setRecording(false);
-        return jsonResult({ ok: true, recorded: count });
-    });
-    server.registerTool("export_recorded_rules", {
-        title: "Export Recorded Rules",
-        description: "Export recorded network traffic as NetworkMockRule[]. " +
-            "Duplicated URLs are merged, request bodies generate requestBodyMatch rules, " +
-            "and sequential responses are assigned callIndex. " +
-            "Use after stop_recording to convert captured traffic into reusable mock rules.",
-    }, async () => {
-        const rules = networkMockService.exportRecordedRules();
-        return jsonResult({ ok: true, count: rules.length, rules });
-    });
     registerExplorationTools(server, { client, loadConfigEnv, ensureAgentStarted: async () => { await runtime.ensureStarted(); }, createSessionFromMeta: createMidsceneSessionFromResourceId, projectRoot });
     return server;
 }

package/dist/mcp/setup.js

@@ -20,6 +20,8 @@ export async function setupLocalMcp(options) {
     const skillPath = join(options.projectRoot, ".preflight", "skills", "preflight.md");
     const codexSkillPath = join(homedir(), ".codex", "skills", "preflight", "SKILL.md");
     const agentsSkillPath = join(homedir(), ".agents", "skills", "preflight", "SKILL.md");
+    const claudeSkillPath = join(homedir(), ".claude", "skills", "preflight", "SKILL.md");
+    const androidEmulatorSetupSkillPath = join(homedir(), ".claude", "skills", "android-emulator-setup", "SKILL.md");
     const userConfigExamplePath = join(homedir(), ".preflight", "config.example.json");
     const codexConfigPath = join(homedir(), ".codex", "config.toml");
     await writeCursorMcpConfig(cursorConfigPath, options.projectRoot, agentBaseUrl, livePort, isRuntime, runtimeRoot);
@@ -27,9 +29,11 @@ export async function setupLocalMcp(options) {
     await writeTextFile(skillPath, skillText());
     await writeTextFile(codexSkillPath, skillText());
     await writeTextFile(agentsSkillPath, skillText());
+    await writeTextFile(claudeSkillPath, skillText());
+    await writeTextFile(androidEmulatorSetupSkillPath, androidEmulatorSetupSkillText());
     await writeTextFile(userConfigExamplePath, userConfigExampleText());
     await upsertCodexMcpConfig(codexConfigPath, options.projectRoot, agentBaseUrl, livePort, isRuntime, runtimeRoot);
-    return { cursorConfigPath, cursorRulePath, codexConfigPath, skillPath, codexSkillPath, agentsSkillPath, runtimeRoot, userConfigExamplePath };
+    return { cursorConfigPath, cursorRulePath, codexConfigPath, skillPath, codexSkillPath, agentsSkillPath, claudeSkillPath, androidEmulatorSetupSkillPath, runtimeRoot, userConfigExamplePath };
 }
 async function writeCursorMcpConfig(path, projectRoot, agentBaseUrl, livePort, isRuntime, runtimeRoot) {
     let existing = {};
@@ -127,12 +131,13 @@ alwaysApply: false
 5. 调用 \`list_devices\`，优先选择与改动相关的平台设备。
 6. 调用 \`get_visual_flow_ir_rules\`，按 IR 规范生成 visualFlow JSON。默认不要直接写 Midscene TS 脚本。
 7. 调用 \`validate_visual_flow\`。如果校验失败，按 message 修正 visualFlow 后再次校验。
-8. 生成最小测试用例：先覆盖改动点，再补必要回归。
-9. 如用户给了 app 包，先调用 \`install_app\`。
-10. 调用 \`run_flow\` 时必须设置 \`waitForCompletion: false\`，让工具立即返回 runId/liveUrl；不要用 \`waitForCompletion: true\` 等待完整流程，避免 MCP 60 秒传输超时。
-11. 执行中调用 \`watch_run\` 观察状态；工具默认等待最多 45 秒，run 一旦成功或失败会提前返回。失败时先判断是环境/设备、IR 用例步骤、agent runtime 还是真实业务问题。
-12. 如果失败原因是 IR 步骤不合理，只能调整 visualFlow 后重跑；不要读取或手写 Midscene TS 脚本。若是 Preflight 编译器/runtime 内部错误，停止并报告为工具缺陷。
-13. 最终调用 \`save_report\`，并在回复中给出测试报告、report/liveUrl 和 PASS/FAIL 结论。
+8. **每条 visualFlow 必须以冷启动开始**：第一个步骤总是 \`closeApp\` + \`launch\`（同一个 packageName），确保 app 从已知初始状态执行。不要在已打开的 app 上接着跑测试；不确定 app 已在哪个页面时，一律重启。
+9. 生成最小测试用例：先覆盖改动点，再补必要回归。
+10. 如用户给了 app 包，先调用 \`install_app\`。
+11. 调用 \`run_flow\` 时必须设置 \`waitForCompletion: false\`，让工具立即返回 runId/liveUrl；不要用 \`waitForCompletion: true\` 等待完整流程，避免 MCP 60 秒传输超时。
+12. 执行中调用 \`watch_run\` 观察状态；工具默认等待最多 45 秒，run 一旦成功或失败会提前返回。失败时先判断是环境/设备、IR 用例步骤、agent runtime 还是真实业务问题。
+13. 如果失败原因是 IR 步骤不合理，只能调整 visualFlow 后重跑；不要读取或手写 Midscene TS 脚本。若是 Preflight 编译器/runtime 内部错误，停止并报告为工具缺陷。
+14. 最终调用 \`save_report\`，并在回复中给出测试报告、report/liveUrl 和 PASS/FAIL 结论。
 `;
 }
 function skillText() {
@@ -164,11 +169,12 @@ Workflow:
 5. List devices with \`list_devices\`.
 6. Read \`get_visual_flow_ir_rules\` and generate visualFlow JSON, not raw Midscene TypeScript.
 7. Validate with \`validate_visual_flow\`; fix the JSON until validation passes.
-8. Install the app when an app package path is provided.
-9. Start the run with \`run_flow\` using \`waitForCompletion: false\`, then show the returned liveUrl. Never wait for a full flow inside \`run_flow\`; MCP transport can time out after about 60 seconds.
-10. Poll with \`watch_run\`; it waits up to 45s by default and returns early when the run succeeds or fails.
-11. Analyze failures before retrying. Distinguish device/env failures, brittle IR steps, agent runtime failures, and real app bugs. For IR problems, revise visualFlow only; never switch to raw Midscene script repair.
-12. Save report with \`save_report\`.
+8. **Every visualFlow MUST begin with a cold start.** The first two steps are always \`closeApp\` then \`launch\` (same packageName). This guarantees the app starts from a known, clean initial state. Never skip this — even if the app is already open on the target screen.
+9. Install the app when an app package path is provided.
+10. Start the run with \`run_flow\` using \`waitForCompletion: false\`, then show the returned liveUrl. Never wait for a full flow inside \`run_flow\`; MCP transport can time out after about 60 seconds.
+11. Poll with \`watch_run\`; it waits up to 45s by default and returns early when the run succeeds or fails.
+12. Analyze failures before retrying. Distinguish device/env failures, brittle IR steps, agent runtime failures, and real app bugs. For IR problems, revise visualFlow only; never switch to raw Midscene script repair.
+13. Save report with \`save_report\`.
 
 Reports are written under \`~/.preflight/midscene_run/report/<reportName>/\`.
 
@@ -187,3 +193,129 @@ function userConfigExampleText() {
 }
 `;
 }
+function androidEmulatorSetupSkillText() {
+    return `---
+name: android-emulator-setup
+description: Use when setting up an Android emulator from scratch, installing Android SDK command-line tools, creating AVDs, or when emulator/adb/avdmanager commands are not found. Also use when the user asks to install, configure, or bootstrap an Android development environment.
+---
+
+# Android Emulator Setup
+
+Install the Android SDK command-line tools, create AVDs, and start emulators — the prerequisite step before Argent or Preflight can interact with a device.
+
+## Quick Detection
+
+Run these before doing any work. Skip sections whose tools already work.
+
+\`\`\`bash
+adb --version 2>/dev/null && echo "ADB OK" || echo "ADB MISSING"
+emulator -list-avds 2>/dev/null && echo "EMULATOR OK" || echo "EMULATOR MISSING"
+echo "ANDROID_HOME=\${ANDROID_HOME:-UNSET}"
+\`\`\`
+
+| Result | Action |
+|--------|--------|
+| ADB MISSING | Start from § Install SDK |
+| EMULATOR MISSING, ADB OK | Jump to § Install SDK Components |
+| Both OK, no AVDs | Jump to § Create AVD |
+| Both OK, AVD exists | Jump to § Start Emulator |
+
+## Install SDK
+
+**macOS with Homebrew (recommended):**
+
+\`\`\`bash
+brew install android-commandlinetools
+\`\`\`
+
+**Manual install (macOS/Linux):**
+
+\`\`\`bash
+# 1. Download from https://developer.android.com/studio#command-line-tools-only
+# 2. Unzip to the correct path:
+mkdir -p ~/Library/Android/sdk/cmdline-tools/latest
+cd ~/Library/Android/sdk/cmdline-tools/latest
+unzip ~/Downloads/commandlinetools-mac-*.zip
+\`\`\`
+
+## Configure Environment
+
+Add to \`~/.zshrc\` (or \`~/.bashrc\`):
+
+\`\`\`bash
+# With brew:
+export ANDROID_HOME=/opt/homebrew/share/android-commandlinetools
+# With manual install:
+# export ANDROID_HOME=$HOME/Library/Android/sdk
+
+export PATH=$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools:$ANDROID_HOME/cmdline-tools/latest/bin:$PATH
+\`\`\`
+
+Then \`source ~/.zshrc\` and verify:
+
+\`\`\`bash
+sdkmanager --version  # should print a version
+\`\`\`
+
+## Install SDK Components
+
+\`\`\`bash
+# Accept licenses (non-interactive)
+yes | sdkmanager --licenses
+
+# Install core components
+sdkmanager "platform-tools" "emulator" "platforms;android-34"
+
+# Install a system image (ARM Mac → arm64-v8a, Intel → x86_64)
+sdkmanager "system-images;android-34;google_apis;arm64-v8a"
+\`\`\`
+
+> **Pick the right system image:** \`sdkmanager --list | grep system-images\` to see available images. API 34 is a safe default; adjust based on the app's \`minSdk\`.
+
+## Create AVD
+
+\`\`\`bash
+avdmanager create avd \\
+  -n test_device \\
+  -k "system-images;android-34;google_apis;arm64-v8a" \\
+  -d "pixel_6"
+\`\`\`
+
+Verify: \`emulator -list-avds\` should show \`test_device\`.
+
+## Start Emulator
+
+\`\`\`bash
+emulator -avd test_device &
+\`\`\`
+
+Wait for boot (1-2 min), then verify:
+
+\`\`\`bash
+adb devices
+# List of devices attached
+# emulator-5554   device
+\`\`\`
+
+## Common Issues
+
+| Symptom | Fix |
+|---------|-----|
+| \`sdkmanager: command not found\` | \`cmdline-tools/latest/bin\` not in PATH; check § Configure Environment |
+| \`avdmanager: command not found\` | Same as above — part of cmdline-tools |
+| Emulator black screen on Apple Silicon | Ensure system image is \`arm64-v8a\`, not \`x86_64\` |
+| \`adb devices\` shows \`unauthorized\` | Wait 30s for emulator to finish booting |
+| \`The emulator process has terminated\` | Try \`emulator -avd test_device -wipe-data\` |
+| \`ANDROID_HOME\` not set after brew install | Brew's path is \`/opt/homebrew/share/android-commandlinetools\` |
+| \`PANIC: Missing emulator engine\` | Run \`sdkmanager "emulator"\` to install the emulator binary |
+| No space left on device | System images are ~1-2 GB; \`sdkmanager --uninstall\` unused images |
+
+## Post-Setup
+
+Once the emulator is running, it's ready for:
+- **Argent:** \`argent-android-emulator-setup\` skill (boot, connect, interact)
+- **Preflight:** \`preflight\` skill (visual-flow tests via MCP)
+
+To kill: \`adb -s emulator-5554 emu kill\`
+`;
+}

package/dist/mcp/visual-flow/validate.js

@@ -61,156 +61,6 @@ function parseScriptVars(raw) {
     }
     return { ok: true, value: out };
 }
-function parseSingleMockRule(o, path) {
-    const urlPattern = typeof o.urlPattern === 'string' && o.urlPattern.trim() ? o.urlPattern.trim() : "";
-    const urlRegex = typeof o.urlRegex === 'string' && o.urlRegex.trim() ? o.urlRegex.trim() : "";
-    if (!urlPattern && !urlRegex)
-        return { ok: false, message: `${path}.urlPattern 或 urlRegex 必填其一` };
-    if (urlPattern && urlPattern.length > 1000)
-        return { ok: false, message: `${path}.urlPattern 过长` };
-    if (urlRegex) {
-        try {
-            new RegExp(urlRegex);
-        }
-        catch {
-            return { ok: false, message: `${path}.urlRegex 无效` };
-        }
-    }
-    const queryParams = o.queryParams != null && typeof o.queryParams === 'object' && !Array.isArray(o.queryParams) ? Object.fromEntries(Object.entries(o.queryParams).filter(([, v]) => typeof v === 'string').map(([k, v]) => [k, v])) : undefined;
-    const method = typeof o.method === 'string' ? o.method.trim().toUpperCase() : '';
-    if (method && !['GET', 'POST', 'PUT', 'DELETE', 'PATCH'].includes(method))
-        return { ok: false, message: `${path}.method 须为 GET|POST|PUT|DELETE|PATCH` };
-    if (!Array.isArray(o.responses) || o.responses.length === 0)
-        return { ok: false, message: `${path}.responses 须为非空数组` };
-    if (o.responses.length > 50)
-        return { ok: false, message: `${path}.responses 超过上限 50` };
-    const responses = [];
-    const bodyStr = (b) => String(b);
-    for (let j = 0; j < o.responses.length; j++) {
-        const rPath = `${path}.responses[${j}]`;
-        const ri = o.responses[j];
-        if (!ri || typeof ri !== 'object' || Array.isArray(ri))
-            return { ok: false, message: `${rPath} 须为对象` };
-        const r = ri;
-        if (r.body == null)
-            return { ok: false, message: `${rPath}.body 必填` };
-        const body = bodyStr(r.body);
-        if (body.length > 1_000_000)
-            return { ok: false, message: `${rPath}.body 过长` };
-        const status = r.status != null ? Number(r.status) : 200;
-        if (!Number.isFinite(status) || status < 100 || status > 599)
-            return { ok: false, message: `${rPath}.status 须为 100～599` };
-        const callIndex = r.callIndex != null ? Number(r.callIndex) : undefined;
-        if (callIndex != null && (!Number.isFinite(callIndex) || callIndex < 1))
-            return { ok: false, message: `${rPath}.callIndex 须为正整数` };
-        const delay = r.delay != null ? Number(r.delay) : undefined;
-        if (delay != null && (!Number.isFinite(delay) || delay < 0 || delay > 60_000))
-            return { ok: false, message: `${rPath}.delay 须为 0～60000` };
-        responses.push({ status: Math.floor(status), body, ...(callIndex != null ? { callIndex: Math.floor(callIndex) } : {}), ...(delay != null ? { delay: Math.floor(delay) } : {}), ...(typeof r.headers === 'object' && r.headers && !Array.isArray(r.headers) && Object.keys(r.headers).length > 0 ? { headers: Object.fromEntries(Object.entries(r.headers).filter(([, v]) => typeof v === 'string').map(([k, v]) => [k, v])) } : {}), ...(typeof r.requestBodyMatch === 'object' && r.requestBodyMatch && !Array.isArray(r.requestBodyMatch) && Object.keys(r.requestBodyMatch).length > 0 ? { requestBodyMatch: Object.fromEntries(Object.entries(r.requestBodyMatch).filter(([, v]) => typeof v === 'string').map(([k, v]) => [k, v])) } : {}) });
-    }
-    const description = typeof o.description === 'string' && o.description.trim() ? o.description.trim().slice(0, 500) : undefined;
-    return { ok: true, value: { ...(urlPattern ? { urlPattern } : {}), ...(urlRegex ? { urlRegex } : {}), ...(queryParams && Object.keys(queryParams).length > 0 ? { queryParams } : {}), ...(method ? { method: method } : {}), responses, ...(description ? { description } : {}) } };
-}
-function parseNetworkMocks(raw) {
-    if (raw === undefined || raw === null)
-        return { ok: true, value: [] };
-    if (!Array.isArray(raw))
-        return { ok: false, message: 'visualFlow.networkMocks 须为数组' };
-    if (raw.length > 50)
-        return { ok: false, message: 'mock 规则数量超过上限 50' };
-    const out = [];
-    for (let i = 0; i < raw.length; i++) {
-        const path = `networkMocks[${i}]`;
-        const item = raw[i];
-        if (!item || typeof item !== 'object' || Array.isArray(item)) {
-            return { ok: false, message: `${path} 须为对象` };
-        }
-        const o = item;
-        const urlPattern = typeof o.urlPattern === 'string' && o.urlPattern.trim() ? o.urlPattern.trim() : "";
-        const urlRegex = typeof o.urlRegex === 'string' && o.urlRegex.trim() ? o.urlRegex.trim() : "";
-        if (!urlPattern && !urlRegex)
-            return { ok: false, message: `${path}.urlPattern 或 urlRegex 必填其一` };
-        if (urlPattern && urlPattern.length > 1000)
-            return { ok: false, message: `${path}.urlPattern 过长` };
-        if (urlRegex) {
-            try {
-                new RegExp(urlRegex);
-            }
-            catch {
-                return { ok: false, message: `${path}.urlRegex 不是有效的正则表达式` };
-            }
-        }
-        const queryParams = o.queryParams != null && typeof o.queryParams === 'object' && !Array.isArray(o.queryParams)
-            ? Object.fromEntries(Object.entries(o.queryParams).filter(([, v]) => typeof v === "string").map(([k, v]) => [k, v]))
-            : undefined;
-        const method = typeof o.method === 'string' ? o.method.trim().toUpperCase() : '';
-        if (method && !['GET', 'POST', 'PUT', 'DELETE', 'PATCH'].includes(method)) {
-            return { ok: false, message: `${path}.method 须为 GET|POST|PUT|DELETE|PATCH` };
-        }
-        if (!Array.isArray(o.responses) || o.responses.length === 0) {
-            return { ok: false, message: `${path}.responses 须为非空数组` };
-        }
-        if (o.responses.length > 50) {
-            return { ok: false, message: `${path}.responses 数量超过上限 50` };
-        }
-        const responses = [];
-        for (let j = 0; j < o.responses.length; j++) {
-            const rPath = `${path}.responses[${j}]`;
-            const rItem = o.responses[j];
-            if (!rItem || typeof rItem !== 'object' || Array.isArray(rItem)) {
-                return { ok: false, message: `${rPath} 须为对象` };
-            }
-            const r = rItem;
-            if (r.body == null)
-                return { ok: false, message: `${rPath}.body 必填` };
-            const body = String(r.body);
-            if (body.length > 1_000_000)
-                return { ok: false, message: `${rPath}.body 过长（上限 1MB）` };
-            const status = r.status != null ? Number(r.status) : 200;
-            if (!Number.isFinite(status) || status < 100 || status > 599) {
-                return { ok: false, message: `${rPath}.status 须为 100～599` };
-            }
-            const callIndex = r.callIndex != null ? Number(r.callIndex) : undefined;
-            if (callIndex != null && (!Number.isFinite(callIndex) || callIndex < 1)) {
-                return { ok: false, message: `${rPath}.callIndex 须为正整数` };
-            }
-            const delay = r.delay != null ? Number(r.delay) : undefined;
-            if (delay != null && (!Number.isFinite(delay) || delay < 0 || delay > 60_000)) {
-                return { ok: false, message: `${rPath}.delay 须为 0～60000` };
-            }
-            const headers = r.headers != null && typeof r.headers === 'object' && !Array.isArray(r.headers)
-                ? Object.fromEntries(Object.entries(r.headers)
-                    .filter(([, v]) => typeof v === 'string')
-                    .map(([k, v]) => [k, v]))
-                : undefined;
-            const requestBodyMatch = r.requestBodyMatch != null && typeof r.requestBodyMatch === 'object' && !Array.isArray(r.requestBodyMatch)
-                ? Object.fromEntries(Object.entries(r.requestBodyMatch)
-                    .filter(([, v]) => typeof v === 'string')
-                    .map(([k, v]) => [k, v]))
-                : undefined;
-            responses.push({
-                status: Math.floor(status),
-                body,
-                ...(callIndex != null ? { callIndex: Math.floor(callIndex) } : {}),
-                ...(delay != null ? { delay: Math.floor(delay) } : {}),
-                ...(headers && Object.keys(headers).length > 0 ? { headers } : {}),
-                ...(requestBodyMatch && Object.keys(requestBodyMatch).length > 0 ? { requestBodyMatch } : {}),
-            });
-        }
-        const description = typeof o.description === 'string' && o.description.trim()
-            ? o.description.trim().slice(0, 500)
-            : undefined;
-        out.push({
-            ...(urlPattern ? { urlPattern } : {}),
-            ...(urlRegex ? { urlRegex } : {}),
-            ...(queryParams && Object.keys(queryParams).length > 0 ? { queryParams } : {}),
-            ...(method ? { method: method } : {}),
-            responses,
-            ...(description ? { description } : {}),
-        });
-    }
-    return { ok: true, value: out };
-}
 function isNonEmptyString(v) {
     return typeof v === 'string' && v.trim().length > 0;
 }
@@ -471,23 +321,6 @@ function parseStep(raw, path) {
                 },
             };
         }
-        case 'setMock': {
-            if (!o.rule || typeof o.rule !== 'object' || Array.isArray(o.rule)) {
-                return { ok: false, message: `${path}.rule 须为 NetworkMockRule 对象` };
-            }
-            const mockParsed = parseSingleMockRule(o.rule, `${path}.rule`);
-            if (!mockParsed.ok)
-                return mockParsed;
-            return { ok: true, step: { type: 'setMock', rule: mockParsed.value } };
-        }
-        case 'removeMock': {
-            if (!isNonEmptyString(o.urlPattern))
-                return { ok: false, message: `${path}.urlPattern 必填` };
-            return { ok: true, step: { type: 'removeMock', urlPattern: o.urlPattern.trim() } };
-        }
-        case 'clearMocks': {
-            return { ok: true, step: { type: 'clearMocks' } };
-        }
         case 'callScript': {
             if (!isNonEmptyString(o.targetTestCaseId)) {
                 return { ok: false, message: `${path}.targetTestCaseId 必填` };
@@ -758,9 +591,6 @@ export function tryParseVisualFlow(raw) {
     const scriptVarsParsed = parseScriptVars(o.scriptVars);
     if (!scriptVarsParsed.ok)
         return scriptVarsParsed;
-    const networkMocksParsed = parseNetworkMocks(o.networkMocks);
-    if (!networkMocksParsed.ok)
-        return networkMocksParsed;
     const steps = [];
     for (let i = 0; i < o.steps.length; i++) {
         const r = parseStep(o.steps[i], `steps[${i}]`);
@@ -782,7 +612,6 @@ export function tryParseVisualFlow(raw) {
             version: VISUAL_FLOW_VERSION,
             ...(scriptVarsParsed.value.length ? { scriptVars: scriptVarsParsed.value } : {}),
             steps,
-            ...(networkMocksParsed.value.length ? { networkMocks: networkMocksParsed.value } : {}),
         },
     };
 }