create-weapp-vite 2.0.76 → 2.0.78

package/README.md

@@ -10,6 +10,7 @@
 - 内置多种模板（默认、Wevu、Tailwindcss、TDesign、Vant 等）
 - 自动对齐 `weapp-vite` 与 `wevu` 版本
 - 自动处理 `.gitignore` 写入
+- 可选安装推荐的 AI skills（`sonofmagic/skills`）
 
 ## 安装
 
@@ -31,10 +32,24 @@ npx create-weapp-vite
 pnpm create weapp-vite
 ```
 
+交互流程会默认询问是否安装推荐的 AI skills，并提示将执行：
+
+```bash
+npx skills add sonofmagic/skills
+```
+
+如果你暂时不想安装，也可以先跳过，后面再手动执行上面的命令。
+
 非交互式创建：
 
 ```bash
 pnpm create weapp-vite my-app wevu
+
+# 显式安装推荐 skills
+pnpm create weapp-vite my-app wevu --install-skills
+
+# 显式跳过推荐 skills 安装
+pnpm create weapp-vite my-app wevu --no-install-skills
 ```
 
 在代码中使用：
@@ -43,6 +58,7 @@ pnpm create weapp-vite my-app wevu
 import { createProject, TemplateName } from 'create-weapp-vite'
 
 await createProject('my-app', TemplateName.wevu)
+await createProject('my-app', TemplateName.wevu, { installSkills: true })
 ```
 
 ## 配置

package/dist/cli.js

@@ -1,13 +1,33 @@
-import { n as TemplateName, t as createProject } from "./src-BhGRh_fC.js";
+import { n as RECOMMENDED_SKILLS_INSTALL_COMMAND, r as TemplateName, t as createProject } from "./src-CCWjAwFU.js";
 import logger from "@weapp-core/logger";
-import fs from "fs-extra";
-import path from "node:path";
+import { fs } from "@weapp-core/shared";
 import process from "node:process";
+import path from "node:path";
 import { confirm, input, select } from "@inquirer/prompts";
 //#region src/cli.ts
 const cwd = process.cwd();
+function parseCliArgs(argv) {
+	const positionals = [];
+	let installSkills;
+	for (const arg of argv) {
+		if (arg === "--install-skills") {
+			installSkills = true;
+			continue;
+		}
+		if (arg === "--no-install-skills") {
+			installSkills = false;
+			continue;
+		}
+		positionals.push(arg);
+	}
+	return {
+		targetDir: positionals[0],
+		templateName: positionals[1],
+		installSkills
+	};
+}
 async function run() {
-	const [argTarget, argTemplate] = process.argv.slice(2);
+	const { targetDir: argTarget, templateName: argTemplate, installSkills: argInstallSkills } = parseCliArgs(process.argv.slice(2));
 	const isArgMode = Boolean(argTarget);
 	const targetDir = isArgMode ? argTarget : await input({
 		message: "创建应用的目录",
@@ -53,7 +73,10 @@ async function run() {
 			}
 		],
 		default: TemplateName.default
-	}));
+	}), { installSkills: isArgMode ? argInstallSkills ?? false : await confirm({
+		message: `是否安装推荐的 AI skills？将执行 \`${RECOMMENDED_SKILLS_INSTALL_COMMAND}\`，也可稍后手动执行`,
+		default: true
+	}) });
 }
 /**
 * @description CLI 主入口执行 Promise（便于测试或外部调用）

package/dist/index.d.ts

@@ -10,9 +10,12 @@ declare enum TemplateName {
 }
 //#endregion
 //#region src/createProject.d.ts
+interface CreateProjectOptions {
+  installSkills?: boolean;
+}
 /**
  * @description 根据模板创建项目
  */
-declare function createProject(targetDir?: string, templateName?: TemplateName): Promise<void>;
+declare function createProject(targetDir?: string, templateName?: TemplateName, options?: CreateProjectOptions): Promise<void>;
 //#endregion
