nuxt-gin-tools 0.2.17 → 0.2.19

package/commands/pack.js

@@ -45,7 +45,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FILES_TO_COPY = exports.PACKAGE_JSON_CONTENT = exports.SERVER_EXECUTABLE = exports.PACK_CONFIG_PATH = exports.ORIGINAL_DIST_PATH = exports.SERVER_PATH = exports.ZIP_PATH = void 0;
+exports.FILES_TO_COPY = exports.PACKAGE_JSON_CONTENT = exports.SERVER_EXECUTABLE = exports.BUILD_EXECUTABLE = exports.PACK_CONFIG_MJS_PATH = exports.PACK_CONFIG_CJS_PATH = exports.PACK_CONFIG_JS_PATH = exports.PACK_CONFIG_TS_PATH = exports.PACK_CONFIG_PATH = exports.ORIGINAL_DIST_PATH = exports.SERVER_PATH = exports.ZIP_PATH = void 0;
 exports.builtPath = builtPath;
 exports.buildAndPack = buildAndPack;
 // 导入项目构建工具，用于执行 Nuxt 项目的构建流程
@@ -58,6 +58,7 @@ const FS = __importStar(require("fs-extra"));
 const Path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const fast_glob_1 = __importDefault(require("fast-glob"));
+const { createJiti } = require("jiti");
 /**
  * 生成相对于服务器构建目录的绝对路径
  * @param relativePath - 相对路径
@@ -73,22 +74,115 @@ exports.SERVER_PATH = Path.resolve(process.cwd(), ".build/production/server");
 // 定义原始 dist 目录路径，用于清理操作
 exports.ORIGINAL_DIST_PATH = Path.resolve(process.cwd(), "dist");
 exports.PACK_CONFIG_PATH = Path.resolve(process.cwd(), "pack.config.json");
+exports.PACK_CONFIG_TS_PATH = Path.resolve(process.cwd(), "pack.config.ts");
+exports.PACK_CONFIG_JS_PATH = Path.resolve(process.cwd(), "pack.config.js");
+exports.PACK_CONFIG_CJS_PATH = Path.resolve(process.cwd(), "pack.config.cjs");
+exports.PACK_CONFIG_MJS_PATH = Path.resolve(process.cwd(), "pack.config.mjs");
+exports.BUILD_EXECUTABLE = os.platform() === "win32" ? "production.exe" : "production";
 exports.SERVER_EXECUTABLE = os.platform() === "win32" ? "server-production.exe" : "server-production"; // 根据操作系统选择可执行文件名
 // 定义打包后项目的 package.json 内容
 exports.PACKAGE_JSON_CONTENT = {
     private: true,
     scripts: {
-        start: "./server-production.exe", // 定义启动命令
+        start: `./${exports.SERVER_EXECUTABLE}`, // 定义启动命令
     },
 };
 // 定义需要复制到构建目录的文件映射关系（目标为构建目录下的相对路径）
 const DEFAULT_FILES_TO_COPY = {
     "vue/.output": "vue/.output", // Vue 应用构建输出
-    [`.build/.server/production.exe`]: "server-production.exe", // 生产环境可执行文件
+    [`.build/.server/${exports.BUILD_EXECUTABLE}`]: exports.SERVER_EXECUTABLE, // 生产环境可执行文件
     "server.config.json": "server.config.json", // 服务器配置文件
 };
 // 兼容旧导出：默认构建目录下的绝对目标路径
 exports.FILES_TO_COPY = Object.fromEntries(Object.entries(DEFAULT_FILES_TO_COPY).map(([src, dest]) => [src, builtPath(dest)]));
+function warnPackConfig(message) {
+    console.warn(`[nuxt-gin-tools][pack] WARN: ${message}`);
+}
+function errorPackConfig(message) {
+    throw new Error(`[nuxt-gin-tools][pack] ${message}`);
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function validateStringArray(fieldName, value, issues) {
+    if (value === undefined) {
+        return;
+    }
+    if (!Array.isArray(value)) {
+        issues.push({ level: "error", message: `${fieldName} must be an array of strings` });
+        return;
+    }
+    for (const item of value) {
+        if (typeof item !== "string") {
+            issues.push({ level: "error", message: `${fieldName} must contain only strings` });
+            return;
+        }
+    }
+}
+function validateStringRecord(fieldName, value, issues) {
+    if (value === undefined) {
+        return;
+    }
+    if (!isPlainObject(value)) {
+        issues.push({ level: "error", message: `${fieldName} must be an object of string to string` });
+        return;
+    }
+    for (const [key, item] of Object.entries(value)) {
+        if (typeof key !== "string" || typeof item !== "string") {
+            issues.push({ level: "error", message: `${fieldName} must be an object of string to string` });
+            return;
+        }
+    }
+}
+function validatePackConfig(config, sourcePath) {
+    if (!isPlainObject(config)) {
+        errorPackConfig(`${Path.basename(sourcePath)} must export an object`);
+    }
+    const issues = [];
+    const typedConfig = config;
+    const stringFields = ["binaryName", "zipName", "zipPath", "serverPath"];
+    for (const field of stringFields) {
+        const value = typedConfig[field];
+        if (value !== undefined && typeof value !== "string") {
+            issues.push({ level: "error", message: `${field} must be a string` });
+        }
+    }
+    const booleanFields = ["skipGo", "skipNuxt", "cleanDist", "writeScripts", "overwrite"];
+    for (const field of booleanFields) {
+        const value = typedConfig[field];
+        if (value !== undefined && typeof value !== "boolean") {
+            issues.push({ level: "error", message: `${field} must be a boolean` });
+        }
+    }
+    validateStringArray("extraFilesGlobs", typedConfig.extraFilesGlobs, issues);
+    validateStringArray("exclude", typedConfig.exclude, issues);
+    validateStringRecord("extraFiles", typedConfig.extraFiles, issues);
+    if (typedConfig.packageJson !== undefined && !isPlainObject(typedConfig.packageJson)) {
+        issues.push({ level: "error", message: `packageJson must be an object` });
+    }
+    if (typedConfig.beforePack !== undefined && typeof typedConfig.beforePack !== "function") {
+        issues.push({ level: "error", message: `beforePack must be a function` });
+    }
+    if (typedConfig.afterPack !== undefined && typeof typedConfig.afterPack !== "function") {
+        issues.push({ level: "error", message: `afterPack must be a function` });
+    }
+    if (typedConfig.zipName !== undefined && typedConfig.zipPath !== undefined) {
+        issues.push({ level: "warn", message: `zipPath and zipName are both set; zipPath takes precedence` });
+    }
+    if (typedConfig.skipGo === true && typedConfig.skipNuxt === true) {
+        issues.push({ level: "warn", message: `skipGo and skipNuxt are both true; build step will be skipped` });
+    }
+    for (const issue of issues) {
+        if (issue.level === "warn") {
+            warnPackConfig(`${Path.basename(sourcePath)}: ${issue.message}`);
+        }
+    }
+    const errors = issues.filter((issue) => issue.level === "error");
+    if (errors.length > 0) {
+        errorPackConfig(`${Path.basename(sourcePath)} is invalid:\n- ${errors.map((item) => item.message).join("\n- ")}`);
+    }
+    return config;
+}
 /**
  * 写入启动脚本和 package.json 文件到构建目录
  */
