csspilot 0.3.2 → 0.4.0

package/dist/bin.js

@@ -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,8 +30338,8 @@ 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 join22 } from "node:path";
 
 // ../../packages/sdk/src/client.ts
 import { isAbsolute as isAbsolute3, join as join17 } from "node:path";
@@ -32167,8 +32170,12 @@ async function collectEnvVarRefs(root) {
     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();
 }
@@ -32260,6 +32267,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 mkdir11, writeFile as writeFile9 } from "node:fs/promises";
+import { dirname as dirname7, join as join21 } 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 = join21(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(join21(src, name), join21(dest, name), { recursive: true, force: true });
+  }
+  for (const dir of CORE_DIRS) {
+    if (existsSync6(join21(src, dir))) {
+      await cp(join21(src, dir), join21(dest, dir), { recursive: true, force: true });
+    }
+  }
+}
+async function syncSkillFiles(root, options = {}) {
+  const dest = join21(root, ".agents", "skills", "testpilot");
+  const bundledVersion = readManifestVersion(resolveSkillSourceDir() ?? "");
+  if (!await exists3(join21(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 mkdir11(dirname7(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 = join21(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 = join21(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 = join21(refsDir, name);
+    if (await exists3(file2)) continue;
+    await mkdir11(refsDir, { recursive: true });
+    await writeFile9(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 +32429,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(join22(root, ".testpilot", "project.json")) ? ok(".testpilot/project.json") : error62(".testpilot/project.json", "\u8FD0\u884C npx csspilot init \u751F\u6210"),
+    existsSync7(join22(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([join22(root, casesDir)], { root }).catch(() => []);
   const invalidCount = cases.filter((item) => !item.valid).length;
-  const testDir = join21(root, "tests", "e2e");
+  const testDir = join22(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(join22(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 = join22(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(join22(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",
@@ -32387,11 +32544,11 @@ function makeDoctorCommand() {
 import { join as join25 } 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 mkdir12, readFile as readFile8, writeFile as writeFile10 } from "node:fs/promises";
+import { basename as basename2, join as join23 } from "node:path";
+async function exists4(path) {
   try {
-    await access2(path);
+    await access3(path);
     return true;
   } catch {
     return false;
@@ -32432,28 +32589,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 = join23(root, ".gitignore");
+  if (!await exists4(gitignorePath)) {
+    await writeFile10(gitignorePath, `# ${comment}
+${entry}
+`, "utf8");
+    return "created";
+  }
+  const content = await readFile8(gitignorePath, "utf8");
+  if (content.split(/\r?\n/).some((item) => item.trim() === entry)) {
+    return "exists";
+  }
+  const separator = content.endsWith("\n") || content === "" ? "" : "\n";
+  await writeFile10(gitignorePath, `${content}${separator}# ${comment}
+${entry}
+`, "utf8");
+  return "updated";
+}
 async function initTestPilotConfig(root, info, adapters) {
-  const yamlPath = join22(root, "testpilot.yaml");
+  const yamlPath = join23(root, "testpilot.yaml");
   let yaml = "reused";
-  if (!await exists3(yamlPath)) {
-    await writeFile9(yamlPath, renderTestpilotYaml(info), "utf8");
+  if (!await exists4(yamlPath)) {
+    await writeFile10(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 = join23(root, ".env.example");
+  let envExample = "reused";
+  if (!await exists4(envExamplePath)) {
+    await writeFile10(envExamplePath, renderDotEnvExample(), "utf8");
+    envExample = "created";
+  }
+  const gitignore = await ensureGitignoreEntry(root, ".env");
+  const runtimeDir = join23(root, ".testpilot", "artifacts");
+  await mkdir12(runtimeDir, { recursive: true });
+  const keep = join23(runtimeDir, ".gitkeep");
+  if (!await exists4(keep)) {
+    await writeFile10(keep, "", "utf8");
   }
   const existing = await readProjectLink(root);
   const defaultAdapter = defaultAdapterFor(info.type);
@@ -32472,7 +32673,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: join23(root, ".testpilot"),
+    projectLink: link,
+    projectLinkFile,
+    envExample,
+    gitignore
+  };
 }
 async function createProjectOnServer(root, info, _adapters, serverUrl) {
   const git = info.git;
@@ -32501,106 +32709,6 @@ 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";
@@ -32658,6 +32766,12 @@ async function runInit(root, options = {}) {
   console.log(`\u2713 Runtime \u76EE\u5F55      ${join25(".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 +32781,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        ${join25(".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)"
   );
@@ -32899,6 +33019,37 @@ function makeSyncMetadataCommand() {
   });
 }
 
+// src/commands/update.ts
+import { writeFile as writeFile12 } from "node:fs/promises";
+import { join as join27 } 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 = join27(".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 writeFile12(join27(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 +33086,10 @@ function makeValidateCommand() {
 }
 
 // src/cli.ts
-var CLI_VERSION = "0.3.2";
+var CLI_VERSION = "0.4.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).addCommand(makeInitCommand()).addCommand(makeValidateCommand()).addCommand(makeListCommand()).addCommand(makeRunCommand()).addCommand(makeReportCommand()).addCommand(makeSyncMetadataCommand()).addCommand(makeDoctorCommand()).addCommand(makeUpdateCommand()).addCommand(makeCiCommand());
   return program2;
 }
 

package/dist/index.js

@@ -10449,8 +10449,8 @@ 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 join22 } from "node:path";
 
 // ../../packages/core/src/errors/index.ts
 var TestPilotError = class extends Error {
@@ -30243,7 +30243,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
   };
 }
 
@@ -32166,8 +32169,12 @@ async function collectEnvVarRefs(root) {
     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();
 }
@@ -32259,6 +32266,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 mkdir11, writeFile as writeFile9 } from "node:fs/promises";
+import { dirname as dirname7, join as join21 } 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 = join21(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(join21(src, name), join21(dest, name), { recursive: true, force: true });
+  }
+  for (const dir of CORE_DIRS) {
+    if (existsSync6(join21(src, dir))) {
+      await cp(join21(src, dir), join21(dest, dir), { recursive: true, force: true });
+    }
+  }
+}
+async function syncSkillFiles(root, options = {}) {
+  const dest = join21(root, ".agents", "skills", "testpilot");
+  const bundledVersion = readManifestVersion(resolveSkillSourceDir() ?? "");
+  if (!await exists3(join21(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 mkdir11(dirname7(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 = join21(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 = join21(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 = join21(refsDir, name);
+    if (await exists3(file2)) continue;
+    await mkdir11(refsDir, { recursive: true });
+    await writeFile9(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 = [];
@@ -32283,25 +32428,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(join22(root, ".testpilot", "project.json")) ? ok(".testpilot/project.json") : error62(".testpilot/project.json", "\u8FD0\u884C npx csspilot init \u751F\u6210"),
+    existsSync7(join22(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([join22(root, casesDir)], { root }).catch(() => []);
   const invalidCount = cases.filter((item) => !item.valid).length;
-  const testDir = join21(root, "tests", "e2e");
+  const testDir = join22(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(join22(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 = join22(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(join22(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",
@@ -32386,11 +32543,11 @@ function makeDoctorCommand() {
 import { join as join25 } 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 mkdir12, readFile as readFile8, writeFile as writeFile10 } from "node:fs/promises";
+import { basename as basename2, join as join23 } from "node:path";
+async function exists4(path) {
   try {
-    await access2(path);
+    await access3(path);
     return true;
   } catch {
     return false;
@@ -32431,28 +32588,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 = join23(root, ".gitignore");
+  if (!await exists4(gitignorePath)) {
+    await writeFile10(gitignorePath, `# ${comment}
+${entry}
+`, "utf8");
+    return "created";
+  }
+  const content = await readFile8(gitignorePath, "utf8");
+  if (content.split(/\r?\n/).some((item) => item.trim() === entry)) {
+    return "exists";
+  }
+  const separator = content.endsWith("\n") || content === "" ? "" : "\n";
+  await writeFile10(gitignorePath, `${content}${separator}# ${comment}
+${entry}
+`, "utf8");
+  return "updated";
+}
 async function initTestPilotConfig(root, info, adapters) {
-  const yamlPath = join22(root, "testpilot.yaml");
+  const yamlPath = join23(root, "testpilot.yaml");
   let yaml = "reused";
-  if (!await exists3(yamlPath)) {
-    await writeFile9(yamlPath, renderTestpilotYaml(info), "utf8");
+  if (!await exists4(yamlPath)) {
+    await writeFile10(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 = join23(root, ".env.example");
+  let envExample = "reused";
+  if (!await exists4(envExamplePath)) {
+    await writeFile10(envExamplePath, renderDotEnvExample(), "utf8");
+    envExample = "created";
+  }
+  const gitignore = await ensureGitignoreEntry(root, ".env");
+  const runtimeDir = join23(root, ".testpilot", "artifacts");
+  await mkdir12(runtimeDir, { recursive: true });
+  const keep = join23(runtimeDir, ".gitkeep");
+  if (!await exists4(keep)) {
+    await writeFile10(keep, "", "utf8");
   }
   const existing = await readProjectLink(root);
   const defaultAdapter = defaultAdapterFor(info.type);
@@ -32471,7 +32672,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: join23(root, ".testpilot"),
+    projectLink: link,
+    projectLinkFile,
+    envExample,
+    gitignore
+  };
 }
 async function createProjectOnServer(root, info, _adapters, serverUrl) {
   const git = info.git;
@@ -32500,106 +32708,6 @@ 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";
@@ -32657,6 +32765,12 @@ async function runInit(root, options = {}) {
   console.log(`\u2713 Runtime \u76EE\u5F55      ${join25(".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(
@@ -32666,9 +32780,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        ${join25(".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)"
   );
@@ -32898,6 +33018,37 @@ function makeSyncMetadataCommand() {
   });
 }
 
+// src/commands/update.ts
+import { writeFile as writeFile12 } from "node:fs/promises";
+import { join as join27 } 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 = join27(".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 writeFile12(join27(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) => {
@@ -32934,10 +33085,10 @@ function makeValidateCommand() {
 }
 
 // src/cli.ts
-var CLI_VERSION = "0.3.2";
+var CLI_VERSION = "0.4.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).addCommand(makeInitCommand()).addCommand(makeValidateCommand()).addCommand(makeListCommand()).addCommand(makeRunCommand()).addCommand(makeReportCommand()).addCommand(makeSyncMetadataCommand()).addCommand(makeDoctorCommand()).addCommand(makeUpdateCommand()).addCommand(makeCiCommand());
   return program2;
 }
 export {

package/dist/skills/testpilot/SKILL.md

@@ -12,6 +12,7 @@ TestPilot is a **tool, not a business test project**. Business cases always belo
 
 Use TestPilot when the user wants to:
 
+- review test requirements for testability
 - create business test cases
 - validate test cases
 - run tests
@@ -20,12 +21,13 @@ Use TestPilot when the user wants to:
 ## Core workflow
 
 1. Understand user requirement
-2. Inspect project
-3. Identify test target
-4. Create TestPilot Case (`tests/e2e/cases/*.yaml`)
-5. Validate Case (`npx csspilot validate`)
-6. Run Case (`npx csspilot run`)
-7. Analyze result (`npx csspilot report`)
+2. Review requirements & produce test points (`workflows/test-requirements-review.md`)
+3. Inspect project
+4. Identify test target
+5. Create TestPilot Case (`tests/e2e/cases/*.yaml`, linked to test point IDs)
+6. Validate Case (`npx csspilot validate`)
+7. Run Case (`npx csspilot run`)
+8. Analyze result (`npx csspilot report`)
 
 ## Important rules
 
@@ -72,4 +74,5 @@ Read `references/` first (generated by `csspilot init` for this project):
 - `rules/dsl.md` — case structure and the V0.1 action set
 - `rules/locator.md` — locator forms and the no-invention rule
 - `rules/assertion.md` — assertions and variable references
-- `workflows/` — step-by-step workflows (create / validate / run / analyze)
+- `workflows/test-requirements-review.md` — requirements review, test point checklist
+- `workflows/` — step-by-step workflows (review / create / validate / run / analyze)

package/dist/skills/testpilot/manifest.yaml

@@ -2,12 +2,13 @@
 # `npx csspilot init` 会把整个 skills/testpilot/ 安装到业务项目 .agents/skills/testpilot/
 id: testpilot
 name: TestPilot
-version: 0.2.0
+version: 0.4.0
 
 description: >
   AI Native cross-platform testing skill.
 
 capabilities:
+  - test-requirements-review
   - create-case
   - validate
   - run
@@ -37,4 +38,4 @@ permissions:
       - npx
       - pnpm
       - npm
-      - testpilot
+      - csspilot

package/dist/skills/testpilot/workflows/create-case.md

@@ -1,13 +1,16 @@
 # Workflow:创建测试 Case
 
-输入:用户的一句业务需求(如"帮我测试用户下单")。
+输入:用户需求,或 `test-requirements-review` 产出的**测试点清单**(推荐先做需求评审)。
 
-1. 阅读本 Skill:`rules/dsl.md`、`rules/case-design.md`、`rules/locator.md`。
-2. 分析项目结构:确定被测端(miniapp / web)与业务入口页面。
-3. 找到业务路径上的真实页面与组件,收集证据(读代码 / DOM / 现有测试)。
-4. 确定测试路径:从入口到业务结果页的完整步骤。
-5. 按 DSL 规范生成 Case,写入 `tests/e2e/cases/<case-id>.yaml`。
+1. 尚无测试点清单时,先执行 `workflows/test-requirements-review.md`;已有清单则直接使用。
+2. 阅读本 Skill:`rules/dsl.md`、`rules/case-design.md`、`rules/locator.md`。
+3. 分析项目结构:确定被测端(miniapp / web)与业务入口页面。
+4. 针对测试点收集证据(读代码 / DOM / 现有测试),确定业务路径:从入口到业务结果页的完整步骤。
+5. 按 DSL 规范生成 Case,写入 `tests/e2e/cases/<case-id>.yaml`:
+   - 一条 Case 覆盖一个测试点(或一组强关联测试点)
+   - Case 的 `description` 注明关联的测试点编号(如 `测试点: TP-001`),保持需求可溯源
+   - 按评审产出的平台执行信息声明 `accountRef` / `workspace`;发现 `.env` 缺少某平台的地址或凭据变量时,向用户索取后写入 `.env`,**不写进 Case**
 6. 执行 `npx csspilot validate tests/e2e/cases/<case-id>.yaml`。
 7. 校验失败则修复 Case 后重新 validate,直到通过。
 
-禁止:跳过第 2-3 步直接生成 Case(AI 不能凭空生成测试)。
+禁止:跳过第 3-4 步直接生成 Case(AI 不能凭空生成测试)。

package/dist/skills/testpilot/workflows/test-requirements-review.md

@@ -0,0 +1,61 @@
+# Workflow:测试需求评审(可测性评审 + 测试点分析)
+
+输入:需求文档 / PRD / 用户的一句话(如"帮我测试用户下单")。
+产出:**测试点清单** + **平台执行信息表** + 澄清问题 + 评审结论。测试点清单是 `create-case` 的正式输入。
+
+## 步骤
+
+1. **复述理解**:用自己的话列出需求覆盖的功能点与业务流程,向用户确认理解偏差。
+2. **平台盘点**:识别需求涉及的执行端(miniapp / web / api)。跨端需求(如"小程序下单、Web 后台验证")必须逐平台澄清执行信息,见下方"多平台"一节。
+3. **可测性检查清单**(逐项过):
+   - 验收标准是否明确:输入 / 操作步骤 / 预期结果是否可判定
+   - 边界与异常:空值、极值、重复提交、并发、权限、网络异常
+   - 数据准备可行性:测试账号、mock 数据、上下游依赖是否可用
+   - 平台与入口:miniapp / web 的页面路径与入口是否真实存在(不确定时先看项目代码)
+   - 回归范围:改动是否影响现有功能,需要哪些已有 Case 回归
+4. **输出测试点清单**,每条包含:
+
+   | 字段 | 说明 |
+   | --- | --- |
+   | 编号 | `TP-001` 格式,Case 需回链 |
+   | 模块 | 所属功能模块 |
+   | 场景 | 一句话描述验证什么 |
+   | 类型 | 正向 / 边界 / 异常 |
+   | 优先级 | P0 / P1 / P2 |
+   | 平台 | miniapp / web / 双端 |
+
+5. **澄清阻塞项**:需求缺失、矛盾、不可判定时,列出问题向用户提问。**不猜测**。
+6. **给出评审结论**:
+   - 可测:测试点清单完整,直接进入 `create-case`
+   - 有条件可测:部分测试点依赖澄清,先对可执行部分建 Case
+   - 不可测:说明缺口,等待需求补充
+
+## 多平台:平台执行信息澄清
+
+需求涉及多个平台时,**每个平台都必须澄清以下三项**;缺任何一项,该平台相关测试点只能标记"有条件可测",不得开始写 Case:
+
+| 平台 | 必须澄清 | 落地位置 |
+| --- | --- | --- |
+| web | 测试地址(baseUrl)+ 页面入口路由 + 登录角色 | `.env` 的 `WEB_BASE_URL` / `TEST_BASE_URL`;`accountRef` |
+| miniapp | 小程序项目路径 + 起始页面路由 + 登录角色(连哪个环境后端) | `.env` 的 `MINIAPP_PROJECT_PATH`;`accountRef` |
+| api | 服务 baseUrl + 鉴权方式(token / session)+ 账号角色 | `.env` 的 `API_BASE_URL`;`accountRef` |
+
+规则:
+
+- **登录角色**:每个平台确认用什么角色(普通用户 / 管理员 / 游客),映射为 `accountRef`(如 `admin` / `test-user`);真实凭据放 `TESTPILOT_ACCOUNT_<REF大写>` 环境变量或 Server Secrets,**禁止写进 Case**
+- **测试地址**:一律指向测试环境,写入 `.env`(如 `WEB_BASE_URL`);**禁止把内网 / 生产地址写进 Case 或 testpilot.yaml**
+- **使用 Workspace 的项目**:以上信息应登记为 Workspace 的绑定(项目 → 环境),Case 用 `workspace: <名称>` 声明,不逐条硬编码
+
+### 澄清问题示例(多平台需求)
+
+- Web 后台的测试地址是什么?订单查询页面的入口路由是?
+- 小程序连接哪个环境的后端?小程序项目目录在本机哪里?
+- 各平台分别用什么角色登录(普通用户 / 管理员)?该角色是否有完成流程所需的权限?
+- 这些地址和账号是否已写入 `.env`?缺哪个我来补?
+
+## 铁律
+
+- 没有测试点清单,不要进入 `create-case`。
+- 涉及多平台但执行信息(地址 / 入口 / 登录角色)不全时,结论只能是"有条件可测",先澄清再建 Case。
+- 评审基于需求 + 项目代码/页面证据;两项都没有时先收集证据,不空谈。
+- 每个测试点必须可验证:都能回答"怎么判定通过"。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "csspilot",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "TestPilot — AI Native 跨端业务测试基础设施 CLI",
   "license": "MIT",
   "repository": {