-export { TemplateName, createProject };
+export { type CreateProjectOptions, TemplateName, createProject };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { n as TemplateName, t as createProject } from "./src-BhGRh_fC.js";
+import { r as TemplateName, t as createProject } from "./src-CCWjAwFU.js";
 export { TemplateName, createProject };

package/dist/{src-BhGRh_fC.js → src-CCWjAwFU.js}

@@ -1,16 +1,18 @@
 import { fileURLToPath } from "node:url";
 import logger from "@weapp-core/logger";
-import fs from "fs-extra";
+import { fs } from "@weapp-core/shared";
 import path from "pathe";
 import https from "node:https";
+import { spawn } from "node:child_process";
+import process from "node:process";
 //#region ../../packages-runtime/weapi/package.json
-var version$2 = "0.2.2";
+var version$2 = "0.2.3";
 //#endregion
 //#region ../../packages-runtime/wevu/package.json
-var version$1 = "6.13.3";
+var version$1 = "6.14.0";
 //#endregion
 //#region ../weapp-vite/package.json
-var version = "6.13.3";
+var version = "6.14.0";
 //#endregion
 //#region src/enums.ts
 let TemplateName = /* @__PURE__ */ function(TemplateName) {
@@ -51,9 +53,17 @@ function createAgentsGuidelines(templateName) {
 		"- Prefer project scripts such as `pnpm dev`, `pnpm build`, `pnpm open`, and `pnpm g` before ad-hoc shell commands.",
 		"- Use `weapp-vite prepare` or `wv prepare` when managed support files under `.weapp-vite/` need to be refreshed.",
 		"- Prefer `weapp-vite screenshot` or `wv screenshot` for mini-program screenshot acceptance.",
+		"- Prefer `weapp-vite compare` or `wv compare` for mini-program screenshot diff, baseline comparison, and visual regression checks.",
 		"- Prefer `weapp-vite ide logs --open` or `wv ide logs --open` for DevTools terminal log bridging.",
 		"- Do not default to generic browser screenshot tools when the target is the mini-program runtime in WeChat DevTools.",
 		"",
+		"## AI Intent Routing",
+		"",
+		"- When the request mentions screenshot, 截图, 页面快照, runtime screenshot, or capture the current mini-program page, default to `weapp-vite screenshot` / `wv screenshot`.",
+		"- When the request mentions screenshot compare, 截图对比, diff, baseline, visual regression, 像素对比, or acceptance comparison, default to `weapp-vite compare` / `wv compare`.",
+		"- Treat these commands as the primary screenshot contract for AI workflows in this project.",
+		"- Only fall back to generic browser screenshot tools when the target is explicitly the web runtime instead of WeChat DevTools.",
+		"",
 		"## Weapp-vite Workflow",
 		"",
 		"- Keep `vite.config.ts` as the source of truth for `weapp` config, output behavior, and IDE/MCP automation.",
@@ -71,9 +81,9 @@ function createAgentsGuidelines(templateName) {
 		"",
 		"- Recommend installing shared skills with `npx skills add sonofmagic/skills`.",
 		"- In Codex/Claude environments, prefer these skills first when available:",
-		"  - `$weapp-vite-best-practices` for config, build, subpackage, route, and CLI orchestration work.",
+		"  - `$weapp-vite-best-practices` for config, build, subpackage, route, DevTools CLI orchestration, and screenshot/compare command work.",
 		"  - `$weapp-vite-vue-sfc-best-practices` for `.vue` SFC macros, JSON blocks, and template compatibility.",
-		"  - `$weapp-ide-cli-best-practices` for DevTools automation, screenshot, preview, upload, and config commands.",
+		"  - `$release-and-changeset-best-practices` for issue delivery, changesets, release decisions, and PR workflow.",
 		"  - `$docs-and-website-sync` when documentation or AI guidance must be refreshed together with code changes."
 	];
 	if (supportsWevu(templateName)) lines.push("  - `$wevu-best-practices` for `wevu` runtime lifecycle, state, store, and event contracts.", "", "## Wevu Authoring", "", "- Import runtime APIs from `wevu` in business code.", "- Register lifecycle hooks synchronously in `setup()` and avoid hook registration after `await`.", "- Prefer `ref`, `reactive`, `computed`, and explicit event contracts over large opaque state writes.", "- Use `storeToRefs` when destructuring store state/getters.", "- Treat mini-program runtime constraints as primary; do not assume Vue web-only behavior.");
@@ -105,12 +115,10 @@ const TEMPLATE_CATALOG = {
 	"class-variance-authority": "^0.7.1",
 	"comment-json": "^4.6.2",
 	"estree-walker": "^3.0.3",
-	"fs-extra": "^11.3.4",
 	"gm-crypto": "^0.1.12",
 	"lru-cache": "^11.2.7",
 	"magic-string": "^0.30.21",
 	"miniprogram-api-typings": "^5.1.2",
-	"object-hash": "^3.0.0",
 	"oxc-parser": "^0.123.0",
 	"oxc-walker": "^0.7.0",
 	"pkg-types": "^2.3.0",
@@ -196,6 +204,37 @@ async function latestVersion(packageName, prefix = "^", fetch = getLatestVersion
 	}
 }
 //#endregion
+//#region src/skills.ts
+const RECOMMENDED_SKILLS_SOURCE = "sonofmagic/skills";
+const RECOMMENDED_SKILLS_INSTALL_COMMAND = `npx skills add ${RECOMMENDED_SKILLS_SOURCE}`;
+function resolveNpxCommand() {
+	return process.platform === "win32" ? "npx.cmd" : "npx";
+}
+/**
+* @description 安装推荐的 AI skills。
+*/
+async function installRecommendedSkills(cwd) {
+	const command = resolveNpxCommand();
+	await new Promise((resolve, reject) => {
+		const child = spawn(command, [
+			"skills",
+			"add",
+			RECOMMENDED_SKILLS_SOURCE
+		], {
+			cwd,
+			stdio: "inherit"
+		});
+		child.on("error", reject);
+		child.on("exit", (code) => {
+			if (code === 0) {
+				resolve();
+				return;
+			}
+			reject(/* @__PURE__ */ new Error(`skills install exited with code ${code ?? "unknown"}`));
+		});
+	});
+}
+//#endregion
 //#region src/gitignore.ts
 const DEFAULT_GITIGNORE = `# dependencies
 node_modules
@@ -333,6 +372,7 @@ async function updateGitIgnore(options) {
 //#region src/createProject.ts
 const DIGIT_RE = /\d/;
 const CRLF_RE = /\r\n/g;
+const WINDOWS_VERBATIM_PATH_RE = /^\\\\\?\\/;
 const moduleDir = path.dirname(fileURLToPath(import.meta.url));
 const TEMPLATE_DIR_MAP = {
 	[TemplateName.default]: "weapp-vite-template",
@@ -349,9 +389,12 @@ function resolveWorkspaceTemplateDir(templateName) {
 	const templateDirName = TEMPLATE_DIR_MAP[templateName];
 	return templateDirName ? path.resolve(moduleDir, "../../../templates", templateDirName) : path.resolve(moduleDir, "../../../templates", templateName);
 }
+function normalizeTemplatePath(value) {
+	return value.replace(WINDOWS_VERBATIM_PATH_RE, "").split("\\").join("/");
+}
 function normalizeTemplateRelativePath(relativePath) {
 	if (!relativePath || relativePath === ".") return "";
-	return relativePath.split("\\").join("/");
+	return normalizeTemplatePath(relativePath);
 }
 async function resolveTemplateDirs(templateName) {
 	const packagedTemplateDir = path.resolve(moduleDir, "../templates", templateName);
@@ -363,7 +406,7 @@ async function resolveTemplateDirs(templateName) {
 	};
 }
 function shouldSkipTemplateFile(filePath, templateRoot) {
-	const relativePath = normalizeTemplateRelativePath(path.relative(templateRoot, filePath));
+	const relativePath = normalizeTemplateRelativePath(path.relative(normalizeTemplatePath(templateRoot), normalizeTemplatePath(filePath)));
 	if (!relativePath) return false;
 	return relativePath === "node_modules" || relativePath.startsWith("node_modules/") || relativePath.includes("/node_modules/") || relativePath === ".weapp-vite" || relativePath.startsWith(".weapp-vite/") || relativePath.includes("/.weapp-vite/") || relativePath === "vite.config.ts.timestamp" || relativePath.endsWith("/vite.config.ts.timestamp") || relativePath === "dist" || relativePath.startsWith("dist/") || relativePath.includes("/dist/") || relativePath === "CHANGELOG.md" || relativePath.endsWith("/CHANGELOG.md") || relativePath === ".turbo" || relativePath.startsWith(".turbo/") || relativePath.includes("/.turbo/") || relativePath === ".DS_Store" || relativePath.endsWith("/.DS_Store");
 }
@@ -465,7 +508,7 @@ function normalizeTemplateDependencySpecs(pkgJson) {
 /**
 * @description 根据模板创建项目
 */
-async function createProject(targetDir = "", templateName = TemplateName.default) {
+async function createProject(targetDir = "", templateName = TemplateName.default, options = {}) {
 	const { preferredTemplateDir, workspaceTemplateDir } = await resolveTemplateDirs(templateName);
 	const dotGitignorePath = path.resolve(targetDir, ".gitignore");
 	const existingGitignore = await fs.pathExists(dotGitignorePath) ? await fs.readFile(dotGitignorePath, "utf8") : null;
@@ -494,7 +537,19 @@ async function createProject(targetDir = "", templateName = TemplateName.default
 		root: targetDir,
 		write: true
 	});
+	if (options.installSkills) {
+		logger.info(`🤖 即将安装 AI skills：${RECOMMENDED_SKILLS_INSTALL_COMMAND}`);
+		logger.info("如果你更想手动执行，也可以在项目创建后自行运行上面的命令。");
+		try {
+			await installRecommendedSkills(targetDir);
+			logger.log("✨ 已安装推荐的 AI skills!");
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			logger.warn(`安装 AI skills 失败：${message}`);
+			logger.warn(`你可以稍后手动执行：${RECOMMENDED_SKILLS_INSTALL_COMMAND}`);
+		}
+	}
 	logger.log("✨ 创建模板成功!");
 }
 //#endregion
-export { TemplateName as n, createProject as t };
+export { RECOMMENDED_SKILLS_INSTALL_COMMAND as n, TemplateName as r, createProject as t };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-weapp-vite",
   "type": "module",
-  "version": "2.0.76",
+  "version": "2.0.78",
   "description": "create-weapp-vite",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -48,10 +48,10 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.3.2",
-    "fs-extra": "^11.3.4",
     "pathe": "^2.0.3",
     "pkg-types": "^2.3.0",
-    "@weapp-core/logger": "^3.1.1"
+    "@weapp-core/logger": "^3.1.1",
+    "@weapp-core/shared": "^3.0.3"
   },
   "scripts": {
     "catalog:sync": "node --import tsx scripts/generate-template-catalog.ts",

package/templates/default/.vscode/settings.json

@@ -1,4 +1,73 @@
 {
+  "prettier.enable": false,
+  "editor.formatOnSave": false,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit",
+    "source.organizeImports": "never"
+  },
+  "eslint.rules.customizations": [
+    {
+      "rule": "format/*",
+      "severity": "off"
+    },
+    {
+      "rule": "*-indent",
+      "severity": "off"
+    },
+    {
+      "rule": "*-spacing",
+      "severity": "off"
+    },
+    {
+      "rule": "*-spaces",
+      "severity": "off"
+    },
+    {
+      "rule": "*-order",
+      "severity": "off"
+    },
+    {
+      "rule": "*-dangle",
+      "severity": "off"
+    },
+    {
+      "rule": "*-newline",
+      "severity": "off"
+    },
+    {
+      "rule": "*quotes",
+      "severity": "off"
+    },
+    {
+      "rule": "*semi",
+      "severity": "off"
+    }
+  ],
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    "typescript",
+    "typescriptreact",
+    "vue",
+    "html",
+    "markdown",
+    "json",
+    "jsonc",
+    "yaml",
+    "toml",
+    "xml",
+    "gql",
+    "graphql",
+    "astro",
+    "css",
+    "less",
+    "scss",
+    "pcss",
+    "postcss"
+  ],
+  "css.validate": false,
+  "less.validate": false,
+  "scss.validate": false,
   "files.associations": {
     "*.wxml": "html",
     "*.wxss": "css"

package/templates/default/project.config.json

@@ -40,4 +40,4 @@
     "include": []
   },
   "appid": "wx6ffee4673b257014"
-}
+}

package/templates/default/src/components/HelloWorld/HelloWorld.ts

@@ -1,3 +1,5 @@
+import { wpi } from '@wevu/api'
+
 interface HelloWorldLink {
   text: string
   url: string
@@ -45,8 +47,8 @@ Component({
       }
 
       try {
-        await wx.setClipboardData({ data: url })
-        wx.showToast({
+        await wpi.setClipboardData({ data: url })
+        await wpi.showToast({
           title: '链接已复制',
           icon: 'success',
           duration: 1500,

package/templates/default/src/pages/index/index.ts

@@ -1,3 +1,5 @@
+import { wpi } from '@wevu/api'
+
 Page({
   data: {
     hello: {
@@ -21,8 +23,8 @@ Page({
     // eslint-disable-next-line no-console
     console.log('on click')
   },
-  goToLayouts() {
-    wx.navigateTo({
+  async goToLayouts() {
+    await wpi.navigateTo({
       url: '/pages/layouts/index',
     })
   },

package/templates/default/src/pages/layouts/index.ts

@@ -1,3 +1,4 @@
+import { wpi } from '@wevu/api'
 import { setPageLayout } from 'weapp-vite/runtime'
 
 Page({
@@ -36,7 +37,7 @@ Page({
     this.setData({ currentLayout: 'none' })
     setPageLayout(false)
   },
-  backHome() {
-    wx.navigateTo({ url: '/pages/index/index' })
+  async backHome() {
+    await wpi.navigateTo({ url: '/pages/index/index' })
   },
 })

package/templates/lib/.vscode/settings.json

@@ -1,4 +1,73 @@
 {
+  "prettier.enable": false,
+  "editor.formatOnSave": false,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit",
+    "source.organizeImports": "never"
+  },
+  "eslint.rules.customizations": [
+    {
+      "rule": "format/*",
+      "severity": "off"
+    },
+    {
+      "rule": "*-indent",
+      "severity": "off"
+    },
+    {
+      "rule": "*-spacing",
+      "severity": "off"
+    },
+    {
+      "rule": "*-spaces",
+      "severity": "off"
+    },
+    {
+      "rule": "*-order",
+      "severity": "off"
+    },
+    {
+      "rule": "*-dangle",
+      "severity": "off"
+    },
+    {
+      "rule": "*-newline",
+      "severity": "off"
+    },
+    {
+      "rule": "*quotes",
+      "severity": "off"
+    },
+    {
+      "rule": "*semi",
+      "severity": "off"
+    }
+  ],
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    "typescript",
+    "typescriptreact",
+    "vue",
+    "html",
+    "markdown",
+    "json",
+    "jsonc",
+    "yaml",
+    "toml",
+    "xml",
+    "gql",
+    "graphql",
+    "astro",
+    "css",
+    "less",
+    "scss",
+    "pcss",
+    "postcss"
+  ],
+  "css.validate": false,
+  "less.validate": false,
+  "scss.validate": false,
   "files.associations": {
     "*.wxml": "html",
     "*.wxss": "css"

package/templates/lib/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weapp-vite-lib-template",
   "type": "module",
-  "version": "4.0.3",
+  "version": "5.0.0",
   "private": true,
   "description": "weapp-vite 组件库（lib 模式）模板",
   "author": "ice breaker <1324318532@qq.com>",

package/templates/lib/src/components/HelloWorld/HelloWorld.ts

@@ -1,3 +1,5 @@
+import { wpi } from '@wevu/api'
+
 interface HelloWorldLink {
   text: string
   url: string
@@ -45,8 +47,8 @@ Component({
       }
 
       try {
-        await wx.setClipboardData({ data: url })
-        wx.showToast({
+        await wpi.setClipboardData({ data: url })
+        await wpi.showToast({
           title: '链接已复制',
           icon: 'success',
           duration: 1500,

package/templates/lib/src/pages/index/index.ts

@@ -1,3 +1,5 @@
+import { wpi } from '@wevu/api'
+
 Page({
   data: {
     hello: {
@@ -17,8 +19,8 @@ Page({
       ],
     },
   },
-  goToLayouts() {
-    wx.navigateTo({
+  async goToLayouts() {
+    await wpi.navigateTo({
       url: '/pages/layouts/index',
     })
   },

package/templates/lib/src/pages/layouts/index.ts

@@ -1,3 +1,4 @@
+import { wpi } from '@wevu/api'
 import { setPageLayout } from 'weapp-vite/runtime'
 
 Page({
@@ -36,8 +37,8 @@ Page({
     this.setData({ currentLayout: 'none' })
     setPageLayout(false)
   },
-  backHome() {
-    wx.navigateTo({
+  async backHome() {
+    await wpi.navigateTo({
       url: '/pages/index/index',
     })
   },

package/templates/tailwindcss/.vscode/settings.json

@@ -1,4 +1,73 @@
 {
+  "prettier.enable": false,
+  "editor.formatOnSave": false,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit",
+    "source.organizeImports": "never"
+  },
+  "eslint.rules.customizations": [
+    {
+      "rule": "format/*",
+      "severity": "off"
+    },
+    {
+      "rule": "*-indent",
+      "severity": "off"
+    },
+    {
+      "rule": "*-spacing",
+      "severity": "off"
+    },
+    {
+      "rule": "*-spaces",
+      "severity": "off"
+    },
+    {
+      "rule": "*-order",
+      "severity": "off"
+    },
+    {
+      "rule": "*-dangle",
+      "severity": "off"
+    },
+    {
+      "rule": "*-newline",
+      "severity": "off"
+    },
+    {
+      "rule": "*quotes",
+      "severity": "off"
+    },
+    {
+      "rule": "*semi",
+      "severity": "off"
+    }
+  ],
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    "typescript",
+    "typescriptreact",
+    "vue",
+    "html",
+    "markdown",
+    "json",
+    "jsonc",
+    "yaml",
+    "toml",
+    "xml",
+    "gql",
+    "graphql",
+    "astro",
+    "css",
+    "less",
+    "scss",
+    "pcss",
+    "postcss"
+  ],
+  "css.validate": false,
+  "less.validate": false,
+  "scss.validate": false,
   "files.associations": {
     "*.wxml": "html",
     "*.wxss": "css"

package/templates/tailwindcss/project.config.json

@@ -40,4 +40,4 @@
     "include": []
   },
   "appid": "wx6ffee4673b257014"
-}
+}

package/templates/tailwindcss/src/components/HelloWorld/HelloWorld.ts

@@ -1,3 +1,5 @@
+import { wpi } from '@wevu/api'
+
 interface HelloWorldLink {
   text: string
   url: string
@@ -45,8 +47,8 @@ Component({
       }
 
       try {
-        await wx.setClipboardData({ data: url })
-        wx.showToast({
+        await wpi.setClipboardData({ data: url })
+        await wpi.showToast({
           title: '链接已复制',
           icon: 'success',
           duration: 1500,