csspilot 0.3.2 → 0.5.0

package/dist/bin.js

@@ -15418,7 +15418,7 @@ var recursive = /* @__PURE__ */ new WeakMap();
 var NONE = 0;
 var ASSUMED = 1;
 var PROVEN = 2;
-function isRecursive(inst, stack, resolve5) {
+function isRecursive(inst, stack, resolve6) {
   const cached2 = recursive.get(inst);
   if (cached2 !== void 0)
     return cached2 ? PROVEN : NONE;
@@ -15428,7 +15428,7 @@ function isRecursive(inst, stack, resolve5) {
   let result = NONE;
   const check2 = (child) => {
     if (result !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve5);
+      const answer = isRecursive(child, stack, resolve6);
       if (answer > result)
         result = answer;
     }
@@ -15439,7 +15439,7 @@ function isRecursive(inst, stack, resolve5) {
       const desc = Object.getOwnPropertyDescriptor(sh, key);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve5) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve6) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -15506,7 +15506,7 @@ function isRecursive(inst, stack, resolve5) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve5 ? inst._zod.innerType : void 0);
+      const inner = def._cachedInner ?? (resolve6 ? inst._zod.innerType : void 0);
       merge2(inner ? isRecursive(inner, stack, false) : ASSUMED);
       break;
     }
@@ -30148,7 +30148,10 @@ async function loadTestpilotConfig(cwd = process.cwd()) {
       baseUrl: parsed.api.baseUrl === void 0 ? void 0 : interpolateEnvRefs(parsed.api.baseUrl),
       timeoutMs: parsed.api.timeoutMs
     } : void 0,
-    miniapp: parsed.miniapp
+    miniapp: parsed.miniapp ? {
+      projectPath: parsed.miniapp.projectPath === void 0 ? void 0 : interpolateEnvRefs(parsed.miniapp.projectPath),
+      cliPath: parsed.miniapp.cliPath === void 0 ? void 0 : interpolateEnvRefs(parsed.miniapp.cliPath)
+    } : void 0
   };
 }
 
@@ -30335,11 +30338,11 @@ function makeCiCommand() {
 }
 
 // src/commands/init/doctor.ts
-import { existsSync as existsSync6 } from "node:fs";
-import { join as join21 } from "node:path";
+import { existsSync as existsSync7 } from "node:fs";
+import { join as join24 } from "node:path";
 
 // ../../packages/sdk/src/client.ts
-import { isAbsolute as isAbsolute3, join as join17 } from "node:path";
+import { isAbsolute as isAbsolute3, join as join19 } from "node:path";
 
 // ../../packages/sdk/src/cases.ts
 import { mkdir as mkdir3, readFile as readFile3, readdir, stat as stat2, writeFile as writeFile3 } from "node:fs/promises";
@@ -30713,12 +30716,62 @@ async function writeCaseFile(file2, source, options = {}) {
 }
 
 // ../../packages/sdk/src/reports.ts
-import { readFile as readFile6 } from "node:fs/promises";
-import { join as join16 } from "node:path";
+import { readFile as readFile7 } from "node:fs/promises";
+import { join as join18 } from "node:path";
 
 // ../../packages/reporter/src/report.ts
 import { writeFile as writeFile4 } from "node:fs/promises";
-import { join as join7, resolve as resolve3 } from "node:path";
+import { dirname as dirname2, join as join8, resolve as resolve3 } from "node:path";
+
+// ../../packages/reporter/src/classify.ts
+var FAILURE_CATEGORIES = [
+  { id: "assert", label: "\u65AD\u8A00\u5931\u8D25" },
+  { id: "element", label: "\u5143\u7D20\u672A\u627E\u5230" },
+  { id: "adapter", label: "Adapter \u95EE\u9898" },
+  { id: "env", label: "\u73AF\u5883 / \u8FDE\u63A5" },
+  { id: "timeout", label: "\u8D85\u65F6" },
+  { id: "other", label: "\u5176\u4ED6" }
+];
+function categoryLabel(id) {
+  return FAILURE_CATEGORIES.find((item) => item.id === id)?.label ?? id;
+}
+var RULES = [
+  { id: "assert", pattern: /断言失败|AssertionError|expect\(.+\)\.to/i },
+  { id: "element", pattern: /未找到元素|等待元素超时|waiting for locator|waiting for selector|element not found/i },
+  { id: "adapter", pattern: /未注册 target|ADAPTER_NOT_FOUND|无法定位 TestPilot Skill/i },
+  { id: "env", pattern: /net::ERR|ECONNREFUSED|Connection closed|Failed to launch|服务端口|不可达|ENOTFOUND|EACCES/i },
+  { id: "timeout", pattern: /timeout|超时/i }
+];
+function classifyFailure(message) {
+  if (!message) return "other";
+  for (const rule of RULES) {
+    if (rule.pattern.test(message)) return rule.id;
+  }
+  return "other";
+}
+
+// ../../packages/reporter/src/history.ts
+import { readFile as readFile4, readdir as readdir2 } from "node:fs/promises";
+import { join as join7 } from "node:path";
+async function collectHistory(runsRoot2, skipRunId, limit = 12) {
+  const entries = (await readdir2(runsRoot2).catch(() => [])).filter((name) => /^\d{8}-\d{3}$/.test(name) && name !== skipRunId).sort().slice(-limit);
+  const points = [];
+  for (const runId of entries) {
+    try {
+      const summary = JSON.parse(await readFile4(join7(runsRoot2, runId, "result.json"), "utf8"));
+      points.push({
+        runId,
+        startedAt: summary.startedAt,
+        status: summary.status ?? "unknown",
+        passed: summary.totals?.passed ?? 0,
+        failed: summary.totals?.failed ?? 0,
+        durationMs: summary.durationMs
+      });
+    } catch {
+    }
+  }
+  return points;
+}
 
 // ../../packages/reporter/src/summary.ts
 function toSummaryView(summary) {
@@ -30737,40 +30790,201 @@ function toSummaryView(summary) {
 }
 
 // ../../packages/reporter/src/report.ts
-async function writeReports(runDir, summary) {
+var HISTORY_LIMIT = 12;
+async function writeReports(runDir, summary, options = {}) {
   const dir = resolve3(runDir);
-  const jsonPath = join7(dir, "report.json");
-  const htmlPath = join7(dir, "report.html");
-  const payload = { generatedAt: (/* @__PURE__ */ new Date()).toISOString(), summary };
-  await writeFile4(jsonPath, JSON.stringify(payload, null, 2), "utf8");
-  await writeFile4(htmlPath, renderHtml(summary), "utf8");
+  const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const history = options.history ?? await collectHistory(dirname2(dir), summary.runId, options.historyLimit ?? HISTORY_LIMIT);
+  const failures = [];
+  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;
+      if (category) {
+        categories.add(category);
+        failures.push({
+          category,
+          label: categoryLabel(category),
+          caseId: item.caseId,
+          index: step.index,
+          message: step.error ?? ""
+        });
+      }
+      return { ...step, category };
+    });
+    return { ...item, steps, categories: [...categories] };
+  });
+  const categoryLabels = {};
+  for (const item of FAILURE_CATEGORIES) categoryLabels[item.id] = item.label;
+  const data = {
+    generatedAt,
+    summary: { ...summary, cases },
+    history,
+    failures,
+    view: toSummaryView(summary),
+    categoryLabels
+  };
+  const jsonPath = join8(dir, "report.json");
+  const htmlPath = join8(dir, "report.html");
+  await writeFile4(jsonPath, JSON.stringify(data, null, 2), "utf8");
+  await writeFile4(htmlPath, renderHtml(data), "utf8");
   return { json: jsonPath, html: htmlPath };
 }
