create-art-app-pino 1.0.0

package/README.md

@@ -0,0 +1,213 @@
+# create-art-app-pino
+
+基于 [Art Design Pro](https://github.com/Daymychen/art-design-pro) 的 Vue 3 项目脚手架 CLI。
+
+一条命令生成包含认证、路由、工程化、文档治理的完整前端项目，生成后独立演进，CLI 不再介入。
+
+## 快速开始
+
+```bash
+# 推荐：交互式创建
+pnpm create art-app-pino my-project
+
+# 或使用 npx
+npx create-art-app-pino my-project
+
+# 全默认（跳过所有问答）
+pnpm create art-app-pino my-project --default
+```
+
+## CLI 参数
+
+| 参数 | 说明 | 默认值 |
+| --- | --- | --- |
+| `--default` | 跳过所有交互，使用默认值 | — |
+| `--auth art` | Art 内置登录页 | `art` |
+| `--auth zhs` | 智慧树 CAS 统一认证 | — |
+| `--history` | History 路由模式 | ✅ |
+| `--hash` | Hash 路由模式 | — |
+| `--no-reference` | 不克隆 `.reference/art-design-pro` | — |
+| `--no-vscode` | 不生成 `.vscode/` 配置 | — |
+| `--no-agents` | 不生成 `AGENTS.md` | — |
+| `--no-doc-governance` | 不启用文档治理 | — |
+
+### 示例
+
+```bash
+# 智慧树认证 + Hash 路由 + 不克隆 reference
+pnpm create art-app-pino my-app --auth zhs --hash --no-reference
+
+# 最小化项目
+pnpm create art-app-pino my-app --default --no-reference --no-vscode --no-doc-governance
+```
+
+## 生成项目的技术栈
+
+- **框架**：Vue 3 + TypeScript + Vite
+- **UI**：Element Plus + Tailwind CSS v4
+- **状态管理**：Pinia + pinia-plugin-persistedstate
+- **工程化**：ESLint + Husky + lint-staged + commitlint
+- **文档治理**（可选）：frontmatter 校验 + 命名规范 + 私人路径检测 + 死链检测
+
+## 交互式选项
+
+### 认证方式
+
+| 选项 | 说明 |
+| --- | --- |
+| **Art 内置登录** | 用户名/密码登录页 + 前端 token 管理 |
+| **智慧树 CAS** | 企业 CAS 统一认证 + 开发态 env token 模式 |
+
+### 功能模块
+
+| 模块 | 包 | 默认 |
+| --- | --- | --- |
+| Markdown 渲染 | `md-editor-v3` | ✅ |
+| SSE 流式请求 | `@microsoft/fetch-event-source` | ✅ |
+| ECharts 图表 | `echarts` + `vue-echarts` | ✅ |
+| 拖拽 | `vue-draggable-plus` | ✅ |
+| 日期工具 | `dayjs` | ✅ |
+
+### 工程化配置
+
+| 配置 | 说明 | 默认 |
+| --- | --- | --- |
+| `.reference` | 克隆 art-design-pro 作为参考代码 | ✅ |
+| `.vscode` | 统一编辑器配置 | ✅ |
+| `AGENTS.md` | AI 开发约束文件 | ✅ |
+| 文档治理 | `docs/` 骨架 + 4 道护栏 + PR 模板 | ✅ |
+
+## 版本标记与升级迁移
+
+### 版本标记
+
+每个生成的项目在 `package.json` 中自动记录创建时使用的 CLI 版本：
+
+```json
+{
+  "create-art-app-pino": {
+    "version": "1.0.0"
+  }
+}
+```
+
+### 迁移机制
+
+**生成后的项目与 CLI 解耦**——CLI 只负责初始创建，不提供 `upgrade` 命令。当脚手架升级时，通过 [MIGRATION.md](./MIGRATION.md) 指导已有项目手动跟进。
+
+#### 对于 CLI 维护者
+
+每次发版时在 `MIGRATION.md` 中新增版本段落，包含：
+
+1. **变更概述** — 本次改了什么
+2. **必须操作** — 已有项目必须执行的步骤
+3. **可选操作** — 按需执行的步骤
+
+#### 对于已有项目的开发者
+
+1. 查看项目 `package.json` 中的 `create-art-app-pino.version`
+2. 打开 CLI 仓库的 [MIGRATION.md](./MIGRATION.md)
+3. 找到从当前版本到最新版本之间的所有段落
+4. 按顺序执行迁移步骤
+
+## 开发
+
+```bash
+pnpm install     # 安装依赖
+pnpm dev         # 开发模式（watch）
+pnpm build       # 构建
+
+# 本地测试
+mkdir -p _test-output && cd _test-output
+node ../dist/index.cjs my-test --default --no-reference
+```
+
+## 发布
+
+### 前置：npm registry 配置
+
+国内开发者通常用 CNPM 镜像加速安装，但 **登录和发布必须走官方 registry**。
+
+```bash
+# 查看当前 registry（如果是 npmmirror 则需要额外配置）
+npm config get registry
+```
+
+**方式 A：命令行指定（推荐，不改全局配置）**
+
+```bash
+npm login --registry=https://registry.npmjs.org
+```
+
+**方式 B：在 package.json 中锁定发布地址（一劳永逸）**
+
+项目已配置 `publishConfig`，`pnpm publish` 会自动走官方 registry：
+
+```json
+{
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  }
+}
+```
+
+> 日常 `pnpm install` 仍走 CNPM 镜像，两不耽误。
+
+### 首次发布
+
+```bash
+# 1. 登录 npm（首次需要，会打开浏览器验证）
+npm login --registry=https://registry.npmjs.org
+
+# 2. 确认登录成功
+npm whoami --registry=https://registry.npmjs.org
+```
+
+### 日常发版
+
+```bash
+# 1. 更新版本号（自动同步到生成项目的版本标记）
+npm version patch  # 或 minor / major
+
+# 2. 更新 MIGRATION.md（如有变更需要已有项目跟进）
+
+# 3. 发布到 npm（prepublishOnly 自动构建）
+pnpm publish
+
+# 4. 推送 tag
+git push --follow-tags
+```
+
+发布后用户即可通过 `pnpm create art-app-pino` 使用最新版本。
+## 项目结构
+
+```
+create-art-app-pino/
+├── src/                         # CLI 源码
+│   ├── index.ts                 # 入口
+│   ├── prompts.ts               # 交互式问答 + 选项定义
+│   ├── generator.ts             # 生成编排（模板叠加 + EJS）
+│   ├── postActions.ts           # 后置操作（git init + .reference）
+│   ├── featureDeps.ts           # 功能模块依赖声明
+│   └── utils/
+│       ├── renderTemplate.ts    # 模板渲染引擎
+│       ├── deepMerge.ts         # package.json 深度合并
+│       └── banner.ts            # CLI 横幅
+├── template/                    # 模板层
+│   ├── base/                    # 基础模板（所有项目共享）
+│   ├── auth-art/                # Art 内置登录叠加层
+│   ├── auth-zhihuishu/          # 智慧树 CAS 叠加层
+│   ├── scaffold-doc-governance/ # 文档治理叠加层
+│   ├── feature-markdown/        # Markdown 功能模板
+│   ├── feature-sse/             # SSE 功能模板
+│   └── feature-echarts/         # ECharts 功能模板
+├── package.json
+├── tsconfig.json
+├── tsup.config.ts
+├── MIGRATION.md                 # 版本迁移指南
+└── README.md
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,418 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/index.ts
+var import_node_fs4 = __toESM(require("fs"), 1);
+var import_node_path4 = __toESM(require("path"), 1);
+var import_minimist = __toESM(require("minimist"), 1);
+
+// src/utils/banner.ts
+var import_kolorist = require("kolorist");
+function showBanner() {
+  console.log();
+  console.log((0, import_kolorist.bold)((0, import_kolorist.cyan)("  create-art-app-pino")));
+  console.log();
+  console.log(`  ${(0, import_kolorist.green)("\u2714")} Art Design Pro based project scaffold`);
+  console.log();
+}
+function logError(message) {
+  console.error((0, import_kolorist.red)(`  \u2716 ${message}`));
+}
+
+// src/prompts.ts
+var import_prompts = __toESM(require("prompts"), 1);
+async function getProjectOptions(argv) {
+  const defaultMode = argv.default === true;
+  const argProjectName = argv._[0];
+  let result;
+  try {
+    result = await (0, import_prompts.default)(
+      [
+        {
+          type: argProjectName ? null : "text",
+          name: "projectName",
+          message: "\u9879\u76EE\u540D\u79F0:",
+          initial: "my-project",
+          validate: (val) => /^[a-z0-9-]+$/.test(val) || "\u9879\u76EE\u540D\u53EA\u80FD\u5305\u542B\u5C0F\u5199\u5B57\u6BCD\u3001\u6570\u5B57\u548C\u8FDE\u5B57\u7B26"
+        },
+        {
+          type: defaultMode || argv.auth ? null : "select",
+          name: "auth",
+          message: "\u8BA4\u8BC1\u65B9\u5F0F:",
+          choices: [
+            { title: "Art \u5185\u7F6E\u767B\u5F55\u9875\uFF08\u7528\u6237\u540D/\u5BC6\u7801 + \u524D\u7AEF token \u7BA1\u7406\uFF09", value: "art" },
+            { title: "\u667A\u6167\u6811 CAS \u767B\u5F55\uFF08\u4F01\u4E1A\u7EDF\u4E00\u8BA4\u8BC1 + \u5F00\u53D1\u6001 env token\uFF09", value: "zhihuishu" }
+          ],
+          initial: 0
+        },
+        {
+          type: defaultMode || argv.history || argv.hash ? null : "select",
+          name: "routerMode",
+          message: "\u8DEF\u7531\u6A21\u5F0F:",
+          choices: [
+            { title: "History\uFF08\u63A8\u8350\uFF0C\u9700\u670D\u52A1\u7AEF\u914D\u5408\uFF09", value: "history" },
+            { title: "Hash", value: "hash" }
+          ],
+          initial: 0
+        },
+        {
+          type: defaultMode ? null : "multiselect",
+          name: "features",
+          message: "\u542F\u7528\u529F\u80FD\u6A21\u5757\uFF08\u7A7A\u683C\u5207\u6362\uFF0C\u56DE\u8F66\u786E\u8BA4\uFF09:",
+          choices: [
+            { title: "Markdown \u6E32\u67D3\uFF08md-editor-v3\uFF09", value: "markdown", selected: true },
+            { title: "SSE \u6D41\u5F0F\u8BF7\u6C42\uFF08@microsoft/fetch-event-source\uFF09", value: "sse", selected: true },
+            { title: "ECharts \u56FE\u8868", value: "echarts", selected: true },
+            { title: "vue-draggable-plus \u62D6\u62FD", value: "draggable", selected: true },
+            { title: "dayjs \u65E5\u671F\u5DE5\u5177", value: "dayjs", selected: true }
+          ]
+        },
+        {
+          type: defaultMode ? null : "multiselect",
+          name: "scaffold",
+          message: "\u5DE5\u7A0B\u5316\u914D\u7F6E\uFF08\u7A7A\u683C\u5207\u6362\uFF0C\u56DE\u8F66\u786E\u8BA4\uFF09:",
+          choices: [
+            { title: ".reference \u53C2\u8003\u9879\u76EE\uFF08\u514B\u9686 art-design-pro \u6700\u65B0\u4EE3\u7801\uFF09", value: "reference", selected: true },
+            { title: ".vscode \u7EDF\u4E00\u7F16\u8F91\u5668\u914D\u7F6E", value: "vscode", selected: true },
+            { title: "AGENTS.md AI \u5F00\u53D1\u7EA6\u675F\u6587\u4EF6", value: "agentsMd", selected: true },
+            { title: "\u6587\u6863\u6CBB\u7406\uFF08docs/ + 4 \u9053\u62A4\u680F + PR \u6A21\u677F\uFF09", value: "docGovernance", selected: true }
+          ]
+        },
+        {
+          type: defaultMode ? null : "select",
+          name: "packageManager",
+          message: "\u5305\u7BA1\u7406\u5668:",
+          choices: [
+            { title: "pnpm\uFF08\u63A8\u8350\uFF09", value: "pnpm" },
+            { title: "npm", value: "npm" }
+          ],
+          initial: 0
+        }
+      ],
+      {
+        onCancel: () => {
+          throw new Error("\u64CD\u4F5C\u5DF2\u53D6\u6D88");
+        }
+      }
+    );
+  } catch {
+    return null;
+  }
+  const projectName = argProjectName || result.projectName || "my-project";
+  const auth = argv.auth === "zhs" ? "zhihuishu" : argv.auth || result.auth || "art";
+  const routerMode = argv.hash ? "hash" : argv.history ? "history" : result.routerMode || "history";
+  const features = defaultMode ? ["markdown", "sse", "echarts", "draggable", "dayjs"] : result.features || ["markdown", "sse", "echarts", "draggable", "dayjs"];
+  const scaffoldChoices = defaultMode ? ["reference", "vscode", "agentsMd", "docGovernance"] : result.scaffold || ["reference", "vscode", "agentsMd", "docGovernance"];
+  const scaffold = {
+    reference: argv.reference === false ? false : scaffoldChoices.includes("reference"),
+    vscode: argv.vscode === false ? false : scaffoldChoices.includes("vscode"),
+    agentsMd: argv.agents === false ? false : scaffoldChoices.includes("agentsMd"),
+    docGovernance: argv["doc-governance"] === false ? false : scaffoldChoices.includes("docGovernance")
+  };
+  const packageManager = defaultMode ? "pnpm" : result.packageManager || "pnpm";
+  return {
+    projectName,
+    auth,
+    routerMode,
+    features,
+    scaffold,
+    packageManager
+  };
+}
+
+// src/generator.ts
+var import_node_fs2 = __toESM(require("fs"), 1);
+var import_node_path2 = __toESM(require("path"), 1);
+
+// src/featureDeps.ts
+var FEATURE_DEPS = {
+  draggable: { deps: { "vue-draggable-plus": "^0.5.6" } },
+  dayjs: { deps: { dayjs: "^1.11.13" } }
+};
+var TEMPLATE_FEATURES = ["markdown", "sse", "echarts"];
+function hasTemplateDir(feature) {
+  return TEMPLATE_FEATURES.includes(feature);
+}
+function getFeatureDeps(features) {
+  const result = { deps: {}, devDeps: {} };
+  for (const feature of features) {
+    const config = FEATURE_DEPS[feature];
+    if (config) {
+      Object.assign(result.deps, config.deps || {});
+      Object.assign(result.devDeps, config.devDeps || {});
+    }
+  }
+  return result;
+}
+
+// src/utils/renderTemplate.ts
+var import_node_fs = __toESM(require("fs"), 1);
+var import_node_path = __toESM(require("path"), 1);
+var import_ejs = __toESM(require("ejs"), 1);
+async function renderTemplate(templateDir, targetDir, options, skipFiles = []) {
+  const stats = import_node_fs.default.statSync(templateDir);
+  if (!stats.isDirectory()) return;
+  const files = import_node_fs.default.readdirSync(templateDir);
+  for (const file of files) {
+    if (skipFiles.includes(file)) continue;
+    const srcPath = import_node_path.default.join(templateDir, file);
+    const srcStat = import_node_fs.default.statSync(srcPath);
+    if (srcStat.isDirectory()) {
+      const destName = file.startsWith("_") ? `.${file.slice(1)}` : file;
+      const destDir = import_node_path.default.join(targetDir, destName);
+      import_node_fs.default.mkdirSync(destDir, { recursive: true });
+      await renderTemplate(srcPath, destDir, options);
+    } else {
+      await renderFile(srcPath, targetDir, file, options);
+    }
+  }
+}
+async function renderFile(srcPath, targetDir, fileName, options) {
+  let destName = fileName;
+  let content;
+  if (fileName.endsWith(".ejs")) {
+    destName = fileName.slice(0, -4);
+    const template = import_node_fs.default.readFileSync(srcPath, "utf-8");
+    content = import_ejs.default.render(template, { options });
+    if (!content.trim()) return;
+  } else {
+    content = import_node_fs.default.readFileSync(srcPath, "utf-8");
+  }
+  if (destName.startsWith("_")) {
+    destName = `.${destName.slice(1)}`;
+  }
+  const destPath = import_node_path.default.join(targetDir, destName);
+  import_node_fs.default.mkdirSync(import_node_path.default.dirname(destPath), { recursive: true });
+  import_node_fs.default.writeFileSync(destPath, content);
+}
+async function renderEjsInPlace(targetDir, options) {
+  const files = getAllFiles(targetDir);
+  for (const filePath of files) {
+    if (filePath.endsWith(".ejs")) {
+      const template = import_node_fs.default.readFileSync(filePath, "utf-8");
+      const content = import_ejs.default.render(template, { options });
+      const destPath = filePath.slice(0, -4);
+      if (content.trim()) {
+        import_node_fs.default.writeFileSync(destPath, content);
+      }
+      import_node_fs.default.unlinkSync(filePath);
+    }
+  }
+}
+function getAllFiles(dir) {
+  const results = [];
+  const entries = import_node_fs.default.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = import_node_path.default.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === "node_modules" || entry.name === ".git") continue;
+      results.push(...getAllFiles(fullPath));
+    } else {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
+// src/utils/deepMerge.ts
+function sortDependencies(pkg) {
+  const sorted = { ...pkg };
+  const depsFields = ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"];
+  for (const field of depsFields) {
+    if (sorted[field]) {
+      sorted[field] = Object.fromEntries(
+        Object.entries(sorted[field]).sort(([a], [b]) => a.localeCompare(b))
+      );
+    }
+  }
+  return sorted;
+}
+
+// src/generator.ts
+async function generate(options, targetDir) {
+  const templateRoot = import_node_path2.default.resolve(__dirname, "..", "template");
+  const baseDir = import_node_path2.default.join(templateRoot, "base");
+  if (import_node_fs2.default.existsSync(baseDir)) {
+    await renderTemplate(baseDir, targetDir, options);
+  }
+  const authDir = import_node_path2.default.join(templateRoot, options.auth === "zhihuishu" ? "auth-zhihuishu" : "auth-art");
+  if (import_node_fs2.default.existsSync(authDir)) {
+    await renderTemplate(authDir, targetDir, options);
+  }
+  if (options.scaffold.docGovernance) {
+    const dgDir = import_node_path2.default.join(templateRoot, "scaffold-doc-governance");
+    if (import_node_fs2.default.existsSync(dgDir)) {
+      mergeTemplatePackageJson(dgDir, targetDir);
+      await renderTemplate(dgDir, targetDir, options, ["package.json"]);
+    }
+  }
+  const templateFeatures = options.features.filter((f) => hasTemplateDir(f));
+  for (const feature of templateFeatures) {
+    const featureDir = import_node_path2.default.join(templateRoot, `feature-${feature}`);
+    if (import_node_fs2.default.existsSync(featureDir)) {
+      mergeTemplatePackageJson(featureDir, targetDir);
+      await renderTemplate(featureDir, targetDir, options, ["package.json"]);
+    }
+  }
+  mergeFeatureDeps(targetDir, options);
+  await renderEjsInPlace(targetDir, options);
+  removeEmptyDirs(targetDir);
+  sortPackageJson(targetDir);
+}
+function mergeFeatureDeps(targetDir, options) {
+  const pkgPath = import_node_path2.default.join(targetDir, "package.json");
+  if (!import_node_fs2.default.existsSync(pkgPath)) return;
+  const pkg = JSON.parse(import_node_fs2.default.readFileSync(pkgPath, "utf-8"));
+  const { deps, devDeps } = getFeatureDeps(options.features);
+  if (Object.keys(deps).length > 0) {
+    pkg.dependencies = { ...pkg.dependencies, ...deps };
+  }
+  if (Object.keys(devDeps).length > 0) {
+    pkg.devDependencies = { ...pkg.devDependencies, ...devDeps };
+  }
+  const cliPkgPath = import_node_path2.default.resolve(__dirname, "..", "package.json");
+  const cliVersion = import_node_fs2.default.existsSync(cliPkgPath) ? JSON.parse(import_node_fs2.default.readFileSync(cliPkgPath, "utf-8")).version : "0.0.0";
+  pkg["create-art-app-pino"] = { version: cliVersion };
+  import_node_fs2.default.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+}
+function mergeTemplatePackageJson(featureDir, targetDir) {
+  const featurePkgPath = import_node_path2.default.join(featureDir, "package.json");
+  if (!import_node_fs2.default.existsSync(featurePkgPath)) return;
+  const targetPkgPath = import_node_path2.default.join(targetDir, "package.json");
+  if (!import_node_fs2.default.existsSync(targetPkgPath)) return;
+  const featurePkg = JSON.parse(import_node_fs2.default.readFileSync(featurePkgPath, "utf-8"));
+  const targetPkg = JSON.parse(import_node_fs2.default.readFileSync(targetPkgPath, "utf-8"));
+  if (featurePkg.dependencies) {
+    targetPkg.dependencies = { ...targetPkg.dependencies, ...featurePkg.dependencies };
+  }
+  if (featurePkg.devDependencies) {
+    targetPkg.devDependencies = { ...targetPkg.devDependencies, ...featurePkg.devDependencies };
+  }
+  import_node_fs2.default.writeFileSync(targetPkgPath, JSON.stringify(targetPkg, null, 2) + "\n");
+}
+function sortPackageJson(targetDir) {
+  const pkgPath = import_node_path2.default.join(targetDir, "package.json");
+  if (!import_node_fs2.default.existsSync(pkgPath)) return;
+  const pkg = JSON.parse(import_node_fs2.default.readFileSync(pkgPath, "utf-8"));
+  const sorted = sortDependencies(pkg);
+  import_node_fs2.default.writeFileSync(pkgPath, JSON.stringify(sorted, null, 2) + "\n");
+}
+function removeEmptyDirs(dir) {
+  const entries = import_node_fs2.default.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      const fullPath = import_node_path2.default.join(dir, entry.name);
+      if (entry.name === ".git") continue;
+      removeEmptyDirs(fullPath);
+      const remaining = import_node_fs2.default.readdirSync(fullPath);
+      if (remaining.length === 0) {
+        import_node_fs2.default.rmdirSync(fullPath);
+      }
+    }
+  }
+}
+
+// src/postActions.ts
+var import_node_fs3 = __toESM(require("fs"), 1);
+var import_node_path3 = __toESM(require("path"), 1);
+var import_node_child_process = require("child_process");
+var import_kolorist2 = require("kolorist");
+async function postGenerate(options, targetDir) {
+  if (options.scaffold.reference) {
+    await cloneReference(targetDir);
+  }
+  await initGit(targetDir);
+  console.log();
+  console.log((0, import_kolorist2.green)("  \u9879\u76EE\u521B\u5EFA\u5B8C\u6210\uFF01"));
+  console.log();
+  console.log(`  ${(0, import_kolorist2.cyan)("cd")} ${options.projectName}`);
+  console.log(`  ${(0, import_kolorist2.cyan)(`${options.packageManager} install`)}`);
+  console.log(`  ${(0, import_kolorist2.cyan)(`${options.packageManager === "npm" ? "npm run" : options.packageManager} dev`)}`);
+  if (options.scaffold.docGovernance) {
+    console.log(`  ${(0, import_kolorist2.cyan)(`${options.packageManager === "npm" ? "npm run" : options.packageManager} docs:lint`)}  # \u6587\u6863\u6CBB\u7406\u68C0\u67E5`);
+  }
+  console.log();
+}
+async function cloneReference(targetDir) {
+  const refDir = import_node_path3.default.join(targetDir, ".reference", "art-design-pro");
+  console.log(`  ${(0, import_kolorist2.cyan)("\u23F3")} \u514B\u9686 .reference/art-design-pro ...`);
+  try {
+    import_node_fs3.default.mkdirSync(import_node_path3.default.join(targetDir, ".reference"), { recursive: true });
+    (0, import_node_child_process.execSync)(
+      `git clone --depth 1 https://github.com/Daymychen/art-design-pro.git "${refDir}"`,
+      { stdio: "pipe" }
+    );
+    const gitDir = import_node_path3.default.join(refDir, ".git");
+    if (import_node_fs3.default.existsSync(gitDir)) {
+      import_node_fs3.default.rmSync(gitDir, { recursive: true });
+    }
+    console.log(`  ${(0, import_kolorist2.green)("\u2714")} .reference/art-design-pro \u514B\u9686\u5B8C\u6210`);
+  } catch {
+    console.log(`  ${(0, import_kolorist2.yellow)("\u26A0")} .reference \u514B\u9686\u5931\u8D25\uFF0C\u53EF\u7A0D\u540E\u624B\u52A8\u6267\u884C\uFF1A`);
+    console.log(`    git clone --depth 1 https://github.com/Daymychen/art-design-pro.git .reference/art-design-pro`);
+  }
+}
+async function initGit(targetDir) {
+  try {
+    (0, import_node_child_process.execSync)("git init", { cwd: targetDir, stdio: "pipe" });
+    console.log(`  ${(0, import_kolorist2.green)("\u2714")} Git \u4ED3\u5E93\u5DF2\u521D\u59CB\u5316`);
+  } catch {
+    console.log(`  ${(0, import_kolorist2.yellow)("\u26A0")} Git \u521D\u59CB\u5316\u5931\u8D25\uFF0C\u8BF7\u624B\u52A8\u6267\u884C git init`);
+  }
+}
+
+// src/index.ts
+async function main() {
+  const argv = (0, import_minimist.default)(process.argv.slice(2), {
+    boolean: ["default", "history", "hash"],
+    string: ["auth"]
+  });
+  showBanner();
+  const options = await getProjectOptions(argv);
+  if (!options) {
+    logError("\u64CD\u4F5C\u5DF2\u53D6\u6D88");
+    process.exit(1);
+  }
+  const cwd = process.cwd();
+  const targetDir = import_node_path4.default.join(cwd, options.projectName);
+  if (import_node_fs4.default.existsSync(targetDir)) {
+    const entries = import_node_fs4.default.readdirSync(targetDir);
+    if (entries.length > 0) {
+      logError(`\u76EE\u5F55 ${options.projectName} \u5DF2\u5B58\u5728\u4E14\u4E0D\u4E3A\u7A7A`);
+      process.exit(1);
+    }
+  } else {
+    import_node_fs4.default.mkdirSync(targetDir, { recursive: true });
+  }
+  console.log();
+  console.log(`  \u6B63\u5728\u521B\u5EFA\u9879\u76EE ${options.projectName} ...`);
+  console.log();
+  await generate(options, targetDir);
+  await postGenerate(options, targetDir);
+}
+main().catch((err) => {
+  logError(err.message || "\u672A\u77E5\u9519\u8BEF");
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "create-art-app-pino",
+  "version": "1.0.0",
+  "description": "CLI scaffold tool for creating Art Design Pro based projects",
+  "type": "module",
+  "bin": {
+    "create-art-app-pino": "dist/index.cjs"
+  },
+  "files": [
+    "dist",
+    "template"
+  ],
+  "keywords": [
+    "cli",
+    "scaffold",
+    "vue",
+    "art-design-pro",
+    "create-app"
+  ],
+  "author": "pino",
+  "license": "MIT",
+  "dependencies": {
+    "ejs": "^3.1.10",
+    "kolorist": "^1.8.0",
+    "minimist": "^1.2.8",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/ejs": "^3.1.5",
+    "@types/minimist": "^1.2.5",
+    "@types/node": "^22.10.0",
+    "@types/prompts": "^2.4.9",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "start": "node dist/index.cjs"
+  }
+}

package/template/auth-art/_env.development

@@ -0,0 +1,2 @@
+# API 基础地址（开发环境）
+VITE_API_BASE_URL=http://localhost:3000