csspilot 0.7.1 → 0.7.2

package/dist/bin.js

@@ -30115,9 +30115,10 @@ var configSchema = external_exports.strictObject({
 function interpolateEnvRefs(value) {
   return value.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (match, name) => process.env[name] ?? match);
 }
+var ENV_TESTING_FILE = ".env.testing";
 function loadProjectEnvFile(root = process.cwd()) {
   try {
-    process.loadEnvFile(join2(root, ".env"));
+    process.loadEnvFile(join2(root, ENV_TESTING_FILE));
   } catch {
   }
 }
@@ -30183,8 +30184,8 @@ async function loadTestpilotConfig(cwd = process.cwd()) {
 }
 
 // ../../packages/core/src/wechat-devtools.ts
-import { execFile } from "node:child_process";
-import { existsSync, readdirSync } from "node:fs";
+import { exec, execFile } from "node:child_process";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join as join3 } from "node:path";
 var CLI_NAMES = ["cli.bat", "cli"];
 var REGISTRY_UNINSTALL_KEYS = [
@@ -30271,6 +30272,42 @@ function execToString(command, args) {
     });
   });
 }
+async function isWechatDevToolsLoggedIn(cliPath) {
+  const output2 = await execCliToString(cliPath, ["islogin"]).catch(() => void 0);
+  if (output2 === void 0) return void 0;
+  if (/is\s*login\s*[:=]?\s*(true|yes|1)\b/i.test(output2)) return true;
+  if (/is\s*login\s*[:=]?\s*(false|no|0)\b/i.test(output2)) return false;
+  if (/\btrue\b/i.test(output2)) return true;
+  if (/\bfalse\b/i.test(output2)) return false;
+  return void 0;
+}
+function execCliToString(cliPath, args) {
+  return new Promise((resolvePromise, rejectPromise) => {
+    const quote = (value) => /\s/.test(value) ? `"${value}"` : value;
+    exec(
+      `"${cliPath}" ${args.map(quote).join(" ")}`,
+      { windowsHide: true, timeout: 3e4, encoding: "buffer" },
+      (err, stdout, stderr) => {
+        const text = `${stdout.toString("utf8")}${stderr.toString("utf8")}`.trim();
+        if (err && !text) {
+          rejectPromise(err);
+          return;
+        }
+        resolvePromise(text);
+      }
+    );
+  });
+}
+function readMiniappProjectAppid(projectPath) {
+  const configPath = join3(projectPath, "project.config.json");
+  if (!existsSync(configPath)) return void 0;
+  try {
+    const parsed = JSON.parse(readFileSync(configPath, "utf8"));
+    return { appid: typeof parsed.appid === "string" ? parsed.appid : void 0, configPath };
+  } catch {
+    return void 0;
+  }
+}
 
 // ../../node_modules/.pnpm/commander@12.1.0/node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -30392,8 +30429,16 @@ var ACTIONS = [
   "callMethod",
   "mockWxApi",
   "trigger",
-  "setData"
+  "setData",
+  "longpress",
+  "callWxApi",
+  "touch",
+  "scroll",
+  "swipeTo",
+  "slideTo",
+  "moveTo"
 ];