-function renderHtml(summary) {
-  const view = toSummaryView(summary);
+function categoryChips(data) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const failure2 of data.failures) {
+    counts.set(failure2.category, (counts.get(failure2.category) ?? 0) + 1);
+  }
+  const chips = [
+    '<span class="chip active" data-group="status" data-value="all">\u5168\u90E8\u72B6\u6001</span>',
+    '<span class="chip" data-group="status" data-value="failed">\u4EC5\u5931\u8D25</span>'
+  ];
+  for (const item of FAILURE_CATEGORIES) {
+    const count = counts.get(item.id) ?? 0;
+    if (count > 0) {
+      chips.push(
+        `<span class="chip" data-group="cat" data-value="${item.id}">${escapeHtml(item.label)}(${count})</span>`
+      );
+    }
+  }
+  return chips.join("\n");
+}
+function renderHtml(data) {
+  const view = toSummaryView(data.summary);
+  const summary = data.summary;
+  const trendSvg = renderTrend(data);
   const casesHtml = summary.cases.map((item) => caseHtml(item)).join("\n");
+  const chips = categoryChips(data);
   return `<!doctype html>
 <html lang="zh-CN">
 <head>
 <meta charset="utf-8" />
 <title>TestPilot Report ${escapeHtml(summary.runId)}</title>
 <style>
-  body { font-family: system-ui, sans-serif; margin: 24px; color: #1f2328; }
-  h1 { font-size: 20px; } h2 { font-size: 16px; margin-top: 24px; }
-  .badge { padding: 2px 10px; border-radius: 10px; color: #fff; font-size: 13px; }
-  .passed { background: #1a7f37; } .failed { background: #cf222e; } .skipped { background: #6e7781; }
-  table { border-collapse: collapse; width: 100%; margin: 8px 0 16px; font-size: 13px; }
-  th, td { border: 1px solid #d0d7de; padding: 6px 10px; text-align: left; }
-  td.num { text-align: right; }
-  .error { color: #cf222e; white-space: pre-wrap; }
-  a { color: #0969da; }
-  code { background: #f6f8fa; padding: 1px 4px; border-radius: 4px; }
+  :root { --ok:#1a7f37; --fail:#cf222e; --skip:#6e7781; --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); } .skipped { background: var(--skip); }
+  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; }
+  .card b { font-size: 20px; display: block; }
+  .card span { color: var(--muted); font-size: 12px; }
+  .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; }
+  input#q { flex: 1; min-width: 180px; padding: 5px 10px; border: 1px solid var(--line); border-radius: 6px; font-size: 13px; }
+  .btn { border: 1px solid var(--line); background: #fff; border-radius: 6px; padding: 4px 10px; font-size: 12px; cursor: pointer; }
+  #count { color: var(--muted); font-size: 12px; margin-left: auto; }
+  details.case { background: #fff; border: 1px solid var(--line); border-radius: 8px; margin: 10px 0; }
+  details.case > summary { cursor: pointer; padding: 10px 14px; font-size: 14px; list-style: none; }
+  details.case > summary::-webkit-details-marker { display: none; }
+  details.case > summary:hover { background: #f6f8fa; }
+  table { border-collapse: collapse; width: 100%; font-size: 13px; }
+  th, td { border-top: 1px solid var(--line); padding: 6px 10px; text-align: left; vertical-align: top; }
+  td.num { text-align: right; white-space: nowrap; }
+  .error { color: var(--fail); white-space: pre-wrap; }
+  a { color: #0969da; text-decoration: none; }
+  .trend { background: #fff; border: 1px solid var(--line); border-radius: 8px; padding: 12px; overflow-x: auto; }
+  .muted { color: var(--muted); }
+  .hide { display: none !important; }
+  .meta { color: var(--muted); font-size: 12px; margin: 6px 0; }
 </style>
 </head>
 <body>
-<h1>TestPilot \u62A5\u544A <span class="badge ${summary.status}">${summary.status}</span></h1>
-<p>run <code>${escapeHtml(summary.runId)}</code> \xB7 \u7528\u4F8B ${view.cases.passed}\u2713 / ${view.cases.failed}\u2717 \xB7 \u6B65\u9AA4 ${view.steps.passed}\u2713 ${view.steps.failed}\u2717 ${view.steps.skipped}\u21B7 \xB7 \u8017\u65F6 ${(view.durationMs / 1e3).toFixed(1)}s</p>
-${casesHtml}
+<div class="wrap">
+  <h1>TestPilot \u6D4B\u8BD5\u62A5\u544A <span class="badge ${summary.status}">${summary.status}</span></h1>
+  <p class="meta">run <code>${escapeHtml(summary.runId)}</code> \xB7 \u751F\u6210\u4E8E ${escapeHtml(data.generatedAt)} \xB7 \u8017\u65F6 ${(view.durationMs / 1e3).toFixed(1)}s</p>
+
+  <div class="cards">
+    <div class="card"><b>${view.cases.passed}<span style="color:var(--ok)"> \u2713</span></b><span>\u901A\u8FC7\u7528\u4F8B</span></div>
+    <div class="card"><b>${view.cases.failed}<span style="color:var(--fail)"> \u2717</span></b><span>\u5931\u8D25\u7528\u4F8B</span></div>
+    <div class="card"><b>${view.steps.passed}<span style="color:var(--ok)"> \u2713</span></b><span>\u901A\u8FC7\u6B65\u9AA4</span></div>
+    <div class="card"><b>${view.steps.failed}<span style="color:var(--fail)"> \u2717</span></b><span>\u5931\u8D25\u6B65\u9AA4</span></div>
+    <div class="card"><b>${view.steps.skipped} \u21B7</b><span>\u8DF3\u8FC7\u6B65\u9AA4</span></div>
+  </div>
+
+  <h2>\u5386\u53F2\u8D8B\u52BF(\u6700\u8FD1 ${data.history.length + 1} \u6B21\u8FD0\u884C)</h2>
+  <div class="trend">${trendSvg}</div>
+
+  <h2>\u5931\u8D25\u5206\u7C7B</h2>
+  <div class="toolbar" id="cat-chips">${chips}</div>
+
+  <h2>\u7528\u4F8B</h2>
+  <div class="toolbar">
+    <input id="q" placeholder="\u641C\u7D22\u7528\u4F8B id / \u540D\u79F0 / \u6587\u4EF6\u2026" />
+    <button class="btn" id="expand">\u5C55\u5F00\u5168\u90E8</button>
+    <button class="btn" id="collapse">\u6536\u8D77\u5168\u90E8</button>
+    <span id="count"></span>
+  </div>
+  <div id="cases">${casesHtml}</div>
+</div>
+
+<script id="report-data" type="application/json">${embedJson(data)}</script>
+<script>
+(function () {
+  var data = JSON.parse(document.getElementById('report-data').textContent);
+  var state = { status: 'all', cat: 'all', q: '' };
+  var labels = data.categoryLabels || {};
+
+  function setChip(group, value) {
+    document.querySelectorAll('.chip[data-group="' + group + '"]').forEach(function (chip) {
+      chip.classList.toggle('active', chip.getAttribute('data-value') === value);
+    });
+  }
+
+  function matches(card) {
+    if (state.status !== 'all' && card.getAttribute('data-status') !== state.status) return false;
+    if (state.cat !== 'all' && (',' + (card.getAttribute('data-cats') || '') + ',').indexOf(',' + state.cat + ',') === -1) return false;
+    if (state.q) {
+      var text = (card.getAttribute('data-search') || '').toLowerCase();
+      if (text.indexOf(state.q.toLowerCase()) === -1) return false;
+    }
+    return true;
+  }
+
+  function apply() {
+    var cards = document.querySelectorAll('details.case');
+    var shown = 0;
+    cards.forEach(function (card) {
+      var show = matches(card);
+      card.classList.toggle('hide', !show);
+      if (show) shown++;
+    });
+    var count = document.getElementById('count');
+    if (count) count.textContent = shown + ' / ' + cards.length + ' \u7528\u4F8B';
+  }
+
+  document.querySelectorAll('.chip').forEach(function (chip) {
+    chip.addEventListener('click', function () {
+      var group = chip.getAttribute('data-group');
+      var value = chip.getAttribute('data-value');
+      if (group === 'status') state.status = value;
+      if (group === 'cat') state.cat = value;
+      setChip(group, value);
+      apply();
+    });
+  });
+  var q = document.getElementById('q');
+  if (q) q.addEventListener('input', function () { state.q = q.value.trim(); apply(); });
+  var expand = document.getElementById('expand');
+  if (expand) expand.addEventListener('click', function () {
+    document.querySelectorAll('details.case').forEach(function (c) { c.open = true; });
+  });
+  var collapse = document.getElementById('collapse');
+  if (collapse) collapse.addEventListener('click', function () {
+    document.querySelectorAll('details.case').forEach(function (c) { c.open = false; });
+  });
+
+  function failedSteps(card) {
+    return data.summary.cases.find(function (c) { return c.caseId === card; });
+  }
+  apply();
+})();
+</script>
 </body>
 </html>`;
 }
@@ -30781,18 +30995,27 @@ function caseHtml(item) {
   if (item.video) links.push(`<a href="${escapeHtml(item.video)}">\u89C6\u9891</a>`);
   if (item.trace) links.push(`<a href="${escapeHtml(item.trace)}">Trace</a>`);
   const linksLine = links.length > 0 ? `<p>${links.join(" \xB7 ")}</p>` : "";
+  const search = escapeHtml(`${item.caseId} ${item.caseName} ${item.file}`).replaceAll('"', "&quot;");
+  const cats = escapeHtml(item.categories.join(","));
   return `
-<h2>${escapeHtml(item.caseId)} \xB7 ${escapeHtml(item.caseName)} <span class="badge ${item.status}">${item.status}</span></h2>
-${errorLine}
-${linksLine}
-<table>
-  <tr><th>#</th><th>target</th><th>action</th><th>\u72B6\u6001</th><th>\u8017\u65F6</th><th>\u8BE6\u60C5</th></tr>
-  ${rows}
-</table>`;
+<details class="case" data-status="${item.status}" data-cats="${cats}" data-search="${search}">
+  <summary>
+    <span class="badge ${item.status}">${item.status}</span>
+    <b>${escapeHtml(item.caseId)}</b> \xB7 ${escapeHtml(item.caseName)}
+    <span class="muted">\xB7 ${item.steps.length} \u6B65 \xB7 ${(item.durationMs / 1e3).toFixed(1)}s</span>
+  </summary>
+  ${errorLine}
+  ${linksLine}
+  <table>
+    <tr><th>#</th><th>target</th><th>action</th><th>\u72B6\u6001</th><th>\u8017\u65F6</th><th>\u8BE6\u60C5</th></tr>
+    ${rows}
+  </table>
+</details>`;
 }
 function stepHtml(step) {
   const details = [];
   if (step.error) details.push(`<span class="error">${escapeHtml(step.error)}</span>`);
+  if (step.category) details.push(`<span class="muted">\u5206\u7C7B: ${escapeHtml(categoryLabel(step.category))}</span>`);
   if (step.extracted) {
     for (const [name, value] of Object.entries(step.extracted)) {
       details.push(`\u53D8\u91CF ${escapeHtml(name)} = <code>${escapeHtml(value)}</code>`);
@@ -30808,21 +31031,344 @@ function stepHtml(step) {
   <td>${details.join("<br />") || "-"}</td>
 </tr>`;
 }
+function renderTrend(data) {
+  const points = [
+    ...data.history.map((h) => ({ runId: h.runId, passed: h.passed, failed: h.failed, status: h.status })),
+    {
+      runId: data.summary.runId,
+      passed: data.summary.totals.passed,
+      failed: data.summary.totals.failed,
+      status: data.summary.status
+    }
+  ];
+  if (points.length === 0) return '<p class="muted">\u6682\u65E0\u5386\u53F2\u6570\u636E</p>';
+  const max = Math.max(1, ...points.map((p) => p.passed + p.failed));
+  const barW = 34;
+  const gap = 14;
+  const chartH = 90;
+  const labelH = 34;
+  const width = points.length * (barW + gap) + gap;
+  const height = chartH + labelH;
+  const bars = points.map((point, index) => {
+    const total = point.passed + point.failed;
+    const scale = (count) => total === 0 ? 0 : count / max * chartH;
+    const passedH = scale(point.passed);
+    const failedH = scale(point.failed);
+    const x = gap + index * (barW + gap);
+    const passedY = chartH - passedH;
+    const failedY = passedY - failedH;
+    const tip = `${point.runId}: \u2713${point.passed} \u2717${point.failed}`;
+    return `<g>
+  <title>${escapeHtml(tip)}</title>
+  <rect x="${x}" y="${chartH + 4}" width="${barW}" height="1" fill="var(--line)"></rect>
+  ${passedH > 0 ? `<rect x="${x}" y="${passedY.toFixed(1)}" width="${barW}" height="${passedH.toFixed(1)}" fill="var(--ok)" rx="2"></rect>` : ""}
+  ${failedH > 0 ? `<rect x="${x}" y="${failedY.toFixed(1)}" width="${barW}" height="${failedH.toFixed(1)}" fill="var(--fail)" rx="2"></rect>` : ""}
+  <text x="${x + barW / 2}" y="${chartH + 20}" font-size="9" fill="var(--muted)" text-anchor="middle">${escapeHtml(shortId(point.runId))}</text>
+</g>`;
+  }).join("\n");
+  return `<svg width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" xmlns="http://www.w3.org/2000/svg">${bars}</svg>`;
+}
+function shortId(runId) {
+  return runId.replace(/^\d{8}-/, "");
+}
 function escapeHtml(input2) {
   return input2.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
 }
