preflite 1.1.1 → 1.1.4

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 = {};
@@ -129,8 +133,8 @@ alwaysApply: false
 7. 调用 \`validate_visual_flow\`。如果校验失败，按 message 修正 visualFlow 后再次校验。
 8. 生成最小测试用例：先覆盖改动点，再补必要回归。
 9. 如用户给了 app 包，先调用 \`install_app\`。
-10. 调用 \`run_flow\`，把返回的 liveUrl 明确给用户，让用户可以打开浏览器看实时执行。
-11. 执行中调用 \`watch_run\` 观察状态。失败时先判断是环境/设备、IR 用例步骤、agent runtime 还是真实业务问题。
+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 结论。
 `;
@@ -165,8 +169,8 @@ Workflow:
 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\` and show the returned liveUrl.
-10. Poll with \`watch_run\`.
+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\`.
 
@@ -187,3 +191,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/types.js

@@ -2,4 +2,4 @@
  * 可视化编排 IR（与 Midscene 业务脚本双写：存库 + 生成 `scriptContent`）。
  * 版本字段便于后续迁移；步骤与 {@link generateScriptFromVisualFlow} 对齐。
  */
-export const VISUAL_FLOW_VERSION = 1;
+export const VISUAL_FLOW_VERSION = 2;

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

@@ -61,6 +61,156 @@ 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;
 }
@@ -321,6 +471,23 @@ 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 必填` };
@@ -591,6 +758,9 @@ 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}]`);
@@ -612,6 +782,7 @@ 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

@@ -9,8 +9,9 @@
 
 | 字段           | 必填  | 说明                                   |
 | ------------ | --- | ------------------------------------ |
-| `version`    | 是   | 固定为数字 `1`，其它值保存失败。                   |
+| `version`    | 是   | 固定为数字 `2`，其它值保存失败。                   |
 | `scriptVars` | 否   | 执行前由人填的变量声明数组；步骤文案里用 `{{变量名}}` 引用。   |
+| `networkMocks` | 否   | 网络 mock 规则数组，在测试开始前启动代理并配置到设备。每条规则描述一个 API 的 URL 匹配与 mock 响应序列。 |
 | `steps`      | 是   | 顶层步骤数组，按顺序执行；**展开后总条数 ≤ 500**（含子步骤）。 |
 
 
@@ -25,6 +26,70 @@
 | `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. 步骤类型与设计原则
@@ -100,7 +165,10 @@
 
 ## 4. 易错校验（生成后自查）
 
-- `version !== 1` → 失败。
+- `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.1",
+  "version": "1.1.4",
   "description": "Preflight — Local mobile AI testing via MCP. AI-assisted testing on real Android/iOS/Harmony devices.",
   "license": "Apache-2.0",
   "type": "module",