csspilot 0.6.0 → 0.7.1

package/dist/index.js

@@ -8102,7 +8102,7 @@ var require_composer = __commonJS({
     var node_process = __require("process");
     var directives = require_directives();
     var Document = require_Document();
-    var errors = require_errors();
+    var errors2 = require_errors();
     var identity = require_identity();
     var composeDoc = require_compose_doc();
     var resolveEnd = require_resolve_end();
@@ -8149,9 +8149,9 @@ var require_composer = __commonJS({
         this.onError = (source, code, message, warning) => {
           const pos = getErrorPos(source);
           if (warning)
-            this.warnings.push(new errors.YAMLWarning(pos, code, message));
+            this.warnings.push(new errors2.YAMLWarning(pos, code, message));
           else
-            this.errors.push(new errors.YAMLParseError(pos, code, message));
+            this.errors.push(new errors2.YAMLParseError(pos, code, message));
         };
         this.directives = new directives.Directives({ version: options.version || "1.2" });
         this.options = options;
@@ -8249,7 +8249,7 @@ ${cb}` : comment;
             break;
           case "error": {
             const msg = token.source ? `${token.message}: ${JSON.stringify(token.source)}` : token.message;
-            const error62 = new errors.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
+            const error62 = new errors2.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
             if (this.atDirectives || !this.doc)
               this.errors.push(error62);
             else
@@ -8259,7 +8259,7 @@ ${cb}` : comment;
           case "doc-end": {
             if (!this.doc) {
               const msg = "Unexpected doc-end without preceding document";
-              this.errors.push(new errors.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
+              this.errors.push(new errors2.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
               break;
             }
             this.doc.directives.docEnd = true;
@@ -8274,7 +8274,7 @@ ${end.comment}` : end.comment;
             break;
           }
           default:
-            this.errors.push(new errors.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
+            this.errors.push(new errors2.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
         }
       }
       /**
@@ -8309,7 +8309,7 @@ var require_cst_scalar = __commonJS({
     "use strict";
     var resolveBlockScalar = require_resolve_block_scalar();
     var resolveFlowScalar = require_resolve_flow_scalar();
-    var errors = require_errors();
+    var errors2 = require_errors();
     var stringifyString = require_stringifyString();
     function resolveAsScalar(token, strict = true, onError) {
       if (token) {
@@ -8318,7 +8318,7 @@ var require_cst_scalar = __commonJS({
           if (onError)
             onError(offset, code, message);
           else
-            throw new errors.YAMLParseError([offset, offset + 1], code, message);
+            throw new errors2.YAMLParseError([offset, offset + 1], code, message);
         };
         switch (token.type) {
           case "scalar":
@@ -10213,7 +10213,7 @@ var require_public_api = __commonJS({
     "use strict";
     var composer = require_composer();
     var Document = require_Document();
-    var errors = require_errors();
+    var errors2 = require_errors();
     var log = require_log();
     var identity = require_identity();
     var lineCounter = require_line_counter();
@@ -10230,8 +10230,8 @@ var require_public_api = __commonJS({
       const docs = Array.from(composer$1.compose(parser$1.parse(source)));
       if (prettyErrors && lineCounter2)
         for (const doc of docs) {
-          doc.errors.forEach(errors.prettifyError(source, lineCounter2));
-          doc.warnings.forEach(errors.prettifyError(source, lineCounter2));
+          doc.errors.forEach(errors2.prettifyError(source, lineCounter2));
+          doc.warnings.forEach(errors2.prettifyError(source, lineCounter2));
         }
       if (docs.length > 0)
         return docs;
@@ -10246,13 +10246,13 @@ var require_public_api = __commonJS({
         if (!doc)
           doc = _doc;
         else if (doc.options.logLevel !== "silent") {
-          doc.errors.push(new errors.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
+          doc.errors.push(new errors2.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
           break;
         }
       }
       if (prettyErrors && lineCounter2) {
-        doc.errors.forEach(errors.prettifyError(source, lineCounter2));
-        doc.warnings.forEach(errors.prettifyError(source, lineCounter2));
+        doc.errors.forEach(errors2.prettifyError(source, lineCounter2));
+        doc.warnings.forEach(errors2.prettifyError(source, lineCounter2));
       }
       return doc;
     }
@@ -10311,7 +10311,7 @@ var require_dist = __commonJS({
     var composer = require_composer();
     var Document = require_Document();
     var Schema = require_Schema();
-    var errors = require_errors();
+    var errors2 = require_errors();
     var Alias = require_Alias();
     var identity = require_identity();
     var Pair = require_Pair();
@@ -10327,9 +10327,9 @@ var require_dist = __commonJS({
     exports.Composer = composer.Composer;
     exports.Document = Document.Document;
     exports.Schema = Schema.Schema;
-    exports.YAMLError = errors.YAMLError;
-    exports.YAMLParseError = errors.YAMLParseError;
-    exports.YAMLWarning = errors.YAMLWarning;
+    exports.YAMLError = errors2.YAMLError;
+    exports.YAMLParseError = errors2.YAMLParseError;
+    exports.YAMLWarning = errors2.YAMLWarning;
     exports.Alias = Alias.Alias;
     exports.isAlias = identity.isAlias;
     exports.isCollection = identity.isCollection;
@@ -10462,6 +10462,28 @@ var TestPilotError = class extends Error {
   }
 };
 
+// ../../packages/core/src/verdict.ts
+var INFRA_CODES = /* @__PURE__ */ new Set([
+  "ENVIRONMENT_UNAVAILABLE",
+  "ADAPTER_NOT_FOUND",
+  "UNSUPPORTED_ACTION",
+  "FIXTURE_MISSING",
+  "ACCOUNT_UNAVAILABLE",
+  "CONFIG_MISSING"
+]);
+var UNVERIFIED_CODES = /* @__PURE__ */ new Set(["PREREQ_VARIABLE_MISSING"]);
+function verdictFromErrorCode(code) {
+  if (code !== void 0 && INFRA_CODES.has(code)) return "infra";
+  if (code !== void 0 && UNVERIFIED_CODES.has(code)) return "unverified";
+  return "product";
+}
+function caseStatusFromErrorCode(code) {
+  const verdict = verdictFromErrorCode(code);
+  if (verdict === "infra") return "blocked";
+  if (verdict === "unverified") return "inconclusive";
+  return "failed";
+}
+
 // ../../packages/core/src/constants/index.ts
 import { join as join2 } from "node:path";
 var TESTPILOT_DIR = ".testpilot";
@@ -30365,7 +30387,11 @@ var ACTIONS = [
   "assert",
   "extract",
   "screenshot",
-  "request"
+  "request",
+  "callMethod",
+  "mockWxApi",
+  "trigger",
+  "setData"
 ];
 var locatorSchema = external_exports.strictObject({
   text: external_exports.string().min(1).optional(),
@@ -30393,7 +30419,25 @@ var stepSchema = external_exports.strictObject({
   variable: external_exports.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/, "\u53D8\u91CF\u540D\u9700\u4EE5\u5B57\u6BCD\u6216\u4E0B\u5212\u7EBF\u5F00\u5934,\u4EC5\u542B\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u4E0B\u5212\u7EBF").optional(),
   timeout: external_exports.number().int().positive().optional(),
   /** UI 动作触发的网络请求精确次数断言 */
-  expectRequests: external_exports.array(requestExpectationSchema).min(1).optional()
+  expectRequests: external_exports.array(requestExpectationSchema).min(1).optional(),
+  /** callMethod:要调用的 Page / 组件方法名(仅 miniapp;页面级调用不写 locator) */
+  methodName: external_exports.string().min(1).optional(),
+  /** callMethod 的入参(支持 ${var} 模板) */
+  args: external_exports.array(external_exports.unknown()).optional(),
+  /** mockWxApi:要 mock 的 wx.* API 名(如 showModal / request) */
+  wxApi: external_exports.string().min(1).optional(),
+  /** mockWxApi:mock 返回值(对象按原样注入;capture 时真实调用先上报再返回 mock 值) */
+  result: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  /** mockWxApi:捕获真实调用参数的变量名(${<capture>.options} / ${<capture>.called}) */
+  capture: external_exports.string().min(1).optional(),
+  /** trigger:触发的事件类型(如 getphonenumber;空 detail 即"用户拒绝/取消"类分支) */
+  eventType: external_exports.string().min(1).optional(),
+  /** trigger:作为事件 e.detail 注入(值支持 ${var} 模板) */
+  detail: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  /** setData:写入页面 data 的补丁(值支持 ${var} 模板) */
+  patch: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  /** assert:页面 data 路径断言(与 locator 互斥,仅 miniapp) */
+  dataPath: external_exports.string().min(1).optional()
 });
 var datasetReferenceSchema = external_exports.strictObject({
   file: external_exports.string().min(1),
@@ -30466,7 +30510,11 @@ var ADAPTER_SUPPORT = {
   assert: ["web", "miniapp", "api"],
   extract: ["web", "miniapp", "api"],
   screenshot: ["web", "miniapp"],
-  request: ["api"]
+  request: ["api"],
+  callMethod: ["miniapp"],
+  mockWxApi: ["miniapp"],
+  trigger: ["miniapp"],
+  setData: ["miniapp"]
 };
 var LOCATOR_REQUIRED = /* @__PURE__ */ new Set(["click", "input", "select", "assert", "extract"]);
 var VALUE_REQUIRED = /* @__PURE__ */ new Set(["input", "select"]);
@@ -30479,7 +30527,16 @@ var FIELD_ALLOWED = {
   timeout: ["wait"],
   method: ["request"],
   headers: ["request"],
-  body: ["request"]
+  body: ["request"],
+  methodName: ["callMethod"],
+  args: ["callMethod"],
+  wxApi: ["mockWxApi"],
+  result: ["mockWxApi"],
+  capture: ["mockWxApi"],
+  eventType: ["trigger"],
+  detail: ["trigger"],
+  patch: ["setData"],
+  dataPath: ["assert"]
 };
 var VARIABLE_REF = /\$\{([A-Za-z_][A-Za-z0-9_.]*)\}/g;
 function validateCase(data) {
@@ -30543,6 +30600,23 @@ function checkStep(step, at, declared, issues) {
       });
     }
   }
+  if (step.action === "mockWxApi") {
+    if (!step.wxApi) {
+      issues.push({ path: `${at}.wxApi`, code: "semantic", message: "mockWxApi \u5FC5\u987B\u63D0\u4F9B wxApi(\u8981 mock \u7684 wx.* API \u540D)" });
+    }
+    if (!step.result) {
+      issues.push({ path: `${at}.result`, code: "semantic", message: "mockWxApi \u5FC5\u987B\u63D0\u4F9B result(mock \u8FD4\u56DE\u503C)" });
+    }
+  }
+  if (step.action === "trigger" && !step.eventType) {
+    issues.push({ path: `${at}.eventType`, code: "semantic", message: "trigger \u5FC5\u987B\u63D0\u4F9B eventType(\u89E6\u53D1\u7684\u4E8B\u4EF6\u7C7B\u578B)" });
+  }
+  if (step.action === "setData" && (!step.patch || Object.keys(step.patch).length === 0)) {
+    issues.push({ path: `${at}.patch`, code: "semantic", message: "setData \u5FC5\u987B\u63D0\u4F9B patch(\u5199\u5165\u9875\u9762 data \u7684\u8865\u4E01)" });
+  }
+  if (step.dataPath !== void 0 && step.target !== "miniapp") {
+    issues.push({ path: `${at}.dataPath`, code: "semantic", message: "dataPath \u65AD\u8A00\u4EC5 miniapp \u652F\u6301(web \u7AEF\u7528 locator)" });
+  }
   if (step.action === "navigate" && !step.url) {
     issues.push({ path: `${at}.url`, code: "semantic", message: "navigate \u5FC5\u987B\u63D0\u4F9B url" });
   }
@@ -30574,6 +30648,13 @@ function checkStep(step, at, declared, issues) {
   if (step.action === "wait" && !step.locator && step.timeout === void 0) {
     issues.push({ path: at, code: "semantic", message: "wait \u9700\u8981\u63D0\u4F9B locator(\u7B49\u5F85\u5143\u7D20)\u6216 timeout(\u6BEB\u79D2)" });
   }
+  if (step.action === "callMethod" && !step.methodName) {
+    issues.push({
+      path: `${at}.methodName`,
+      code: "semantic",
+      message: "callMethod \u5FC5\u987B\u63D0\u4F9B methodName(\u9875\u9762\u6216\u7EC4\u4EF6\u7684\u65B9\u6CD5\u540D)"
+    });
+  }
   if (step.expectRequests) {
     if (step.target === "api" || !REQUEST_EXPECTATION_ACTIONS.has(step.action)) {
       issues.push({
@@ -30615,11 +30696,17 @@ function checkVariableRefs(step, at, declared, issues) {
   collect("value", step.value);
   collect("expected", step.expected);
   collect("url", step.url);
+  collect("methodName", step.methodName);
   collect("locator.text", step.locator?.text);
   collect("locator.css", step.locator?.css);
   if (typeof step.body === "string") collect("body", step.body);
   else if (step.body) collect("body", JSON.stringify(step.body));
   for (const headerValue of Object.values(step.headers ?? {})) collect("headers", headerValue);
+  if (Array.isArray(step.args)) {
+    step.args.forEach((arg, index) => {
+      if (typeof arg === "string") collect(`args[${index}]`, arg);
+    });
+  }
   for (const [index, expectation] of (step.expectRequests ?? []).entries()) {
     collect(`expectRequests[${index}].urlContains`, expectation.urlContains);
   }
@@ -30716,6 +30803,9 @@ async function loadCaseDataFile(reference, options) {
   const [realDataDir, realTarget] = await Promise.all([
     realpath(dataDir).catch(() => dataDir),
     realpath(target).catch((error62) => {
+      if (error62 instanceof Error && error62.code === "ENOENT") {
+        throw new TestPilotError("FIXTURE_MISSING", `\u6570\u636E\u6587\u4EF6\u4E0D\u5B58\u5728:${reference}`);
+      }
       throw new Error(
         `\u8BFB\u53D6\u6570\u636E\u6587\u4EF6\u5931\u8D25:${reference}:${error62 instanceof Error ? error62.message : String(error62)}`
       );
@@ -30943,6 +31033,9 @@ async function validateCaseDataSource(source, file2, root) {
     );
     return validation;
   } catch (error62) {
+    if (error62 instanceof TestPilotError && error62.code === "FIXTURE_MISSING") {
+      return validation;
+    }
     return {
       ok: false,
       data: validation.data,
@@ -30991,6 +31084,24 @@ function classifyFailure(message) {
   }
   return "other";
 }
+var CODE_CATEGORIES = {
+  ASSERTION_FAILED: "assert",
+  REQUEST_COUNT_MISMATCH: "assert",
+  STATUS_MISMATCH: "assert",
+  STEP_TIMEOUT: "assert",
+  ELEMENT_NOT_FOUND: "element",
+  ADAPTER_NOT_FOUND: "adapter",
+  UNSUPPORTED_ACTION: "adapter",
+  CONFIG_MISSING: "adapter",
+  ENVIRONMENT_UNAVAILABLE: "env",
+  FIXTURE_MISSING: "env",
+  ACCOUNT_UNAVAILABLE: "env",
+  PREREQ_VARIABLE_MISSING: "other"
+};
+function classifyFromCode(code) {
+  if (code === void 0) return void 0;
+  return CODE_CATEGORIES[code];
+}
 
 // ../../packages/reporter/src/history.ts
 import { readFile as readFile5, readdir as readdir2 } from "node:fs/promises";
@@ -31048,7 +31159,7 @@ async function writeReports(runDir, summary, options = {}) {
   const cases = summary.cases.map((item) => {
     const categories = /* @__PURE__ */ new Set();
     const steps = item.steps.map((step) => {
-      const category = step.status === "failed" ? classifyFailure(step.error) : void 0;
+      const category = classifyFromCode(step.errorCode) ?? (step.status === "failed" ? classifyFailure(step.error) : void 0);
       if (category) {
         categories.add(category);
         failures.push({
@@ -31056,7 +31167,8 @@ async function writeReports(runDir, summary, options = {}) {
           label: categoryLabel(category),
           caseId: item.caseId,
           index: step.index,
-          message: step.error ?? ""
+          message: step.error ?? "",
+          verdict: verdictFromErrorCode(step.errorCode ?? item.errorCode)
         });
       }
       return { ...step, category };
@@ -31079,6 +31191,20 @@ async function writeReports(runDir, summary, options = {}) {
   await writeFile4(htmlPath, renderHtml(data), "utf8");
   return { json: jsonPath, html: htmlPath };
 }
+var VERDICT_GROUPS = [
+  { verdict: "product", title: "\u4EA7\u54C1\u5931\u8D25" },
+  { verdict: "infra", title: "\u73AF\u5883\u4E0E\u524D\u7F6E(\u975E\u4EA7\u54C1\u56DE\u5F52)" },
+  { verdict: "unverified", title: "\u672A\u9A8C\u8BC1" }
+];
+function verdictGroupsHtml(data) {
+  return VERDICT_GROUPS.map((group) => {
+    const items = data.failures.filter((failure2) => failure2.verdict === group.verdict);
+    const list = items.length > 0 ? items.map(
+      (failure2) => `<li><code>${escapeHtml(failure2.caseId)}</code> #${failure2.index} ${escapeHtml(failure2.message.slice(0, 160))}</li>`
+    ).join("\n") : '<li class="muted">\u65E0</li>';
+    return `<div class="verdict-group"><h3>${escapeHtml(group.title)}(${items.length})</h3><ul>${list}</ul></div>`;
+  }).join("\n");
+}
 function categoryChips(data) {
   const counts = /* @__PURE__ */ new Map();
   for (const failure2 of data.failures) {
@@ -31104,19 +31230,20 @@ function renderHtml(data) {
   const trendSvg = renderTrend(data);
   const casesHtml = groupedCasesHtml(summary.cases);
   const chips = categoryChips(data);
+  const verdictHtml = verdictGroupsHtml(data);
   return `<!doctype html>
 <html lang="zh-CN">
 <head>
 <meta charset="utf-8" />
 <title>TestPilot Report ${escapeHtml(summary.runId)}</title>
 <style>
-  :root { --ok:#1a7f37; --fail:#cf222e; --warn:#9a6700; --skip:#6e7781; --line:#d0d7de; --muted:#59636e; }
+  :root { --ok:#1a7f37; --fail:#cf222e; --warn:#9a6700; --skip:#6e7781; --blocked:#8250df; --inconclusive:#9a6700; --line:#d0d7de; --muted:#59636e; }
   * { box-sizing: border-box; }
   body { font-family: system-ui, "Segoe UI", sans-serif; margin: 0; color: #1f2328; background: #f6f8fa; }
   .wrap { max-width: 1080px; margin: 0 auto; padding: 20px 16px 48px; }
   h1 { font-size: 20px; margin: 8px 0; } h2 { font-size: 15px; margin: 24px 0 8px; }
   .badge { display: inline-block; padding: 2px 10px; border-radius: 10px; color: #fff; font-size: 12px; }
-  .passed { background: var(--ok); } .failed { background: var(--fail); } .warning { background: var(--warn); } .skipped { background: var(--skip); }
+  .passed { background: var(--ok); } .failed { background: var(--fail); } .warning { background: var(--warn); } .skipped { background: var(--skip); } .blocked { background: var(--blocked); } .inconclusive { background: var(--inconclusive); }
   code { background: #eef1f4; padding: 1px 5px; border-radius: 4px; font-size: 12px; }
   .cards { display: flex; gap: 12px; flex-wrap: wrap; margin: 14px 0; }
   .card { background: #fff; border: 1px solid var(--line); border-radius: 8px; padding: 10px 16px; min-width: 130px; }
@@ -31143,6 +31270,11 @@ function renderHtml(data) {
   .muted { color: var(--muted); }
   .hide { display: none !important; }
   .meta { color: var(--muted); font-size: 12px; margin: 6px 0; }
+  .verdicts { display: flex; gap: 14px; flex-wrap: wrap; }
+  .verdict-group { background: #fff; border: 1px solid var(--line); border-radius: 8px; padding: 10px 14px; flex: 1; min-width: 220px; }
+  .verdict-group h3 { font-size: 13px; margin: 0 0 6px; }
+  .verdict-group ul { margin: 0; padding-left: 18px; font-size: 12px; }
+  .verdict-group li { margin: 3px 0; }
 </style>
 </head>
 <body>
@@ -31163,6 +31295,9 @@ function renderHtml(data) {
   <h2>\u5386\u53F2\u8D8B\u52BF(\u6700\u8FD1 ${data.history.length + 1} \u6B21\u8FD0\u884C)</h2>
   <div class="trend">${trendSvg}</div>
 
+  <h2>\u5931\u8D25\u4E09\u6876</h2>
+  <div class="verdicts">${verdictHtml}</div>
+
   <h2>\u5931\u8D25\u5206\u7C7B</h2>
   <div class="toolbar" id="cat-chips">${chips}</div>
 
@@ -31371,7 +31506,7 @@ function buildSummaryData(runs) {
     for (const item of summary.cases) {
       const platforms = [...new Set(item.steps.map((step) => step.target))];
       const failedStep = item.steps.find((step) => step.status === "failed");
-      const category = item.status === "failed" ? classifyFailure(failedStep?.error) : void 0;
+      const category = classifyFromCode(item.errorCode ?? failedStep?.errorCode) ?? (item.status === "failed" ? classifyFailure(failedStep?.error) : void 0);
       executions.push({
         runId,
         caseId: item.caseId,
@@ -31434,6 +31569,10 @@ function buildSummaryData(runs) {
   })).filter((item) => item.count > 0);
   const durations = runs.map((item) => item.summary.durationMs).filter((value) => typeof value === "number");
   return {
+    buckets: {
+      blocked: executions.filter((exec2) => exec2.status === "blocked").length,
+      inconclusive: executions.filter((exec2) => exec2.status === "inconclusive").length
+    },
     window: {
       runs: runs.length,
       from: runPoints[0]?.startedAt,
@@ -31518,7 +31657,7 @@ function renderSummaryHtml(data) {
   th.num, td.num { text-align: right; }
   code { background: #eef1f4; padding: 1px 5px; border-radius: 4px; font-size: 12px; cursor: pointer; }
   .badge { display: inline-block; padding: 1px 9px; border-radius: 10px; color: #fff; font-size: 11px; }
-  .passed { background: #1a7f37; } .failed { background: #cf222e; } .unknown { background: #6e7781; }
+  .passed { background: #1a7f37; } .failed { background: #cf222e; } .unknown { background: #6e7781; } .blocked { background: #8250df; } .inconclusive { background: #9a6700; }
   .toolbar { display: flex; gap: 8px; flex-wrap: wrap; align-items: center; margin: 10px 0; }
   .chip { border: 1px solid var(--line); background: #fff; border-radius: 14px; padding: 3px 12px; font-size: 12px; cursor: pointer; }
   .chip.active { background: #0969da; color: #fff; border-color: #0969da; }
@@ -31544,6 +31683,8 @@ function renderSummaryHtml(data) {
     <div class="card"><b>${rateText}</b><span>\u6574\u4F53\u901A\u8FC7\u7387</span></div>
     <div class="card"><b>${(kpis.avgDurationMs / 1e3).toFixed(1)}s</b><span>\u5E73\u5747\u8FD0\u884C\u8017\u65F6</span></div>
     <div class="card"><b>${kpis.flakyCount}</b><span>Flaky \u7528\u4F8B</span></div>
+    ${data.buckets.blocked > 0 ? `<div class="card"><b>${data.buckets.blocked} \u2298</b><span>\u73AF\u5883/\u524D\u7F6E\u963B\u585E(\u975E\u4EA7\u54C1)</span></div>` : ""}
+    ${data.buckets.inconclusive > 0 ? `<div class="card"><b>${data.buckets.inconclusive} ?</b><span>\u672A\u9A8C\u8BC1(\u8BC1\u636E\u4E0D\u8DB3)</span></div>` : ""}
   </div>
 
   <h2>\u8D8B\u52BF(\u6BCF\u6B21\u8FD0\u884C\u7ED3\u679C\u4E0E\u901A\u8FC7\u7387,\u60AC\u6D6E\u770B\u8BE6\u60C5)</h2>
@@ -31752,14 +31893,23 @@ var ExecutionContext = class {
     }
   }
   /**
-   * 将字符串中的 ${name} 替换为已提取的变量值;未定义的引用保持原样(校验阶段已拦截)。
-   * 名字允许点号,用于引擎注入的 account.username 一类凭据变量(用户 extract 变量名不含点号)。
+   * 将字符串中的 ${name} 替换为已提取的变量值;未定义的引用抛 TestPilotError——
+   * 校验阶段已静态拦截"从未声明"的引用,运行时未命中即数据未兑现
+   * (前置 extract 未执行或 fixture/dataset/凭据缺失),按三态归 unverified/account 桶。
+   * 凭据桶仅限 `account` 整值或 `account.*` 字段;用户变量撞 account 前缀(如 accountId)
+   * 不误归凭据桶。名字允许点号,用于引擎注入的 account.username 一类凭据变量
+   * (用户 extract 变量名不含点号)。
    */
   resolve(template) {
-    return template.replace(
-      /\$\{([A-Za-z_][A-Za-z0-9_.]*)\}/g,
-      (match, name) => this.variables.get(name) ?? match
-    );
+    return template.replace(/\$\{([A-Za-z_][A-Za-z0-9_.]*)\}/g, (_match, name) => {
+      const value = this.variables.get(name);
+      if (value !== void 0) return value;
+      const isAccount = name === "account" || name.startsWith("account.");
+      throw new TestPilotError(
+        isAccount ? "ACCOUNT_UNAVAILABLE" : "PREREQ_VARIABLE_MISSING",
+        `\u53D8\u91CF "${name}" \u672A\u5B9A\u4E49(\u524D\u7F6E extract \u672A\u6267\u884C\u6216 fixture/dataset/\u51ED\u636E\u7F3A\u5931)`
+      );
+    });
   }
   /**
    * 注入 accountRef 凭据:值为 JSON 对象时按 `${account.<字段>}` 展开为字符串,
@@ -31784,6 +31934,26 @@ var ExecutionContext = class {
     }
     this.variables.set("account", rawValue);
   }
+  /**
+   * 注入结构化对象(如 mockWxApi 的捕获结果):按点号路径展开为平铺字符串变量。
+   * 例如 seedObject('showModalCall', { called: true, args: { content: 'x' } }) 后,
+   * `${showModalCall.called}` 与 `${showModalCall.args.content}` 均可解析。
+   */
+  seedObject(name, value) {
+    const flatten = (prefix, input2) => {
+      if (input2 !== null && typeof input2 === "object" && !Array.isArray(input2)) {
+        const entries = Object.entries(input2);
+        if (entries.length === 0) {
+          this.variables.set(prefix, "");
+          return;
+        }
+        for (const [key, item] of entries) flatten(`${prefix}.${key}`, item);
+        return;
+      }
+      this.variables.set(prefix, input2 === void 0 ? "" : String(input2));
+    };
+    flatten(name, value);
+  }
 };
 
 // ../../packages/execution-engine/src/lifecycle/index.ts
@@ -31918,7 +32088,7 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
     } : void 0;
     if (step.expectRequests) {
       if (!adapter.startRequestCapture || !adapter.stopRequestCapture) {
-        throw new Error(`\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301\u8BF7\u6C42\u6B21\u6570\u65AD\u8A00`);
+        throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301\u8BF7\u6C42\u6B21\u6570\u65AD\u8A00`);
       }
       await adapter.startRequestCapture();
       captureStarted = true;
@@ -31942,14 +32112,22 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
       case "wait":
         await adapter.wait(locator, step.timeout);
         break;
-      case "assert":
+      case "assert": {
+        if (step.dataPath !== void 0) {
+          if (!adapter.assertData) {
+            throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301 dataPath \u65AD\u8A00`);
+          }
+          await adapter.assertData(context.resolve(step.dataPath), context.resolve(step.expected ?? ""));
+          break;
+        }
         if (step.target === "api") {
-          if (!adapter.assertResponse) throw new Error("\u5F53\u524D adapter \u4E0D\u652F\u6301 api \u65AD\u8A00");
+          if (!adapter.assertResponse) throw new TestPilotError("UNSUPPORTED_ACTION", "\u5F53\u524D adapter \u4E0D\u652F\u6301 api \u65AD\u8A00");
           await adapter.assertResponse(context.resolve(step.expected ?? ""));
         } else {
           await adapter.assert(locator, context.resolve(step.expected ?? ""));
         }
         break;
+      }
       case "extract": {
         const value = step.target === "api" ? await extractApiResponse(adapter, context.resolve(step.value ?? "")) : await adapter.extract(locator);
         if (step.variable) {
@@ -31964,7 +32142,7 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
         break;
       }
       case "request": {
-        if (!adapter.request) throw new Error("\u5F53\u524D adapter \u4E0D\u652F\u6301 api request");
+        if (!adapter.request) throw new TestPilotError("UNSUPPORTED_ACTION", "\u5F53\u524D adapter \u4E0D\u652F\u6301 api request");
         const method = step.method ?? "GET";
         const url2 = context.resolve(step.url ?? "");
         const headers = resolveHeaders(step.headers, context);
@@ -31981,16 +32159,53 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
         if (step.expected !== void 0) {
           const expectedStatus = context.resolve(step.expected);
           if (String(response.status) !== expectedStatus) {
-            throw new Error(
+            throw new TestPilotError(
+              "STATUS_MISMATCH",
               `HTTP \u72B6\u6001\u7801 ${response.status} ${response.statusText},\u671F\u671B ${expectedStatus}:${snippet(response.bodyText, 200)}`
             );
           }
         }
         break;
       }
+      case "callMethod": {
+        if (typeof adapter.callMethod !== "function") {
+          throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301 callMethod`);
+        }
+        const methodName = context.resolve(step.methodName ?? "");
+        if (!methodName) throw new TestPilotError("MISSING_METHOD_NAME", "callMethod \u5FC5\u987B\u63D0\u4F9B methodName");
+        const callArgs = (step.args ?? []).map((arg) => resolveDeep(arg, context));
+        await adapter.callMethod(locator, methodName, callArgs);
+        break;
+      }
+      case "mockWxApi": {
+        if (typeof adapter.mockWxApi !== "function") {
+          throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301 mockWxApi`);
+        }
+        await adapter.mockWxApi({
+          api: context.resolve(step.wxApi ?? ""),
+          result: step.result ? resolveDeep(step.result, context) : void 0,
+          capture: step.capture
+        });
+        break;
+      }
+      case "trigger": {
+        if (typeof adapter.trigger !== "function") {
+          throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301 trigger`);
+        }
+        if (!locator) throw new TestPilotError("MISSING_LOCATOR", "trigger \u5FC5\u987B\u63D0\u4F9B locator(\u8981\u89E6\u53D1\u4E8B\u4EF6\u7684\u7EC4\u4EF6)");
+        await adapter.trigger(locator, context.resolve(step.eventType ?? ""), step.detail ? resolveDeep(step.detail, context) : void 0);
+        break;
+      }
+      case "setData": {
+        if (typeof adapter.setData !== "function") {
+          throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301 setData`);
+        }
+        await adapter.setData(resolveDeep(step.patch ?? {}, context));
+        break;
+      }
       default: {
         const exhaustive = step.action;
-        throw new Error(`\u4E0D\u652F\u6301\u7684 action:${String(exhaustive)}`);
+        throw new TestPilotError("UNSUPPORTED_ACTION", `\u4E0D\u652F\u6301\u7684 action:${String(exhaustive)}`);
       }
     }
     if (step.expectRequests) {
@@ -32001,7 +32216,8 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
       result.requestAssertions = buildRequestAssertions(step, requests, context);
       const mismatches = result.requestAssertions.filter((item) => item.actualCount !== item.count);
       if (mismatches.length > 0) {
-        throw new Error(
+        throw new TestPilotError(
+          "REQUEST_COUNT_MISMATCH",
           mismatches.map(
             (item) => `\u8BF7\u6C42\u6B21\u6570\u4E0D\u5339\u914D:${item.method ?? "*"} ${item.urlContains},\u5B9E\u9645 ${item.actualCount},\u671F\u671B ${item.count}`
           ).join("; ")
@@ -32018,6 +32234,7 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
     }
     result.status = "failed";
     result.error = err instanceof Error ? err.message : String(err);
+    result.errorCode = err instanceof TestPilotError ? err.code : void 0;
     try {
       const data = await adapter.screenshot();
       result.screenshot = await artifacts.saveStepScreenshot(`${options.screenshotName}-failed.png`, data);
@@ -32028,8 +32245,8 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
   return result;
 }
 async function extractApiResponse(adapter, path) {
-  if (!adapter.extractResponse) throw new Error("\u5F53\u524D adapter \u4E0D\u652F\u6301 api \u63D0\u53D6");
-  if (!path) throw new Error("api \u7AEF extract \u9700\u8981\u63D0\u4F9B value(\u70B9\u53F7 JSON path)");
+  if (!adapter.extractResponse) throw new TestPilotError("UNSUPPORTED_ACTION", "\u5F53\u524D adapter \u4E0D\u652F\u6301 api \u63D0\u53D6");
+  if (!path) throw new TestPilotError("UNSUPPORTED_ACTION", "api \u7AEF extract \u9700\u8981\u63D0\u4F9B value(\u70B9\u53F7 JSON path)");
   return adapter.extractResponse(path);
 }
 function resolveHeaders(headers, context) {
@@ -32103,6 +32320,7 @@ var ExecutionEngine = class {
     const warnings = [];
     const evidenceAdapters = /* @__PURE__ */ new Map();
     let caseError;
+    let caseErrorCode;
     const executionId = safeArtifactName(`${data.id}-${rowId}`);
     await bus.emit({
       type: "case-started",
@@ -32173,6 +32391,12 @@ var ExecutionEngine = class {
           result = await executeStep(step, index, adapter, context, artifacts, {
             screenshotName: `${executionId}-${phase}-${String(index).padStart(2, "0")}`
           });
+          if (step.capture !== void 0 && typeof adapter.readWxApiCaptures === "function") {
+            const captures = adapter.readWxApiCaptures();
+            if (captures && captures.calls.length > 0) {
+              context.seedObject(step.capture, captures.calls[0]?.options ?? null);
+            }
+          }
         } catch (err) {
           result = {
             index,
@@ -32180,7 +32404,8 @@ var ExecutionEngine = class {
             action: step.action,
             status: "failed",
             durationMs: 0,
-            error: err instanceof Error ? err.message : String(err)
+            error: err instanceof Error ? err.message : String(err),
+            errorCode: err instanceof TestPilotError ? err.code : void 0
           };
         }
         result.phase = phase;
@@ -32209,6 +32434,7 @@ var ExecutionEngine = class {
         if (result.status === "failed") {
           passed = false;
           caseError = result.error;
+          caseErrorCode = result.errorCode;
           for (const [skipIndex, skippedStep] of phaseSteps.entries()) {
             if (skipIndex <= index) continue;
             steps.push({
@@ -32225,24 +32451,42 @@ var ExecutionEngine = class {
       }
       return passed;
     };
-    const setupPassed = await runPhase("setup", data.setup ?? []);
-    if (setupPassed) {
-      await runPhase("steps", data.steps);
-    } else {
-      for (const [index, step] of data.steps.entries()) {
+    if (options.blockedError) {
+      const first = data.setup?.[0] ?? data.steps[0];
+      if (first) {
         steps.push({
-          index,
-          phase: "steps",
-          target: step.target,
-          action: step.action,
-          status: "skipped",
-          durationMs: 0
+          index: 0,
+          phase: "setup",
+          target: first.target,
+          action: first.action,
+          status: "failed",
+          durationMs: 0,
+          error: options.blockedError.message,
+          errorCode: options.blockedError.code
         });
       }
+      caseError = options.blockedError.message;
+      caseErrorCode = options.blockedError.code;
+    } else {
+      const setupPassed = await runPhase("setup", data.setup ?? []);
+      if (setupPassed) {
+        await runPhase("steps", data.steps);
+      } else {
+        for (const [index, step] of data.steps.entries()) {
+          steps.push({
+            index,
+            phase: "steps",
+            target: step.target,
+            action: step.action,
+            status: "skipped",
+            durationMs: 0
+          });
+        }
+      }
+      await runPhase("teardown", data.teardown ?? []);
     }
-    await runPhase("teardown", data.teardown ?? []);
     const finishedAt = /* @__PURE__ */ new Date();
-    const status = caseError ? "failed" : "passed";
+    const status = caseError ? caseStatusFromErrorCode(caseErrorCode) : "passed";
     const caseResult = {
       caseId: data.id,
       caseName: data.name,
@@ -32256,6 +32500,7 @@ var ExecutionEngine = class {
       durationMs: finishedAt.getTime() - startedAt.getTime()
     };
     if (caseError) caseResult.error = caseError;
+    if (caseErrorCode) caseResult.errorCode = caseErrorCode;
     if (warnings.length > 0) caseResult.warnings = warnings;
     for (const [target, adapter] of evidenceAdapters) {
       if (!adapter.stopEvidence) continue;
@@ -32273,6 +32518,9 @@ var ExecutionEngine = class {
         );
       }
     }
+    for (const [, adapter] of evidenceAdapters) {
+      await adapter.restoreWxMock?.().catch(() => void 0);
+    }
     await bus.emit({
       type: "case-finished",
       runId,
@@ -32299,6 +32547,8 @@ function buildRunSummary(runId, startedAt, cases, options = {}) {
     passed: cases.filter((item) => item.status === "passed").length,
     failed: cases.filter((item) => item.status === "failed").length,
     skipped: cases.filter((item) => item.status === "skipped").length,
+    ...cases.some((item) => item.status === "blocked") ? { blocked: cases.filter((item) => item.status === "blocked").length } : {},
+    ...cases.some((item) => item.status === "inconclusive") ? { inconclusive: cases.filter((item) => item.status === "inconclusive").length } : {},
     warnings: 0,
     steps: 0,
     stepsPassed: 0,
@@ -32323,7 +32573,8 @@ function buildRunSummary(runId, startedAt, cases, options = {}) {
     startedAt: startedAt.toISOString(),
     finishedAt: finishedAt.toISOString(),
     durationMs: finishedAt.getTime() - startedAt.getTime(),
-    status: totals.failed > 0 ? "failed" : totals.passed > 0 || totals.cases === 0 ? "passed" : "skipped",
+    // run 状态按三桶优先级推导:产品失败 > 证据不足 > 环境阻塞 > 通过 > 跳过
+    status: totals.failed > 0 ? "failed" : (totals.inconclusive ?? 0) > 0 ? "inconclusive" : (totals.blocked ?? 0) > 0 ? "blocked" : totals.passed > 0 || totals.cases === 0 ? "passed" : "skipped",
     ...options.cancelled ? { cancelled: true } : {},
     cases,
     totals
@@ -32375,6 +32626,7 @@ var TestRunner = class {
           rowIndex: item.rowIndex ?? 0,
           initialVariables: item.initialVariables ?? {},
           missingDependencies: item.missingDependencies ?? [],
+          blockedError: item.blockedError,
           artifacts,
           bus,
           resolver: this.resolver,
@@ -32431,6 +32683,11 @@ import { existsSync as existsSync3 } from "node:fs";
 import { mkdtemp, readFile as readFile6, rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join as join16 } from "node:path";
+import { errors } from "playwright";
+var TEXT_WAIT_MS = 1e4;
+function delay2(ms) {
+  return new Promise((resolve7) => setTimeout(resolve7, ms));
+}
 var PlaywrightAdapter = class {
   constructor(bundle, options = {}) {
     this.bundle = bundle;
@@ -32487,36 +32744,63 @@ var PlaywrightAdapter = class {
     const options = this.options;
     const page = await this.ensurePage();
     const target = options.baseUrl && !/^https?:\/\//i.test(url2) ? new URL(url2, options.baseUrl).toString() : url2;
-    await page.goto(target);
+    try {
+      await page.goto(target);
+    } catch (err) {
+      if (err instanceof errors.TimeoutError) {
+        throw new TestPilotError("STEP_TIMEOUT", err.message, { cause: err });
+      }
+      if (err instanceof Error && err.message.includes("net::ERR")) {
+        throw new TestPilotError("ENVIRONMENT_UNAVAILABLE", err.message, { cause: err });
+      }
+      throw err;
+    }
   }
   async click(locator) {
-    await (await this.toLocator(locator)).click();
+    const target = await this.toLocator(locator);
+    await this.coded(() => target.click());
   }
   async input(locator, value) {
-    await (await this.toLocator(locator)).fill(value);
+    const target = await this.toLocator(locator);
+    await this.coded(() => target.fill(value));
   }
   async select(locator, value) {
-    await (await this.toLocator(locator)).selectOption(value);
+    const target = await this.toLocator(locator);
+    await this.coded(() => target.selectOption(value));
   }
   async wait(locator, timeoutMs) {
     const page = await this.ensurePage();
     if (locator) {
-      await this.toLocatorOn(page, locator).waitFor({ state: "visible", timeout: timeoutMs });
+      await this.coded(() => this.toLocatorOn(page, locator).waitFor({ state: "visible", timeout: timeoutMs }));
       return;
     }
     await page.waitForTimeout(timeoutMs ?? 1e3);
   }
   async assert(locator, expected) {
     const target = await this.toLocator(locator);
-    await target.waitFor({ state: "visible" });
-    const actual = (await target.innerText()).trim();
     const wanted = expected.trim();
-    if (!actual.includes(wanted)) {
-      throw new Error(`\u65AD\u8A00\u5931\u8D25:\u671F\u671B\u5305\u542B "${wanted}",\u5B9E\u9645\u4E3A "${actual.slice(0, 200)}"`);
+    const startedAt = Date.now();
+    for (; ; ) {
+      await this.coded(() => target.waitFor({ state: "visible" }));
+      const actual = (await this.coded(() => target.innerText())).trim();
+      if (actual.includes(wanted)) return;
+      if (Date.now() - startedAt > TEXT_WAIT_MS) {
+        throw new TestPilotError(
+          "ASSERTION_FAILED",
+          `\u65AD\u8A00\u5931\u8D25(\u7B49\u5F85 ${TEXT_WAIT_MS}ms):\u671F\u671B\u5305\u542B "${wanted}",\u5B9E\u9645\u4E3A "${actual.slice(0, 200)}"`
+        );
+      }
+      await delay2(300);
     }
   }
   async extract(locator) {
-    return (await this.toLocator(locator)).innerText().then((text) => text.trim());
+    const target = await this.toLocator(locator);
+    const startedAt = Date.now();
+    for (; ; ) {
+      const text = (await this.coded(() => target.innerText())).trim();
+      if (text.length > 0 || Date.now() - startedAt > TEXT_WAIT_MS) return text;
+      await delay2(300);
+    }
   }
   async screenshot() {
     return (await this.ensurePage()).screenshot();
@@ -32534,6 +32818,17 @@ var PlaywrightAdapter = class {
   async toLocator(locator) {
     return this.toLocatorOn(await this.ensurePage(), locator);
   }
+  /** 定位类操作的统一兜底:等待超时按「元素没等到」归类(可能是回归也可能是 selector 腐烂,不允许静默) */
+  async coded(fn) {
+    try {
+      return await fn();
+    } catch (err) {
+      if (err instanceof errors.TimeoutError) {
+        throw new TestPilotError("ELEMENT_NOT_FOUND", err.message, { cause: err });
+      }
+      throw err;
+    }
+  }
   toLocatorOn(page, locator) {
     if (locator.text !== void 0) {
       return page.getByText(locator.text, { exact: true });
@@ -32570,6 +32865,8 @@ import net from "node:net";
 var AUTO_PORT_FALLBACK_WAIT_MS = 9e4;
 var NAVIGATE_RETRY_WINDOW_MS = 45e3;
 var ELEMENT_WAIT_MS = 1e4;
+var TEXT_WAIT_MS2 = 1e4;
+var PAGE_READY_WAIT_MS = 3e4;
 var CONNECTION_LOST = /connection closed|not connected/i;
 var automatorLauncher = {
   launch: async (options) => {
@@ -32583,7 +32880,7 @@ var automatorLauncher = {
     }
   }
 };
-function delay2(ms) {
+function delay3(ms) {
   return new Promise((resolve7) => setTimeout(resolve7, ms));
 }
 async function connectWithRetry(wsEndpoint, timeoutMs) {
@@ -32594,7 +32891,7 @@ async function connectWithRetry(wsEndpoint, timeoutMs) {
       return await automator.connect({ wsEndpoint });
     } catch (err) {
       lastError = err;
-      await delay2(1e3);
+      await delay3(1e3);
     }
   }
   throw lastError instanceof Error ? lastError : new Error(String(lastError));
@@ -32611,12 +32908,12 @@ function startCliAuto(cliPath, projectPath, port) {
     child.stderr?.on("data", (chunk) => {
       output2 += chunk.toString("utf8");
     });
-    child.once("error", (err) => rejectPromise(new Error(`\u62C9\u8D77\u5F00\u53D1\u8005\u5DE5\u5177 cli \u5931\u8D25:${err.message}`)));
+    child.once("error", (err) => rejectPromise(new TestPilotError("ENVIRONMENT_UNAVAILABLE", `\u62C9\u8D77\u5F00\u53D1\u8005\u5DE5\u5177 cli \u5931\u8D25:${err.message}`)));
     child.once("exit", (code) => {
       if (code === 0) {
         resolvePromise();
       } else {
-        rejectPromise(new Error(`cli auto \u9000\u51FA\u7801 ${code}:${output2.slice(-400)}`));
+        rejectPromise(new TestPilotError("ENVIRONMENT_UNAVAILABLE", `cli auto \u9000\u51FA\u7801 ${code}:${output2.slice(-400)}`));
       }
     });
     const startedAt = Date.now();
@@ -32629,7 +32926,7 @@ function startCliAuto(cliPath, projectPath, port) {
       socket.once("error", () => {
         socket.destroy();
         if (Date.now() - startedAt > AUTO_PORT_FALLBACK_WAIT_MS) {
-          rejectPromise(new Error(`\u7B49\u5F85\u5F00\u53D1\u8005\u5DE5\u5177\u81EA\u52A8\u5316\u7AEF\u53E3 ${port} \u8D85\u65F6;\u8BF7\u786E\u8BA4:1) \u5DE5\u5177\u5DF2\u767B\u5F55 2) \u8BBE\u7F6E->\u5B89\u5168\u8BBE\u7F6E->\u670D\u52A1\u7AEF\u53E3\u5DF2\u5F00\u542F`));
+          rejectPromise(new TestPilotError("ENVIRONMENT_UNAVAILABLE", `\u7B49\u5F85\u5F00\u53D1\u8005\u5DE5\u5177\u81EA\u52A8\u5316\u7AEF\u53E3 ${port} \u8D85\u65F6;\u8BF7\u786E\u8BA4:1) \u5DE5\u5177\u5DF2\u767B\u5F55 2) \u8BBE\u7F6E->\u5B89\u5168\u8BBE\u7F6E->\u670D\u52A1\u7AEF\u53E3\u5DF2\u5F00\u542F`));
         } else {
           setTimeout(poll, 500);
         }
@@ -32663,14 +32960,31 @@ var MiniAppAdapter = class {
         await this.runWithReconnect(async () => {
           await (await this.getProgram()).reLaunch(url2);
         });
+        await this.waitForPageReady();
         return;
       } catch (err) {
         lastError = err;
-        await delay2(3e3);
+        await delay3(3e3);
       }
     }
     throw lastError instanceof Error ? lastError : new Error(String(lastError));
   }
+  /** 等待页面就绪:模拟器编译期间 currentPage / data 会失败或挂起,轮询至可响应 */
+  async waitForPageReady(timeoutMs = PAGE_READY_WAIT_MS) {
+    const startedAt = Date.now();
+    for (; ; ) {
+      const page = await (await this.getProgram()).currentPage();
+      const data = await page.data().catch(() => void 0);
+      if (data !== void 0 && data !== null) return;
+      if (Date.now() - startedAt > timeoutMs) {
+        throw new TestPilotError(
+          "PAGE_READY_TIMEOUT",
+          `\u7B49\u5F85\u9875\u9762\u5C31\u7EEA\u8D85\u65F6(${timeoutMs}ms):\u6A21\u62DF\u5668\u53EF\u80FD\u4ECD\u5728\u7F16\u8BD1,\u6216\u9879\u76EE\u672A\u88AB\u4FE1\u4EFB`
+        );
+      }
+      await delay3(300);
+    }
+  }
   async click(locator) {
     await this.runWithReconnect(async () => (await this.element(locator)).tap());
   }
@@ -32678,7 +32992,7 @@ var MiniAppAdapter = class {
     await this.runWithReconnect(async () => (await this.element(locator)).input(value));
   }
   async select() {
-    throw new Error("\u5C0F\u7A0B\u5E8F\u7AEF\u6682\u4E0D\u652F\u6301 select(picker \u4EA4\u4E92),\u8BF7\u6539\u7528 click \u5B8C\u6210\u9009\u62E9");
+    throw new TestPilotError("UNSUPPORTED_ACTION", "\u5C0F\u7A0B\u5E8F\u7AEF\u6682\u4E0D\u652F\u6301 select(picker \u4EA4\u4E92),\u8BF7\u6539\u7528 click \u5B8C\u6210\u9009\u62E9");
   }
   async wait(locator, timeoutMs) {
     await this.runWithReconnect(async () => {
@@ -32693,17 +33007,100 @@ var MiniAppAdapter = class {
   async assert(locator, expected) {
     await this.runWithReconnect(async () => {
       const element = await this.element(locator);
-      const actual = (await element.text()).trim();
       const wanted = expected.trim();
-      if (!actual.includes(wanted)) {
-        throw new Error(`\u65AD\u8A00\u5931\u8D25:\u671F\u671B\u5305\u542B "${wanted}",\u5B9E\u9645\u4E3A "${actual.slice(0, 200)}"`);
+      const startedAt = Date.now();
+      for (; ; ) {
+        const actual = (await element.text()).trim();
+        if (actual.includes(wanted)) return;
+        if (Date.now() - startedAt > TEXT_WAIT_MS2) {
+          throw new TestPilotError(
+            "ASSERTION_FAILED",
+            `\u65AD\u8A00\u5931\u8D25(\u7B49\u5F85 ${TEXT_WAIT_MS2}ms):\u671F\u671B\u5305\u542B "${wanted}",\u5B9E\u9645\u4E3A "${actual.slice(0, 200)}"`
+          );
+        }
+        await delay3(300);
       }
     });
   }
   async extract(locator) {
     return this.runWithReconnect(async () => {
       const element = await this.element(locator);
-      return (await element.text()).trim();
+      const startedAt = Date.now();
+      for (; ; ) {
+        const text = (await element.text()).trim();
+        if (text.length > 0 || Date.now() - startedAt > TEXT_WAIT_MS2) return text;
+        await delay3(300);
+      }
+    });
+  }
+  /** 调用 Page / 组件方法;不传 locator 时为页面级调用(Page 实例方法) */
+  async callMethod(locator, methodName, args = []) {
+    return this.runWithReconnect(async () => {
+      if (locator) {
+        const element = await this.element(locator);
+        return element.callMethod(methodName, ...args);
+      }
+      const page = await (await this.getProgram()).currentPage();
+      return page.callMethod(methodName, ...args);
+    });
+  }
+  // ---- miniapp 深度测试(V0.2)----
+  wxMock;
+  /** mock 任意 wx.* API:拦截调用并返回 mock 值;capture 记录真实调用参数(最近调用在前) */
+  async mockWxApi(options) {
+    if (this.wxMock?.api === options.api) await this.restoreWxMock();
+    const program2 = await this.getProgram();
+    const captured = [];
+    this.wxMock = { api: options.api, captured };
+    const callbackName = options.capture ? `__tpWxCapture_${options.capture}` : void 0;
+    if (callbackName) {
+      await program2.exposeFunction(callbackName, (payload) => {
+        if (payload !== null && typeof payload === "object") {
+          captured.push(payload);
+        }
+      });
+    }
+    await program2.mockWxMethod(
+      options.api,
+      function(invokeOptions, cbName) {
+        const callbacks = globalThis;
+        callbacks[cbName]?.({ options: invokeOptions });
+        return options.result ?? this.origin(invokeOptions);
+      },
+      callbackName
+    );
+  }
+  /** 读取 mock 期间捕获的调用参数(最近调用在前) */
+  readCapturedWxApiCalls(api) {
+    return this.wxMock?.api === api ? [...this.wxMock.captured].reverse() : [];
+  }
+  /** 恢复 mock 的 wx API(用例结束由引擎调用) */
+  async restoreWxMock() {
+    const mock = this.wxMock;
+    if (!mock) return;
+    this.wxMock = void 0;
+    if (!this.program) return;
+    await this.program.restoreWxMethod(mock.api).catch(() => void 0);
+  }
+  /** 触发组件事件(trigger;detail 作为 e.detail 注入,空 detail 即"用户拒绝/取消"类分支) */
+  async trigger(locator, eventType, detail) {
+    await this.runWithReconnect(async () => {
+      const element = await this.element(locator);
+      await element.trigger(eventType, detail);
+    });
+  }
+  /** 读取页面 data(点号路径,缺省为整个 data 对象) */
+  async getData(dataPath) {
+    return this.runWithReconnect(async () => {
+      const page = await (await this.getProgram()).currentPage();
+      return page.data(dataPath);
+    });
+  }
+  /** 写入页面 data 补丁(setData 驱动 onShow/onPullDownRefresh 等真实链路) */
+  async setData(patch) {
+    await this.runWithReconnect(async () => {
+      const page = await (await this.getProgram()).currentPage();
+      await page.setData(patch);
     });
   }
   async screenshot() {
@@ -32794,9 +33191,9 @@ var MiniAppAdapter = class {
       const element = await page.$(selector);
       if (element) return element;
       if (Date.now() - startedAt > ELEMENT_WAIT_MS) {
-        throw new Error(`\u7B49\u5F85\u5143\u7D20\u8D85\u65F6(${ELEMENT_WAIT_MS}ms):${selector}`);
+        throw new TestPilotError("ELEMENT_NOT_FOUND", `\u7B49\u5F85\u5143\u7D20\u8D85\u65F6(${ELEMENT_WAIT_MS}ms):${selector}`);
       }
-      await delay2(500);
+      await delay3(500);
     }
   }
 };
@@ -32872,7 +33269,7 @@ var ApiAdapter = class {
         signal: AbortSignal.timeout(this.options.timeoutMs ?? 15e3)
       });
     } catch (err) {
-      throw new Error(`API \u8BF7\u6C42\u5931\u8D25 ${request.method.toUpperCase()} ${url2}:${err instanceof Error ? err.message : String(err)}`);
+      throw new TestPilotError("ENVIRONMENT_UNAVAILABLE", `API \u8BF7\u6C42\u5931\u8D25 ${request.method.toUpperCase()} ${url2}:${err instanceof Error ? err.message : String(err)}`, { cause: err });
     }
     const bodyText = await res.text();
     let json2;
@@ -32894,7 +33291,7 @@ var ApiAdapter = class {
     if (!this.last) throw new Error("\u5C1A\u672A\u53D1\u8D77\u4EFB\u4F55 API \u8BF7\u6C42,\u65E0\u6CD5\u65AD\u8A00\u54CD\u5E94");
     if (!this.last.bodyText.includes(expected)) {
       const snippet2 = this.last.bodyText.slice(0, 200);
-      throw new Error(`\u54CD\u5E94\u4F53\u4E0D\u5305\u542B "${expected}":HTTP ${this.last.status} ${snippet2}`);
+      throw new TestPilotError("ASSERTION_FAILED", `\u54CD\u5E94\u4F53\u4E0D\u5305\u542B "${expected}":HTTP ${this.last.status} ${snippet2}`);
     }
   }
   async extractResponse(path) {
@@ -33023,7 +33420,23 @@ async function runCases(options = {}) {
           variables: config2.variables,
           accounts: options.accounts
         }
-      )
+      ).catch((err) => {
+        if (err instanceof TestPilotError && err.code === "FIXTURE_MISSING") {
+          return [
+            {
+              data: item.case,
+              file: item.file,
+              templateId: item.case.id,
+              rowId: "default",
+              rowIndex: 0,
+              initialVariables: {},
+              missingDependencies: [],
+              blockedError: { code: err.code, message: err.message }
+            }
+          ];
+        }
+        throw err;
+      })
     )
   )).flat();
   const summary = await runner.run(
@@ -33260,7 +33673,7 @@ async function collectEnvVarRefs(root) {
 }
 
 // src/commands/init/project-detector.ts
-import { existsSync as existsSync6, readFileSync as readFileSync2 } from "node:fs";
+import { existsSync as existsSync6, readdirSync as readdirSync2, readFileSync as readFileSync2 } from "node:fs";
 import { basename, join as join22 } from "node:path";
 
 // src/lib/git.ts
@@ -33316,10 +33729,31 @@ function detectProjectType(root) {
   if (isWeb) return "web";
   return "unknown";
 }
+function detectLanguageFromSources(root) {
+  const SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "miniprogram_npm", "dist", ".git"]);
+  const found = { ts: false, js: false };
+  const walk = (dir, depth) => {
+    if (depth > 4 || found.ts && found.js) return;
+    for (const entry of readdirSync2(dir, { withFileTypes: true })) {
+      if (entry.name.startsWith(".")) continue;
+      const full = join22(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (!SKIP_DIRS.has(entry.name)) walk(full, depth + 1);
+        continue;
+      }
+      if (/\.(ts|tsx)$/.test(entry.name)) found.ts = true;
+      else if (/\.(js|cjs|mjs|wxml)$/.test(entry.name)) found.js = true;
+    }
+  };
+  walk(root, 0);
+  if (found.ts) return "TypeScript";
+  if (found.js) return "JavaScript";
+  return "Unknown";
+}
 async function detectProject(root) {
   const pkg = readPackageJson(root);
   const type = detectProjectType(root);
-  const language = existsSync6(join22(root, "tsconfig.json")) ? "TypeScript" : pkg || existsSync6(join22(root, "src")) ? "JavaScript" : "Unknown";
+  const language = existsSync6(join22(root, "tsconfig.json")) ? "TypeScript" : pkg || existsSync6(join22(root, "src")) ? "JavaScript" : detectLanguageFromSources(root);
   const packageManager = existsSync6(join22(root, "pnpm-lock.yaml")) ? "pnpm" : existsSync6(join22(root, "yarn.lock")) ? "yarn" : existsSync6(join22(root, "package-lock.json")) ? "npm" : "npx";
   const existingE2eDirs = E2E_DIR_CANDIDATES.filter((dir) => existsSync6(join22(root, dir)));
   return {
@@ -33799,7 +34233,7 @@ function randomId() {
 }
 
 // src/commands/init/test-structure.ts
-import { existsSync as existsSync9, readdirSync as readdirSync2 } from "node:fs";
+import { existsSync as existsSync9, readdirSync as readdirSync3 } from "node:fs";
 import { mkdir as mkdir14, writeFile as writeFile12 } from "node:fs/promises";
 import { join as join26 } from "node:path";
 async function initTestStructure(root, _info) {
@@ -33819,7 +34253,7 @@ async function initTestStructure(root, _info) {
     await mkdir14(dir, { recursive: true });
   }
   for (const [name, dir] of Object.entries(dirs)) {
-    if (!existed[name] && readdirSync2(dir).length === 0) {
+    if (!existed[name] && readdirSync3(dir).length === 0) {
       await writeFile12(join26(dir, ".gitkeep"), "", "utf8").catch(() => void 0);
     }
   }
@@ -33989,6 +34423,11 @@ function openInBrowser(file2) {
 
 // src/commands/run.ts
 import { join as join28 } from "node:path";
+function exitCodeForSummary(status) {
+  if (status === "failed" || status === "inconclusive") return 1;
+  if (status === "blocked") return 2;
+  return 0;
+}
 function makeRunCommand() {
   return new Command("run").description("\u6267\u884C\u6D4B\u8BD5\u7528\u4F8B(\u9ED8\u8BA4\u8FD0\u884C testpilot.yaml \u914D\u7F6E\u7684 Case)").argument("[paths...]", "\u7528\u4F8B\u6587\u4EF6\u6216\u76EE\u5F55,\u9ED8\u8BA4\u6309\u9879\u76EE\u914D\u7F6E").option("--tag <tag>", "\u6309\u6807\u7B7E\u8FC7\u6EE4\u7528\u4F8B").action(async (paths, options) => {
     const client = new TestPilotClient();
@@ -34010,11 +34449,11 @@ function makeRunCommand() {
       ].filter(Boolean).join(",");
       console.log("");
       console.log(
-        `Run ${summary.runId}${summary.cancelled ? "(\u5DF2\u53D6\u6D88)" : ""}: ${summary.status.toUpperCase()} \u2014 \u6A21\u677F ${summary.totals.templates ?? summary.totals.cases},\u6570\u636E\u884C \u2713${summary.totals.passed} \u2717${summary.totals.failed} \u21B7${summary.totals.skipped ?? 0} \u26A0${summary.totals.warnings ?? 0},\u6B65\u9AA4 \u2713${summary.totals.stepsPassed} \u2717${summary.totals.stepsFailed} \u21B7${summary.totals.stepsSkipped} \u26A0${summary.totals.stepsWarning ?? 0}${notes ? `(${notes})` : ""}`
+        `Run ${summary.runId}${summary.cancelled ? "(\u5DF2\u53D6\u6D88)" : ""}: ${summary.status.toUpperCase()} \u2014 \u6A21\u677F ${summary.totals.templates ?? summary.totals.cases},\u6570\u636E\u884C \u2713${summary.totals.passed} \u2717${summary.totals.failed} \u2298${summary.totals.blocked ?? 0} ?${summary.totals.inconclusive ?? 0} \u21B7${summary.totals.skipped ?? 0} \u26A0${summary.totals.warnings ?? 0},\u6B65\u9AA4 \u2713${summary.totals.stepsPassed} \u2717${summary.totals.stepsFailed} \u21B7${summary.totals.stepsSkipped} \u26A0${summary.totals.stepsWarning ?? 0}${notes ? `(${notes})` : ""}`
       );
       console.log(`\u4EA7\u7269\u76EE\u5F55:${join28(".testpilot", "artifacts", "runs", summary.runId)}`);
       console.log("\u67E5\u770B\u62A5\u544A:npx csspilot report");
-      if (summary.status === "failed") process.exitCode = 1;
+      process.exitCode = exitCodeForSummary(summary.status);
     } catch (err) {
       console.error(err instanceof Error ? err.message : err);
       process.exitCode = 1;
@@ -34189,7 +34628,7 @@ function makeValidateCommand() {
 }
 
 // src/cli.ts
-var CLI_VERSION = "0.6.0";
+var CLI_VERSION = "0.7.1";
 async function createCli() {
   const program2 = new Command();
   program2.name("csspilot").description("TestPilot \u2014 AI Native \u8DE8\u7AEF\u4E1A\u52A1\u6D4B\u8BD5\u57FA\u7840\u8BBE\u65BD CLI").version(CLI_VERSION, "-v, --version", "output the current version").option("-V", "output the current version", () => {