+function embedJson(data) {
+  return JSON.stringify(data).replaceAll("<", "\\u003c");
+}
+
+// ../../packages/reporter/src/summary-report.ts
+import { mkdir as mkdir4, writeFile as writeFile5 } from "node:fs/promises";
+import { join as join9, resolve as resolve4 } from "node:path";
+function escapeHtml2(value) {
+  return String(value).replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
+}
+function pct(value) {
+  return (value * 100).toFixed(1) + "%";
+}
+function buildSummaryData(runs) {
+  const executions = [];
+  const runPoints = [];
+  for (const { runId, summary } of 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;
+      executions.push({
+        runId,
+        caseId: item.caseId,
+        caseName: item.caseName,
+        status: item.status,
+        category,
+        platforms
+      });
+    }
+    runPoints.push({
+      runId,
+      startedAt: summary.startedAt,
+      status: summary.status,
+      passed: summary.totals.passed,
+      failed: summary.totals.failed,
+      passRate: summary.totals.cases > 0 ? summary.totals.passed / summary.totals.cases : 0
+    });
+  }
+  const byCase = /* @__PURE__ */ new Map();
+  for (const exec2 of executions) {
+    let agg = byCase.get(exec2.caseId);
+    if (!agg) {
+      agg = {
+        caseId: exec2.caseId,
+        caseName: exec2.caseName,
+        platforms: [],
+        runs: 0,
+        passed: 0,
+        failed: 0,
+        passRate: 0,
+        lastStatus: "unknown",
+        flaky: false
+      };
+      byCase.set(exec2.caseId, agg);
+    }
+    agg.runs++;
+    if (exec2.status === "passed") agg.passed++;
+    else agg.failed++;
+    for (const platform of exec2.platforms) {
+      if (!agg.platforms.includes(platform)) agg.platforms.push(platform);
+    }
+  }
+  for (const agg of byCase.values()) {
+    const last = [...executions].reverse().find((exec2) => exec2.caseId === agg.caseId);
+    agg.lastStatus = last?.status ?? "unknown";
+    agg.lastCategory = last?.category;
+    agg.passRate = agg.runs > 0 ? agg.passed / agg.runs : 0;
+    agg.flaky = agg.failed > 0 && agg.passed > 0;
+  }
+  const cases = [...byCase.values()];
+  const flaky = cases.filter((item) => item.flaky);
+  const categories = FAILURE_CATEGORIES.map((item) => ({
+    id: item.id,
+    label: item.label,
+    count: executions.filter((exec2) => exec2.status === "failed" && exec2.category === item.id).length
+  })).filter((item) => item.count > 0);
+  const durations = runs.map((item) => item.summary.durationMs).filter((value) => typeof value === "number");
+  return {
+    window: {
+      runs: runs.length,
+      from: runPoints[0]?.startedAt,
+      to: runPoints.at(-1)?.startedAt
+    },
+    kpis: {
+      runs: runs.length,
+      executions: executions.length,
+      overallRate: executions.length > 0 ? executions.filter((exec2) => exec2.status === "passed").length / executions.length : 0,
+      avgDurationMs: durations.length > 0 ? durations.reduce((sum, value) => sum + value, 0) / durations.length : 0,
+      flakyCount: flaky.length
+    },
+    runs: runPoints,
+    cases,
+    platforms: [...new Set(cases.flatMap((item) => item.platforms))].sort(),
+    categories,
+    categoryLabels: Object.fromEntries(FAILURE_CATEGORIES.map((item) => [item.id, item.label]))
+  };
+}
+function renderSummaryTrend(runs) {
+  if (runs.length === 0) return '<p class="muted">\u7EDF\u8BA1\u7A97\u53E3\u5185\u6CA1\u6709\u8FD0\u884C\u6570\u636E</p>';
+  const barW = 30;
+  const gap = 8;
+  const chartH = 96;
+  const width = runs.length * (barW + gap) + gap;
+  const height = chartH + 30;
+  const max = Math.max(1, ...runs.map((run) => run.passed + run.failed));
+  const bars = runs.map((run, index) => {
+    const x = gap + index * (barW + gap);
+    const passedH = run.passed / max * chartH;
+    const failedH = run.failed / max * chartH;
+    const passedY = chartH - passedH;
+    const failedY = passedY - failedH;
+    const total = run.passed + run.failed;
+    const rate = total > 0 ? Math.round(run.passed / total * 100) : 0;
+    const label = run.runId.replace(/^\d{8}-/, "");
+    return "<g><title>" + escapeHtml2(run.runId) + ": \u2713" + run.passed + " \u2717" + run.failed + '</title><rect x="' + x + '" y="' + passedY.toFixed(1) + '" width="' + barW + '" height="' + passedH.toFixed(1) + '" fill="#1a7f37" rx="2"></rect><rect x="' + x + '" y="' + failedY.toFixed(1) + '" width="' + barW + '" height="' + failedH.toFixed(1) + '" fill="#cf222e" rx="2"></rect><text x="' + (x + barW / 2) + '" y="' + (chartH + 12) + '" font-size="8" fill="#59636e" text-anchor="middle">' + escapeHtml2(label) + '</text><text x="' + (x + barW / 2) + '" y="' + (chartH + 24) + '" font-size="8" fill="#59636e" text-anchor="middle">' + rate + "%</text></g>";
+  }).join("\n");
+  return '<svg width="' + width + '" height="' + height + '" viewBox="0 0 ' + width + " " + height + '" xmlns="http://www.w3.org/2000/svg">' + bars + "</svg>";
+}
+function renderSummaryHtml(data) {
+  const kpis = data.kpis;
+  const rateText = pct(kpis.overallRate);
+  const trendSvg = renderSummaryTrend(data.runs);
+  const catBars = data.categories.map(
+    (item) => '<div class="hbar-row" data-cat="' + item.id + '" title="\u70B9\u51FB\u7B5B\u9009\u7528\u4F8B\u660E\u7EC6"><span class="hbar-label">' + escapeHtml2(item.label) + '</span><span class="hbar-track"><span class="hbar" style="width:' + (kpis.executions > 0 ? Math.round(item.count / kpis.executions * 100) : 0) + '%"></span></span><span class="hbar-num">' + item.count + "</span></div>"
+  ).join("\n");
+  const catHtml = catBars || '<p class="muted">\u7EDF\u8BA1\u7A97\u53E3\u5185\u65E0\u5931\u8D25</p>';
+  const flaky = data.cases.filter((item) => item.flaky);
+  const flakyRows = flaky.map(
+    (item) => '<tr data-platform="' + escapeHtml2(item.platforms.join(" ")) + '" data-q="' + escapeHtml2(item.caseId + " " + item.caseName) + '"><td><code class="flaky-link" data-q="' + escapeHtml2(item.caseId) + '">' + escapeHtml2(item.caseId) + "</code></td><td>" + escapeHtml2(item.caseName) + "</td><td>" + escapeHtml2(item.platforms.join(" + ")) + '</td><td class="num">' + item.failed + " / " + item.runs + '</td><td class="num">' + pct(item.passRate) + '</td><td><span class="badge ' + item.lastStatus + '">' + item.lastStatus + "</span></td></tr>"
+  ).join("\n");
+  const platformChips = ["all", ...data.platforms].map(
+    (platform) => '<span class="chip' + (platform === "all" ? " active" : "") + '" data-platform="' + platform + '">' + (platform === "all" ? "\u5168\u90E8\u5E73\u53F0" : platform) + "</span>"
+  ).join("\n");
+  const detailRows = data.cases.map(
+    (item) => '<tr data-platform="' + escapeHtml2(item.platforms.join(" ")) + '" data-cat="' + escapeHtml2(item.lastCategory ?? "") + '" data-q="' + escapeHtml2(item.caseId + " " + item.caseName) + '" data-pass="' + item.passRate + '" data-runs="' + item.runs + '" data-failed="' + item.failed + '"><td><code>' + escapeHtml2(item.caseId) + "</code></td><td>" + escapeHtml2(item.caseName) + "</td><td>" + escapeHtml2(item.platforms.join(" + ")) + '</td><td class="num">' + item.runs + '</td><td class="num">' + item.passed + '</td><td class="num">' + item.failed + '</td><td><span class="mini-track"><span class="mini ' + (item.failed > 0 ? "warn" : "ok") + '" style="width:' + Math.round(item.passRate * 60) + 'px"></span></span> ' + pct(item.passRate) + "</td><td>" + (item.lastCategory ? escapeHtml2(categoryLabel(item.lastCategory)) : "-") + '</td><td><span class="badge ' + item.lastStatus + '">' + item.lastStatus + "</span></td></tr>"
+  ).join("\n");
+  const range = (data.window.from ?? "").slice(0, 10) + " \u2192 " + (data.window.to ?? "").slice(0, 10);
+  return `<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8" />
+<title>TestPilot \u6C47\u603B\u62A5\u544A</title>
+<style>
+  :root { --ok:#1a7f37; --fail:#cf222e; --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: 1120px; margin: 0 auto; padding: 20px 16px 56px; }
+  h1 { font-size: 21px; margin: 8px 0; } h2 { font-size: 15px; margin: 26px 0 8px; }
+  .meta { color: var(--muted); font-size: 12px; margin: 4px 0 12px; }
+  .cards { display: flex; gap: 12px; flex-wrap: wrap; margin: 14px 0; }
+  .card { background: #fff; border: 1px solid var(--line); border-radius: 8px; padding: 12px 18px; min-width: 140px; }
+  .card b { font-size: 22px; display: block; } .card span { color: var(--muted); font-size: 12px; }
+  .row2 { display: flex; gap: 14px; flex-wrap: wrap; align-items: stretch; }
+  .panel { background: #fff; border: 1px solid var(--line); border-radius: 8px; padding: 14px; }
+  .panel h3 { margin: 0 0 8px; font-size: 13px; color: var(--muted); font-weight: 500; }
+  .trend { overflow-x: auto; flex: 1; min-width: 320px; }
+  table { border-collapse: collapse; width: 100%; font-size: 13px; background: #fff; }
+  th, td { border-bottom: 1px solid var(--line); padding: 7px 10px; text-align: left; }
+  th { color: var(--muted); font-weight: 500; cursor: pointer; white-space: nowrap; }
+  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; }
+  .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; }
+  input#q { flex: 1; min-width: 160px; padding: 5px 10px; border: 1px solid var(--line); border-radius: 6px; font-size: 13px; }
+  #count { color: var(--muted); font-size: 12px; margin-left: auto; }
+  .hbar-row { display: flex; align-items: center; gap: 10px; margin: 7px 0; cursor: pointer; }
+  .hbar-label { width: 90px; font-size: 13px; } .hbar-num { width: 30px; text-align: right; font-size: 13px; }
+  .hbar-track { flex: 1; background: #eef1f4; border-radius: 5px; height: 12px; overflow: hidden; }
+  .hbar { display: block; height: 100%; background: var(--fail); }
+  .mini-track { display: inline-block; width: 60px; height: 7px; background: #eef1f4; border-radius: 4px; overflow: hidden; vertical-align: middle; }
+  .mini { display: block; height: 100%; } .mini.ok { background: var(--ok); } .mini.warn { background: #bf8700; }
+  .muted { color: var(--muted); } .hide { display: none !important; }
+</style>
+</head>
+<body>
+<div class="wrap">
+  <h1>TestPilot \u6C47\u603B\u62A5\u544A</h1>
+  <p class="meta">\u7EDF\u8BA1\u8303\u56F4:\u6700\u8FD1 ${data.window.runs} \u6B21\u8FD0\u884C(${escapeHtml2(range)})\xB7 \u751F\u6210\u4E8E ${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}</p>
+
+  <div class="cards">
+    <div class="card"><b>${kpis.runs}</b><span>\u8FD0\u884C\u6B21\u6570</span></div>
+    <div class="card"><b>${kpis.executions}</b><span>\u7528\u4F8B\u6267\u884C\u6B21\u6570</span></div>
+    <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>
+  </div>
+
+  <h2>\u8D8B\u52BF(\u6BCF\u6B21\u8FD0\u884C\u7ED3\u679C\u4E0E\u901A\u8FC7\u7387,\u60AC\u6D6E\u770B\u8BE6\u60C5)</h2>
+  <div class="panel trend">${trendSvg}</div>
+
+  <h2>\u5931\u8D25\u5206\u7C7B\u5206\u5E03(\u70B9\u51FB\u7B5B\u9009\u660E\u7EC6)</h2>
+  <div class="panel">${catHtml}</div>
+
+  <h2>Flaky \u699C(\u53C8\u8FC7\u53C8\u6302;\u70B9\u7528\u4F8B\u540D\u5B9A\u4F4D\u660E\u7EC6)</h2>
+  <div class="panel"><table>
+    <tr><th>\u7528\u4F8B</th><th>\u540D\u79F0</th><th>\u5E73\u53F0</th><th class="num">\u5931\u8D25 / \u53C2\u4E0E</th><th class="num">\u901A\u8FC7\u7387</th><th>\u6700\u8FD1\u72B6\u6001</th></tr>
+    ${flakyRows || '<tr><td colspan="6" class="muted">\u7EDF\u8BA1\u7A97\u53E3\u5185\u65E0 Flaky \u7528\u4F8B</td></tr>'}
+  </table></div>
+
+  <h2>\u7528\u4F8B\u660E\u7EC6</h2>
+  <div class="toolbar">
+    ${platformChips}
+    <input id="q" placeholder="\u641C\u7D22\u7528\u4F8B id / \u540D\u79F0\u2026" />
+    <span id="count"></span>
+  </div>
+  <table id="detail">
+    <thead><tr>
+      <th>\u7528\u4F8B</th><th>\u540D\u79F0</th><th>\u5E73\u53F0</th>
+      <th class="num" data-sort="runs">\u8FD0\u884C\u6B21\u6570</th><th class="num" data-sort="passed">\u901A\u8FC7</th><th class="num" data-sort="failed">\u5931\u8D25</th>
+      <th data-sort="passRate">\u901A\u8FC7\u7387 \u25BE</th><th>\u6700\u8FD1\u5206\u7C7B</th><th>\u6700\u8FD1\u72B6\u6001</th>
+    </tr></thead>
+    <tbody>${detailRows}</tbody>
+  </table>
+</div>
+
+<script id="summary-data" type="application/json">${JSON.stringify(data).replaceAll("<", "\\u003c")}</script>
+<script>
+(function () {
+  var rows = Array.prototype.slice.call(document.querySelectorAll('#detail tbody tr'));
+  var state = { platform: 'all', cat: 'all', q: '', sortKey: 'passRate', sortDir: -1 };
+
+  function apply() {
+    var shown = 0;
+    rows.forEach(function (row) {
+      var show = true;
+      if (state.platform !== 'all' && row.getAttribute('data-platform').split(' ').indexOf(state.platform) === -1) show = false;
+      if (state.cat !== 'all' && (row.getAttribute('data-cat') || '') !== state.cat) show = false;
+      if (state.q && row.getAttribute('data-q').toLowerCase().indexOf(state.q.toLowerCase()) === -1) show = false;
+      row.classList.toggle('hide', !show);
+      if (show) shown++;
+    });
+    document.getElementById('count').textContent = shown + ' / ' + rows.length + ' \u7528\u4F8B';
+  }
+
+  document.querySelectorAll('.chip[data-platform]').forEach(function (chip) {
+    chip.addEventListener('click', function () {
+      document.querySelectorAll('.chip[data-platform]').forEach(function (c) { c.classList.remove('active'); });
+      chip.classList.add('active');
+      state.platform = chip.getAttribute('data-platform');
+      apply();
+    });
+  });
+  document.querySelectorAll('.hbar-row').forEach(function (bar) {
+    bar.addEventListener('click', function () {
+      state.cat = bar.getAttribute('data-cat');
+      apply();
+    });
+  });
+  var q = document.getElementById('q');
+  q.addEventListener('input', function () { state.q = q.value.trim(); apply(); });
+
+  document.querySelectorAll('#detail th[data-sort]').forEach(function (th) {
+    th.addEventListener('click', function () {
+      var key = th.getAttribute('data-sort');
+      state.sortDir = state.sortKey === key ? -state.sortDir : -1;
+      state.sortKey = key;
+      var sorted = rows.slice().sort(function (a, b) {
+        return (Number(a.getAttribute('data-' + key)) - Number(b.getAttribute('data-' + key))) * state.sortDir;
+      });
+      var tbody = document.querySelector('#detail tbody');
+      sorted.forEach(function (row) { tbody.appendChild(row); });
+    });
+  });
+
+  apply();
+})();
+</script>
+</body>
+</html>`;
+}
+async function writeSummaryReport(artifactsDir, data) {
+  const dir = resolve4(artifactsDir);
+  await mkdir4(dir, { recursive: true });
+  const htmlPath = join9(dir, "summary.html");
+  const jsonPath = join9(dir, "summary.json");
+  await writeFile5(jsonPath, JSON.stringify(data, null, 2), "utf8");
+  await writeFile5(htmlPath, renderSummaryHtml(data), "utf8");
+  return { html: htmlPath, json: jsonPath };
+}
 
 // ../../packages/sdk/src/runs.ts
