preflite 1.1.4 → 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

@@ -131,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() {
@@ -168,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>/\`.
 

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 } : {}),
         },
     };
 }

package/docs/visual-flow-ir-llm.md

@@ -11,7 +11,6 @@
 | ------------ | --- | ------------------------------------ |
 | `version`    | 是   | 固定为数字 `2`，其它值保存失败。                   |
 | `scriptVars` | 否   | 执行前由人填的变量声明数组；步骤文案里用 `{{变量名}}` 引用。   |
-| `networkMocks` | 否   | 网络 mock 规则数组，在测试开始前启动代理并配置到设备。每条规则描述一个 API 的 URL 匹配与 mock 响应序列。 |
 | `steps`      | 是   | 顶层步骤数组，按顺序执行；**展开后总条数 ≤ 500**（含子步骤）。 |
 
 
@@ -26,70 +25,6 @@
 | `scope`        | 否   | `global`、`local` 或 `temp`；缺省按平台约定。 |
 
 
-### 1.2 `networkMocks[]` 每项
-
-| 字段           | 必填  | 说明                                   |
-| -------------- | --- | -------------------------------------- |
-| `urlPattern`   | 是   | 请求 URL 的子串匹配（`includes` 语义）。首个匹配的规则生效。 |
-| `method`       | 否   | HTTP 方法：`GET`、`POST`、`PUT`、`DELETE` 或 `PATCH`。不填则匹配任意方法。 |
-| `responses`    | 是   | 非空响应序列数组，按顺序匹配第一项满足条件的响应。 |
-| `description`  | 否   | 给人看的说明。 |
-
-#### `responses[]` 每项
-
-| 字段               | 必填  | 说明                                   |
-| ------------------ | --- | -------------------------------------- |
-| `body`             | 是   | 响应体字符串（通常为 JSON）。上限 1MB。 |
-| `status`           | 否   | HTTP 状态码，默认 200。范围 100～599。 |
-| `callIndex`        | 否   | 仅第 n 次调用时匹配（1-based）。用于实现状态性 mock：首次返回错误，二次返回成功。 |
-| `requestBodyMatch` | 否   | 键值对映射，必须在请求体的 JSON 中存在且值匹配才会命中。 |
-| `headers`          | 否   | 额外的响应头。Content-Type 默认为 `application/json; charset=utf-8`。 |
-| `delay`            | 否   | 响应延迟毫秒数。范围 0～60000。 |
-
-#### 匹配规则
-
-1. 遍历 `networkMocks`，找到第一条 `urlPattern` 是请求 URL 子串的规则。
-2. 递增该规则的调用计数器。
-3. 按顺序遍历 `responses`，找到第一项满足 `callIndex` 和 `requestBodyMatch` 的响应并返回。
-4. 若无匹配响应或请求不匹配任何规则，透明转发到真实服务器。
-
-#### 示例
-
-```json
-{
-  "networkMocks": [
-    {
-      "urlPattern": "getMafangRosterNewFlowSwitch",
-      "description": "启用码放新流程",
-      "responses": [
-        {
-          "status": 200,
-          "body": "{\"code\":200,\"data\":{\"newFlowEnabled\":true},\"subcode\":200}"
-        }
-      ]
-    },
-    {
-      "urlPattern": "copyWorkScheduleGroup",
-      "method": "POST",
-      "description": "日复制先弹确认再成功",
-      "responses": [
-        {
-          "callIndex": 1,
-          "status": 200,
-          "body": "{\"code\":\"WORK_SCHEDULE_PARTITION_MAFANG_COPY_SKIP_CONFIRM\",\"data\":{\"blockedCount\":2}}"
-        },
-        {
-          "callIndex": 2,
-          "requestBodyMatch": {"mafangSkipConfirmed": "true"},
-          "status": 200,
-          "body": "{\"code\":200,\"data\":{\"flag\":true}}"
-        }
-      ]
-    }
-  ]
-}
-```
-
 ---
 
 ## 2. 步骤类型与设计原则
@@ -166,9 +101,6 @@
 ## 4. 易错校验（生成后自查）
 
 - `version !== 2` → 失败。
-- `networkMocks` 超过 50 条规则或单条规则的 `responses` 超过 50 项 → 失败。
-- `networkMocks[].urlPattern` 为空或过长（>1000）→ 失败。
-- `networkMocks[].responses` 为空数组 → 失败。
 - `if` / `ifDeviceType` 的 `thenSteps` 为空，或 `whileLoop` / `forLoop` 的 `bodySteps` 为空 → 失败。
 - `sleep.ms`、`whileLoop.maxIterations`、`forLoop.count` 超出上表范围 → 失败。
 - `callScript.targetTestCaseId` 非 24 位 hex，或 `scopeId` 不符合 `sub`+12hex → 失败。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "preflite",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "Preflight — Local mobile AI testing via MCP. AI-assisted testing on real Android/iOS/Harmony devices.",
   "license": "Apache-2.0",
   "type": "module",