+var TOUCH_PHASES = ["touchstart", "touchmove", "touchend"];
 var locatorSchema = external_exports.strictObject({
   text: external_exports.string().min(1).optional(),
   css: external_exports.string().min(1).optional()
@@ -30409,7 +30454,7 @@ var stepSchema = external_exports.strictObject({
   action: external_exports.enum(ACTIONS),
   locator: locatorSchema.optional(),
   url: external_exports.string().min(1).optional(),
-  value: external_exports.string().optional(),
+  value: external_exports.union([external_exports.string(), external_exports.number()]).optional(),
   expected: external_exports.string().optional(),
   /** api target:request 的 HTTP 方法(默认 GET) */
   method: external_exports.enum(HTTP_METHODS).optional(),
@@ -30435,10 +30480,29 @@ var stepSchema = external_exports.strictObject({
   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} 模板) */
+  /** setData:写入页面 data 的补丁(值支持 ${var} 模板);提供 locator 时为组件级 setData */
   patch: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
-  /** assert:页面 data 路径断言(与 locator 互斥,仅 miniapp) */
-  dataPath: external_exports.string().min(1).optional()
+  /** assert:页面 data 路径断言(与 locator/attribute/property/count 互斥,仅 miniapp) */
+  dataPath: external_exports.string().min(1).optional(),
+  /** assert:元素 attribute 名(与 expected 组合做属性断言;web/miniapp) */
+  attribute: external_exports.string().min(1).optional(),
+  /** assert:元素 property 名(自定义组件实例属性;仅 miniapp) */
+  property: external_exports.string().min(1).optional(),
+  /** assert:匹配元素的精确数量(0 即"元素不存在"断言;与 expected/attribute/property/dataPath 互斥) */
+  count: external_exports.number().int().nonnegative().optional(),
+  /** touch:触摸阶段 */
+  phase: external_exports.enum(TOUCH_PHASES).optional(),
+  /** touch:触摸点数组(元素如 [{identifier: 0, x: 100, y: 200}],值支持 ${var} 模板) */
+  touches: external_exports.array(external_exports.record(external_exports.string(), external_exports.unknown())).min(1).optional(),
+  /** touch:changedTouches 触摸点数组;缺省复用 touches */
+  changedTouches: external_exports.array(external_exports.record(external_exports.string(), external_exports.unknown())).optional(),
+  /** scroll:滚动位置(scroll-view 内滚动提供 locator;缺省滚动页面) */
+  scrollTop: external_exports.number().optional(),
+  /** swipeTo:swiper 目标页索引 */
+  index: external_exports.number().int().nonnegative().optional(),
+  /** moveTo:movable-view 目标坐标 */
+  x: external_exports.number().optional(),
+  y: external_exports.number().optional()
 });
 var datasetReferenceSchema = external_exports.strictObject({
   file: external_exports.string().min(1),
@@ -30515,29 +30579,57 @@ var ADAPTER_SUPPORT = {
   callMethod: ["miniapp"],
   mockWxApi: ["miniapp"],
   trigger: ["miniapp"],
-  setData: ["miniapp"]
+  setData: ["miniapp"],
+  longpress: ["web", "miniapp"],
+  callWxApi: ["miniapp"],
+  touch: ["miniapp"],
+  scroll: ["miniapp"],
+  swipeTo: ["miniapp"],
+  slideTo: ["miniapp"],
+  moveTo: ["miniapp"]
 };
-var LOCATOR_REQUIRED = /* @__PURE__ */ new Set(["click", "input", "select", "assert", "extract"]);
-var VALUE_REQUIRED = /* @__PURE__ */ new Set(["input", "select"]);
+var LOCATOR_REQUIRED = /* @__PURE__ */ new Set([
+  "click",
+  "input",
+  "select",
+  "assert",
+  "extract",
+  "longpress",
+  "touch",
+  "swipeTo",
+  "slideTo",
+  "moveTo"
+]);
+var VALUE_REQUIRED = /* @__PURE__ */ new Set(["input", "select", "slideTo"]);
 var REQUEST_EXPECTATION_ACTIONS = /* @__PURE__ */ new Set(["navigate", "click", "input", "select"]);
 var FIELD_ALLOWED = {
   url: ["navigate", "request"],
-  value: ["input", "select", "extract"],
+  value: ["input", "select", "extract", "slideTo"],
   expected: ["assert", "request"],
-  variable: ["extract"],
+  variable: ["extract", "callWxApi"],
   timeout: ["wait"],
   method: ["request"],
   headers: ["request"],
   body: ["request"],
   methodName: ["callMethod"],
-  args: ["callMethod"],
-  wxApi: ["mockWxApi"],
+  args: ["callMethod", "callWxApi"],
+  wxApi: ["mockWxApi", "callWxApi"],
   result: ["mockWxApi"],
   capture: ["mockWxApi"],
   eventType: ["trigger"],
   detail: ["trigger"],
   patch: ["setData"],
-  dataPath: ["assert"]
+  dataPath: ["assert"],
+  attribute: ["assert"],
+  property: ["assert"],
+  count: ["assert"],
+  phase: ["touch"],
+  touches: ["touch"],
+  changedTouches: ["touch"],
+  scrollTop: ["scroll"],
+  index: ["swipeTo"],
+  x: ["moveTo"],
+  y: ["moveTo"]
 };
 var VARIABLE_REF = /\$\{([A-Za-z_][A-Za-z0-9_.]*)\}/g;
 function validateCase(data) {
@@ -30601,6 +30693,55 @@ function checkStep(step, at, declared, issues) {
       });
     }
   }
+  if (step.action === "callWxApi" && !step.wxApi) {
+    issues.push({ path: `${at}.wxApi`, code: "semantic", message: "callWxApi \u5FC5\u987B\u63D0\u4F9B wxApi(\u8981\u4E3B\u52A8\u8C03\u7528\u7684 wx.* API \u540D,\u5982 setStorageSync)" });
+  }
+  if (step.action === "touch") {
+    if (!step.phase) {
+      issues.push({ path: `${at}.phase`, code: "semantic", message: "touch \u5FC5\u987B\u63D0\u4F9B phase(touchstart / touchmove / touchend)" });
+    }
+    if (!step.touches || step.touches.length === 0) {
+      issues.push({ path: `${at}.touches`, code: "semantic", message: "touch \u5FC5\u987B\u63D0\u4F9B touches(\u89E6\u6478\u70B9\u6570\u7EC4,\u5982 [{identifier: 0, x: 0, y: 0}])" });
+    }
+  }
+  if (step.action === "scroll" && step.scrollTop === void 0) {
+    issues.push({ path: `${at}.scrollTop`, code: "semantic", message: "scroll \u5FC5\u987B\u63D0\u4F9B scrollTop(\u6EDA\u52A8\u4F4D\u7F6E\u50CF\u7D20)" });
+  }
+  if (step.action === "swipeTo" && step.index === void 0) {
+    issues.push({ path: `${at}.index`, code: "semantic", message: "swipeTo \u5FC5\u987B\u63D0\u4F9B index(swiper \u76EE\u6807\u9875\u7D22\u5F15)" });
+  }
+  if (step.action === "moveTo" && (step.x === void 0 || step.y === void 0)) {
+    issues.push({ path: `${at}.x`, code: "semantic", message: "moveTo \u5FC5\u987B\u63D0\u4F9B x \u4E0E y(movable-view \u76EE\u6807\u5750\u6807)" });
+  }
+  if (step.action === "assert") {
+    const modes = [
+      step.dataPath !== void 0,
+      step.attribute !== void 0,
+      step.property !== void 0,
+      step.count !== void 0
+    ].filter(Boolean).length;
+    if (modes > 1) {
+      issues.push({ path: `${at}.assert`, code: "semantic", message: "assert \u7684 dataPath / attribute / property / count \u53EA\u80FD\u63D0\u4F9B\u5176\u4E00(\u7F3A\u7701\u4E3A\u5143\u7D20\u6587\u672C\u65AD\u8A00)" });
+    }
+    if (step.property !== void 0 && step.target !== "miniapp") {
+      issues.push({ path: `${at}.property`, code: "semantic", message: "property \u65AD\u8A00\u4EC5 miniapp \u652F\u6301(\u81EA\u5B9A\u4E49\u7EC4\u4EF6\u5B9E\u4F8B\u5C5E\u6027)" });
+    }
+    if ((step.attribute !== void 0 || step.property !== void 0) && !step.locator) {
+      issues.push({ path: `${at}.locator`, code: "semantic", message: "attribute / property \u65AD\u8A00\u5FC5\u987B\u63D0\u4F9B locator" });
+    }
+    if (step.count !== void 0 && !step.locator) {
+      issues.push({ path: `${at}.locator`, code: "semantic", message: "count \u65AD\u8A00\u5FC5\u987B\u63D0\u4F9B locator(\u7EDF\u8BA1\u5339\u914D\u5143\u7D20)" });
+    }
+    if (step.count !== void 0 && step.expected !== void 0) {
+      issues.push({ path: `${at}.assert`, code: "semantic", message: "count \u65AD\u8A00\u4EE5 count \u4E3A\u671F\u671B\u503C,\u4E0D\u9700\u8981 expected" });
+    }
+    if (step.target === "api" && (step.attribute !== void 0 || step.property !== void 0 || step.count !== void 0)) {
+      issues.push({ path: `${at}.assert`, code: "semantic", message: "api \u7AEF assert \u4EC5\u652F\u6301 expected(\u54CD\u5E94\u4F53\u5305\u542B)" });
+    }
+    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 === "mockWxApi") {
     if (!step.wxApi) {
       issues.push({ path: `${at}.wxApi`, code: "semantic", message: "mockWxApi \u5FC5\u987B\u63D0\u4F9B wxApi(\u8981 mock \u7684 wx.* API \u540D)" });
@@ -30615,22 +30756,19 @@ function checkStep(step, at, declared, issues) {
   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" });
   }
   if (step.action === "request" && !step.url) {
     issues.push({ path: `${at}.url`, code: "semantic", message: "request \u5FC5\u987B\u63D0\u4F9B url(\u76F8\u5BF9\u8DEF\u5F84\u6309 api.baseUrl \u89E3\u6790)" });
   }
-  if (VALUE_REQUIRED.has(step.action) && !step.value) {
+  if (VALUE_REQUIRED.has(step.action) && (step.value === void 0 || step.value === "")) {
     issues.push({ path: `${at}.value`, code: "semantic", message: `action "${step.action}" \u5FC5\u987B\u63D0\u4F9B value` });
   }
   if (step.action === "extract" && step.target === "api" && !step.value) {
     issues.push({ path: `${at}.value`, code: "semantic", message: "api \u7AEF extract \u5FC5\u987B\u63D0\u4F9B value(\u70B9\u53F7 JSON path,\u5982 data.orderId)" });
   }
-  if (step.action === "assert" && !step.expected) {
+  if (step.action === "assert" && step.count === void 0 && !step.expected) {
     issues.push({ path: `${at}.expected`, code: "semantic", message: "assert \u5FC5\u987B\u63D0\u4F9B expected" });
   }
   if (step.action === "extract") {
@@ -30670,6 +30808,7 @@ function checkStep(step, at, declared, issues) {
 function checkLocator(step, at, issues) {
   const locator = step.locator;
   if (!locator) {
+    if (step.action === "assert" && step.dataPath !== void 0) return;
     if (LOCATOR_REQUIRED.has(step.action)) {
       issues.push({
         path: `${at}.locator`,
@@ -30694,7 +30833,7 @@ function checkVariableRefs(step, at, declared, issues) {
       if (match[1]) refs.push([field, match[1]]);
     }
   };
-  collect("value", step.value);
+  collect("value", step.value === void 0 ? void 0 : String(step.value));
   collect("expected", step.expected);
   collect("url", step.url);
   collect("methodName", step.methodName);
@@ -31529,13 +31668,13 @@ function buildSummaryData(runs) {
     });
   }
   const byCase = /* @__PURE__ */ new Map();
-  for (const exec2 of executions) {
-    let agg = byCase.get(exec2.identity);
+  for (const exec3 of executions) {
+    let agg = byCase.get(exec3.identity);
     if (!agg) {
       agg = {
-        caseId: exec2.caseId,
-        rowId: exec2.rowId,
-        caseName: exec2.caseName,
+        caseId: exec3.caseId,
+        rowId: exec3.rowId,
+        caseName: exec3.caseName,
         platforms: [],
         runs: 0,
         passed: 0,
@@ -31544,18 +31683,18 @@ function buildSummaryData(runs) {
         lastStatus: "unknown",
         flaky: false
       };
-      byCase.set(exec2.identity, agg);
+      byCase.set(exec3.identity, agg);
     }
     agg.runs++;
-    if (exec2.status === "passed") agg.passed++;
-    else if (exec2.status === "failed") agg.failed++;
-    for (const platform of exec2.platforms) {
+    if (exec3.status === "passed") agg.passed++;
+    else if (exec3.status === "failed") agg.failed++;
+    for (const platform of exec3.platforms) {
       if (!agg.platforms.includes(platform)) agg.platforms.push(platform);
     }
   }
   for (const agg of byCase.values()) {
     const identity = agg.rowId && agg.rowId !== "default" ? `${agg.caseId}#${agg.rowId}` : agg.caseId;
-    const last = [...executions].reverse().find((exec2) => exec2.identity === identity);
+    const last = [...executions].reverse().find((exec3) => exec3.identity === identity);
     agg.lastStatus = last?.status ?? "unknown";
     agg.lastCategory = last?.category;
     agg.passRate = agg.runs > 0 ? agg.passed / agg.runs : 0;
@@ -31566,13 +31705,13 @@ function buildSummaryData(runs) {
   const categories = FAILURE_CATEGORIES.map((item) => ({
     id: item.id,
     label: item.label,
-    count: executions.filter((exec2) => exec2.status === "failed" && exec2.category === item.id).length
+    count: executions.filter((exec3) => exec3.status === "failed" && exec3.category === item.id).length
   })).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
+      blocked: executions.filter((exec3) => exec3.status === "blocked").length,
+      inconclusive: executions.filter((exec3) => exec3.status === "inconclusive").length
     },
     window: {
       runs: runs.length,
@@ -31582,7 +31721,7 @@ function buildSummaryData(runs) {
     kpis: {
       runs: runs.length,
       executions: executions.length,
-      overallRate: executions.length > 0 ? executions.filter((exec2) => exec2.status === "passed").length / executions.length : 0,
+      overallRate: executions.length > 0 ? executions.filter((exec3) => exec3.status === "passed").length / executions.length : 0,
       avgDurationMs: durations.length > 0 ? durations.reduce((sum, value) => sum + value, 0) / durations.length : 0,
       flakyCount: flaky.length
     },
@@ -31786,7 +31925,7 @@ import { readFile as readFile7, readdir as readdir4 } from "node:fs/promises";
 import { isAbsolute as isAbsolute3, join as join17 } from "node:path";
 
 // ../../packages/execution-engine/src/artifacts/index.ts
-import { mkdir as mkdir9 } from "node:fs/promises";
+import { mkdir as mkdir9, writeFile as writeFile9 } from "node:fs/promises";
 import { join as join13 } from "node:path";
 
 // ../../packages/evidence/src/log.ts
@@ -31877,6 +32016,12 @@ var ArtifactManager = class {
     await saveTrace(this.tracesDir, fileName, data);
     return `traces/${fileName}`;
   }
+  /** 保存失败用例的运行时诊断(console 尾部/异常/页面栈/systemInfo),返回相对 run 目录的路径 */
+  async saveDiagnostics(fileName, data) {
+    await mkdir9(this.logsDir, { recursive: true });
+    await writeFile9(join13(this.logsDir, fileName), JSON.stringify(data, null, 2), "utf8");
+    return `logs/${fileName}`;
+  }
 };
 
 // ../../packages/execution-engine/src/context/index.ts
@@ -32016,6 +32161,14 @@ function redactHeaders(headers) {
   return redacted;
 }
 
+// ../../packages/adapter-core/src/locator.ts
+function describeLocator(locator) {
+  if (!locator) return "-";
+  if (locator.text !== void 0) return `text="${locator.text}"`;
+  if (locator.css !== void 0) return `css="${locator.css}"`;
+  return "-";
+}
+
 // ../../packages/adapter-core/src/session.ts
 var AdapterSession = class {
   constructor(target, factory) {
@@ -32072,6 +32225,8 @@ var AdapterResolver = class {
 
 // ../../packages/execution-engine/src/engine/step-executor.ts
 var SNIPPET_LIMIT = 400;
+var ASSERT_POLL_MS = 1e4;
+var ABSENT_SETTLE_MS = 2e3;
 async function executeStep(step, index, adapter, context, artifacts, options) {
   const startedAt = Date.now();
   const result = {
@@ -32105,15 +32260,26 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
         await adapter.click(locator);
         break;
       case "input":
-        await adapter.input(locator, context.resolve(step.value ?? ""));
+        await adapter.input(locator, resolveValueText(step.value, context));
         break;
       case "select":
-        await adapter.select(locator, context.resolve(step.value ?? ""));
+        await adapter.select(locator, resolveValueText(step.value, context));
         break;
       case "wait":
         await adapter.wait(locator, step.timeout);
         break;
       case "assert": {
+        if (step.count !== void 0) {
+          if (!adapter.countElements) {
+            throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301 count \u65AD\u8A00`);
+          }
+          await assertElementCount(adapter, locator, step.count);
+          break;
+        }
+        if (step.attribute !== void 0 || step.property !== void 0) {
+          await assertElementAttribute(adapter, locator, step, context);
+          break;
+        }
         if (step.dataPath !== void 0) {
           if (!adapter.assertData) {
             throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301 dataPath \u65AD\u8A00`);
@@ -32130,7 +32296,7 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
         break;
       }
       case "extract": {
-        const value = step.target === "api" ? await extractApiResponse(adapter, context.resolve(step.value ?? "")) : await adapter.extract(locator);
+        const value = step.target === "api" ? await extractApiResponse(adapter, resolveValueText(step.value, context)) : await adapter.extract(locator);
         if (step.variable) {
           context.set(step.variable, value);
           result.extracted = { [step.variable]: value };
@@ -32201,7 +32367,69 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
         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));
+        await adapter.setData(resolveDeep(step.patch ?? {}, context), locator);
+        break;
+      }
+      case "longpress": {
+        if (typeof adapter.longpress !== "function") {
+          throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301 longpress`);
+        }
+        await adapter.longpress(locator);
+        break;
+      }
+      case "callWxApi": {
+        if (typeof adapter.callWxApi !== "function") {
+          throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301 callWxApi`);
+        }
+        const wxApi = context.resolve(step.wxApi ?? "");
+        if (!wxApi) throw new TestPilotError("MISSING_WX_API", "callWxApi \u5FC5\u987B\u63D0\u4F9B wxApi");
+        const callArgs = (step.args ?? []).map((arg) => resolveDeep(arg, context));
+        const returned = await adapter.callWxApi(wxApi, callArgs);
+        if (step.variable) {
+          const captured = typeof returned === "string" ? returned : JSON.stringify(returned) ?? "";
+          context.set(step.variable, captured);
+          result.extracted = { [step.variable]: captured };
+        }
+        break;
+      }
+      case "touch": {
+        if (typeof adapter.touch !== "function") {
+          throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301 touch`);
+        }
+        if (!locator) throw new TestPilotError("MISSING_LOCATOR", "touch \u5FC5\u987B\u63D0\u4F9B locator");
+        const touches = (step.touches ?? []).map((point) => resolveDeep(point, context));
+        const changed = (step.changedTouches ?? step.touches ?? []).map(
+          (point) => resolveDeep(point, context)
+        );
+        await adapter.touch(locator, step.phase ?? "", touches, changed);
+        break;
+      }
+      case "scroll": {
+        if (typeof adapter.scroll !== "function") {
+          throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301 scroll`);
+        }
+        await adapter.scroll(locator, step.scrollTop ?? 0);
+        break;
+      }
+      case "swipeTo": {
+        if (typeof adapter.swipeTo !== "function") {
+          throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301 swipeTo`);
+        }
+        await adapter.swipeTo(locator, step.index ?? 0);
+        break;
+      }
+      case "slideTo": {
+        if (typeof adapter.slideTo !== "function") {
+          throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301 slideTo`);
+        }
+        await adapter.slideTo(locator, Number(resolveValueText(step.value, context)));
+        break;
+      }
+      case "moveTo": {
+        if (typeof adapter.moveTo !== "function") {
+          throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301 moveTo`);
+        }
+        await adapter.moveTo(locator, step.x ?? 0, step.y ?? 0);
         break;
       }
       default: {
@@ -32250,6 +32478,42 @@ async function extractApiResponse(adapter, path) {
   if (!path) throw new TestPilotError("UNSUPPORTED_ACTION", "api \u7AEF extract \u9700\u8981\u63D0\u4F9B value(\u70B9\u53F7 JSON path)");
   return adapter.extractResponse(path);
 }
+function resolveValueText(value, context) {
+  return value === void 0 ? "" : context.resolve(String(value));
+}
+async function assertElementCount(adapter, locator, expected) {
+  const windowMs = expected > 0 ? ASSERT_POLL_MS : ABSENT_SETTLE_MS;
+  const startedAt = Date.now();
+  for (; ; ) {
+    const actual = await adapter.countElements(locator);
+    if (actual === expected) return;
+    if (Date.now() - startedAt > windowMs) {
+      throw new TestPilotError(
+        "ASSERTION_FAILED",
+        `\u5143\u7D20\u6570\u91CF\u65AD\u8A00\u5931\u8D25(\u7B49\u5F85 ${windowMs}ms):${describeLocator(locator)} \u5B9E\u9645 ${actual},\u671F\u671B ${expected}`
+      );
+    }
+    await delay(300);
+  }
+}
+async function assertElementAttribute(adapter, locator, step, context) {
+  const useProperty = step.property !== void 0;
+  const name = (useProperty ? step.property : step.attribute) ?? "";
+  const wanted = context.resolve(step.expected ?? "").trim();
+  const startedAt = Date.now();
+  for (; ; ) {
+    const actual = useProperty ? await adapter.getElementProperty(locator, name) : await adapter.getElementAttribute(locator, name);
+    const actualText = actual === void 0 || actual === null ? "<absent>" : String(actual);
+    if (actualText.trim() === wanted) return;
+    if (Date.now() - startedAt > ASSERT_POLL_MS) {
+      throw new TestPilotError(
+        "ASSERTION_FAILED",
+        `\u5C5E\u6027\u65AD\u8A00\u5931\u8D25(\u7B49\u5F85 ${ASSERT_POLL_MS}ms):${describeLocator(locator)} \u7684 ${useProperty ? "property" : "attribute"} "${name}" \u671F\u671B "${wanted}",\u5B9E\u9645\u4E3A "${actualText.slice(0, 200)}"`
+      );
+    }
+    await delay(300);
+  }
+}
 function resolveHeaders(headers, context) {
   if (!headers) return void 0;
   const resolved = {};
@@ -32522,6 +32786,24 @@ var ExecutionEngine = class {
     for (const [, adapter] of evidenceAdapters) {
       await adapter.restoreWxMock?.().catch(() => void 0);
     }
+    if (status !== "passed") {
+      for (const [target, adapter] of evidenceAdapters) {
+        if (typeof adapter.readDiagnostics !== "function") continue;
+        try {
+          const diagnostics = await adapter.readDiagnostics();
+          const hasContent = diagnostics.consoleLogs.length > 0 || diagnostics.exceptions.length > 0 || (diagnostics.pageStack?.length ?? 0) > 0 || diagnostics.systemInfo !== void 0;
+          if (!hasContent) continue;
+          caseResult.diagnostics = await artifacts.saveDiagnostics(
+            `${executionId}-${target}.json`,
+            diagnostics
+          );
+        } catch (err) {
+          await artifacts.logger.info(
+            `diagnostics dump failed for ${target}: ${err instanceof Error ? err.message : String(err)}`
+          );
+        }
+      }
+    }
     await bus.emit({
       type: "case-finished",
       runId,
@@ -32583,7 +32865,7 @@ function buildRunSummary(runId, startedAt, cases, options = {}) {
 }
 
 // ../../packages/execution-engine/src/engine/test-runner.ts
-import { writeFile as writeFile9 } from "node:fs/promises";
+import { writeFile as writeFile10 } from "node:fs/promises";
 import { join as join15, resolve as resolve6 } from "node:path";
 var TestRunner = class {
   resolver;
@@ -32647,7 +32929,7 @@ var TestRunner = class {
       ts: (/* @__PURE__ */ new Date()).toISOString()
     });
     await artifacts.logger.info(`run ${runId} finished: ${summary.status}`);
-    await writeFile9(join15(runDir, RESULT_FILE), JSON.stringify(summary, null, 2), "utf8");
+    await writeFile10(join15(runDir, RESULT_FILE), JSON.stringify(summary, null, 2), "utf8");
     return summary;
   }
 };
@@ -32686,6 +32968,7 @@ import { tmpdir } from "node:os";
 import { join as join16 } from "node:path";
 import { errors } from "playwright";
 var TEXT_WAIT_MS = 1e4;
+var LONG_PRESS_MS = 600;
 function delay2(ms) {
   return new Promise((resolve7) => setTimeout(resolve7, ms));
 }
@@ -32761,6 +33044,21 @@ var PlaywrightAdapter = class {
     const target = await this.toLocator(locator);
     await this.coded(() => target.click());
   }
+  /** 长按元素:web 端没有原生 longpress,以按住 LONG_PRESS_MS 的 click 近似 */
+  async longpress(locator) {
+    const target = await this.toLocator(locator);
+    await this.coded(() => target.click({ delay: LONG_PRESS_MS }));
+  }
+  /** 统计匹配元素数量(单次读取,不等待;重试语义由引擎负责) */
+  async countElements(locator) {
+    const target = await this.toLocator(locator);
+    return target.count();
+  }
+  /** 读取元素 attribute(不存在时为 null) */
+  async getElementAttribute(locator, name) {
+    const target = await this.toLocator(locator);
+    return this.coded(() => target.getAttribute(name));
+  }
   async input(locator, value) {
     const target = await this.toLocator(locator);
     await this.coded(() => target.fill(value));
@@ -32869,6 +33167,8 @@ 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 DIAGNOSTICS_BUFFER_MAX = 200;
+var CONSOLE_TEXT_LIMIT = 500;
 var automatorLauncher = {
   launch: async (options) => {
     try {
@@ -32884,6 +33184,20 @@ var automatorLauncher = {
 function delay3(ms) {
   return new Promise((resolve7) => setTimeout(resolve7, ms));
 }
+function serializeConsoleArg(value) {
+  if (typeof value === "string") return value;
+  try {
+    return JSON.stringify(value) ?? String(value);
+  } catch {
+    return String(value);
+  }
+}
+function stringifyDataValue(value) {
+  if (value === void 0 || value === null) return "";
+  if (typeof value === "string") return value;
+  if (typeof value === "object") return JSON.stringify(value);
+  return String(value);
+}
 async function connectWithRetry(wsEndpoint, timeoutMs) {
   const startedAt = Date.now();
   let lastError;
@@ -32944,6 +33258,10 @@ var MiniAppAdapter = class {
   target = "miniapp";
   program;
   requestCapture;
+  /** console / exception 环形缓冲(失败取证的数据源);重连后继续累积 */
+  consoleLogs = [];
+  exceptions = [];
+  diagnosticsAttachedTo;
   /** 拉起开发者工具并建立自动化连接;需幂等 */
   async launch() {
     if (this.program) return;
@@ -32952,6 +33270,7 @@ var MiniAppAdapter = class {
     };
     if (this.config.cliPath) launchOptions.cliPath = this.config.cliPath;
     this.program = await this.launcher.launch(launchOptions);
+    this.attachDiagnostics(this.program);
   }
   async navigate(url2) {
     const startedAt = Date.now();
@@ -33071,7 +33390,12 @@ var MiniAppAdapter = class {
       callbackName
     );
   }
-  /** 读取 mock 期间捕获的调用参数(最近调用在前) */
+  /** 读取 mock 期间捕获的调用参数(引擎在带 capture 的 mockWxApi step 后调用;最近调用在前) */
+  readWxApiCaptures() {
+    if (!this.wxMock) return void 0;
+    return { name: this.wxMock.api, calls: [...this.wxMock.captured].reverse() };
+  }
+  /** @deprecated 引擎已改用 readWxApiCaptures();保留按 API 名读取的旧入口 */
   readCapturedWxApiCalls(api) {
     return this.wxMock?.api === api ? [...this.wxMock.captured].reverse() : [];
   }
@@ -33097,13 +33421,146 @@ var MiniAppAdapter = class {
       return page.data(dataPath);
     });
   }
-  /** 写入页面 data 补丁(setData 驱动 onShow/onPullDownRefresh 等真实链路) */
-  async setData(patch) {
+  /** 写入 data 补丁(setData 驱动 onShow/onPullDownRefresh 等真实链路);locator 提供时为组件级 */
+  async setData(patch, locator) {
     await this.runWithReconnect(async () => {
+      if (locator) {
+        await (await this.element(locator)).setData(patch);
+        return;
+      }
       const page = await (await this.getProgram()).currentPage();
       await page.setData(patch);
     });
   }
+  /** 断言页面 data 路径的值包含 expected(数据绑定未完成时轮询等待) */
+  async assertData(dataPath, expected) {
+    await this.runWithReconnect(async () => {
+      const page = await (await this.getProgram()).currentPage();
+      const wanted = expected.trim();
+      const startedAt = Date.now();
+      for (; ; ) {
+        const actual = stringifyDataValue(await page.data(dataPath));
+        if (actual.includes(wanted)) return;
+        if (Date.now() - startedAt > TEXT_WAIT_MS2) {
+          throw new TestPilotError(
+            "ASSERTION_FAILED",
+            `\u9875\u9762 data \u65AD\u8A00\u5931\u8D25(\u7B49\u5F85 ${TEXT_WAIT_MS2}ms):data.${dataPath} \u671F\u671B\u5305\u542B "${wanted}",\u5B9E\u9645\u4E3A "${actual.slice(0, 200)}"`
+          );
+        }
+        await delay3(300);
+      }
+    });
+  }
+  // ---- miniapp 交互扩展(对照官方 automator Element / MiniProgram API)----
+  /** 长按元素 */
+  async longpress(locator) {
+    await this.runWithReconnect(async () => (await this.element(locator)).longpress());
+  }
+  /** 主动调用 wx.* API(如 setStorageSync / clearStorageSync 造前置状态) */
+  async callWxApi(api, args = []) {
+    return this.runWithReconnect(async () => {
+      const program2 = await this.getProgram();
+      if (typeof program2.callWxMethod !== "function") {
+        throw new TestPilotError(
+          "UNSUPPORTED_ACTION",
+          "\u5F53\u524D miniprogram-automator \u4E0D\u652F\u6301 callWxMethod,\u8BF7\u5347\u7EA7\u5FAE\u4FE1\u5F00\u53D1\u8005\u5DE5\u5177\u540E\u91CD\u8BD5"
+        );
+      }
+      return program2.callWxMethod(api, ...args);
+    });
+  }
+  /** 派发触摸事件(touchstart / touchmove / touchend) */
+  async touch(locator, phase, touches, changedTouches) {
+    await this.runWithReconnect(async () => {
+      const element = await this.element(locator);
+      const options = { touches: [...touches], changedTouches: [...changedTouches] };
+      if (phase === "touchstart") await element.touchstart(options);
+      else if (phase === "touchmove") await element.touchmove(options);
+      else if (phase === "touchend") await element.touchend(options);
+      else throw new TestPilotError("UNSUPPORTED_ACTION", `\u672A\u77E5\u89E6\u6478\u9636\u6BB5:${phase}`);
+    });
+  }
+  /** 滚动:locator 提供时滚动 scroll-view 元素,缺省滚动页面 */
+  async scroll(locator, scrollTop) {
+    await this.runWithReconnect(async () => {
+      if (locator) {
+        await (await this.element(locator)).scrollTo(scrollTop);
+        return;
+      }
+      const program2 = await this.getProgram();
+      if (typeof program2.pageScrollTo !== "function") {
+        throw new TestPilotError(
+          "UNSUPPORTED_ACTION",
+          "\u5F53\u524D miniprogram-automator \u4E0D\u652F\u6301 pageScrollTo,\u8BF7\u5347\u7EA7\u5FAE\u4FE1\u5F00\u53D1\u8005\u5DE5\u5177\u540E\u91CD\u8BD5"
+        );
+      }
+      await program2.pageScrollTo(scrollTop);
+    });
+  }
+  /** swiper 切换到指定页 */
+  async swipeTo(locator, index) {
+    await this.runWithReconnect(async () => (await this.element(locator)).swipeTo(index));
+  }
+  /** slider 滑到指定值 */
+  async slideTo(locator, value) {
+    await this.runWithReconnect(async () => (await this.element(locator)).slideTo(value));
+  }
+  /** movable-view 移动到指定坐标 */
+  async moveTo(locator, x, y) {
+    await this.runWithReconnect(async () => (await this.element(locator)).moveTo(x, y));
+  }
+  /** 统计匹配元素数量(单次读取;存在性/计数断言的重试语义由引擎负责) */
+  async countElements(locator) {
+    return this.runWithReconnect(async () => {
+      const page = await (await this.getProgram()).currentPage();
+      const elements = await page.$$(this.cssSelector(locator));
+      return elements.length;
+    });
+  }
+  /** 读取元素 attribute(不存在时为 undefined/null) */
+  async getElementAttribute(locator, name) {
+    return this.runWithReconnect(async () => (await this.element(locator)).attribute(name));
+  }
+  /** 读取元素 property(miniapp 自定义组件实例属性) */
+  async getElementProperty(locator, name) {
+    return this.runWithReconnect(async () => (await this.element(locator)).property(name));
+  }
+  /** 导出运行时诊断:console 尾部 / 异常 / 页面栈 / systemInfo(失败取证由引擎落盘) */
+  async readDiagnostics() {
+    const program2 = this.program;
+    const pageStack = await program2?.pageStack?.().catch(() => void 0);
+    const systemInfo = await program2?.systemInfo?.().catch(() => void 0);
+    return {
+      consoleLogs: [...this.consoleLogs],
+      exceptions: [...this.exceptions],
+      pageStack,
+      systemInfo
+    };
+  }
+  /** 订阅小程序 console / exception 事件(每个 program 实例只挂一次) */
+  attachDiagnostics(program2) {
+    if (this.diagnosticsAttachedTo === program2 || typeof program2.on !== "function") return;
+    this.diagnosticsAttachedTo = program2;
+    program2.on("console", (payload) => {
+      const record2 = payload ?? {};
+      const args = Array.isArray(record2.args) ? record2.args : [];
+      this.pushConsoleLog({
+        ts: (/* @__PURE__ */ new Date()).toISOString(),
+        type: typeof record2.type === "string" ? record2.type : "log",
+        text: args.map(serializeConsoleArg).join(" ").slice(0, CONSOLE_TEXT_LIMIT)
+      });
+    });
+    program2.on("exception", (payload) => {
+      const record2 = payload ?? {};
+      const message = typeof record2.message === "string" ? record2.message : String(payload);
+      this.exceptions.push(message.slice(0, CONSOLE_TEXT_LIMIT));
+      if (this.exceptions.length > DIAGNOSTICS_BUFFER_MAX) this.exceptions.shift();
+    });
+  }
+  pushConsoleLog(entry) {
+    this.consoleLogs.push(entry);
+    if (this.consoleLogs.length > DIAGNOSTICS_BUFFER_MAX) this.consoleLogs.shift();
+  }
   async screenshot() {
     return this.runWithReconnect(async () => {
       const base643 = await (await this.getProgram()).screenshot();
@@ -33617,7 +34074,7 @@ var TestPilotClient = class {
 };
 
 // src/commands/init/adapter-detector.ts
-import { existsSync as existsSync5, readFileSync } from "node:fs";
+import { existsSync as existsSync5, readFileSync as readFileSync2 } from "node:fs";
 import { join as join20 } from "node:path";
 async function detectAdapters(root, projectType) {
   const required2 = projectType === "hybrid" ? ["playwright", "wechatide"] : projectType === "wechat-miniapp" ? ["wechatide"] : projectType === "web" ? ["playwright"] : [];
@@ -33644,7 +34101,7 @@ function readPackageJsonDeps(root) {
   const file2 = join20(root, "package.json");
   if (!existsSync5(file2)) return void 0;
   try {
-    const pkg = JSON.parse(readFileSync(file2, "utf8"));
+    const pkg = JSON.parse(readFileSync2(file2, "utf8"));
     return { ...pkg.dependencies, ...pkg.devDependencies };
   } catch {
     return void 0;
@@ -33674,7 +34131,7 @@ async function collectEnvVarRefs(root) {
 }
 
 // src/commands/init/project-detector.ts
-import { existsSync as existsSync6, readdirSync as readdirSync2, readFileSync as readFileSync2 } from "node:fs";
+import { existsSync as existsSync6, readdirSync as readdirSync2, readFileSync as readFileSync3 } from "node:fs";
 import { basename, join as join22 } from "node:path";
 
 // src/lib/git.ts
@@ -33715,7 +34172,7 @@ function readPackageJson(root) {
   const file2 = join22(root, "package.json");
   if (!existsSync6(file2)) return void 0;
   try {
-    return JSON.parse(readFileSync2(file2, "utf8"));
+    return JSON.parse(readFileSync3(file2, "utf8"));
   } catch {
     return void 0;
   }
@@ -33782,8 +34239,8 @@ function adaptersFor(type) {
 }
 
 // src/commands/init/skill-installer.ts
-import { existsSync as existsSync7, readFileSync as readFileSync3 } from "node:fs";
-import { access as access2, cp, mkdir as mkdir12, writeFile as writeFile10 } from "node:fs/promises";
+import { existsSync as existsSync7, readFileSync as readFileSync4 } from "node:fs";
+import { access as access2, cp, mkdir as mkdir12, writeFile as writeFile11 } from "node:fs/promises";
 import { dirname as dirname9, join as join23 } from "node:path";
 import { fileURLToPath } from "node:url";
 var CORE_FILES = ["SKILL.md", "manifest.yaml"];
@@ -33799,7 +34256,7 @@ async function exists3(path) {
 function readManifestVersion(dir) {
   const manifestPath = join23(dir, "manifest.yaml");
   if (!existsSync7(manifestPath)) return void 0;
-  return /^version:\s*([^\s#]+)/m.exec(readFileSync3(manifestPath, "utf8"))?.[1];
+  return /^version:\s*([^\s#]+)/m.exec(readFileSync4(manifestPath, "utf8"))?.[1];
 }
 function resolveSkillSourceDir() {
   const fromEnv = process.env.TESTPILOT_SKILL_DIR;
@@ -33868,7 +34325,7 @@ async function installSkill(root, info, adapters) {
     const file2 = join23(refsDir, name);
     if (await exists3(file2)) continue;
     await mkdir12(refsDir, { recursive: true });
-    await writeFile10(file2, render(), "utf8");
+    await writeFile11(file2, render(), "utf8");
     references = "created";
   }
   return coreVersion ? { core, coreVersion, references, dest } : { core, references, dest };
@@ -33987,9 +34444,44 @@ async function runDoctor(root) {
       (item) => item.available ? ok(`${item.id}(${item.detail})`) : item.required ? warn(`${item.id} \u4E0D\u53EF\u7528`, item.detail) : warn(`${item.id} \u672A\u5B89\u88C5(\u53EF\u9009)`, item.detail)
     )
   );
+  const miniappProjectPath = config2?.miniapp?.projectPath;
+  if (miniappProjectPath) {
+    const miniappItems = [];
+    const cliPath = process.env.WECHAT_DEVTOOLS_CLI ?? config2?.miniapp?.cliPath ?? await findWechatDevToolsCli();
+    if (!cliPath) {
+      miniappItems.push(
+        warn("\u5FAE\u4FE1\u5F00\u53D1\u8005\u5DE5\u5177 CLI \u672A\u627E\u5230", "\u5B89\u88C5\u5FAE\u4FE1\u5F00\u53D1\u8005\u5DE5\u5177,\u6216\u8BBE\u7F6E WECHAT_DEVTOOLS_CLI \u6307\u5411 cli")
+      );
+    } else {
+      miniappItems.push(ok(`\u5F00\u53D1\u8005\u5DE5\u5177 CLI(${cliPath})`));
+      const loggedIn = await isWechatDevToolsLoggedIn(cliPath);
+      if (loggedIn === true) miniappItems.push(ok("\u5F00\u53D1\u8005\u5DE5\u5177\u5DF2\u767B\u5F55"));
+      else if (loggedIn === false)
+        miniappItems.push(
+          warn("\u5F00\u53D1\u8005\u5DE5\u5177\u672A\u767B\u5F55", "\u6253\u5F00\u5DE5\u5177\u626B\u7801\u767B\u5F55;CI \u65E0\u4EBA\u503C\u5B88\u7684\u767B\u5F55\u6001\u7EF4\u62A4\u89C1 docs/miniapp-testing.md")
+        );
+      else
+        miniappItems.push(
+          warn("\u5F00\u53D1\u8005\u5DE5\u5177\u767B\u5F55\u6001\u672A\u77E5", "cli islogin \u65E0\u6709\u6548\u8F93\u51FA;\u8BF7\u786E\u8BA4\u5DE5\u5177\u5DF2\u767B\u5F55\u4E14 \u5B89\u5168\u8BBE\u7F6E->\u670D\u52A1\u7AEF\u53E3 \u5DF2\u5F00\u542F")
+        );
+    }
+    const appidInfo = readMiniappProjectAppid(miniappProjectPath);
+    if (!appidInfo) {
+      miniappItems.push(warn("project.config.json \u7F3A\u5931", `${miniappProjectPath} \u4E0B\u672A\u627E\u5230,\u81EA\u52A8\u5316\u65E0\u6CD5\u5B9A\u4F4D\u9879\u76EE`));
+    } else if (!appidInfo.appid) {
+      miniappItems.push(warn("project.config.json \u7F3A\u5C11 appid", "\u81EA\u52A8\u5316\u4E0E\u9884\u89C8\u80FD\u529B\u53D7\u9650,\u8BF7\u586B\u5199\u771F\u5B9E appid"));
+    } else if (appidInfo.appid === "touristappid") {
+      miniappItems.push(
+        warn("appid \u4E3A touristappid(\u6E38\u5BA2\u6A21\u5F0F)", "\u90E8\u5206\u81EA\u52A8\u5316/\u9884\u89C8\u80FD\u529B\u53D7\u9650,\u8BF7\u5728 project.config.json \u586B\u5199\u771F\u5B9E appid")
+      );
+    } else {
+      miniappItems.push(ok(`\u5C0F\u7A0B\u5E8F appid(${appidInfo.appid})`));
+    }
+    push("Miniapp IDE", miniappItems);
+  }
   const refs = await collectEnvVarRefs(root);
   const envItems = refs.map(
-    (name) => process.env[name] !== void 0 ? ok(name) : error62(`${name} missing`, "\u5728\u8FD0\u884C\u73AF\u5883(.env / CI Secret)\u4E2D\u8BBE\u7F6E")
+    (name) => process.env[name] !== void 0 ? ok(name) : error62(`${name} missing`, "\u5728 .env.testing(\u65E7\u7248\u672C\u4E3A .env,\u8BF7\u8FC1\u79FB)\u6216 CI Secret \u4E2D\u8BBE\u7F6E")
   );
   const serverConfigured = (process.env.TESTPILOT_SERVER_URL ?? config2?.server?.baseUrl) !== void 0;
   const accountRefs = [
@@ -34064,7 +34556,7 @@ function makeDoctorCommand() {
 import { join as join27 } from "node:path";
 
 // src/commands/init/config-initializer.ts
-import { access as access3, mkdir as mkdir13, readFile as readFile10, writeFile as writeFile11 } from "node:fs/promises";
+import { access as access3, mkdir as mkdir13, readFile as readFile10, writeFile as writeFile12 } from "node:fs/promises";
 import { basename as basename2, join as join25 } from "node:path";
 async function exists4(path) {
   try {
@@ -34096,7 +34588,7 @@ environment:
   staging:
     baseUrl: \${STAGING_BASE_URL}
 
-# Case \u53EF\u89C1\u7684\u9879\u76EE\u53D8\u91CF\u767D\u540D\u5355(\u503C\u6765\u81EA .env / CI Secret;Case \u7528 \${variable.<name>} \u5F15\u7528)
+# Case \u53EF\u89C1\u7684\u9879\u76EE\u53D8\u91CF\u767D\u540D\u5355(\u503C\u6765\u81EA .env.testing / CI Secret;Case \u7528 \${variable.<name>} \u5F15\u7528)
 # variables:
 #   ppmProjectId: \${PPM_PROJECT_ID}
 
@@ -34113,19 +34605,20 @@ ${adapters}
 # server:
 #   baseUrl: http://127.0.0.1:3000
 
-# Web \u7AEF:navigate \u76F8\u5BF9 url \u7684\u57FA\u51C6\u5730\u5740(\u6BCF\u4EBA\u7684\u5730\u5740\u4E0D\u540C,\u503C\u653E .env)
+# Web \u7AEF:navigate \u76F8\u5BF9 url \u7684\u57FA\u51C6\u5730\u5740(\u6BCF\u4EBA\u7684\u5730\u5740\u4E0D\u540C,\u503C\u653E .env.testing)
 # web:
 #   baseUrl: \${WEB_BASE_URL}
 
-# \u5C0F\u7A0B\u5E8F\u7AEF:\u586B\u5165\u5C0F\u7A0B\u5E8F\u9879\u76EE\u76EE\u5F55\u540E\u5373\u53EF\u6267\u884C target: miniapp \u7684\u6B65\u9AA4(\u8DEF\u5F84\u6BCF\u4EBA\u4E0D\u540C,\u8D70 .env)
+# \u5C0F\u7A0B\u5E8F\u7AEF:\u586B\u5165\u5C0F\u7A0B\u5E8F\u9879\u76EE\u76EE\u5F55\u540E\u5373\u53EF\u6267\u884C target: miniapp \u7684\u6B65\u9AA4(\u8DEF\u5F84\u6BCF\u4EBA\u4E0D\u540C,\u8D70 .env.testing)
 # miniapp:
 #   projectPath: \${MINIAPP_PROJECT_PATH}
 #   cliPath: \${MINIAPP_CLI_PATH}
 `;
 }
-function renderDotEnvExample() {
-  return `# TestPilot \u73AF\u5883\u53D8\u91CF\u793A\u4F8B:\u590D\u5236\u4E3A .env \u5E76\u586B\u5165\u771F\u5B9E\u503C(.env \u542B\u654F\u611F\u4FE1\u606F,\u4E0D\u8981\u63D0\u4EA4\u5230 Git)
-# \u4F18\u5148\u7EA7:\u771F\u5B9E\u73AF\u5883\u53D8\u91CF > .env \u6587\u4EF6;testpilot.yaml \u4E2D\u7684 \${VAR} \u5F15\u7528\u8FD0\u884C\u65F6\u81EA\u52A8\u6CE8\u5165
+function renderDotEnvTesting() {
+  return `# TestPilot \u6D4B\u8BD5\u73AF\u5883\u53D8\u91CF(CLI \u81EA\u52A8\u52A0\u8F7D\u672C\u6587\u4EF6,\u76F4\u63A5\u586B\u5165\u771F\u5B9E\u503C\u5373\u53EF,\u65E0\u9700\u590D\u5236)
+# \u53EA\u653E\u6D4B\u8BD5\u76F8\u5173\u53D8\u91CF,\u4E0E\u524D\u7AEF\u9879\u76EE\u81EA\u8EAB\u7684 .env \u4E92\u4E0D\u5F71\u54CD;\u672C\u6587\u4EF6\u542B\u6D4B\u8BD5\u51ED\u636E,\u5DF2\u52A0\u5165 .gitignore
+# \u4F18\u5148\u7EA7:\u771F\u5B9E\u73AF\u5883\u53D8\u91CF > \u672C\u6587\u4EF6;testpilot.yaml \u4E2D\u7684 \${VAR} \u5F15\u7528\u8FD0\u884C\u65F6\u81EA\u52A8\u6CE8\u5165
 
 # \u73AF\u5883\u914D\u7F6E(environment \u6BB5)
 TEST_BASE_URL=http://127.0.0.1:8080
@@ -34145,7 +34638,7 @@ STAGING_BASE_URL=https://staging.example.com
 async function ensureGitignoreEntry(root, entry, comment = "TestPilot \u672C\u5730\u73AF\u5883\u53D8\u91CF") {
   const gitignorePath = join25(root, ".gitignore");
   if (!await exists4(gitignorePath)) {
-    await writeFile11(gitignorePath, `# ${comment}
+    await writeFile12(gitignorePath, `# ${comment}
 ${entry}
 `, "utf8");
     return "created";
@@ -34155,7 +34648,7 @@ ${entry}
     return "exists";
   }
   const separator = content.endsWith("\n") || content === "" ? "" : "\n";
-  await writeFile11(gitignorePath, `${content}${separator}# ${comment}
+  await writeFile12(gitignorePath, `${content}${separator}# ${comment}
 ${entry}
 `, "utf8");
   return "updated";
@@ -34164,21 +34657,22 @@ async function initTestPilotConfig(root, info, adapters) {
   const yamlPath = join25(root, "testpilot.yaml");
   let yaml = "reused";
   if (!await exists4(yamlPath)) {
-    await writeFile11(yamlPath, renderTestpilotYaml(info), "utf8");
+    await writeFile12(yamlPath, renderTestpilotYaml(info), "utf8");
     yaml = "created";
   }
-  const envExamplePath = join25(root, ".env.example");
-  let envExample = "reused";
-  if (!await exists4(envExamplePath)) {
-    await writeFile11(envExamplePath, renderDotEnvExample(), "utf8");
-    envExample = "created";
+  const envTestingPath = join25(root, ENV_TESTING_FILE);
+  let envTesting = "reused";
+  if (!await exists4(envTestingPath)) {
+    await writeFile12(envTestingPath, renderDotEnvTesting(), "utf8");
+    envTesting = "created";
   }
-  const gitignore = await ensureGitignoreEntry(root, ".env");
+  const gitignore = await ensureGitignoreEntry(root, ENV_TESTING_FILE);
+  await ensureGitignoreEntry(root, ".env");
   const runtimeDir = join25(root, ".testpilot", "artifacts");
   await mkdir13(runtimeDir, { recursive: true });
   const keep = join25(runtimeDir, ".gitkeep");
   if (!await exists4(keep)) {
-    await writeFile11(keep, "", "utf8");
+    await writeFile12(keep, "", "utf8");
   }
   const existing = await readProjectLink(root);
   const defaultAdapter = defaultAdapterFor(info.type);
@@ -34202,7 +34696,7 @@ async function initTestPilotConfig(root, info, adapters) {
     runtimeDir: join25(root, ".testpilot"),
     projectLink: link,
     projectLinkFile,
-    envExample,
+    envTesting,
     gitignore
   };
 }
@@ -34235,7 +34729,7 @@ function randomId() {
 
 // src/commands/init/test-structure.ts
 import { existsSync as existsSync9, readdirSync as readdirSync3 } from "node:fs";
-import { mkdir as mkdir14, writeFile as writeFile12 } from "node:fs/promises";
+import { mkdir as mkdir14, writeFile as writeFile13 } from "node:fs/promises";
 import { join as join26 } from "node:path";
 async function initTestStructure(root, _info) {
   const dirs = {
@@ -34255,7 +34749,7 @@ async function initTestStructure(root, _info) {
   }
   for (const [name, dir] of Object.entries(dirs)) {
     if (!existed[name] && readdirSync3(dir).length === 0) {
-      await writeFile12(join26(dir, ".gitkeep"), "", "utf8").catch(() => void 0);
+      await writeFile13(join26(dir, ".gitkeep"), "", "utf8").catch(() => void 0);
     }
   }
   return {
@@ -34294,10 +34788,10 @@ async function runInit(root, options = {}) {
   const serverMode = config2.projectLink.serverUrl ? `Server:${config2.projectLink.serverUrl}` : "\u672C\u5730\u6A21\u5F0F";
   console.log(`\u2713 \u9879\u76EE\u5173\u8054          ${config2.projectLink.projectId}(${serverMode})`);
   console.log(
-    config2.envExample === "created" ? "\u2713 \u73AF\u5883\u53D8\u91CF\u793A\u4F8B      .env.example(\u590D\u5236\u4E3A .env \u586B\u5165\u771F\u5B9E\u503C)" : "\u2713 \u73AF\u5883\u53D8\u91CF\u793A\u4F8B      .env.example(\u5DF2\u5B58\u5728,\u4FDD\u7559)"
+    config2.envTesting === "created" ? "\u2713 \u6D4B\u8BD5\u73AF\u5883\u53D8\u91CF      .env.testing(\u76F4\u63A5\u586B\u5165\u771F\u5B9E\u503C,CLI \u81EA\u52A8\u52A0\u8F7D)" : "\u2713 \u6D4B\u8BD5\u73AF\u5883\u53D8\u91CF      .env.testing(\u5DF2\u5B58\u5728,\u4FDD\u7559)"
   );
   console.log(
-    config2.gitignore === "exists" ? "\u2713 Git \u5FFD\u7565          .env(\u5DF2\u5728 .gitignore)" : `\u2713 Git \u5FFD\u7565          .env(\u5DF2\u5199\u5165 .gitignore)`
+    config2.gitignore === "exists" ? "\u2713 Git \u5FFD\u7565          .env.testing(\u5DF2\u5728 .gitignore)" : `\u2713 Git \u5FFD\u7565          .env.testing(\u5DF2\u5199\u5165 .gitignore)`
   );
   const testStructure = await initTestStructure(root, project);
   const reuseNote = project.existingE2eDirs.filter((dir) => dir !== "tests/e2e");
@@ -34389,7 +34883,7 @@ function makeListCommand() {
 }
 
 // src/commands/report.ts
-import { exec } from "node:child_process";
+import { exec as exec2 } from "node:child_process";
 function makeReportCommand() {
   return new Command("report").description("\u751F\u6210\u6D4B\u8BD5\u62A5\u544A(JSON + HTML)").option("--run <id>", "\u8FD0\u884C\u8BB0\u5F55 ID,\u9ED8\u8BA4\u6700\u8FD1\u4E00\u6B21").option("--open", "\u751F\u6210\u540E\u5728\u6D4F\u89C8\u5668\u6253\u5F00", false).option("--summary", "\u751F\u6210\u8DE8 run \u6C47\u603B\u62A5\u544A(summary.html + summary.json)", false).option("--last <n>", "\u6C47\u603B\u7EDF\u8BA1\u7A97\u53E3:\u6700\u8FD1 N \u6B21\u8FD0\u884C", "30").action(async (options) => {
     const client = new TestPilotClient();
@@ -34418,7 +34912,7 @@ function makeReportCommand() {
 function openInBrowser(file2) {
   const command = process.platform === "win32" ? `start "" "${file2}"` : process.platform === "darwin" ? `open "${file2}"` : `xdg-open "${file2}"`;
   return new Promise((resolvePromise) => {
-    exec(command, () => resolvePromise());
+    exec2(command, () => resolvePromise());
   });
 }
 
@@ -34563,10 +35057,13 @@ function makeSyncMetadataCommand() {
 }
 
 // src/commands/update.ts
-import { writeFile as writeFile13 } from "node:fs/promises";
+import { readFile as readFile11, writeFile as writeFile14 } from "node:fs/promises";
 import { join as join29 } from "node:path";
+function varNames(content) {
+  return new Set([...content.matchAll(/^#?\s*([A-Z][A-Z0-9_]+)=/gm)].map((match) => match[1]));
+}
 function makeUpdateCommand() {
-  const update = new Command("update").description("\u540C\u6B65 TestPilot \u63A5\u5165\u7269\u5230\u5F53\u524D CLI \u7248\u672C(Skill / .env.example;\u4E0D\u89E6\u78B0 .env \u4E0E\u7528\u4F8B)").option("--force", "Skill \u7248\u672C\u4E00\u81F4\u65F6\u4E5F\u5F3A\u5236\u8986\u76D6\u672C\u5730\u4FEE\u6539", false).action(async (options) => {
+  const update = new Command("update").description("\u540C\u6B65 TestPilot \u63A5\u5165\u7269\u5230\u5F53\u524D CLI \u7248\u672C(Skill / .env.testing;\u4E0D\u89E6\u78B0 .env \u4E0E\u7528\u4F8B)").option("--force", "Skill \u7248\u672C\u4E00\u81F4\u65F6\u4E5F\u5F3A\u5236\u8986\u76D6\u672C\u5730\u4FEE\u6539", false).action(async (options) => {
     const root = process.cwd();
     const dest = join29(".agents", "skills", "testpilot");
     const skill = await syncSkillFiles(root, { force: options.force });
@@ -34582,13 +35079,25 @@ function makeUpdateCommand() {
       default:
         console.log(`\u2713 Skill \u5DF2\u662F\u6700\u65B0   v${skill.bundledVersion ?? "?"}`);
     }
-    await writeFile13(join29(root, ".env.example"), renderDotEnvExample(), "utf8");
-    console.log("\u2713 .env.example     \u5DF2\u540C\u6B65\u4E3A\u5F53\u524D\u7248\u672C\u7684\u793A\u4F8B(.env \u4E0D\u53D7\u5F71\u54CD)");
-    const gitignore = await ensureGitignoreEntry(root, ".env");
+    const envPath = join29(root, ENV_TESTING_FILE);
+    const template = renderDotEnvTesting();
+    const existing = await readFile11(envPath, "utf8").catch(() => void 0);
+    if (existing === void 0) {
+      await writeFile14(envPath, template, "utf8");
+      console.log(`\u2713 ${ENV_TESTING_FILE}  \u5DF2\u751F\u6210(\u76F4\u63A5\u586B\u5165\u771F\u5B9E\u503C,CLI \u81EA\u52A8\u52A0\u8F7D)`);
+    } else {
+      console.log(`\u2713 ${ENV_TESTING_FILE}  \u5DF2\u5B58\u5728,\u4FDD\u7559\u7528\u6237\u5185\u5BB9`);
+      const missing = [...varNames(template)].filter((name) => !varNames(existing).has(name));
+      if (missing.length > 0) {
+        console.log(`  \u63D0\u793A:\u5F53\u524D\u7248\u672C\u6A21\u677F\u65B0\u589E\u53D8\u91CF,\u53EF\u6309\u9700\u8865\u5165:${missing.join(", ")}`);
+      }
+    }
+    const gitignore = await ensureGitignoreEntry(root, ENV_TESTING_FILE);
+    await ensureGitignoreEntry(root, ".env");
     console.log(
-      gitignore === "exists" ? "\u2713 .gitignore       \u5DF2\u5FFD\u7565 .env" : "\u2713 .gitignore       \u5DF2\u8FFD\u52A0\u5FFD\u7565 .env"
+      gitignore === "exists" ? `\u2713 .gitignore       \u5DF2\u5FFD\u7565 ${ENV_TESTING_FILE}` : `\u2713 .gitignore       \u5DF2\u8FFD\u52A0\u5FFD\u7565 ${ENV_TESTING_FILE}`
     );
-    console.log("\u63D0\u793A:\u63D0\u4EA4 .agents/skills/ \u4E0E .env.example \u7684\u53D8\u66F4,\u56E2\u961F\u4E0E AI \u5373\u53EF\u4F7F\u7528\u6700\u65B0\u80FD\u529B");
+    console.log("\u63D0\u793A:\u63D0\u4EA4 .agents/skills/ \u7684\u53D8\u66F4,\u56E2\u961F\u4E0E AI \u5373\u53EF\u4F7F\u7528\u6700\u65B0\u80FD\u529B");
   });
   return update;
 }
@@ -34629,7 +35138,7 @@ function makeValidateCommand() {
 }
 
 // src/cli.ts
-var CLI_VERSION = "0.7.1";
+var CLI_VERSION = "0.7.2";
 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", () => {