@@ -96,9 +190,9 @@ function writeScriptFiles(serverPath, config) {
     // 写入 Windows 批处理启动脚本
     FS.outputFileSync(Path.resolve(serverPath, "start.bat"), `powershell -ExecutionPolicy ByPass -File ./start.ps1`);
     // 写入 PowerShell 启动脚本
-    FS.outputFileSync(Path.resolve(serverPath, "start.ps1"), `./server-production.exe`);
+    FS.outputFileSync(Path.resolve(serverPath, "start.ps1"), `./${exports.SERVER_EXECUTABLE}`);
     // 写入 Linux/macOS 启动脚本
-    FS.outputFileSync(Path.resolve(serverPath, "start.sh"), `./server-production.exe`);
+    FS.outputFileSync(Path.resolve(serverPath, "start.sh"), `./${exports.SERVER_EXECUTABLE}`);
     // 写入 package.json 文件，使用 2 个空格缩进
     const mergedPackageJson = mergePackageJson(exports.PACKAGE_JSON_CONTENT, config === null || config === void 0 ? void 0 : config.packageJson);
     FS.outputJSONSync(Path.resolve(serverPath, "package.json"), mergedPackageJson, { spaces: 2 });
@@ -147,10 +241,32 @@ function mergePackageJson(base, override) {
     return Object.assign(Object.assign(Object.assign({}, base), override), { scripts: Object.assign(Object.assign({}, baseScripts), overrideScripts) });
 }
 function readPackConfigFromCwd() {
-    if (!FS.existsSync(exports.PACK_CONFIG_PATH)) {
+    const candidates = [
+        exports.PACK_CONFIG_TS_PATH,
+        exports.PACK_CONFIG_JS_PATH,
+        exports.PACK_CONFIG_CJS_PATH,
+        exports.PACK_CONFIG_MJS_PATH,
+        exports.PACK_CONFIG_PATH,
+    ].filter((configPath) => FS.existsSync(configPath));
+    if (candidates.length === 0) {
         return undefined;
     }
-    return FS.readJSONSync(exports.PACK_CONFIG_PATH);
+    if (candidates.length > 1) {
+        warnPackConfig(`multiple pack config files found (${candidates.map((item) => Path.basename(item)).join(", ")}); using ${Path.basename(candidates[0])}`);
+    }
+    const selectedPath = candidates[0];
+    let loadedConfig;
+    if (selectedPath.endsWith(".json")) {
+        loadedConfig = FS.readJSONSync(selectedPath);
+    }
+    else {
+        const jiti = createJiti(__filename, { moduleCache: false, interopDefault: true });
+        loadedConfig = jiti(selectedPath);
+    }
+    const normalizedConfig = isPlainObject(loadedConfig) && "default" in loadedConfig
+        ? loadedConfig.default
+        : loadedConfig;
+    return validatePackConfig(normalizedConfig, selectedPath);
 }
 function resolveServerPath(config) {
     if (!(config === null || config === void 0 ? void 0 : config.serverPath)) {
@@ -212,7 +328,7 @@ function buildAndPack(config) {
         const resolvedConfig = config !== null && config !== void 0 ? config : readPackConfigFromCwd();
         const serverPath = resolveServerPath(resolvedConfig);
         const zipPath = resolveZipPath(resolvedConfig);
-        yield (0, builder_1.default)(); // 执行项目构建
+        yield (0, builder_1.default)(resolvedConfig); // 执行项目构建
         if (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.beforePack) {
             yield resolvedConfig.beforePack();
         }

package/commands/update.d.ts

@@ -1,2 +1,7 @@
-export declare function update(): void;
+export type UpdateOptions = {
+    latest?: boolean;
+    skipGo?: boolean;
+    skipNode?: boolean;
+};
+export declare function update(options?: UpdateOptions): Promise<void> | Promise<import("concurrently").CloseEvent[]>;
 export default update;

package/commands/update.js

@@ -5,18 +5,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.update = update;
 const concurrently_1 = __importDefault(require("concurrently"));
-function update() {
-    (0, concurrently_1.default)([
-        {
-            command: "pnpm update --latest",
+function update(options = {}) {
+    const commands = [];
+    if (!options.skipNode) {
+        commands.push({
+            command: options.latest ? "pnpm update --latest" : "pnpm update",
             name: "pnpm",
             prefixColor: "magenta",
-        },
-        {
-            command: "go get -u && go mod tidy",
+        });
+    }
+    if (!options.skipGo) {
+        commands.push({
+            command: options.latest ? "go get -u ./... && go mod tidy" : "go get -u=patch ./... && go mod tidy",
             name: "go",
             prefixColor: "green",
-        },
-    ]);
+        });
+    }
+    if (commands.length === 0) {
+        return Promise.resolve();
+    }
+    return (0, concurrently_1.default)(commands).result;
 }
 exports.default = update;

package/index.js

@@ -33,6 +33,15 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -50,6 +59,7 @@ const postinstall_1 = __importDefault(require("./commands/postinstall"));
 const cleanup_1 = __importDefault(require("./commands/cleanup"));
 // 导入更新功能
 const update_1 = __importDefault(require("./commands/update"));
+const cli_options_1 = require("./src/cli-options");
 // 获取命令行参数（去除前两个默认参数）
 const args = process.argv.slice(2);
 // 检查是否提供了命令
@@ -57,41 +67,62 @@ if (args.length === 0) {
     console.error("未提供命令。请指定要运行的命令。");
     process.exit(1);
 }
-// 根据第一个参数执行对应的命令
-switch (args[0]) {
-    case "dev":
-        // 启动开发模式
-        (0, develop_1.default)();
-        break;
-    case "dev:nuxt":
-        // 仅启动 Nuxt 开发模式
-        (0, develop_1.developNuxt)();
-        break;
-    case "dev:go":
-        // 仅启动 Go 开发模式
-        (0, develop_1.developGo)();
-        break;
-    case "build":
-        // 执行构建和打包操作
-        (0, pack_1.default)();
-        break;
-    case "gen":
-        // 生成API代码（注：此处命令可能拼写错误，应为generate）
-        (0, api_generate_1.default)();
-        break;
-    case "install":
-        // 执行安装后的初始化操作
-        (0, postinstall_1.default)();
-        break;
-    case "cleanup":
-        // 执行清理操作
-        (0, cleanup_1.default)();
-        break;
-    case "update":
-        // 更新依赖
-        (0, update_1.default)();
-        break;
-    default:
-        console.error(`未知命令: ${args[0]}`);
-        process.exit(1);
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const command = args[0];
+        const options = (0, cli_options_1.parseCLIOptions)(args.slice(1));
+        switch (command) {
+            case "dev":
+                yield (0, develop_1.default)({
+                    noCleanup: (0, cli_options_1.hasFlag)(options, "no-cleanup"),
+                    skipGo: (0, cli_options_1.hasFlag)(options, "skip-go"),
+                    skipNuxt: (0, cli_options_1.hasFlag)(options, "skip-nuxt"),
+                });
+                break;
+            case "dev:nuxt":
+                yield (0, develop_1.developNuxt)({
+                    noCleanup: (0, cli_options_1.hasFlag)(options, "no-cleanup"),
+                });
+                break;
+            case "dev:go":
+                yield (0, develop_1.developGo)({
+                    noCleanup: (0, cli_options_1.hasFlag)(options, "no-cleanup"),
+                });
+                break;
+            case "build":
+                yield (0, pack_1.default)({
+                    binaryName: (0, cli_options_1.getOption)(options, "binary-name"),
+                    skipGo: (0, cli_options_1.hasFlag)(options, "skip-go"),
+                    skipNuxt: (0, cli_options_1.hasFlag)(options, "skip-nuxt"),
+                });
+                break;
+            case "gen":
+                // 生成API代码（注：此处命令可能拼写错误，应为generate）
+                yield (0, api_generate_1.default)();
+                break;
+            case "install":
+                // 执行安装后的初始化操作
+                yield (0, postinstall_1.default)();
+                break;
+            case "cleanup":
+                // 执行清理操作
+                yield (0, cleanup_1.default)();
+                break;
+            case "update":
+                // 更新依赖
+                yield (0, update_1.default)({
+                    latest: (0, cli_options_1.hasFlag)(options, "latest"),
+                    skipGo: (0, cli_options_1.hasFlag)(options, "skip-go"),
+                    skipNode: (0, cli_options_1.hasFlag)(options, "skip-node"),
+                });
+                break;
+            default:
+                console.error(`未知命令: ${command}`);
+                process.exit(1);
+        }
+    });
 }
+void main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});

package/package.json

@@ -1,30 +1,31 @@
-{
-  "name": "nuxt-gin-tools",
-  "version": "0.2.17",
-  "description": "This project is used as a dependency for [nuxt-gin-starter](https://github.com/RapboyGao/nuxt-gin-starter.git)",
-  "bin": {
-    "nuxt-gin": "index.js"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "MIT",
-  "scripts": {
-    "build": "ts-node build.ts",
-    "publish": "npm publish --access public"
-  },
-  "dependencies": {
-    "7zip-min": "^2.1.0",
-    "chalk": "^5.4.1",
-    "chokidar": "^3.6.0",
-    "concurrently": "^9.2.0",
-    "fast-glob": "^3.3.3",
-    "fs-extra": "^11.3.0"
-  },
-  "devDependencies": {
-    "@types/fs-extra": "^11.0.4",
-    "@types/node": "^24.0.15",
-    "nuxt": "^4.0.1",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.8.3"
-  }
-}
+{
+  "name": "nuxt-gin-tools",
+  "version": "0.2.19",
+  "description": "This project is used as a dependency for [nuxt-gin-starter](https://github.com/RapboyGao/nuxt-gin-starter.git)",
+  "bin": {
+    "nuxt-gin": "index.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "scripts": {
+    "build": "ts-node build.ts",
+    "publish": "npm publish --access public"
+  },
+  "dependencies": {
+    "7zip-min": "^2.1.0",
+    "chalk": "^5.4.1",
+    "chokidar": "^3.6.0",
+    "concurrently": "^9.2.0",
+    "fast-glob": "^3.3.3",
+    "fs-extra": "^11.3.0",
+    "jiti": "^2.6.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^24.0.15",
+    "nuxt": "^4.0.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
+  }
+}

package/src/cli-options.d.ts

@@ -0,0 +1,8 @@
+export type CLIOptions = {
+    flags: Set<string>;
+    values: Map<string, string>;
+    positionals: string[];
+};
+export declare function parseCLIOptions(args: string[]): CLIOptions;
+export declare function hasFlag(options: CLIOptions, key: string): boolean;
+export declare function getOption(options: CLIOptions, key: string): string | undefined;

package/src/cli-options.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCLIOptions = parseCLIOptions;
+exports.hasFlag = hasFlag;
+exports.getOption = getOption;
+function normalizeKey(key) {
+    return key.replace(/^-+/, "").trim();
+}
+function parseCLIOptions(args) {
+    var _a, _b, _c, _d;
+    const flags = new Set();
+    const values = new Map();
+    const positionals = [];
+    for (let i = 0; i < args.length; i += 1) {
+        const current = (_b = (_a = args[i]) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : "";
+        if (!current)
+            continue;
+        if (!current.startsWith("-")) {
+            positionals.push(current);
+            continue;
+        }
+        const eqIndex = current.indexOf("=");
+        if (eqIndex >= 0) {
+            values.set(normalizeKey(current.slice(0, eqIndex)), current.slice(eqIndex + 1));
+            continue;
+        }
+        const key = normalizeKey(current);
+        const next = (_d = (_c = args[i + 1]) === null || _c === void 0 ? void 0 : _c.trim()) !== null && _d !== void 0 ? _d : "";
+        if (next && !next.startsWith("-")) {
+            values.set(key, next);
+            i += 1;
+            continue;
+        }
+        flags.add(key);
+    }
+    return { flags, values, positionals };
+}
+function hasFlag(options, key) {
+    return options.flags.has(normalizeKey(key));
+}
+function getOption(options, key) {
+    return options.values.get(normalizeKey(key));
+}

package/src/go-gin-server.json

@@ -1,5 +1,5 @@
-{
-    "apiPath": "server/api",
-    "packageName": "api",
-    "serverPort": "8099"
+{
+    "apiPath": "server/api",
+    "packageName": "api",
+    "serverPort": "8099"
 }

package/src/pack-config.schema.json

@@ -1,62 +1,62 @@
-{
-  "title": "Nuxt Gin Tools Pack Config",
-  "type": "object",
-  "additionalProperties": false,
-  "properties": {
-    "extraFiles": {
-      "type": "object",
-      "description": "额外需要打包的文件映射（key: 源文件路径，value: 打包后对应位置）",
-      "additionalProperties": {
-        "type": "string"
-      }
-    },
-    "extraFilesGlobs": {
-      "type": "array",
-      "description": "额外需要打包的文件 Glob（相对于项目根目录）",
-      "items": {
-        "type": "string"
-      }
-    },
-    "exclude": {
-      "type": "array",
-      "description": "排除文件/目录 Glob（相对于项目根目录）",
-      "items": {
-        "type": "string"
-      }
-    },
-    "zipName": {
-      "type": "string",
-      "description": "打包输出 zip 名称（相对于默认 zip 目录）"
-    },
-    "zipPath": {
-      "type": "string",
-      "description": "打包输出 zip 路径（相对于项目根目录或绝对路径）"
-    },
-    "serverPath": {
-      "type": "string",
-      "description": "服务器构建输出目录（相对于项目根目录或绝对路径）"
-    },
-    "beforePack": {
-      "description": "打包前钩子（仅在代码调用传入时生效）"
-    },
-    "afterPack": {
-      "description": "打包后钩子（仅在代码调用传入时生效）"
-    },
-    "cleanDist": {
-      "type": "boolean",
-      "description": "是否清理 dist"
-    },
-    "writeScripts": {
-      "type": "boolean",
-      "description": "是否写入启动脚本和 package.json"
-    },
-    "packageJson": {
-      "type": "object",
-      "description": "写入/覆盖 package.json 内容"
-    },
-    "overwrite": {
-      "type": "boolean",
-      "description": "复制时是否覆盖同名文件"
-    }
-  }
-}
+{
+  "title": "Nuxt Gin Tools Pack Config",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "extraFiles": {
+      "type": "object",
+      "description": "额外需要打包的文件映射（key: 源文件路径，value: 打包后对应位置）",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "extraFilesGlobs": {
+      "type": "array",
+      "description": "额外需要打包的文件 Glob（相对于项目根目录）",
+      "items": {
+        "type": "string"
+      }
+    },
+    "exclude": {
+      "type": "array",
+      "description": "排除文件/目录 Glob（相对于项目根目录）",
+      "items": {
+        "type": "string"
+      }
+    },
+    "zipName": {
+      "type": "string",
+      "description": "打包输出 zip 名称（相对于默认 zip 目录）"
+    },
+    "zipPath": {
+      "type": "string",
+      "description": "打包输出 zip 路径（相对于项目根目录或绝对路径）"
+    },
+    "serverPath": {
+      "type": "string",
+      "description": "服务器构建输出目录（相对于项目根目录或绝对路径）"
+    },
+    "beforePack": {
+      "description": "打包前钩子（仅在代码调用传入时生效）"
+    },
+    "afterPack": {
+      "description": "打包后钩子（仅在代码调用传入时生效）"
+    },
+    "cleanDist": {
+      "type": "boolean",
+      "description": "是否清理 dist"
+    },
+    "writeScripts": {
+      "type": "boolean",
+      "description": "是否写入启动脚本和 package.json"
+    },
+    "packageJson": {
+      "type": "object",
+      "description": "写入/覆盖 package.json 内容"
+    },
+    "overwrite": {
+      "type": "boolean",
+      "description": "复制时是否覆盖同名文件"
+    }
+  }
+}