@sys-designer/create-vue 1.0.2 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sys-designer/create-vue",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Scaffold a sys-designer Vue3 + Vite + TS project from the command line.",
   "type": "module",
   "bin": {

package/template/.gitattributes

@@ -0,0 +1,5 @@
+# 强制脚本与源码使用 LF 行尾，避免 Windows / git autocrlf 把 .sh 转成 CRLF
+# 导致 "syntax error near unexpected token '$'in\r''" 等错误。
+* text=auto eol=lf
+*.sh text eol=lf
+*.bat text eol=crlf

package/template/scripts/build.sh

@@ -0,0 +1,137 @@
+#!/usr/bin/env bash
+# 若文件含 CRLF（Windows 拷贝 / git autocrlf 导致），自动转 LF 后重跑。
+# 本自修正必须放在第 2 行（shebang 之后、任何注释/命令之前），确保最先执行。
+# 约束：
+#   1) 必须用纯 && 链式，不能写 if/then/fi —— CRLF 会让 then 失效，自修正无法触发。
+#   2) 不能用 grep 检测 CR —— Git Bash 的 grep 以文本模式读文件，会把 CRLF 的 CR 剥离，检测永远失败。
+#   3) 不能用 sed 's/\r$//' —— Git Bash 的 GNU sed 正则不识别 \r。
+# 故采用「字节数对比」：tr 去掉所有 CR 后字节数变少，说明原文件含 CRLF。
+n1=$(wc -c < "$0"); tr -d '\r' < "$0" > "$0.tmp"; n2=$(wc -c < "$0.tmp"); [ "$n1" != "$n2" ] && mv "$0.tmp" "$0" && exec bash "$0" "$@"; rm -f "$0.tmp"
+
+# build.sh —— 构建项目并将产物打包为压缩包，输出到 output/ 目录
+#
+# 用法:
+#   bash scripts/build.sh                          # 输出到 ./output/<name>-<version>.tar.gz
+#   bash scripts/build.sh myapp                    # 输出到 ./output/myapp.tar.gz
+#   bash scripts/build.sh /path/out                # 输出目录改为 /path/out
+#   bash scripts/build.sh /path/out myapp          # 输出目录 /path/out，名称 myapp
+#   bash scripts/build.sh --name myapp --out /path/out
+#
+# 说明:
+#   - 自动选择包管理器（按 lockfile 判定，优先 pnpm/yarn/npm）；含 pnpm 的 link: 等协议时
+#     必须用 pnpm，否则 npm 会报 EUNSUPPORTEDPROTOCOL。也可用 PKG_MANAGER 环境变量强制指定。
+#   - 执行 安装 + 构建，产物在 dist/。
+#   - 安装后会把 package.json 中所有 link: 依赖的 lib.config.ts 合并，
+#     输出到 common/lib.config.ts（由 scripts/merge-lib-config.mjs 处理）。
+#   - 包名默认取 package.json 的 name-version；可用第二位置参数或 --name 指定。
+#   - 输出目录默认 ./output；可用第一位置参数(像路径)或 --out 指定。
+#   - 若环境存在 zip 命令，会额外生成一个同名 .zip 包。
+#   - 若脚本从 Windows 拷贝带 CRLF 行尾，本脚本会自动转为 LF 后重新执行。
+
+set -euo pipefail
+
+# 切到项目根目录（scripts/ 的上一级）
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$PROJECT_ROOT"
+
+# 选择包管理器：优先按项目里的 lockfile 判定，避免 npm 不识别 pnpm 的 link: 等协议
+# （会报 EUNSUPPORTEDPROTOCOL）。也可用环境变量 PKG_MANAGER=npm|pnpm|yarn 强制指定。
+detect_pm() {
+  if [ -n "${PKG_MANAGER:-}" ]; then
+    PM="$PKG_MANAGER"
+  elif [ -f pnpm-lock.yaml ]; then
+    PM=pnpm
+  elif [ -f yarn.lock ]; then
+    PM=yarn
+  elif [ -f package-lock.json ]; then
+    PM=npm
+  elif command -v pnpm >/dev/null 2>&1; then
+    PM=pnpm
+  elif command -v yarn >/dev/null 2>&1; then
+    PM=yarn
+  else
+    PM=npm
+  fi
+  case "$PM" in
+    pnpm) PM_INSTALL="pnpm install"; PM_RUN="pnpm run" ;;
+    yarn) PM_INSTALL="yarn install"; PM_RUN="yarn" ;;
+    *)    PM_INSTALL="npm install";  PM_RUN="npm run" ;;
+  esac
+}
+detect_pm
+
+OUT_DIR="$PROJECT_ROOT/output"
+ARCHIVE_NAME=""
+POSITIONAL=()
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    $'\r') shift ;;   # 丢弃 CRLF 自修正重跑时可能带入的孤立 CR 参数
+    --name) ARCHIVE_NAME="${2:-}"; shift 2 ;;
+    --name=*) ARCHIVE_NAME="${1#*=}"; shift ;;
+    --out) OUT_DIR="${2:-}"; shift 2 ;;
+    --out=*) OUT_DIR="${1#*=}"; shift ;;
+    -*) echo "未知参数: $1" >&2; exit 1 ;;
+    *) POSITIONAL+=("$1"); shift ;;
+  esac
+done
+
+# 位置参数兜底: $1 = 输出目录(像路径) 或 名称, $2 = 名称
+if [ -z "$ARCHIVE_NAME" ] && [ "${#POSITIONAL[@]}" -ge 1 ]; then
+  first="${POSITIONAL[0]}"
+  if [ "${#POSITIONAL[@]}" -ge 2 ]; then
+    OUT_DIR="$first"; ARCHIVE_NAME="${POSITIONAL[1]}"
+  else
+    case "$first" in
+      /*|./*|../*|*/|*/*) OUT_DIR="$first" ;;
+      *) ARCHIVE_NAME="$first" ;;
+    esac
+  fi
+fi
+
+echo "==> 工作目录: $PROJECT_ROOT"
+
+echo "==> 安装依赖 ($PM_INSTALL)"
+$PM_INSTALL
+
+# 合并所有 link: 依赖(如 new-app)的 lib.config.ts -> common/lib.config.ts
+echo "==> 合并 link 依赖的 lib.config.ts"
+node "$(dirname "$0")/merge-lib-config.mjs"
+
+echo "==> 构建生产包 ($PM_RUN build)"
+$PM_RUN build
+
+DIST_DIR="$PROJECT_ROOT/dist"
+if [ ! -d "$DIST_DIR" ]; then
+  echo "错误: 构建产物目录 $DIST_DIR 不存在，构建可能失败。" >&2
+  exit 1
+fi
+
+# 读取包名与版本（构建依赖 node，必可用）；未指定名称时作为默认名
+PKG_NAME=$(node -p "require('./package.json').name" 2>/dev/null || echo app)
+PKG_VERSION=$(node -p "require('./package.json').version" 2>/dev/null || echo 1.0.0)
+if [ -z "$ARCHIVE_NAME" ]; then
+  ARCHIVE_NAME="$PKG_NAME-$PKG_VERSION"
+else
+  # 去掉用户可能带入的扩展名，避免双重后缀
+  ARCHIVE_NAME="${ARCHIVE_NAME%.tar.gz}"
+  ARCHIVE_NAME="${ARCHIVE_NAME%.tgz}"
+  ARCHIVE_NAME="${ARCHIVE_NAME%.zip}"
+fi
+
+mkdir -p "$OUT_DIR"
+TAR_ARCHIVE="$OUT_DIR/$ARCHIVE_NAME.tar.gz"
+
+echo "==> 打包 dist/ -> $TAR_ARCHIVE"
+tar -czf "$TAR_ARCHIVE" -C "$DIST_DIR" .
+
+# 若环境有 zip，额外生成 zip 包
+if command -v zip >/dev/null 2>&1; then
+  ZIP_ARCHIVE="$OUT_DIR/$ARCHIVE_NAME.zip"
+  echo "==> 打包 dist/ -> $ZIP_ARCHIVE"
+  (cd "$DIST_DIR" && zip -r -q "$ZIP_ARCHIVE" .)
+else
+  echo "==> 未检测到 zip 命令，跳过 zip 包（已生成 tar.gz）"
+fi
+
+echo "==> 构建完成，压缩包输出在: $OUT_DIR"

package/template/scripts/deploy.sh

@@ -0,0 +1,128 @@
+#!/usr/bin/env bash
+# 若文件含 CRLF（Windows 拷贝 / git autocrlf 导致），自动转 LF 后重跑。
+# 本自修正必须放在第 2 行（shebang 之后、任何注释/命令之前），确保最先执行。
+# 约束：
+#   1) 必须用纯 && 链式，不能写 if/then/fi —— CRLF 会让 then 失效，自修正无法触发。
+#   2) 不能用 grep 检测 CR —— Git Bash 的 grep 以文本模式读文件，会把 CRLF 的 CR 剥离，检测永远失败。
+#   3) 不能用 sed 's/\r$//' —— Git Bash 的 GNU sed 正则不识别 \r。
+# 故采用「字节数对比」：tr 去掉所有 CR 后字节数变少，说明原文件含 CRLF。
+n1=$(wc -c < "$0"); tr -d '\r' < "$0" > "$0.tmp"; n2=$(wc -c < "$0.tmp"); [ "$n1" != "$n2" ] && mv "$0.tmp" "$0" && exec bash "$0" "$@"; rm -f "$0.tmp"
+
+# deploy.sh —— 仅发布(解压)已由 build.sh 构建好的压缩包到 nginx html 目录
+#
+# 用法:
+#   bash scripts/deploy.sh                                   # 仅发布 output/ 中已有的压缩包到自动检测的 nginx 目录
+#   bash scripts/deploy.sh /usr/share/nginx/html             # 发布到指定 nginx 目录
+#   bash scripts/deploy.sh /usr/share/nginx/html myapp       # 发布到 nginx 的 myapp 子目录
+#   bash scripts/deploy.sh myapp                             # 自动检测 nginx 目录, 发布到其 myapp 子目录
+#
+# 说明:
+#   - 本脚本【不负责构建】，只能使用 build.sh 已在 output/ 下生成的压缩包。
+#     若找不到压缩包会直接报错，请先运行: bash scripts/build.sh
+#   - 发布时把压缩包【解压】到目标 nginx 静态目录(可直接 serve), 不拷贝 .tar.gz。
+#   - 未传 nginx 目录时尝试自动检测常见目录; 检测到才发布, 否则仅提示压缩包位置。
+#   - --clean 会先清空目标目录(或子目录)现有内容。
+#   - 若脚本从 Windows 拷贝带 CRLF 行尾, 本脚本会自动转为 LF 后重新执行。
+
+set -euo pipefail
+
+# 切到项目根目录（scripts/ 的上一级）
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$PROJECT_ROOT"
+
+DEPLOY_DIR=""
+SUBDIR=""
+ARCHIVE_NAME=""
+CLEAN=0
+POSITIONAL=()
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    $'\r') shift ;;   # 丢弃 CRLF 自修正重跑时可能带入的孤立 CR 参数
+    --name) ARCHIVE_NAME="${2:-}"; shift 2 ;;
+    --name=*) ARCHIVE_NAME="${1#*=}"; shift ;;
+    --clean) CLEAN=1; shift ;;
+    -*) echo "未知参数: $1" >&2; exit 1 ;;
+    *) POSITIONAL+=("$1"); shift ;;
+  esac
+done
+
+# 位置参数: $1 = nginx 目录(可选, 省略则自动检测), $2 = 子目录名(可选)
+if [ "${#POSITIONAL[@]}" -ge 1 ]; then
+  first="${POSITIONAL[0]}"
+  if [ "${#POSITIONAL[@]}" -ge 2 ]; then
+    DEPLOY_DIR="$first"; SUBDIR="${POSITIONAL[1]}"
+  else
+    case "$first" in
+      # 含路径分隔符(/ 或 \)的视为目标目录；否则视为 nginx 下的子目录名
+      /*|./*|../*|*/|*/*|*\\*) DEPLOY_DIR="$first" ;;
+      *) SUBDIR="$first" ;;
+    esac
+  fi
+fi
+
+echo "==> 工作目录: $PROJECT_ROOT"
+
+# 若未显式指定目录，尝试自动检测常见的 nginx html 目录
+if [ -z "$DEPLOY_DIR" ]; then
+  for d in /usr/share/nginx/html /var/www/html /usr/local/nginx/html /opt/nginx/html /data/nginx/html; do
+    if [ -d "$d" ]; then
+      DEPLOY_DIR="$d"
+      echo "==> 未指定目录，自动检测到 nginx html 目录: $DEPLOY_DIR"
+      break
+    fi
+  done
+  if [ -z "$DEPLOY_DIR" ]; then
+    echo "==> 未指定目录且未检测到 nginx html 目录，将只保留压缩包不发布"
+  fi
+fi
+
+# 读取包名与版本（node 必可用），用于推导压缩包名
+PKG_NAME=$(node -p "require('./package.json').name" 2>/dev/null || echo app)
+PKG_VERSION=$(node -p "require('./package.json').version" 2>/dev/null || echo 1.0.0)
+if [ -z "$ARCHIVE_NAME" ]; then
+  ARCHIVE_NAME="$PKG_NAME-$PKG_VERSION"
+else
+  # 去掉用户可能带入的扩展名，避免双重后缀
+  ARCHIVE_NAME="${ARCHIVE_NAME%.tar.gz}"
+  ARCHIVE_NAME="${ARCHIVE_NAME%.tgz}"
+  ARCHIVE_NAME="${ARCHIVE_NAME%.zip}"
+fi
+TAR_ARCHIVE="$PROJECT_ROOT/output/$ARCHIVE_NAME.tar.gz"
+
+# 本脚本不构建，必须使用 build.sh 已生成的压缩包
+if [ ! -f "$TAR_ARCHIVE" ]; then
+  echo "错误: 未找到构建好的压缩包 $TAR_ARCHIVE" >&2
+  echo "      deploy.sh 不负责构建，请先运行: bash scripts/build.sh" >&2
+  exit 1
+fi
+echo "==> 使用构建好的压缩包: $TAR_ARCHIVE"
+
+if [ -n "$DEPLOY_DIR" ]; then
+  # 统一用 / 作为分隔符，避免 Windows 反斜杠路径与子目录 / 拼接时混用导致 mkdir/tar 失败
+  DEPLOY_DIR="${DEPLOY_DIR//\\//}"
+  # nginx 根目录必须存在；不存在则报错，避免 mkdir -p 误建出假的 nginx 目录
+  if [ ! -d "$DEPLOY_DIR" ]; then
+    echo "错误: nginx 目录不存在: $DEPLOY_DIR" >&2
+    exit 1
+  fi
+  TARGET="$DEPLOY_DIR"
+  if [ -n "$SUBDIR" ]; then
+    TARGET="$DEPLOY_DIR/$SUBDIR"
+    # 子目录不存在时自动创建（nginx 目录已存在的前提下）
+    if [ ! -d "$TARGET" ]; then
+      echo "==> 目标子目录不存在，自动创建: $TARGET"
+    fi
+    echo "==> 目标子目录: $SUBDIR"
+  fi
+  echo "==> 解压压缩包到目标目录(nginx 可直接 serve): $TARGET"
+  mkdir -p "$TARGET"
+  if [ "$CLEAN" -eq 1 ]; then
+    echo "==> 清空目标目录现有内容"
+    find "$TARGET" -mindepth 1 -maxdepth 1 -exec rm -rf {} +
+  fi
+  tar -xzf "$TAR_ARCHIVE" -C "$TARGET"
+  echo "==> 已发布(解压): $TARGET"
+else
+  echo "==> 压缩包已就绪: $TAR_ARCHIVE （未指定发布目录，跳过发布）"
+fi

package/template/scripts/merge-lib-config.mjs

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+// merge-lib-config.mjs
+// 读取项目 package.json 中所有 "xxx": "link:../xxx" 依赖，逐个解析其 lib.config.ts，
+// 把其中的 libResolves / libModules 合并后输出到 <项目根>/common/lib.config.ts。
+//
+// 用法: node scripts/merge-lib-config.mjs
+//   - 在 build.sh 中于 install 之后、build 之前被调用。
+//   - 即使没有任何 link: 依赖 / 没有可合并的 lib.config.ts，也会输出一个空的
+//     common/lib.config.ts（不跳过），保证下游构建始终有该文件可用。
+//   - resolve 参数保留原样（如 resolve(process.cwd(), '.', './node_modules/...')）。
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { resolve as pathResolve, join } from 'node:path';
+
+const projectRoot = process.cwd();
+
+// 1) 读取 package.json，找出所有 link: 依赖
+const pkgPath = join(projectRoot, 'package.json');
+const linkDirs = [];
+if (!existsSync(pkgPath)) {
+  console.log('merge-lib-config: 未找到 package.json，将输出空的 common/lib.config.ts');
+} else {
+  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+  const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
+  for (const [name, spec] of Object.entries(deps)) {
+    if (typeof spec === 'string' && spec.startsWith('link:')) {
+      const rel = spec.slice('link:'.length);
+      linkDirs.push({ name, path: pathResolve(projectRoot, rel) });
+    }
+  }
+  if (linkDirs.length === 0) {
+    console.log('merge-lib-config: 未找到 link: 依赖，将输出空的 common/lib.config.ts');
+  }
+}
+
+// 2) 解析单个 lib.config.ts 的 libResolves / libModules
+function parseLibConfig(content) {
+  const resolves = {};
+  const modules = [];
+
+  // libResolves = { ... }
+  const resMatch = content.match(/export\s+const\s+libResolves\s*=\s*\{([\s\S]*?)\n\s*\};/);
+  if (resMatch) {
+    for (const line of resMatch[1].split('\n')) {
+      const m = line.match(/'([^']+)'\s*:\s*([\s\S]+?)\s*,?\s*$/);
+      if (m) resolves[m[1]] = m[2].trim();
+    }
+  }
+
+  // libModules = [ ... ]
+  const modMatch = content.match(/export\s+const\s+libModules\s*=\s*\[([\s\S]*?)\n\s*\];/);
+  if (modMatch) {
+    const reObj = /\{([\s\S]*?)\}/g;
+    let m;
+    while ((m = reObj.exec(modMatch[1])) !== null) {
+      const entry = {};
+      const propRe = /(\w+)\s*:\s*(true|false|'([^']*)')/g;
+      let p;
+      while ((p = propRe.exec(m[1])) !== null) {
+        const key = p[1];
+        if (p[2] === 'true') entry[key] = true;
+        else if (p[2] === 'false') entry[key] = false;
+        else entry[key] = p[3];
+      }
+      if (entry.name) modules.push(entry);
+    }
+  }
+
+  return { resolves, modules };
+}
+
+// 3) 合并（resolves 按 key 去重取先到者；modules 按 name 去重）
+const mergedResolves = {};
+const mergedModules = [];
+const seenModules = new Set();
+let conflictWarned = false;
+
+for (const { name, path } of linkDirs) {
+  const cfgPath = join(path, 'lib.config.ts');
+  if (!existsSync(cfgPath)) {
+    console.log(`merge-lib-config: [${name}] 未找到 lib.config.ts，跳过: ${cfgPath}`);
+    continue;
+  }
+  const { resolves, modules } = parseLibConfig(readFileSync(cfgPath, 'utf-8'));
+  for (const [k, v] of Object.entries(resolves)) {
+    if (k in mergedResolves) {
+      if (!conflictWarned) {
+        console.warn(`merge-lib-config: libResolves 键 "${k}" 重复，保留首个定义`);
+        conflictWarned = true;
+      }
+      continue;
+    }
+    mergedResolves[k] = v;
+  }
+  for (const mod of modules) {
+    if (seenModules.has(mod.name)) continue;
+    seenModules.add(mod.name);
+    mergedModules.push(mod);
+  }
+}
+
+// 4) 渲染并写出到 common/lib.config.ts
+function render() {
+  const lines = [];
+  if (Object.keys(mergedResolves).length > 0) {
+    lines.push("import { resolve } from 'path';");
+    lines.push('');
+  }
+  lines.push('export const libResolves = {');
+  for (const [k, v] of Object.entries(mergedResolves)) {
+    lines.push(`    '${k}': ${v},`);
+  }
+  lines.push('};');
+  lines.push('');
+  lines.push('export const libModules = [');
+  for (const mod of mergedModules) {
+    const props = Object.entries(mod)
+      .map(([k, val]) => (val === true ? `${k}: true` : val === false ? `${k}: false` : `${k}: '${val}'`))
+      .join(', ');
+    lines.push(`    { ${props} },`);
+  }
+  lines.push('];');
+  return lines.join('\n') + '\n';
+}
+
+const outDir = join(projectRoot, 'common');
+mkdirSync(outDir, { recursive: true });
+const outPath = join(outDir, 'lib.config.ts');
+writeFileSync(outPath, render(), 'utf-8');
+console.log(
+  `merge-lib-config: 已合并 ${Object.keys(mergedResolves).length} 个 resolve / ${mergedModules.length} 个 module -> ${outPath}`
+);

package/template/src/router/index.ts

@@ -1,4 +1,4 @@
-import { createRouter, createWebHistory, RouteRecordRaw } from 'vue-router'
+import { createRouter, createWebHashHistory, RouteRecordRaw } from 'vue-router'
 import { routes } from '@common/routes';
 
 export const constantRoutes: RouteRecordRaw[] = [
@@ -10,7 +10,7 @@ export const constantRoutes: RouteRecordRaw[] = [
 ]
 
 const router = createRouter({
-  history: createWebHistory(),
+  history: createWebHashHistory(),
   routes: constantRoutes
 })
 

package/template/src/views/index.vue

@@ -17,7 +17,7 @@ const options = [
 const message = useMessage();
 
 const showMsg = () => {
-  message.success('NaiveUI + Vue3 + TS + Vite 搭建成功！')
+  message.success('Sys-Designer 搭建成功！')
 }
 
 </script>