-import { readFile as readFile5, readdir as readdir3 } from "node:fs/promises";
-import { isAbsolute as isAbsolute2, join as join15 } from "node:path";
+import { readFile as readFile6, readdir as readdir4 } from "node:fs/promises";
+import { isAbsolute as isAbsolute2, join as join17 } from "node:path";
 
 // ../../packages/execution-engine/src/artifacts/index.ts
-import { mkdir as mkdir8 } from "node:fs/promises";
-import { join as join11 } from "node:path";
+import { mkdir as mkdir9 } from "node:fs/promises";
+import { join as join13 } from "node:path";
 
 // ../../packages/evidence/src/log.ts
-import { appendFile, mkdir as mkdir4 } from "node:fs/promises";
-import { dirname as dirname2 } from "node:path";
+import { appendFile, mkdir as mkdir5 } from "node:fs/promises";
+import { dirname as dirname3 } from "node:path";
 var RunLogger = class {
   constructor(filePath) {
     this.filePath = filePath;
@@ -30837,7 +31383,7 @@ var RunLogger = class {
     return this.write("ERROR", message);
   }
   async write(level, message) {
-    await mkdir4(dirname2(this.filePath), { recursive: true });
+    await mkdir5(dirname3(this.filePath), { recursive: true });
     const line = `${(/* @__PURE__ */ new Date()).toISOString()} ${level} ${message}
 `;
     await appendFile(this.filePath, line, "utf8");
@@ -30845,32 +31391,32 @@ var RunLogger = class {
 };
 
 // ../../packages/evidence/src/screenshot.ts
-import { mkdir as mkdir5, writeFile as writeFile5 } from "node:fs/promises";
-import { dirname as dirname3, join as join8 } from "node:path";
+import { mkdir as mkdir6, writeFile as writeFile6 } from "node:fs/promises";
+import { dirname as dirname4, join as join10 } from "node:path";
 async function saveScreenshot(dir, fileName, data) {
-  const file2 = join8(dir, fileName);
-  await mkdir5(dirname3(file2), { recursive: true });
-  await writeFile5(file2, data);
+  const file2 = join10(dir, fileName);
+  await mkdir6(dirname4(file2), { recursive: true });
+  await writeFile6(file2, data);
   return file2;
 }
 
 // ../../packages/evidence/src/trace.ts
-import { mkdir as mkdir6, writeFile as writeFile6 } from "node:fs/promises";
-import { dirname as dirname4, join as join9 } from "node:path";
+import { mkdir as mkdir7, writeFile as writeFile7 } from "node:fs/promises";
+import { dirname as dirname5, join as join11 } from "node:path";
 async function saveTrace(dir, fileName, data) {
-  const file2 = join9(dir, fileName);
-  await mkdir6(dirname4(file2), { recursive: true });
-  await writeFile6(file2, data);
+  const file2 = join11(dir, fileName);
+  await mkdir7(dirname5(file2), { recursive: true });
+  await writeFile7(file2, data);
   return file2;
 }
 
 // ../../packages/evidence/src/video.ts
-import { mkdir as mkdir7, writeFile as writeFile7 } from "node:fs/promises";
-import { dirname as dirname5, join as join10 } from "node:path";
+import { mkdir as mkdir8, writeFile as writeFile8 } from "node:fs/promises";
+import { dirname as dirname6, join as join12 } from "node:path";
 async function saveVideo(dir, fileName, data) {
-  const file2 = join10(dir, fileName);
-  await mkdir7(dirname5(file2), { recursive: true });
-  await writeFile7(file2, data);
+  const file2 = join12(dir, fileName);
+  await mkdir8(dirname6(file2), { recursive: true });
+  await writeFile8(file2, data);
   return file2;
 }
 
@@ -30878,11 +31424,11 @@ async function saveVideo(dir, fileName, data) {
 var ArtifactManager = class {
   constructor(runDir) {
     this.runDir = runDir;
-    this.screenshotsDir = join11(runDir, "screenshots");
-    this.videosDir = join11(runDir, "videos");
-    this.tracesDir = join11(runDir, "traces");
-    this.logsDir = join11(runDir, "logs");
-    this.logger = new RunLogger(join11(this.logsDir, "run.log"));
+    this.screenshotsDir = join13(runDir, "screenshots");
+    this.videosDir = join13(runDir, "videos");
+    this.tracesDir = join13(runDir, "traces");
+    this.logsDir = join13(runDir, "logs");
+    this.logger = new RunLogger(join13(this.logsDir, "run.log"));
   }
   screenshotsDir;
   videosDir;
@@ -30890,8 +31436,8 @@ var ArtifactManager = class {
   logsDir;
   logger;
   async prepare() {
-    await mkdir8(this.screenshotsDir, { recursive: true });
-    await mkdir8(this.logsDir, { recursive: true });
+    await mkdir9(this.screenshotsDir, { recursive: true });
+    await mkdir9(this.logsDir, { recursive: true });
   }
   /** 保存步骤截图,返回相对 run 目录的路径(screenshots/xxx.png,统一正斜杠供报告链接使用) */
   async saveStepScreenshot(fileName, data) {
@@ -30955,8 +31501,8 @@ var ExecutionContext = class {
 };
 
 // ../../packages/execution-engine/src/lifecycle/index.ts
-import { mkdir as mkdir9, readdir as readdir2 } from "node:fs/promises";
-import { join as join12 } from "node:path";
+import { mkdir as mkdir10, readdir as readdir3 } from "node:fs/promises";
+import { join as join14 } from "node:path";
 function dateStamp(date5 = /* @__PURE__ */ new Date()) {
   const year = date5.getFullYear();
   const month = String(date5.getMonth() + 1).padStart(2, "0");
@@ -30965,7 +31511,7 @@ function dateStamp(date5 = /* @__PURE__ */ new Date()) {
 }
 async function allocateRunId(runsRoot2) {
   const stamp = dateStamp();
-  const existing = await readdir2(runsRoot2).catch(() => []);
+  const existing = await readdir3(runsRoot2).catch(() => []);
   let max = 0;
   for (const name of existing) {
     const match = /^(\d{8})-(\d{3})$/.exec(name);
@@ -30976,14 +31522,14 @@ async function allocateRunId(runsRoot2) {
   return `${stamp}-${String(max + 1).padStart(3, "0")}`;
 }
 async function ensureRunDir(runsRoot2, runId) {
-  const runDir = join12(runsRoot2, runId);
-  await mkdir9(runDir, { recursive: true });
+  const runDir = join14(runsRoot2, runId);
+  await mkdir10(runDir, { recursive: true });
   return runDir;
 }
 
 // ../../packages/execution-engine/src/events/index.ts
-import { appendFile as appendFile2, mkdir as mkdir10 } from "node:fs/promises";
-import { dirname as dirname6 } from "node:path";
+import { appendFile as appendFile2, mkdir as mkdir11 } from "node:fs/promises";
+import { dirname as dirname7 } from "node:path";
 var EventBus = class {
   subscribers = [];
   subscribe(subscriber) {
@@ -30997,7 +31543,7 @@ var EventBus = class {
 };
 function ndjsonSubscriber(filePath) {
   return async (event) => {
-    await mkdir10(dirname6(filePath), { recursive: true });
+    await mkdir11(dirname7(filePath), { recursive: true });
     await appendFile2(filePath, `${JSON.stringify(event)}
 `, "utf8");
   };
@@ -31353,8 +31899,8 @@ function buildRunSummary(runId, startedAt, cases, options = {}) {
 }
 
 // ../../packages/execution-engine/src/engine/test-runner.ts
-import { writeFile as writeFile8 } from "node:fs/promises";
-import { join as join13, resolve as resolve4 } from "node:path";
+import { writeFile as writeFile9 } from "node:fs/promises";
+import { join as join15, resolve as resolve5 } from "node:path";
 var TestRunner = class {
   resolver;
   runsRoot;
@@ -31364,7 +31910,7 @@ var TestRunner = class {
   accounts;
   constructor(options) {
     this.resolver = options.resolver;
-    this.runsRoot = resolve4(options.runsRoot ?? join13(process.cwd(), ".testpilot", "artifacts", "runs"));
+    this.runsRoot = resolve5(options.runsRoot ?? join15(process.cwd(), ".testpilot", "artifacts", "runs"));
     this.customRunId = options.runId;
     this.extraSubscriber = options.onEvent;
     this.signal = options.signal;
@@ -31377,7 +31923,7 @@ var TestRunner = class {
     const artifacts = new ArtifactManager(runDir);
     await artifacts.prepare();
     const bus = new EventBus();
-    bus.subscribe(ndjsonSubscriber(join13(runDir, "events.ndjson")));
+    bus.subscribe(ndjsonSubscriber(join15(runDir, "events.ndjson")));
     if (this.extraSubscriber) bus.subscribe(this.extraSubscriber);
     await bus.emit({ type: "run-started", runId, totalCases: cases.length, ts: startedAt.toISOString() });
     await artifacts.logger.info(`run ${runId} started with ${cases.length} case(s)`);
@@ -31410,7 +31956,7 @@ var TestRunner = class {
       ts: (/* @__PURE__ */ new Date()).toISOString()
     });
     await artifacts.logger.info(`run ${runId} finished: ${summary.status}`);
-    await writeFile8(join13(runDir, RESULT_FILE), JSON.stringify(summary, null, 2), "utf8");
+    await writeFile9(join15(runDir, RESULT_FILE), JSON.stringify(summary, null, 2), "utf8");
     return summary;
   }
 };
@@ -31444,9 +31990,9 @@ async function openCaseContext(bundle, options, evidenceTmpDir) {
 
 // ../../packages/adapter-playwright/src/page.ts
 import { existsSync as existsSync2 } from "node:fs";
-import { mkdtemp, readFile as readFile4, rm } from "node:fs/promises";
+import { mkdtemp, readFile as readFile5, rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { join as join14 } from "node:path";
+import { join as join16 } from "node:path";
 var PlaywrightAdapter = class {
   constructor(bundle, options = {}) {
     this.bundle = bundle;
@@ -31460,7 +32006,7 @@ var PlaywrightAdapter = class {
   /** 开始用例级取证:为本用例创建独立 context(录屏 + trace) */
   async startEvidence(_caseId) {
     await this.closeContextQuietly();
-    const evidenceTmpDir = await mkdtemp(join14(tmpdir(), "testpilot-pw-"));
+    const evidenceTmpDir = await mkdtemp(join16(tmpdir(), "testpilot-pw-"));
     this.current = {
       ...await openCaseContext(this.bundle, this.options, evidenceTmpDir),
       evidenceTmpDir
@@ -31471,12 +32017,12 @@ var PlaywrightAdapter = class {
     if (!this.current) return {};
     const { context, page, evidenceTmpDir } = this.current;
     this.current = void 0;
-    const traceZipPath = join14(evidenceTmpDir ?? tmpdir(), "trace.zip");
+    const traceZipPath = join16(evidenceTmpDir ?? tmpdir(), "trace.zip");
     await context.tracing.stop({ path: traceZipPath }).catch(() => void 0);
     const recordedVideoPath = await page.video()?.path().catch(() => void 0);
     await context.close().catch(() => void 0);
-    const video = recordedVideoPath && existsSync2(recordedVideoPath) ? await readFile4(recordedVideoPath) : void 0;
-    const trace = evidenceTmpDir && existsSync2(traceZipPath) ? await readFile4(traceZipPath) : void 0;
+    const video = recordedVideoPath && existsSync2(recordedVideoPath) ? await readFile5(recordedVideoPath) : void 0;
+    const trace = evidenceTmpDir && existsSync2(traceZipPath) ? await readFile5(traceZipPath) : void 0;
     if (evidenceTmpDir) await rm(evidenceTmpDir, { recursive: true, force: true }).catch(() => void 0);
     return { video, trace };
   }
@@ -31580,7 +32126,7 @@ var automatorLauncher = {
   }
 };
 function delay(ms) {
-  return new Promise((resolve5) => setTimeout(resolve5, ms));
+  return new Promise((resolve6) => setTimeout(resolve6, ms));
 }
 async function connectWithRetry(wsEndpoint, timeoutMs) {
   const startedAt = Date.now();
@@ -31940,7 +32486,7 @@ function createDefaultAdapters(config2) {
 async function runCases(options = {}) {
   const root = resolveRoot(options.root);
   const config2 = await loadProjectConfig(root);
-  const inputs = options.paths && options.paths.length > 0 ? options.paths.map((input2) => isAbsolute2(input2) ? input2 : join15(root, input2)) : [join15(root, config2.casesDir)];
+  const inputs = options.paths && options.paths.length > 0 ? options.paths.map((input2) => isAbsolute2(input2) ? input2 : join17(root, input2)) : [join17(root, config2.casesDir)];
   const cases = await collectCases(inputs, { root });
   if (cases.length === 0) {
     throw new RunError("ENO_CASES", `\u672A\u627E\u5230\u7528\u4F8B\u6587\u4EF6(\u67E5\u627E:${inputs.join(", ")})`);
@@ -31966,7 +32512,7 @@ async function runCases(options = {}) {
   ];
   const runner = new TestRunner({
     resolver,
-    runsRoot: join15(root, RUNS_DIR),
+    runsRoot: join17(root, RUNS_DIR),
     runId: options.runId,
     onEvent: options.onEvent,
     signal: options.signal,
@@ -31978,14 +32524,14 @@ async function runCases(options = {}) {
   return { summary, invalid, tagFiltered, missingAccounts };
 }
 function runsRoot(root) {
-  return join15(resolveRoot(root), RUNS_DIR);
+  return join17(resolveRoot(root), RUNS_DIR);
 }
 async function listRuns(options = {}) {
   const base = runsRoot(options.root);
-  const entries = await readdir3(base).catch(() => []);
+  const entries = await readdir4(base).catch(() => []);
   const metas = [];
   for (const entry of entries.filter((name) => /^\d{8}-\d{3}$/.test(name)).sort().reverse()) {
-    metas.push({ ...await readRunMeta(base, entry), runId: entry, dir: join15(base, entry) });
+    metas.push({ ...await readRunMeta(base, entry), runId: entry, dir: join17(base, entry) });
   }
   return metas;
 }
@@ -31995,22 +32541,22 @@ async function latestRunId(options = {}) {
 }
 async function getRun(runId, options = {}) {
   const base = runsRoot(options.root);
-  const file2 = join15(base, runId, RESULT_FILE);
+  const file2 = join17(base, runId, RESULT_FILE);
   try {
-    return JSON.parse(await readFile5(file2, "utf8"));
+    return JSON.parse(await readFile6(file2, "utf8"));
   } catch {
     throw new RunError("ENO_CASES", `\u8BFB\u53D6\u8FD0\u884C\u7ED3\u679C\u5931\u8D25:${file2}(\u8FD0\u884C\u672A\u5B8C\u6210\u6216 runId \u4E0D\u5B58\u5728)`);
   }
 }
 async function getRunEvents(runId, options = {}) {
-  const file2 = join15(runsRoot(options.root), runId, "events.ndjson");
-  const source = await readFile5(file2, "utf8").catch(() => "");
+  const file2 = join17(runsRoot(options.root), runId, "events.ndjson");
+  const source = await readFile6(file2, "utf8").catch(() => "");
   return source.split("\n").filter((line) => line.trim().length > 0).map((line) => JSON.parse(line));
 }
 async function readRunMeta(base, runId) {
   try {
     const summary = JSON.parse(
-      await readFile5(join15(base, runId, RESULT_FILE), "utf8")
+      await readFile6(join17(base, runId, RESULT_FILE), "utf8")
     );
     return {
       status: summary.status,
@@ -32031,25 +32577,47 @@ async function generateReport(runId, options = {}) {
   if (!id) {
     throw new Error("\u672A\u627E\u5230\u8FD0\u884C\u8BB0\u5F55(\u5148\u8FD0\u884C\u4E00\u6B21\u7528\u4F8B)");
   }
-  const runDir = join16(resolveRoot(options.root), RUNS_DIR, id);
+  const runDir = join18(resolveRoot(options.root), RUNS_DIR, id);
   let summary;
   try {
-    summary = JSON.parse(await readFile6(join16(runDir, "result.json"), "utf8"));
+    summary = JSON.parse(await readFile7(join18(runDir, "result.json"), "utf8"));
   } catch {
-    throw new Error(`\u8BFB\u53D6\u8FD0\u884C\u7ED3\u679C\u5931\u8D25:${join16(runDir, "result.json")}(\u8FD0\u884C\u672A\u5B8C\u6210\u6216 runId \u4E0D\u5B58\u5728)`);
+    throw new Error(`\u8BFB\u53D6\u8FD0\u884C\u7ED3\u679C\u5931\u8D25:${join18(runDir, "result.json")}(\u8FD0\u884C\u672A\u5B8C\u6210\u6216 runId \u4E0D\u5B58\u5728)`);
   }
   const written = await writeReports(runDir, summary);
   return { runId: id, json: written.json, html: written.html };
 }
+async function generateSummaryReport(options = {}) {
+  const root = resolveRoot(options.root);
+  const limit = options.last && options.last > 0 ? options.last : 30;
+  const metas = await listRuns({ root });
+  if (metas.length === 0) {
+    throw new Error("\u7EDF\u8BA1\u7A97\u53E3\u5185\u6CA1\u6709\u4EFB\u4F55\u8FD0\u884C\u8BB0\u5F55(\u5148\u8FD0\u884C npx csspilot run)");
+  }
+  const runs = [];
+  for (const meta3 of metas.slice(0, limit)) {
+    try {
+      runs.push({ runId: meta3.runId, summary: await getRun(meta3.runId, { root }) });
+    } catch {
+    }
+  }
+  if (runs.length === 0) {
+    throw new Error("\u7EDF\u8BA1\u7A97\u53E3\u5185\u7684\u8FD0\u884C\u7ED3\u679C\u5747\u4E0D\u53EF\u8BFB");
+  }
+  const data = buildSummaryData(runs);
+  const artifactsDir = join18(root, ".testpilot", "artifacts");
+  const written = await writeSummaryReport(artifactsDir, data);
+  return { html: written.html, json: written.json, data, window: { runs: runs.length } };
+}
 async function readReport(runId, options = {}) {
-  const file2 = join16(resolveRoot(options.root), RUNS_DIR, runId, "report.json");
-  const source = await readFile6(file2, "utf8").catch(() => void 0);
+  const file2 = join18(resolveRoot(options.root), RUNS_DIR, runId, "report.json");
+  const source = await readFile7(file2, "utf8").catch(() => void 0);
   return source ? JSON.parse(source) : void 0;
 }
 
 // ../../packages/sdk/src/client.ts
 function resolveInput(root, input2) {
-  return isAbsolute3(input2) ? input2 : join17(root, input2);
+  return isAbsolute3(input2) ? input2 : join19(root, input2);
 }
 var TestPilotClient = class {
   /** 业务项目根目录(绝对路径) */
@@ -32114,6 +32682,10 @@ var TestPilotClient = class {
   generateReport(runId) {
     return generateReport(runId, { root: this.root });
   }
+  /** 生成跨 run 汇总报告(summary.html + summary.json) */
+  generateSummaryReport(options = {}) {
+    return generateSummaryReport({ ...options, root: this.root });
+  }
   /** 读取已生成的报告 */
   readReport(runId) {
     return readReport(runId, { root: this.root });
@@ -32122,12 +32694,12 @@ var TestPilotClient = class {
 
 // src/commands/init/adapter-detector.ts
 import { existsSync as existsSync4, readFileSync } from "node:fs";
-import { join as join18 } from "node:path";
+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"] : [];
   const pkg = readPackageJsonDeps(root);
   const hasPlaywrightDep = pkg !== void 0 && ("playwright" in pkg || "@playwright/test" in pkg);
-  const playwrightInstalled = hasPlaywrightDep || existsSync4(join18(root, "node_modules", "playwright"));
+  const playwrightInstalled = hasPlaywrightDep || existsSync4(join20(root, "node_modules", "playwright"));
   const devtoolsCli = await findWechatDevToolsCli().catch(() => void 0);
   return [
     {
@@ -32145,7 +32717,7 @@ async function detectAdapters(root, projectType) {
   ];
 }
 function readPackageJsonDeps(root) {
-  const file2 = join18(root, "package.json");
+  const file2 = join20(root, "package.json");
   if (!existsSync4(file2)) return void 0;
   try {
     const pkg = JSON.parse(readFileSync(file2, "utf8"));
@@ -32156,26 +32728,30 @@ function readPackageJsonDeps(root) {
 }
 
 // src/commands/init/environment-initializer.ts
-import { readFile as readFile7 } from "node:fs/promises";
-import { join as join19 } from "node:path";
+import { readFile as readFile8 } from "node:fs/promises";
+import { join as join21 } from "node:path";
 var ENV_REF_PATTERN = /\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g;
 async function collectEnvVarRefs(root) {
   let text;
   try {
-    text = await readFile7(join19(root, "testpilot.yaml"), "utf8");
+    text = await readFile8(join21(root, "testpilot.yaml"), "utf8");
   } catch {
     return [];
   }
   const names = /* @__PURE__ */ new Set();
-  for (const match of text.matchAll(ENV_REF_PATTERN)) {
-    names.add(match[1]);
+  for (const line of text.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith("#")) continue;
+    for (const match of trimmed.matchAll(ENV_REF_PATTERN)) {
+      names.add(match[1]);
+    }
   }
   return [...names].sort();
 }
 
 // src/commands/init/project-detector.ts
 import { existsSync as existsSync5, readFileSync as readFileSync2 } from "node:fs";
-import { basename, join as join20 } from "node:path";
+import { basename, join as join22 } from "node:path";
 
 // src/lib/git.ts
 import { execFile as execFile2 } from "node:child_process";
@@ -32212,7 +32788,7 @@ var WEB_DEP_MARKERS = [
 ];
 var E2E_DIR_CANDIDATES = ["tests/e2e", "test/e2e", "e2e", "cypress"];
 function readPackageJson(root) {
-  const file2 = join20(root, "package.json");
+  const file2 = join22(root, "package.json");
   if (!existsSync5(file2)) return void 0;
   try {
     return JSON.parse(readFileSync2(file2, "utf8"));
@@ -32223,8 +32799,8 @@ function readPackageJson(root) {
 function detectProjectType(root) {
   const pkg = readPackageJson(root);
   const deps = { ...pkg?.dependencies, ...pkg?.devDependencies };
-  const isWechat = existsSync5(join20(root, "project.config.json")) || existsSync5(join20(root, "app.json")) || existsSync5(join20(root, "miniprogram", "app.json"));
-  const isWeb = existsSync5(join20(root, "index.html")) || WEB_DEP_MARKERS.some((marker) => deps?.[marker] !== void 0) || [".ts", ".tsx", ".js", ".jsx"].some((ext) => existsSync5(join20(root, "src", `index${ext}`)));
+  const isWechat = existsSync5(join22(root, "project.config.json")) || existsSync5(join22(root, "app.json")) || existsSync5(join22(root, "miniprogram", "app.json"));
+  const isWeb = existsSync5(join22(root, "index.html")) || WEB_DEP_MARKERS.some((marker) => deps?.[marker] !== void 0) || [".ts", ".tsx", ".js", ".jsx"].some((ext) => existsSync5(join22(root, "src", `index${ext}`)));
   if (isWechat && isWeb) return "hybrid";
   if (isWechat) return "wechat-miniapp";
   if (isWeb) return "web";
@@ -32233,9 +32809,9 @@ function detectProjectType(root) {
 async function detectProject(root) {
   const pkg = readPackageJson(root);
   const type = detectProjectType(root);
-  const language = existsSync5(join20(root, "tsconfig.json")) ? "TypeScript" : pkg || existsSync5(join20(root, "src")) ? "JavaScript" : "Unknown";
-  const packageManager = existsSync5(join20(root, "pnpm-lock.yaml")) ? "pnpm" : existsSync5(join20(root, "yarn.lock")) ? "yarn" : existsSync5(join20(root, "package-lock.json")) ? "npm" : "npx";
-  const existingE2eDirs = E2E_DIR_CANDIDATES.filter((dir) => existsSync5(join20(root, dir)));
+  const language = existsSync5(join22(root, "tsconfig.json")) ? "TypeScript" : pkg || existsSync5(join22(root, "src")) ? "JavaScript" : "Unknown";
+  const packageManager = existsSync5(join22(root, "pnpm-lock.yaml")) ? "pnpm" : existsSync5(join22(root, "yarn.lock")) ? "yarn" : existsSync5(join22(root, "package-lock.json")) ? "npm" : "npx";
+  const existingE2eDirs = E2E_DIR_CANDIDATES.filter((dir) => existsSync5(join22(root, dir)));
   return {
     root,
     name: pkg?.name ?? basename(root),
@@ -32245,8 +32821,8 @@ async function detectProject(root) {
     git: await readGitInfo(root),
     hasTestsE2e: existingE2eDirs.includes("tests/e2e"),
     existingE2eDirs,
-    hasTestpilotConfig: existsSync5(join20(root, "testpilot.yaml")),
-    hasProjectLink: existsSync5(join20(root, ".testpilot", "project.json"))
+    hasTestpilotConfig: existsSync5(join22(root, "testpilot.yaml")),
+    hasProjectLink: existsSync5(join22(root, ".testpilot", "project.json"))
   };
 }
 function defaultAdapterFor(type) {
@@ -32260,6 +32836,144 @@ function adaptersFor(type) {
   return ["playwright"];
 }
 
+// src/commands/init/skill-installer.ts
+import { existsSync as existsSync6, readFileSync as readFileSync3 } from "node:fs";
+import { access as access2, cp, mkdir as mkdir12, writeFile as writeFile10 } from "node:fs/promises";
+import { dirname as dirname8, join as join23 } from "node:path";
+import { fileURLToPath } from "node:url";
+var CORE_FILES = ["SKILL.md", "manifest.yaml"];
+var CORE_DIRS = ["rules", "workflows"];
+async function exists3(path) {
+  try {
+    await access2(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function readManifestVersion(dir) {
+  const manifestPath = join23(dir, "manifest.yaml");
+  if (!existsSync6(manifestPath)) return void 0;
+  return /^version:\s*([^\s#]+)/m.exec(readFileSync3(manifestPath, "utf8"))?.[1];
+}
+function resolveSkillSourceDir() {
+  const fromEnv = process.env.TESTPILOT_SKILL_DIR;
+  if (fromEnv) return fromEnv;
+  const bundled = fileURLToPath(new URL("./skills/testpilot", import.meta.url));
+  if (existsSync6(bundled)) return bundled;
+  const inRepo = fileURLToPath(new URL("../../../../../skills/testpilot", import.meta.url));
+  return existsSync6(inRepo) ? inRepo : void 0;
+}
+async function copyCoreFiles(src, dest) {
+  for (const name of CORE_FILES) {
+    await cp(join23(src, name), join23(dest, name), { recursive: true, force: true });
+  }
+  for (const dir of CORE_DIRS) {
+    if (existsSync6(join23(src, dir))) {
+      await cp(join23(src, dir), join23(dest, dir), { recursive: true, force: true });
+    }
+  }
+}
+async function syncSkillFiles(root, options = {}) {
+  const dest = join23(root, ".agents", "skills", "testpilot");
+  const bundledVersion = readManifestVersion(resolveSkillSourceDir() ?? "");
+  if (!await exists3(join23(dest, "manifest.yaml"))) {
+    const src = resolveSkillSourceDir();
+    if (!src) {
+      throw new Error(
+        "\u65E0\u6CD5\u5B9A\u4F4D TestPilot Skill \u6E90\u76EE\u5F55;\u53EF\u901A\u8FC7\u73AF\u5883\u53D8\u91CF TESTPILOT_SKILL_DIR \u6307\u5B9A skills/testpilot \u8DEF\u5F84"
+      );
+    }
+    await mkdir12(dirname8(dest), { recursive: true });
+    await cp(src, dest, { recursive: true });
+    return { core: "created", bundledVersion, dest };
+  }
+  const installedVersion = readManifestVersion(dest);
+  const bundled = resolveSkillSourceDir();
+  if (!bundled) {
+    return { core: "current", installedVersion, dest };
+  }
+  if (!options.force && installedVersion === bundledVersion) {
+    return { core: "current", installedVersion, bundledVersion, dest };
+  }
+  await copyCoreFiles(bundled, dest);
+  return {
+    core: "updated",
+    installedVersion,
+    bundledVersion,
+    dest
+  };
+}
+async function installSkill(root, info, adapters) {
+  const dest = join23(root, ".agents", "skills", "testpilot");
+  const sync = await syncSkillFiles(root);
+  const core = sync.core === "created" ? "created" : sync.core === "updated" ? "updated" : "reused";
+  const coreVersion = sync.core === "updated" || sync.core === "created" ? { from: sync.installedVersion, to: sync.bundledVersion } : void 0;
+  const config2 = await loadTestpilotConfig(root).catch(() => void 0);
+  const defaultEnvironment = typeof config2?.environment?.default === "string" ? config2.environment.default : "\u672A\u8BBE\u7F6E";
+  const defaultWorkspace = config2?.workspace?.default ?? "\u672A\u8BBE\u7F6E(\u53EF\u5728 yaml workspace.default \u914D\u7F6E)";
+  const refsDir = join23(dest, "references");
+  const files = [
+    ["project.md", () => renderProjectMd(info, adapters, defaultEnvironment, defaultWorkspace)],
+    ["test-conventions.md", renderTestConventionsMd],
+    ["adapters.md", () => renderAdaptersMd(adapters)]
+  ];
+  let references = "reused";
+  for (const [name, render] of files) {
+    const file2 = join23(refsDir, name);
+    if (await exists3(file2)) continue;
+    await mkdir12(refsDir, { recursive: true });
+    await writeFile10(file2, render(), "utf8");
+    references = "created";
+  }
+  return coreVersion ? { core, coreVersion, references, dest } : { core, references, dest };
+}
+function renderProjectMd(info, adapters, defaultEnvironment, defaultWorkspace) {
+  const available = adapters.filter((item) => item.available).map((item) => item.id);
+  return `# Project
+
+\u81EA\u52A8\u751F\u6210\u4E8E \`csspilot init\`,\u63CF\u8FF0\u672C\u9879\u76EE\u7684 TestPilot \u63A5\u5165\u4FE1\u606F;Agent \u4F18\u5148\u4ECE\u8FD9\u91CC\u4E86\u89E3\u9879\u76EE\u3002
+
+- Project name: ${info.name}
+- Project type: ${info.type}
+- Language: ${info.language}
+- Package manager: ${info.packageManager}
+- Test directory: tests/e2e
+- Case directory: tests/e2e/cases
+- Available adapters: ${available.length > 0 ? available.join(", ") : "(none detected)"}
+- Default environment: ${defaultEnvironment}
+- Default workspace: ${defaultWorkspace}
+`;
+}
+function renderTestConventionsMd() {
+  return `# Test Conventions
+
+\u672C\u9879\u76EE E2E \u6D4B\u8BD5\u7EA6\u5B9A,Agent \u751F\u6210/\u4FEE\u6539 Case \u65F6\u5FC5\u987B\u9075\u5B88:
+
+1. E2E Case \u4F4D\u4E8E tests/e2e/cases
+2. Case \u4F7F\u7528 TestPilot DSL
+3. \u4E0D\u5141\u8BB8\u76F4\u63A5\u8C03\u7528 Playwright
+4. \u4E0D\u5141\u8BB8\u76F4\u63A5\u8C03\u7528 WeChatIDE
+5. \u4E0D\u5141\u8BB8\u5728 Case \u4E2D\u5199\u660E\u6587\u5BC6\u7801(\u7528 accountRef \u5F15\u7528)
+6. \u4F18\u5148\u590D\u7528\u5DF2\u6709 Case
+7. \u65B0\u589E Case \u5FC5\u987B\u901A\u8FC7 csspilot validate
+8. Case ID \u5FC5\u987B\u552F\u4E00
+`;
+}
+function renderAdaptersMd(adapters) {
+  const lines = adapters.map(
+    (item) => `- ${item.id}: ${item.available ? "\u53EF\u7528" : "\u4E0D\u53EF\u7528"}${item.required ? "(\u9879\u76EE\u9700\u8981)" : "(\u53EF\u9009)"} \u2014 ${item.detail}`
+  );
+  return `# Adapters
+
+\u6267\u884C\u7AEF\u68C0\u6D4B\u7ED3\u679C(\u4EE5 \`csspilot doctor\` \u6700\u65B0\u8F93\u51FA\u4E3A\u51C6):
+
+${lines.join("\n")}
+
+Agent \u6C38\u8FDC\u4E0D\u76F4\u63A5\u64CD\u4F5C Adapter;Case \u7ECF Execution Engine \u8C03\u5EA6\u5230\u5BF9\u5E94 Adapter \u6267\u884C\u3002
+`;
+}
+
 // src/commands/init/doctor.ts
 async function runDoctor(root) {
   const sections = [];
@@ -32284,25 +32998,37 @@ async function runDoctor(root) {
   const projectItems = [
     ok(`Project ${info.name}(${info.type})`),
     info.git.commit ? ok(`Git repository(${info.git.branch ?? "detached"} \xB7 ${info.git.commit.slice(0, 7)})`) : warn("Git repository \u672A\u68C0\u6D4B\u5230", "Case Metadata \u65E0\u6CD5\u540C\u6B65\u5230 Server"),
-    existsSync6(join21(root, ".testpilot", "project.json")) ? ok(".testpilot/project.json") : error62(".testpilot/project.json", "\u8FD0\u884C npx csspilot init \u751F\u6210"),
-    existsSync6(join21(root, "testpilot.yaml")) ? ok("testpilot.yaml") : error62("testpilot.yaml", "\u8FD0\u884C npx csspilot init \u751F\u6210")
+    existsSync7(join24(root, ".testpilot", "project.json")) ? ok(".testpilot/project.json") : error62(".testpilot/project.json", "\u8FD0\u884C npx csspilot init \u751F\u6210"),
+    existsSync7(join24(root, "testpilot.yaml")) ? ok("testpilot.yaml") : error62("testpilot.yaml", "\u8FD0\u884C npx csspilot init \u751F\u6210")
   ];
   push("Project", projectItems);
   const config2 = await loadTestpilotConfig(root).catch(() => void 0);
   const casesDir = config2?.casesDir ?? "tests/e2e/cases";
-  const cases = await collectCases([join21(root, casesDir)], { root }).catch(() => []);
+  const cases = await collectCases([join24(root, casesDir)], { root }).catch(() => []);
   const invalidCount = cases.filter((item) => !item.valid).length;
-  const testDir = join21(root, "tests", "e2e");
+  const testDir = join24(root, "tests", "e2e");
   push("Test", [
-    existsSync6(testDir) ? ok("tests/e2e") : error62("tests/e2e", "\u8FD0\u884C npx csspilot init \u521B\u5EFA"),
-    existsSync6(join21(root, casesDir)) ? ok(`cases directory(${casesDir})`) : error62(`cases directory(${casesDir})`, "\u8FD0\u884C npx csspilot init \u521B\u5EFA"),
+    existsSync7(testDir) ? ok("tests/e2e") : error62("tests/e2e", "\u8FD0\u884C npx csspilot init \u521B\u5EFA"),
+    existsSync7(join24(root, casesDir)) ? ok(`cases directory(${casesDir})`) : error62(`cases directory(${casesDir})`, "\u8FD0\u884C npx csspilot init \u521B\u5EFA"),
     cases.length === 0 ? warn("Case validation \u8DF3\u8FC7(\u672A\u627E\u5230\u7528\u4F8B)", "\u5728 tests/e2e/cases \u521B\u5EFA Case") : invalidCount === 0 ? ok(`Case validation(${cases.length} \u4E2A\u7528\u4F8B\u5168\u90E8\u6709\u6548)`) : error62(`Case validation(${invalidCount}/${cases.length} \u4E2A\u7528\u4F8B\u6821\u9A8C\u5931\u8D25)`, "\u8FD0\u884C npx csspilot validate \u67E5\u770B\u8BE6\u60C5")
   ]);
-  const skillDir = join21(root, ".agents", "skills", "testpilot");
-  push("Agent", [
-    existsSync6(join21(skillDir, "manifest.yaml")) ? ok("TestPilot Skill(.agents/skills/testpilot)") : error62("TestPilot Skill", "\u8FD0\u884C npx csspilot init \u5B89\u88C5"),
-    existsSync6(join21(skillDir, "references", "project.md")) ? ok("Project testing guide(references/)") : warn("Project testing guide \u7F3A\u5931", "references/ \u7531 init \u751F\u6210;\u53EF\u91CD\u65B0\u8FD0\u884C npx csspilot init")
-  ]);
+  const skillDir = join24(root, ".agents", "skills", "testpilot");
+  const installedSkillVersion = readManifestVersion(skillDir);
+  const skillSource = resolveSkillSourceDir();
+  const bundledSkillVersion = skillSource ? readManifestVersion(skillSource) : void 0;
+  const skillItems = [
+    installedSkillVersion ? ok(`TestPilot Skill(.agents/skills/testpilot,v${installedSkillVersion})`) : error62("TestPilot Skill", "\u8FD0\u884C npx csspilot init \u5B89\u88C5"),
+    existsSync7(join24(skillDir, "references", "project.md")) ? ok("Project testing guide(references/)") : warn("Project testing guide \u7F3A\u5931", "references/ \u7531 init \u751F\u6210;\u53EF\u91CD\u65B0\u8FD0\u884C npx csspilot init")
+  ];
+  if (installedSkillVersion && bundledSkillVersion && installedSkillVersion !== bundledSkillVersion) {
+    skillItems.push(
+      warn(
+        `Skill \u53EF\u66F4\u65B0(v${installedSkillVersion} -> v${bundledSkillVersion})`,
+        "\u8FD0\u884C npx csspilot update \u5E76\u63D0\u4EA4 .agents/skills/ \u53D8\u66F4"
+      )
+    );
+  }
+  push("Agent", skillItems);
   const adapters = await detectAdapters(root, info.type);
   push(
     "Adapters",
@@ -32384,14 +33110,14 @@ function makeDoctorCommand() {
 }
 
 // src/commands/init/index.ts
-import { join as join25 } from "node:path";
+import { join as join27 } from "node:path";
 
 // src/commands/init/config-initializer.ts
-import { access as access2, mkdir as mkdir11, writeFile as writeFile9 } from "node:fs/promises";
-import { basename as basename2, join as join22 } from "node:path";
-async function exists3(path) {
+import { access as access3, mkdir as mkdir13, readFile as readFile9, writeFile as writeFile11 } from "node:fs/promises";
+import { basename as basename2, join as join25 } from "node:path";
+async function exists4(path) {
   try {
-    await access2(path);
+    await access3(path);
     return true;
   } catch {
     return false;
@@ -32432,28 +33158,72 @@ ${adapters}
 # server:
 #   baseUrl: http://127.0.0.1:3000
 
-# Web \u7AEF:navigate \u76F8\u5BF9 url \u7684\u57FA\u51C6\u5730\u5740
+# Web \u7AEF:navigate \u76F8\u5BF9 url \u7684\u57FA\u51C6\u5730\u5740(\u6BCF\u4EBA\u7684\u5730\u5740\u4E0D\u540C,\u503C\u653E .env)
 # web:
-#   baseUrl: http://127.0.0.1:8080
+#   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
+# \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)
 # miniapp:
-#   projectPath: path/to/miniprogram
-#   cliPath: C:/Program Files (x86)/Tencent/\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177/cli.bat
+#   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
+
+# \u73AF\u5883\u914D\u7F6E(environment \u6BB5)
+TEST_BASE_URL=http://127.0.0.1:8080
+STAGING_BASE_URL=https://staging.example.com
+
+# Web \u7AEF\u76F8\u5BF9 url \u7684\u57FA\u51C6(\u53D6\u6D88 testpilot.yaml \u4E2D web \u6BB5\u6CE8\u91CA\u540E\u751F\u6548)
+# WEB_BASE_URL=http://127.0.0.1:8080
+
+# \u5C0F\u7A0B\u5E8F\u7AEF(\u53D6\u6D88 testpilot.yaml \u4E2D miniapp \u6BB5\u6CE8\u91CA\u540E\u751F\u6548)
+# MINIAPP_PROJECT_PATH=path/to/miniprogram
+# MINIAPP_CLI_PATH=C:/Program Files (x86)/Tencent/\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177/cli.bat
+
+# TestPilot Server(Control Plane,\u53EF\u9009)
+# TESTPILOT_SERVER_URL=http://127.0.0.1:3000
 `;
 }
+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}
+${entry}
+`, "utf8");
+    return "created";
+  }
+  const content = await readFile9(gitignorePath, "utf8");
+  if (content.split(/\r?\n/).some((item) => item.trim() === entry)) {
+    return "exists";
+  }
+  const separator = content.endsWith("\n") || content === "" ? "" : "\n";
+  await writeFile11(gitignorePath, `${content}${separator}# ${comment}
+${entry}
+`, "utf8");
+  return "updated";
+}
 async function initTestPilotConfig(root, info, adapters) {
-  const yamlPath = join22(root, "testpilot.yaml");
+  const yamlPath = join25(root, "testpilot.yaml");
   let yaml = "reused";
-  if (!await exists3(yamlPath)) {
-    await writeFile9(yamlPath, renderTestpilotYaml(info), "utf8");
+  if (!await exists4(yamlPath)) {
+    await writeFile11(yamlPath, renderTestpilotYaml(info), "utf8");
     yaml = "created";
   }
-  const runtimeDir = join22(root, ".testpilot", "artifacts");
-  await mkdir11(runtimeDir, { recursive: true });
-  const keep = join22(runtimeDir, ".gitkeep");
-  if (!await exists3(keep)) {
-    await writeFile9(keep, "", "utf8");
+  const envExamplePath = join25(root, ".env.example");
+  let envExample = "reused";
+  if (!await exists4(envExamplePath)) {
+    await writeFile11(envExamplePath, renderDotEnvExample(), "utf8");
+    envExample = "created";
+  }
+  const gitignore = 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");
   }
   const existing = await readProjectLink(root);
   const defaultAdapter = defaultAdapterFor(info.type);
@@ -32472,7 +33242,14 @@ async function initTestPilotConfig(root, info, adapters) {
   }
   if (link.serverUrl === void 0 && serverUrl) link.serverUrl = serverUrl;
   const projectLinkFile = await writeProjectLink(link, root);
-  return { yaml, runtimeDir: join22(root, ".testpilot"), projectLink: link, projectLinkFile };
+  return {
+    yaml,
+    runtimeDir: join25(root, ".testpilot"),
+    projectLink: link,
+    projectLinkFile,
+    envExample,
+    gitignore
+  };
 }
 async function createProjectOnServer(root, info, _adapters, serverUrl) {
   const git = info.git;
@@ -32501,115 +33278,15 @@ function randomId() {
   return Math.random().toString(16).slice(2, 10);
 }
 
-// src/commands/init/skill-installer.ts
-import { existsSync as existsSync7 } from "node:fs";
-import { access as access3, cp, mkdir as mkdir12, writeFile as writeFile10 } from "node:fs/promises";
-import { dirname as dirname7, join as join23 } from "node:path";
-import { fileURLToPath } from "node:url";
-async function exists4(path) {
-  try {
-    await access3(path);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function resolveSkillSourceDir() {
-  const fromEnv = process.env.TESTPILOT_SKILL_DIR;
-  if (fromEnv) return fromEnv;
-  const bundled = fileURLToPath(new URL("./skills/testpilot", import.meta.url));
-  if (existsSync7(bundled)) return bundled;
-  const inRepo = fileURLToPath(new URL("../../../../../skills/testpilot", import.meta.url));
-  return existsSync7(inRepo) ? inRepo : void 0;
-}
-async function installSkill(root, info, adapters) {
-  const dest = join23(root, ".agents", "skills", "testpilot");
-  let core = "reused";
-  if (!await exists4(join23(dest, "manifest.yaml"))) {
-    const src = resolveSkillSourceDir();
-    if (!src) {
-      throw new Error(
-        "\u65E0\u6CD5\u5B9A\u4F4D TestPilot Skill \u6E90\u76EE\u5F55;\u53EF\u901A\u8FC7\u73AF\u5883\u53D8\u91CF TESTPILOT_SKILL_DIR \u6307\u5B9A skills/testpilot \u8DEF\u5F84"
-      );
-    }
-    await mkdir12(dirname7(dest), { recursive: true });
-    await cp(src, dest, { recursive: true });
-    core = "created";
-  }
-  const config2 = await loadTestpilotConfig(root).catch(() => void 0);
-  const defaultEnvironment = typeof config2?.environment?.default === "string" ? config2.environment.default : "\u672A\u8BBE\u7F6E";
-  const defaultWorkspace = config2?.workspace?.default ?? "\u672A\u8BBE\u7F6E(\u53EF\u5728 yaml workspace.default \u914D\u7F6E)";
-  const refsDir = join23(dest, "references");
-  const files = [
-    ["project.md", () => renderProjectMd(info, adapters, defaultEnvironment, defaultWorkspace)],
-    ["test-conventions.md", renderTestConventionsMd],
-    ["adapters.md", () => renderAdaptersMd(adapters)]
-  ];
-  let references = "reused";
-  for (const [name, render] of files) {
-    const file2 = join23(refsDir, name);
-    if (await exists4(file2)) continue;
-    await mkdir12(refsDir, { recursive: true });
-    await writeFile10(file2, render(), "utf8");
-    references = "created";
-  }
-  return { core, references, dest };
-}
-function renderProjectMd(info, adapters, defaultEnvironment, defaultWorkspace) {
-  const available = adapters.filter((item) => item.available).map((item) => item.id);
-  return `# Project
-
-\u81EA\u52A8\u751F\u6210\u4E8E \`csspilot init\`,\u63CF\u8FF0\u672C\u9879\u76EE\u7684 TestPilot \u63A5\u5165\u4FE1\u606F;Agent \u4F18\u5148\u4ECE\u8FD9\u91CC\u4E86\u89E3\u9879\u76EE\u3002
-
-- Project name: ${info.name}
-- Project type: ${info.type}
-- Language: ${info.language}
-- Package manager: ${info.packageManager}
-- Test directory: tests/e2e
-- Case directory: tests/e2e/cases
-- Available adapters: ${available.length > 0 ? available.join(", ") : "(none detected)"}
-- Default environment: ${defaultEnvironment}
-- Default workspace: ${defaultWorkspace}
-`;
-}
-function renderTestConventionsMd() {
-  return `# Test Conventions
-
-\u672C\u9879\u76EE E2E \u6D4B\u8BD5\u7EA6\u5B9A,Agent \u751F\u6210/\u4FEE\u6539 Case \u65F6\u5FC5\u987B\u9075\u5B88:
-
-1. E2E Case \u4F4D\u4E8E tests/e2e/cases
-2. Case \u4F7F\u7528 TestPilot DSL
-3. \u4E0D\u5141\u8BB8\u76F4\u63A5\u8C03\u7528 Playwright
-4. \u4E0D\u5141\u8BB8\u76F4\u63A5\u8C03\u7528 WeChatIDE
-5. \u4E0D\u5141\u8BB8\u5728 Case \u4E2D\u5199\u660E\u6587\u5BC6\u7801(\u7528 accountRef \u5F15\u7528)
-6. \u4F18\u5148\u590D\u7528\u5DF2\u6709 Case
-7. \u65B0\u589E Case \u5FC5\u987B\u901A\u8FC7 csspilot validate
-8. Case ID \u5FC5\u987B\u552F\u4E00
-`;
-}
-function renderAdaptersMd(adapters) {
-  const lines = adapters.map(
-    (item) => `- ${item.id}: ${item.available ? "\u53EF\u7528" : "\u4E0D\u53EF\u7528"}${item.required ? "(\u9879\u76EE\u9700\u8981)" : "(\u53EF\u9009)"} \u2014 ${item.detail}`
-  );
-  return `# Adapters
-
-\u6267\u884C\u7AEF\u68C0\u6D4B\u7ED3\u679C(\u4EE5 \`csspilot doctor\` \u6700\u65B0\u8F93\u51FA\u4E3A\u51C6):
-
-${lines.join("\n")}
-
-Agent \u6C38\u8FDC\u4E0D\u76F4\u63A5\u64CD\u4F5C Adapter;Case \u7ECF Execution Engine \u8C03\u5EA6\u5230\u5BF9\u5E94 Adapter \u6267\u884C\u3002
-`;
-}
-
 // src/commands/init/test-structure.ts
 import { existsSync as existsSync8, readdirSync as readdirSync2 } from "node:fs";
-import { mkdir as mkdir13, writeFile as writeFile11 } from "node:fs/promises";
-import { join as join24 } from "node:path";
+import { mkdir as mkdir14, writeFile as writeFile12 } from "node:fs/promises";
+import { join as join26 } from "node:path";
 async function initTestStructure(root, _info) {
   const dirs = {
-    cases: join24(root, "tests", "e2e", "cases"),
-    fixtures: join24(root, "tests", "e2e", "fixtures"),
-    data: join24(root, "tests", "e2e", "data")
+    cases: join26(root, "tests", "e2e", "cases"),
+    fixtures: join26(root, "tests", "e2e", "fixtures"),
+    data: join26(root, "tests", "e2e", "data")
   };
   const existed = {
     cases: existsSync8(dirs.cases),
@@ -32617,11 +33294,11 @@ async function initTestStructure(root, _info) {
     data: existsSync8(dirs.data)
   };
   for (const dir of Object.values(dirs)) {
-    await mkdir13(dir, { recursive: true });
+    await mkdir14(dir, { recursive: true });
   }
   for (const [name, dir] of Object.entries(dirs)) {
     if (!existed[name] && readdirSync2(dir).length === 0) {
-      await writeFile11(join24(dir, ".gitkeep"), "", "utf8").catch(() => void 0);
+      await writeFile12(join26(dir, ".gitkeep"), "", "utf8").catch(() => void 0);
     }
   }
   return {
@@ -32655,9 +33332,15 @@ async function runInit(root, options = {}) {
   console.log(
     config2.yaml === "created" ? "\u2713 \u9879\u76EE\u914D\u7F6E          testpilot.yaml" : "\u2713 \u9879\u76EE\u914D\u7F6E          testpilot.yaml(\u5DF2\u5B58\u5728,\u4FDD\u7559)"
   );
-  console.log(`\u2713 Runtime \u76EE\u5F55      ${join25(".testpilot", "artifacts")}`);
+  console.log(`\u2713 Runtime \u76EE\u5F55      ${join27(".testpilot", "artifacts")}`);
   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)"
+  );
+  console.log(
+    config2.gitignore === "exists" ? "\u2713 Git \u5FFD\u7565          .env(\u5DF2\u5728 .gitignore)" : `\u2713 Git \u5FFD\u7565          .env(\u5DF2\u5199\u5165 .gitignore)`
+  );
   const testStructure = await initTestStructure(root, project);
   const reuseNote = project.existingE2eDirs.filter((dir) => dir !== "tests/e2e");
   console.log(
@@ -32667,9 +33350,15 @@ async function runInit(root, options = {}) {
     console.log(`  \u26A0 \u68C0\u6D4B\u5230\u5176\u4ED6 E2E \u76EE\u5F55:${reuseNote.join(", ")}(\u4FDD\u7559\u4E0D\u52A8,\u672A\u5F3A\u5236\u8FC1\u79FB)`);
   }
   const skill = await installSkill(root, project, adapters);
-  console.log(
-    skill.core === "created" ? `\u2713 Skill \u5B89\u88C5        ${join25(".agents", "skills", "testpilot")}` : "\u2713 Skill \u5B89\u88C5        .agents/skills/testpilot/(\u5DF2\u5B58\u5728,\u8DF3\u8FC7)"
-  );
+  if (skill.core === "updated") {
+    console.log(
+      `\u2713 Skill \u66F4\u65B0        .agents/skills/testpilot/(v${skill.coreVersion?.from ?? "?"} -> v${skill.coreVersion?.to ?? "?"})`
+    );
+  } else {
+    console.log(
+      skill.core === "created" ? `\u2713 Skill \u5B89\u88C5        ${join27(".agents", "skills", "testpilot")}` : "\u2713 Skill \u5B89\u88C5        .agents/skills/testpilot/(\u5DF2\u5B58\u5728,\u8DF3\u8FC7)"
+    );
+  }
   console.log(
     skill.references === "created" ? "\u2713 Agent \u4E0A\u4E0B\u6587      references/{project,test-conventions,adapters}.md" : "\u2713 Agent \u4E0A\u4E0B\u6587      references/(\u5DF2\u5B58\u5728,\u4FDD\u7559)"
   );
@@ -32744,9 +33433,20 @@ function makeListCommand() {
 // src/commands/report.ts
 import { exec } 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).action(async (options) => {
+  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();
     try {
+      if (options.summary) {
+        const result = await client.generateSummaryReport({
+          last: Number(options.last) > 0 ? Number(options.last) : void 0
+        });
+        console.log(
+          `\u2713 summary.html  ${result.html}(\u7EDF\u8BA1\u6700\u8FD1 ${result.window.runs} \u6B21\u8FD0\u884C,\u6574\u4F53\u901A\u8FC7\u7387 ${(result.data.kpis.overallRate * 100).toFixed(1)}%)`
+        );
+        console.log(`\u2713 summary.json  ${result.json}`);
+        if (options.open) await openInBrowser(result.html);
+        return;
+      }
       const report = await client.generateReport(options.run);
       console.log(`\u2713 report.json  ${report.json}`);
       console.log(`\u2713 report.html  ${report.html}`);
@@ -32765,7 +33465,7 @@ function openInBrowser(file2) {
 }
 
 // src/commands/run.ts
-import { join as join26 } from "node:path";
+import { join as join28 } from "node:path";
 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();
@@ -32789,7 +33489,7 @@ function makeRunCommand() {
       console.log(
         `Run ${summary.runId}${summary.cancelled ? "(\u5DF2\u53D6\u6D88)" : ""}: ${summary.status.toUpperCase()} \u2014 \u7528\u4F8B \u2713${summary.totals.passed} \u2717${summary.totals.failed},\u6B65\u9AA4 \u2713${summary.totals.stepsPassed} \u2717${summary.totals.stepsFailed} \u21B7${summary.totals.stepsSkipped}${notes ? `(${notes})` : ""}`
       );
-      console.log(`\u4EA7\u7269\u76EE\u5F55:${join26(".testpilot", "artifacts", "runs", summary.runId)}`);
+      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;
     } catch (err) {
@@ -32899,6 +33599,37 @@ function makeSyncMetadataCommand() {
   });
 }
 
+// src/commands/update.ts
+import { writeFile as writeFile13 } from "node:fs/promises";
+import { join as join29 } from "node:path";
+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 root = process.cwd();
+    const dest = join29(".agents", "skills", "testpilot");
+    const skill = await syncSkillFiles(root, { force: options.force });
+    switch (skill.core) {
+      case "created":
+        console.log(`\u2713 Skill \u5B89\u88C5       ${dest}(v${skill.bundledVersion ?? "?"})`);
+        break;
+      case "updated":
+        console.log(
+          `\u2713 Skill \u66F4\u65B0       ${dest} v${skill.installedVersion ?? "?"} -> v${skill.bundledVersion ?? "?"}`
+        );
+        break;
+      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");
+    console.log(
+      gitignore === "exists" ? "\u2713 .gitignore       \u5DF2\u5FFD\u7565 .env" : "\u2713 .gitignore       \u5DF2\u8FFD\u52A0\u5FFD\u7565 .env"
+    );
+    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");
+  });
+  return update;
+}
+
 // src/commands/validate.ts
 function makeValidateCommand() {
   return new Command("validate").description("\u6821\u9A8C\u7528\u4F8B DSL").argument("[paths...]", "\u7528\u4F8B\u6587\u4EF6\u6216\u76EE\u5F55,\u9ED8\u8BA4\u6309\u9879\u76EE\u914D\u7F6E").action(async (paths) => {
@@ -32935,10 +33666,13 @@ function makeValidateCommand() {
 }
 
 // src/cli.ts
-var CLI_VERSION = "0.3.2";
+var CLI_VERSION = "0.5.0";
 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).addCommand(makeInitCommand()).addCommand(makeValidateCommand()).addCommand(makeListCommand()).addCommand(makeRunCommand()).addCommand(makeReportCommand()).addCommand(makeSyncMetadataCommand()).addCommand(makeDoctorCommand()).addCommand(makeCiCommand());
+  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", () => {
+    console.log(CLI_VERSION);
+    process.exit(0);
+  }).addCommand(makeInitCommand()).addCommand(makeValidateCommand()).addCommand(makeListCommand()).addCommand(makeRunCommand()).addCommand(makeReportCommand()).addCommand(makeSyncMetadataCommand()).addCommand(makeDoctorCommand()).addCommand(makeUpdateCommand()).addCommand(makeCiCommand());
   return program2;
 }