@liujitcn/kratos-admin-cli 0.0.36 → 0.0.38

package/README.md

@@ -52,7 +52,7 @@ pnpm module:create ../shop-admin --module shop,order --with log
 pnpm --filter @liujitcn/kratos-admin-cli test
 ```
 
-CLI 始终先引入 `@liujitcn/kratos-admin-system`。`--module` 可重复使用，也接受逗号分隔名称，并为每个名称创建独立 module 包；`--with` 接收逗号分隔的额外已发布 module 名称，只装配依赖而不生成源码。CLI 拒绝覆盖已有目录；渲染失败时会清理本次创建的不完整目标目录。
+CLI 默认引入内置 System；指定本地 `system` 时由本地模块继承并替代运行时注册，构建仍扫描内置包。`--module` 可重复使用，也接受逗号分隔名称，并为每个名称创建独立 module 包；`--with` 接收逗号分隔的额外已发布 module 名称，只装配依赖而不生成源码。CLI 拒绝覆盖已有目录；渲染失败时会清理本次创建的不完整目标目录。
 
 生成结果遵守以下约束：
 
@@ -96,3 +96,14 @@ pnpm --filter @liujitcn/kratos-admin-cli test
 发布包包含编译后的 `dist/index.js`、类型声明、workspace 模板和本 README。仓库级
 `make -C frontend package-admin` 会先执行测试和构建，再生成
 `@liujitcn/kratos-admin-cli` tarball。
+
+
+### CLI 生成边界
+
+CLI 直接生成完整宿主、本地业务模块、四种语言源文件与注册入口、类型检查、lint 和打包配置。
+支持本地 `system` 与其他模块一起创建；管理端本地 System 继承内置能力，运行时只注册一次，
+构建仍扫描内置源码。应用端本地模块使用独立导入别名，保留内置 System。
+
+通过 `--kratos-project` 生成与 Go 后端配套的前端：H5 输出到 `backend/data/<terminal>`，
+管理端 CLI 同时在 workspace 父目录创建共享 `Makefile` 与 `scripts`。Go 调用方仅传参执行 CLI。
+新增语言或修改语言文件后运行 `pnpm i18n:sync`；`pnpm i18n:check` 校验注册文件是否同步。

package/dist/index.d.ts

@@ -9,6 +9,8 @@ export interface CreateWorkspaceOptions {
     additionalModules?: string[];
     /** 生成命令的工作目录。 */
     cwd?: string;
+    /** 生成与 Kratos 后端配套的公共前端工具和静态输出配置。 */
+    kratosProject?: boolean;
 }
 /** 创建包含宿主和业务模块包的 pnpm workspace。 */
 export declare function createBusinessWorkspace(options: CreateWorkspaceOptions): Promise<string>;

package/dist/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { execFileSync } from "node:child_process";
 import { mkdir, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
 import { basename, dirname, join, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -23,11 +24,15 @@ export async function createBusinessWorkspace(options) {
     const packageVersion = await readCliPackageVersion();
     const primaryModuleTokens = createModuleTokens(primaryModuleName, packageVersion);
     const moduleManifestEntries = [
-        {
-            packageName: "@liujitcn/kratos-admin-system",
-            moduleIdentifier: "systemAdminModule",
-            optimizeDependencies: officialModuleOptimizeDependencies.system
-        },
+        ...(!moduleNames.includes("system")
+            ? [
+                {
+                    packageName: "@liujitcn/kratos-admin-system",
+                    moduleIdentifier: "systemAdminModule",
+                    optimizeDependencies: officialModuleOptimizeDependencies.system
+                }
+            ]
+            : []),
         ...moduleNames.map(name => ({
             packageName: `@${name}/admin-module`,
             moduleIdentifier: `${toCamelCase(name)}AdminModule`,
@@ -74,6 +79,10 @@ export async function createBusinessWorkspace(options) {
     const tokens = {
         ...primaryModuleTokens,
         __PROJECT_NAME__: projectName,
+        __FRONTEND_MODULE__: primaryModuleName,
+        __MODULES_SPACE__: moduleNames.join(" "),
+        __HOST_BUILD_CACHE__: String(!options.kratosProject),
+        __H5_OUTPUT__: options.kratosProject ? ',\n  outputDirectory: "../../../../backend/data/admin"' : "",
         __APP_PACKAGE__: `@${primaryModuleName}/admin-app`,
         __APP_DEPENDENCIES__: formatJsonValue(appDependencies, "  "),
         __MODULE_FILTERS__: modulePackages.map(packageName => `--filter=${packageName}`).join(" "),
@@ -94,6 +103,10 @@ export async function createBusinessWorkspace(options) {
                 __PROJECT_NAME__: projectName
             });
         }
+        execFileSync(process.execPath, [resolve(target, "scripts/sync-locales.mjs"), "--write"], { stdio: "inherit" });
+        if (options.kratosProject) {
+            await renderDirectory(resolve(packageRoot, "templates/project-frontend"), dirname(target), tokens);
+        }
     }
     catch (error) {
         await rm(target, { recursive: true, force: true });
@@ -115,7 +128,12 @@ export async function runCli(args = process.argv.slice(2)) {
     if (!projectName || moduleNames.length === 0) {
         throw new Error("用法: kratos-admin create <project> --module <module[,module...]>");
     }
-    const target = await createBusinessWorkspace({ projectName, moduleNames, additionalModules: withModules });
+    const target = await createBusinessWorkspace({
+        projectName,
+        moduleNames,
+        additionalModules: withModules,
+        kratosProject: args.includes("--kratos-project")
+    });
     process.stdout.write(`已创建业务 workspace: ${target}\n`);
 }
 /** 渲染模板目录中的路径和文本占位符。 */
@@ -123,7 +141,7 @@ async function renderDirectory(source, target, tokens) {
     await mkdir(target, { recursive: true });
     const entries = await readdir(source, { withFileTypes: true });
     for (const entry of entries) {
-        const renderedName = entry.name === gitignoreTemplateName ? ".gitignore" : replaceTokens(entry.name, tokens);
+        const renderedName = entry.name === gitignoreTemplateName ? ".gitignore" : replaceTokens(entry.name, tokens).replace(/\.tmpl$/, "");
         const sourcePath = join(source, entry.name);
         const targetPath = join(target, renderedName);
         if (entry.isDirectory()) {
@@ -168,7 +186,7 @@ function normalizeModuleNames(moduleNames) {
     if (!primaryModuleName)
         throw new Error("至少需要一个业务模块名称");
     normalized.forEach(name => validateName(name, "模块名称"));
-    const reservedName = normalized.find(name => name === "system" || name === "kratos-admin");
+    const reservedName = normalized.find(name => name === "kratos-admin");
     if (reservedName)
         throw new Error(`自有模块名称不能使用保留名称: ${reservedName}`);
     return [primaryModuleName, ...normalized.slice(1)];
@@ -186,7 +204,18 @@ function createModuleTokens(moduleName, packageVersion) {
         __MODULE_PASCAL__: toPascalCase(moduleName),
         __MODULE_PACKAGE__: `@${moduleName}/admin-module`,
         __MODULE_IDENTIFIER__: `${toCamelCase(moduleName)}AdminModule`,
-        __CORE_VERSION__: `^${packageVersion}`
+        __CORE_VERSION__: `^${packageVersion}`,
+        __SYSTEM_IMPORT__: moduleName === "system"
+            ? 'import { systemAdminModule as baseSystemAdminModule } from "@liujitcn/kratos-admin-system";\n'
+            : "",
+        __MODULE_FIELDS__: moduleName === "system"
+            ? `...baseSystemAdminModule,
+  views: { ...baseSystemAdminModule.views, ...viewModules },
+  messages: Object.fromEntries(Object.entries(LOCALE_MESSAGES).map(([locale, messages]) => [
+    locale, { ...baseSystemAdminModule.messages?.[locale], ...messages }
+  ]))`
+            : `name: "${moduleName}",\n  views: viewModules,\n  messages: LOCALE_MESSAGES`,
+        __MODULE_DEPENDENCIES__: JSON.stringify(moduleName === "system" ? { "@liujitcn/kratos-admin-system": `^${packageVersion}` } : {})
     };
 }
 /** 格式化嵌入模板的多行 JSON 值。 */
@@ -230,7 +259,7 @@ async function pathExists(path) {
 /** 输出 CLI 使用说明。 */
 function printHelp() {
     process.stdout.write([
-        "kratos-admin create <project> --module <module[,module...]> [--module <module>] [--with other]",
+        "kratos-admin create <project> --module <module[,module...]> [--module <module>] [--with other] [--kratos-project]",
         "",
         "示例:",
         "  kratos-admin create shop-admin --module shop",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liujitcn/kratos-admin-cli",
-  "version": "0.0.36",
+  "version": "0.0.38",
   "type": "module",
   "description": "Create pnpm workspace projects for kratos-admin business modules",
   "license": "MIT",

package/templates/business-workspace/.oxlintignore

@@ -0,0 +1,14 @@
+*.sh
+node_modules
+*.md
+*.woff
+*.ttf
+.vscode
+.idea
+dist
+/public
+/docs
+.local
+/bin
+/src/mock/*
+stats.html

package/templates/business-workspace/.prettierignore

@@ -0,0 +1,9 @@
+/dist/*
+.local
+/node_modules/**
+
+**/*.svg
+**/*.sh
+
+/public/*
+stats.html

package/templates/business-workspace/.prettierrc.cjs

@@ -0,0 +1,41 @@
+// @see: https://www.prettier.cn
+
+module.exports = {
+  // 指定最大换行长度
+  printWidth: 130,
+  // 缩进制表符宽度 | 空格数
+  tabWidth: 2,
+  // 使用制表符而不是空格缩进行 (true：制表符，false：空格)
+  useTabs: false,
+  // 结尾不用分号 (true：有，false：没有)
+  semi: true,
+  // 使用单引号 (true：单引号，false：双引号)
+  singleQuote: false,
+  // 在对象字面量中决定是否将属性名用引号括起来 可选值 "<as-needed|consistent|preserve>"
+  quoteProps: "as-needed",
+  // 在JSX中使用单引号而不是双引号 (true：单引号，false：双引号)
+  jsxSingleQuote: false,
+  // 多行时尽可能打印尾随逗号 可选值"<none|es5|all>"
+  trailingComma: "none",
+  // 在对象，数组括号与文字之间加空格 "{ foo: bar }" (true：有，false：没有)
+  bracketSpacing: true,
+  // 将 > 多行元素放在最后一行的末尾，而不是单独放在下一行 (true：放末尾，false：单独一行)
+  bracketSameLine: false,
+  // (x) => {} 箭头函数参数只有一个时是否要有小括号 (avoid：省略括号，always：不省略括号)
+  arrowParens: "avoid",
+  // 指定要使用的解析器，不需要写文件开头的 @prettier
+  requirePragma: false,
+  // 可以在文件顶部插入一个特殊标记，指定该文件已使用 Prettier 格式化
+  insertPragma: false,
+  // 用于控制文本是否应该被换行以及如何进行换行
+  proseWrap: "preserve",
+  // 在html中空格是否是敏感的 "css" - 遵守 CSS 显示属性的默认值， "strict" - 空格被认为是敏感的 ，"ignore" - 空格被认为是不敏感的
+  htmlWhitespaceSensitivity: "css",
+  // 控制在 Vue 单文件组件中 <script> 和 <style> 标签内的代码缩进方式
+  vueIndentScriptAndStyle: false,
+  // 换行符使用 lf 结尾是 可选值 "<auto|lf|crlf|cr>"
+  endOfLine: "auto",
+  // 这两个选项可用于格式化以给定字符偏移量（分别包括和不包括）开始和结束的代码 (rangeStart：开始，rangeEnd：结束)
+  rangeStart: 0,
+  rangeEnd: Infinity
+};

package/templates/business-workspace/.stylelintignore

@@ -0,0 +1,4 @@
+/dist/*
+/public/*
+public/*
+stats.html

package/templates/business-workspace/.stylelintrc.cjs

@@ -0,0 +1,39 @@
+// @see: https://stylelint.io
+
+module.exports = {
+  root: true,
+  // 继承某些已有的规则
+  extends: [
+    "stylelint-config-standard", // 配置 stylelint 拓展插件
+    "stylelint-config-html/vue", // 配置 vue 中 template 样式格式化
+    "stylelint-config-standard-scss", // 配置 stylelint scss 插件
+    "stylelint-config-recommended-vue/scss", // 配置 vue 中 scss 样式格式化
+    "stylelint-config-recess-order" // 配置 stylelint css 属性书写顺序插件,
+  ],
+  overrides: [
+    // 扫描 .vue/html 文件中的 <style> 标签内的样式
+    {
+      files: ["**/*.{vue,html}"],
+      customSyntax: "postcss-html"
+    }
+  ],
+  rules: {
+    "function-url-quotes": "always", // URL 的引号 "always(必须加上引号)"|"never(没有引号)"
+    "color-hex-length": "long", // 指定 16 进制颜色的简写或扩写 "short(16进制简写)"|"long(16进制扩写)"
+    "rule-empty-line-before": "never", // 要求或禁止在规则之前的空行 "always(规则之前必须始终有一个空行)"|"never(规则前绝不能有空行)"|"always-multi-line(多行规则之前必须始终有一个空行)"|"never-multi-line(多行规则之前绝不能有空行)"
+    "font-family-no-missing-generic-family-keyword": null, // 禁止在字体族名称列表中缺少通用字体族关键字
+    "property-no-unknown": null, // 禁止未知的属性
+    "no-empty-source": null, // 禁止空源码
+    "selector-class-pattern": null, // 强制选择器类名的格式
+    "value-no-vendor-prefix": null, // 关闭 vendor-prefix (为了解决多行省略 -webkit-box)
+    "no-descending-specificity": null, // 不允许较低特异性的选择器出现在覆盖较高特异性的选择器
+    "value-keyword-case": null, // 解决在 scss 中使用 v-bind 大写单词报错
+    "selector-pseudo-class-no-unknown": [
+      true,
+      {
+        ignorePseudoClasses: ["global", "v-deep", "deep"]
+      }
+    ]
+  },
+  ignoreFiles: ["**/*.js", "**/*.jsx", "**/*.tsx", "**/*.ts"]
+};

package/templates/business-workspace/apps/admin/src/main.ts

@@ -1,4 +1,15 @@
 import { bootstrapAdminApp } from "@liujitcn/kratos-admin-core";
 import adminModules from "./modules";
 
+const globalState = JSON.parse(window.localStorage.getItem("admin-global") ?? "null") as {
+  primary?: string;
+  isDark?: boolean;
+} | null;
+if (globalState) {
+  const dot = document.querySelectorAll<HTMLElement>(".dot i");
+  const html = document.querySelector("html");
+  if (globalState.primary) dot.forEach(item => (item.style.background = globalState.primary ?? ""));
+  if (globalState.isDark && html) html.style.background = "#141414";
+}
+
 void bootstrapAdminApp({ modules: adminModules });

package/templates/business-workspace/apps/admin/src/module-manifest.ts

@@ -13,11 +13,17 @@ export interface AdminModuleManifestItem {
 /** 当前宿主启用的管理端业务模块清单。 */
 export const adminModuleManifest = [__MODULE_MANIFEST__] satisfies AdminModuleManifestItem[];
 
+/** 编译清单保留内置 System 源码，供继承它的本地模块完成自动导入。 */
+const adminBuildModules: Pick<AdminModuleManifestItem, "packageName" | "optimizeDependencies">[] = [
+  { packageName: "@liujitcn/kratos-admin-system", optimizeDependencies: ["swagger-ui-dist/swagger-ui-bundle.js"] },
+  ...adminModuleManifest.filter(item => item.packageName !== "@liujitcn/kratos-admin-system")
+];
+
 /** 当前宿主需要扫描的业务模块包。 */
-export const adminModulePackages = adminModuleManifest.map(item => item.packageName);
+export const adminModulePackages = adminBuildModules.map(item => item.packageName);
 
 /** 当前宿主需要预构建的业务模块依赖。 */
-export const adminModuleOptimizeDependencies = adminModuleManifest.flatMap(item => {
+export const adminModuleOptimizeDependencies = adminBuildModules.flatMap(item => {
   return item.optimizeDependencies?.map(dependency => `${item.packageName} > ${dependency}`) ?? [];
 });
 

package/templates/business-workspace/apps/admin/{vite.config.ts → vite.config.ts.tmpl}

@@ -3,5 +3,5 @@ import { adminModuleOptimizeDependencies, adminModulePackages } from "./src/modu
 
 export default defineAdminViteConfig({
   modulePackages: adminModulePackages,
-  optimizeDependencies: adminModuleOptimizeDependencies
+  optimizeDependencies: adminModuleOptimizeDependencies__H5_OUTPUT__
 });

package/templates/business-workspace/internal/lint-config/oxlint.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "../../node_modules/oxlint/configuration_schema.json",
+  "env": {
+    "browser": true,
+    "node": true,
+    "es2020": true,
+    "vue": true
+  },
+  "plugins": ["vue", "typescript"],
+  "categories": {
+    "correctness": "warn",
+    "suspicious": "warn"
+  },
+  "rules": {
+    "no-var": "error",
+    "no-unused-vars": "error",
+    "no-empty-function": "error",
+    "no-unused-expressions": "off",
+    "no-extra-boolean-cast": "off",
+    "no-unsafe-finally": "off",
+    "no-shadow": "off",
+    "no-underscore-dangle": "off",
+    "prefer-const": "off",
+    "no-use-before-define": "off",
+    "typescript/prefer-ts-expect-error": "error",
+    "typescript/ban-ts-comment": "error",
+    "typescript/no-inferrable-types": "off",
+    "typescript/no-explicit-any": "off",
+    "typescript/ban-types": "off",
+    "typescript/no-namespace": "off",
+    "typescript/no-var-requires": "off",
+    "typescript/no-require-imports": "off",
+    "typescript/no-non-null-assertion": "off",
+    "vue/define-props-destructuring": "off",
+    "vue/no-deprecated-props-default-this": "off",
+    "vue/no-required-prop-with-default": "off"
+  }
+}

package/templates/business-workspace/lint-staged.config.cjs

@@ -0,0 +1,8 @@
+module.exports = {
+  "*.{js,jsx,ts,tsx}": ["oxlint --fix --config ./internal/lint-config/oxlint.json", "prettier --write"],
+  "{!(package)*.json,*.code-snippets,.!(browserslist)*rc}": ["prettier --write --parser json"],
+  "package.json": ["prettier --write"],
+  "*.vue": ["oxlint --fix --vue-plugin --config ./internal/lint-config/oxlint.json", "prettier --write", "stylelint --fix"],
+  "*.{scss,less,styl,html}": ["stylelint --fix", "prettier --write"],
+  "*.md": ["prettier --write"]
+};

package/templates/business-workspace/package.json

@@ -7,7 +7,15 @@
     "build": "turbo run build --filter=__APP_PACKAGE__",
     "build:package": "turbo run build:package __MODULE_FILTERS__",
     "type:check": "turbo run type:check",
-    "package": "pnpm build:package && pnpm --recursive __MODULE_FILTERS__ pack"
+    "package": "pnpm build:package && pnpm --recursive __MODULE_FILTERS__ pack",
+    "test": "node --test",
+    "lint:oxlint": "oxlint --fix --vue-plugin --config ./internal/lint-config/oxlint.json --ignore-path .oxlintignore ./apps ./packages ./internal ./scripts",
+    "lint:lint-staged": "lint-staged",
+    "lint:prettier": "prettier --write \"{apps,packages,internal,scripts}/**/*.{js,mjs,ts,json,tsx,css,less,scss,vue,html,md,yaml}\"",
+    "lint:stylelint": "stylelint --cache --fix \"{apps,packages}/**/*.{vue,less,postcss,css,scss}\" --cache-location node_modules/.cache/stylelint/",
+    "generate:auto-import-types": "node scripts/generate-auto-import-types.mjs",
+    "i18n:sync": "node scripts/sync-locales.mjs --write",
+    "i18n:check": "node scripts/sync-locales.mjs"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
@@ -15,10 +23,61 @@
     "turbo": "^2.5.6",
     "typescript": "6.0.3",
     "vite": "^8.0.14",
-    "vue-tsc": "^3.3.2"
+    "vue-tsc": "^3.3.2",
+    "@commitlint/cli": "^18.4.3",
+    "@commitlint/config-conventional": "^18.4.3",
+    "@types/md5": "^2.3.5",
+    "@types/nprogress": "^0.2.3",
+    "@types/qs": "^6.9.15",
+    "@types/sortablejs": "^1.15.8",
+    "autoprefixer": "^10.4.19",
+    "cz-git": "1.13.1",
+    "czg": "^1.13.1",
+    "lint-staged": "^15.2.5",
+    "oxlint": "^1.67.0",
+    "postcss": "^8.4.38",
+    "postcss-html": "^1.8.1",
+    "prettier": "^3.3.2",
+    "standard-version": "^9.5.0",
+    "stylelint": "^17.12.0",
+    "stylelint-config-html": "^1.1.0",
+    "stylelint-config-recess-order": "^7.7.0",
+    "stylelint-config-recommended-scss": "^17.0.1",
+    "stylelint-config-recommended-vue": "^1.5.0",
+    "stylelint-config-standard": "^40.0.0",
+    "stylelint-config-standard-scss": "^17.0.0",
+    "stylelint-order": "8.1.1",
+    "ts-proto": "^2.11.8"
   },
   "engines": {
     "node": "^20.19.0 || >=22.12.0"
   },
-  "packageManager": "pnpm@10.33.4"
+  "packageManager": "pnpm@10.33.4",
+  "pnpm": {
+    "overrides": {
+      "@vueuse/core": "14.4.0",
+      "element-plus": "2.14.5",
+      "svg-baker>braces": "3.0.3",
+      "svg-baker>micromatch": "4.0.8",
+      "svg-baker>postcss": "8.5.26",
+      "vue": "3.5.42",
+      "vue-router": "5.3.1"
+    },
+    "onlyBuiltDependencies": [
+      "@parcel/watcher",
+      "es5-ext",
+      "esbuild",
+      "vue-demi",
+      "workbox-build"
+    ],
+    "ignoredBuiltDependencies": [
+      "@scarf/scarf"
+    ],
+    "auditConfig": {
+      "ignoreCves": [
+        "CVE-2025-71330",
+        "CVE-2025-71329"
+      ]
+    }
+  }
 }

package/templates/business-workspace/packages/modules/__MODULE_NAME__/package.json

@@ -10,6 +10,7 @@
     "type:check": "vue-tsc --noEmit --skipLibCheck",
     "prepack": "pnpm build:package"
   },
+  "dependencies": __MODULE_DEPENDENCIES__,
   "devDependencies": {
     "@liujitcn/kratos-admin-core": "__CORE_VERSION__"
   },

package/templates/business-workspace/packages/modules/__MODULE_NAME__/src/locales/en-US.json

@@ -0,0 +1 @@
+{}

package/templates/business-workspace/packages/modules/__MODULE_NAME__/src/locales/ja-JP.json

@@ -0,0 +1 @@
+{}

package/templates/business-workspace/packages/modules/__MODULE_NAME__/src/locales/zh-CN.json

@@ -0,0 +1 @@
+{}

package/templates/business-workspace/packages/modules/__MODULE_NAME__/src/locales/zh-TW.json

@@ -0,0 +1 @@
+{}

package/templates/business-workspace/packages/modules/__MODULE_NAME__/src/{module.ts → module.ts.tmpl}

@@ -1,10 +1,12 @@
 import type { Component } from "vue";
 import { defineAdminModule } from "@liujitcn/kratos-admin-core";
 
+__SYSTEM_IMPORT__
+import { LOCALE_MESSAGES } from "./locales/generated";
+
 const viewModules = import.meta.glob<{ default: Component }>("./views/**/*.vue");
 
 /** __MODULE_PASCAL__ 管理端业务模块。 */
 export const __MODULE_IDENTIFIER__ = defineAdminModule({
-  name: "__MODULE_NAME__",
-  views: viewModules
+  __MODULE_FIELDS__
 });

package/templates/business-workspace/scripts/generate-auto-import-types.mjs

@@ -0,0 +1,40 @@
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { build } from "vite";
+
+const adminRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const hostRequire = createRequire(resolve(adminRoot, "apps/admin/package.json"));
+const coreRoot = dirname(hostRequire.resolve("@liujitcn/kratos-admin-core/package.json"));
+const coreRequire = createRequire(resolve(coreRoot, "package.json"));
+const { default: AutoImport } = await import(pathToFileURL(coreRequire.resolve("unplugin-auto-import/vite")).href);
+const { ElementPlusResolver } = await import(pathToFileURL(coreRequire.resolve("unplugin-vue-components/resolvers")).href);
+const imports = JSON.parse(readFileSync(resolve(coreRoot, "build/auto-imports.json"), "utf8"));
+const virtualEntry = "virtual:kratos-auto-import-types";
+
+await build({
+  configFile: false,
+  logLevel: "silent",
+  plugins: [
+    {
+      name: "kratos-auto-import-types-entry",
+      resolveId(id) {
+        return id === virtualEntry ? `\0${virtualEntry}` : undefined;
+      },
+      load(id) {
+        return id === `\0${virtualEntry}` ? "export {};" : undefined;
+      }
+    },
+    AutoImport({
+      dts: resolve(adminRoot, "apps/admin/src/auto-imports.d.ts"),
+      dtsMode: "overwrite",
+      imports: ["vue", "vue-router", imports],
+      resolvers: [ElementPlusResolver()]
+    })
+  ],
+  build: {
+    write: false,
+    rollupOptions: { input: virtualEntry }
+  }
+});

package/templates/business-workspace/scripts/sync-locales.mjs

@@ -0,0 +1,38 @@
+import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const modulesRoot = resolve(root, 'packages/modules')
+const write = process.argv.includes('--write')
+let expectedLocales
+for (const entry of existsSync(modulesRoot) ? readdirSync(modulesRoot, { withFileTypes: true }) : []) {
+  if (!entry.isDirectory()) continue
+  const directory = resolve(modulesRoot, entry.name, 'src/locales')
+  const locales = readdirSync(directory).filter(file => file.endsWith('.json')).map(file => file.slice(0, -5))
+    .sort((a, b) => a === 'zh-CN' ? -1 : b === 'zh-CN' ? 1 : a.localeCompare(b))
+  if (!locales.includes('zh-CN')) throw new Error(`${entry.name} 缺少 zh-CN 语言包`)
+  if (expectedLocales && locales.join(',') !== expectedLocales) throw new Error(`${entry.name} 语言集合不一致`)
+  expectedLocales = locales.join(',')
+  const messages = Object.fromEntries(locales.map(locale => {
+    if (!/^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(locale)) throw new Error(`语言代码无效：${locale}`)
+    return [locale, JSON.parse(readFileSync(resolve(directory, `${locale}.json`), 'utf8'))]
+  }))
+  const keys = Object.keys(messages['zh-CN']).sort().join('\0')
+  for (const locale of locales) {
+    if (Object.keys(messages[locale]).sort().join('\0') !== keys) throw new Error(`${entry.name}/${locale} 语言键集合不一致`)
+  }
+  const imports = locales.map((locale, index) => `import locale${index} from './${locale}.json'`)
+  const content = [
+    '/* 此文件由 scripts/sync-locales.mjs 生成，请勿手工修改。 */',
+    ...imports, '', 'export const LOCALE_MESSAGES = {',
+    ...locales.map((locale, index) => `  '${locale}': locale${index},`),
+    '} as const satisfies Record<string, Record<string, string>>', '',
+    'export type GeneratedLocale = keyof typeof LOCALE_MESSAGES',
+    "export const DEFAULT_LOCALE: GeneratedLocale = 'zh-CN'",
+    'export const SUPPORTED_LOCALES = Object.keys(LOCALE_MESSAGES) as GeneratedLocale[]', '',
+  ].join('\n')
+  const file = resolve(directory, 'generated.ts')
+  if (write) writeFileSync(file, content)
+  else if (!existsSync(file) || readFileSync(file, 'utf8') !== content) throw new Error(`语言注册产物过期：${file}，请执行 pnpm i18n:sync`)
+}

package/templates/business-workspace/turbo.json

@@ -5,6 +5,11 @@
       "dependsOn": ["^build"],
       "outputs": ["dist/**"]
     },
+    "@__FRONTEND_MODULE__/admin-app#build": {
+      "dependsOn": ["^build"],
+      "cache": __HOST_BUILD_CACHE__,
+      "outputs": []
+    },
     "build:package": {
       "dependsOn": ["^build:package"],
       "outputs": ["dist/package/**"]

package/templates/project-frontend/Makefile

@@ -0,0 +1,369 @@
+# Frontend Makefile
+#
+# 常用流程：
+#   安装全部依赖：make init
+#   启动全部前端：make run
+#   检查全部前端：make check
+#   生成全部前端 RPC：make ts
+#   构建全部宿主：make build
+#   生成全部 npm 包：make package
+
+.PHONY: help init reinstall pnpm-admin pnpm-uni-app pnpm-taro-app \
+	ts types-admin ts-admin ts-uni-app ts-taro-app \
+	run run-all run-h5 run-mp-weixin run-admin run-uni-app run-uni-app-h5 run-uni-app-mp-weixin run-taro-app run-taro-app-h5 run-taro-app-mp-weixin \
+	check check-admin check-uni-app check-taro-app \
+	build build-all build-h5 build-mp-weixin build-admin build-uni-app build-uni-app-h5 build-uni-app-mp-weixin build-taro-app build-taro-app-h5 build-taro-app-mp-weixin build-package \
+	package package-admin package-uni-app package-taro-app \
+	publish publish-only publish-admin publish-uni-app publish-taro-app
+
+# ===== 执行参数 =====
+
+PNPM ?= pnpm
+CI ?= 1
+GO_BIN_DIR ?= $(or $(shell go env GOBIN),$(shell go env GOPATH)/bin)
+API_DIR ?= ../backend/api
+BUSINESS_MODULES := __MODULES_SPACE__
+PROTO_FILES := $(shell find "$(API_DIR)/proto" -type f -name '*.proto' 2>/dev/null)
+ADMIN_PROTO_FILES := $(filter-out $(foreach module,$(BUSINESS_MODULES),$(API_DIR)/proto/$(module)/app/%),$(PROTO_FILES))
+APP_PROTO_FILES := $(filter-out $(foreach module,$(BUSINESS_MODULES),$(API_DIR)/proto/$(module)/admin/%),$(PROTO_FILES))
+
+TS_PROTO_BIN ?= $(or \
+	$(shell command -v protoc-gen-ts_proto 2>/dev/null), \
+	$(wildcard $(CURDIR)/admin/node_modules/.bin/protoc-gen-ts_proto), \
+	$(wildcard $(CURDIR)/uni-app/node_modules/.bin/protoc-gen-ts_proto), \
+	$(wildcard $(CURDIR)/taro-app/node_modules/.bin/protoc-gen-ts_proto), \
+	$(lastword $(wildcard $(HOME)/.nvm/versions/node/*/bin/protoc-gen-ts_proto)) \
+)
+TS_PROTO_BIN_DIR := $(dir $(TS_PROTO_BIN))
+
+# ===== npm 发布参数 =====
+
+NPM_REGISTRY ?= https://registry.npmjs.org/
+NPM_ACCESS ?= public
+NPM_TAG ?= latest
+NPM_PACK_DEST ?= dist/npm
+NPM_SKIP_GIT_CHECKS ?= true
+
+NPM_PUBLISH_ENV := NPM_REGISTRY="$(NPM_REGISTRY)" NPM_ACCESS="$(NPM_ACCESS)" NPM_TAG="$(NPM_TAG)" NPM_SKIP_GIT_CHECKS="$(NPM_SKIP_GIT_CHECKS)"
+
+# ===== 依赖安装 =====
+
+# 按管理后台、uni-app、Taro 的顺序安装全部前端依赖
+init:
+	@$(MAKE) pnpm-admin
+	@$(MAKE) pnpm-uni-app
+	@$(MAKE) pnpm-taro-app
+
+# 删除全部前端 node_modules 并重新安装依赖
+reinstall:
+	@bash scripts/reinstall_dependencies.sh
+
+# 安装管理后台依赖
+pnpm-admin:
+	@cd admin && CI="$(CI)" $(PNPM) install
+
+# 安装 uni-app 应用端依赖
+pnpm-uni-app:
+	@cd uni-app && CI="$(CI)" $(PNPM) install
+
+# 安装 Taro React 应用端依赖
+pnpm-taro-app:
+	@cd taro-app && CI="$(CI)" $(PNPM) install
+
+# ===== TypeScript RPC 生成 =====
+
+# 生成管理端、uni-app 和 Taro 的全部 TypeScript RPC 代码。
+ts: ts-admin ts-uni-app ts-taro-app
+	@echo "==> 全部 TypeScript RPC 代码生成完成"
+
+# 生成管理端 TypeScript RPC 代码。
+ts-admin: types-admin
+ifneq ($(strip $(ADMIN_PROTO_FILES)),)
+	@echo "==> 生成管理端 TypeScript RPC 代码"
+	@test -n "$(TS_PROTO_BIN)" || (echo "未找到 protoc-gen-ts_proto，请先执行 make init，或全局安装 ts-proto" && exit 1)
+	@cd "$(API_DIR)" && \
+		set -e; for module in $(BUSINESS_MODULES); do \
+		if find "proto/$$module" ! -path "proto/$$module/app/*" -name '*.proto' -type f | grep -q .; then \
+		PATH="$(TS_PROTO_BIN_DIR):$(GO_BIN_DIR):$$PATH" buf generate --template "buf.admin.$$module.typescript.gen.yaml" --path "proto/$$module" --exclude-path "proto/$$module/app"; \
+		fi; done
+	@echo "==> 管理端 TypeScript RPC 代码生成完成"
+else
+	@echo "未发现业务 Proto，跳过 admin RPC 生成"
+endif
+
+# 生成管理端自动导入声明。
+types-admin:
+	@echo "==> 生成管理端自动导入声明"
+	@cd admin && CI="$(CI)" $(PNPM) run generate:auto-import-types
+	@echo "==> 管理端自动导入声明生成完成"
+
+# 生成 uni-app 端 TypeScript RPC 代码。
+ts-uni-app:
+ifneq ($(strip $(APP_PROTO_FILES)),)
+	@echo "==> 生成 uni-app TypeScript RPC 代码"
+	@test -n "$(TS_PROTO_BIN)" || (echo "未找到 protoc-gen-ts_proto，请先执行 make init，或全局安装 ts-proto" && exit 1)
+	@cd "$(API_DIR)" && \
+		set -e; for module in $(BUSINESS_MODULES); do \
+		if find "proto/$$module" ! -path "proto/$$module/admin/*" -name '*.proto' -type f | grep -q .; then \
+		PATH="$(TS_PROTO_BIN_DIR):$(GO_BIN_DIR):$$PATH" buf generate --template "buf.uni-app.$$module.typescript.gen.yaml" --path "proto/$$module" --exclude-path "proto/$$module/admin"; \
+		fi; done
+	@echo "==> uni-app TypeScript RPC 代码生成完成"
+else
+	@echo "未发现业务 Proto，跳过 uni-app RPC 生成"
+endif
+
+# 生成 Taro React 端 TypeScript RPC 代码。
+ts-taro-app:
+ifneq ($(strip $(APP_PROTO_FILES)),)
+	@echo "==> 生成 Taro React TypeScript RPC 代码"
+	@test -n "$(TS_PROTO_BIN)" || (echo "未找到 protoc-gen-ts_proto，请先执行 make init，或全局安装 ts-proto" && exit 1)
+	@cd "$(API_DIR)" && \
+		set -e; for module in $(BUSINESS_MODULES); do \
+		if find "proto/$$module" ! -path "proto/$$module/admin/*" -name '*.proto' -type f | grep -q .; then \
+		PATH="$(TS_PROTO_BIN_DIR):$(GO_BIN_DIR):$$PATH" buf generate --template "buf.taro-app.$$module.typescript.gen.yaml" --path "proto/$$module" --exclude-path "proto/$$module/admin"; \
+		fi; done
+	@echo "==> Taro React TypeScript RPC 代码生成完成"
+else
+	@echo "未发现业务 Proto，跳过 taro-app RPC 生成"
+endif
+
+# ===== 本地运行 =====
+
+# 并行启动管理后台、uni-app 和 Taro 的 H5/微信小程序开发环境
+run:
+	@$(MAKE) run-all
+
+# 并行启动全部前端开发环境；按 Ctrl-C 会同时停止所有子进程
+run-all:
+	@set -e; \
+	pids=""; \
+	cleanup() { trap - INT TERM EXIT; test -z "$$pids" || kill $$pids 2>/dev/null || true; test -z "$$pids" || wait $$pids 2>/dev/null || true; }; \
+	trap cleanup INT TERM EXIT; \
+	$(MAKE) run-admin & pids="$$pids $$!"; \
+	$(MAKE) run-uni-app-h5 & pids="$$pids $$!"; \
+	$(MAKE) run-uni-app-mp-weixin & pids="$$pids $$!"; \
+	$(MAKE) run-taro-app-h5 & pids="$$pids $$!"; \
+	$(MAKE) run-taro-app-mp-weixin & pids="$$pids $$!"; \
+	wait
+
+# 并行启动全部 H5 开发环境
+run-h5:
+	@$(MAKE) --jobs=3 run-admin run-uni-app-h5 run-taro-app-h5
+
+# 并行启动全部微信小程序开发环境
+run-mp-weixin:
+	@$(MAKE) --jobs=2 run-uni-app-mp-weixin run-taro-app-mp-weixin
+
+# 启动管理后台开发服务
+run-admin:
+	@cd admin && CI="$(CI)" $(PNPM) run dev
+
+# 启动 uni-app 微信小程序开发服务
+run-uni-app:
+	@$(MAKE) run-uni-app-mp-weixin
+
+# 启动 uni-app H5 开发服务
+run-uni-app-h5:
+	@cd uni-app && CI="$(CI)" $(PNPM) run dev:h5
+
+# 启动 uni-app 微信小程序开发服务
+run-uni-app-mp-weixin:
+	@cd uni-app && CI="$(CI)" $(PNPM) run dev:mp-weixin
+
+# 启动 Taro 微信小程序开发服务
+run-taro-app:
+	@$(MAKE) run-taro-app-mp-weixin
+
+# 启动 Taro H5 开发服务
+run-taro-app-h5:
+	@cd taro-app && CI="$(CI)" $(PNPM) run dev:h5
+
+# 启动 Taro 微信小程序开发服务
+run-taro-app-mp-weixin:
+	@cd taro-app && CI="$(CI)" $(PNPM) run dev:mp-weixin
+
+# ===== 代码检查 =====
+
+# 检查管理后台的静态规则、类型和测试
+check-admin:
+	@cd admin && \
+		CI="$(CI)" $(PNPM) exec oxlint --vue-plugin --config ./internal/lint-config/oxlint.json --ignore-path .oxlintignore ./apps ./packages ./internal ./scripts && \
+		CI="$(CI)" $(PNPM) run type:check && \
+		CI="$(CI)" $(PNPM) run test
+
+# 检查 uni-app 的静态规则、类型、测试和包边界
+check-uni-app:
+	@cd uni-app && \
+		CI="$(CI)" $(PNPM) exec eslint . && \
+		CI="$(CI)" $(PNPM) run tsc && \
+		CI="$(CI)" $(PNPM) run test && \
+		CI="$(CI)" $(PNPM) run check:exports
+
+# 检查 Taro 的静态规则、类型、测试和包边界
+check-taro-app:
+	@cd taro-app && \
+		CI="$(CI)" $(PNPM) exec eslint . --ext .js,.mjs,.ts,.tsx && \
+		CI="$(CI)" $(PNPM) run tsc && \
+		CI="$(CI)" $(PNPM) run test && \
+		CI="$(CI)" $(PNPM) run check:exports
+
+# 按管理后台、uni-app、Taro 的顺序检查全部前端
+check:
+	@$(MAKE) check-admin
+	@$(MAKE) check-uni-app
+	@$(MAKE) check-taro-app
+	@echo "==> 全部前端检查完成"
+
+# ===== 应用与模块构建 =====
+
+# 构建全部前端 H5 和微信小程序产物
+build:
+	@$(MAKE) build-all
+
+# 构建管理后台静态资源
+build-admin:
+	@cd admin && CI="$(CI)" $(PNPM) run build
+
+# 构建 uni-app H5 静态资源
+build-uni-app:
+	@$(MAKE) build-uni-app-h5
+
+# 构建 uni-app H5 静态资源
+build-uni-app-h5:
+	@cd uni-app && CI="$(CI)" $(PNPM) run build:h5
+
+# 构建 uni-app 微信小程序产物
+build-uni-app-mp-weixin:
+	@cd uni-app && CI="$(CI)" $(PNPM) run build:mp-weixin
+
+# 构建 Taro H5 静态资源
+build-taro-app:
+	@$(MAKE) build-taro-app-h5
+
+# 构建 Taro H5 静态资源
+build-taro-app-h5:
+	@cd taro-app && CI="$(CI)" $(PNPM) run build:h5
+
+# 构建 Taro 微信小程序产物
+build-taro-app-mp-weixin:
+	@cd taro-app && CI="$(CI)" $(PNPM) run build:mp-weixin
+
+# 构建管理后台、uni-app 和 Taro 的全部 H5 产物
+build-h5:
+	@$(MAKE) build-admin
+	@$(MAKE) build-uni-app-h5
+	@$(MAKE) build-taro-app-h5
+
+# 构建 uni-app 和 Taro 的全部微信小程序产物
+build-mp-weixin:
+	@$(MAKE) build-uni-app-mp-weixin
+	@$(MAKE) build-taro-app-mp-weixin
+
+# 构建管理后台、uni-app 和 Taro 的 H5/微信小程序全部宿主
+build-all:
+	@$(MAKE) build-h5
+	@$(MAKE) build-mp-weixin
+	@echo "==> 全部前端宿主构建完成"
+
+# 构建可供业务后台组合使用的管理端模块包
+build-package:
+	@cd admin && CI="$(CI)" $(PNPM) run build:package
+
+# ===== npm 打包 =====
+
+# 检查并生成管理后台 npm 包
+package-admin:
+	@$(MAKE) check-admin
+	@$(MAKE) build-package
+	@for package_dir in $(addprefix admin/packages/modules/,$(BUSINESS_MODULES)); do \
+		(cd "$$package_dir" && CI="$(CI)" $(PNPM) pack --pack-destination "$(NPM_PACK_DEST)") || exit 1; \
+	done
+
+# 检查并生成 uni-app npm 包
+package-uni-app:
+	@$(MAKE) check-uni-app
+	@cd uni-app && CI="$(CI)" $(PNPM) run build:packages
+
+# 检查并生成 Taro npm 包
+package-taro-app:
+	@$(MAKE) check-taro-app
+	@cd taro-app && CI="$(CI)" $(PNPM) run build:packages
+
+# 按管理后台、uni-app、Taro 的顺序检查并生成全部 npm 包
+package:
+	@$(MAKE) package-admin
+	@$(MAKE) package-uni-app
+	@$(MAKE) package-taro-app
+	@echo "==> 全部前端 npm 包生成完成"
+
+# ===== npm 发布 =====
+
+# 检查、打包并发布管理后台 npm 包
+publish-admin:
+	@$(MAKE) package-admin
+	@$(NPM_PUBLISH_ENV) bash scripts/publish_packages.sh $(addprefix admin/packages/modules/,$(BUSINESS_MODULES))
+
+# 检查、打包并发布 uni-app npm 包
+publish-uni-app:
+	@$(MAKE) package-uni-app
+	@$(NPM_PUBLISH_ENV) bash scripts/publish_packages.sh $(addprefix uni-app/packages/modules/,$(BUSINESS_MODULES))
+
+# 检查、打包并发布 Taro npm 包
+publish-taro-app:
+	@$(MAKE) package-taro-app
+	@$(NPM_PUBLISH_ENV) bash scripts/publish_packages.sh $(addprefix taro-app/packages/modules/,$(BUSINESS_MODULES))
+
+# 发布已经检查并构建的全部 npm 包
+publish-only:
+	@$(NPM_PUBLISH_ENV) bash scripts/publish_packages.sh $(addprefix admin/packages/modules/,$(BUSINESS_MODULES)) $(addprefix uni-app/packages/modules/,$(BUSINESS_MODULES)) $(addprefix taro-app/packages/modules/,$(BUSINESS_MODULES))
+
+# 按打包、发布的顺序发布全部 npm 包
+publish:
+	@$(MAKE) package
+	@$(MAKE) publish-only
+
+# ===== 帮助 =====
+
+# 查看常用流程、全部目标及可覆盖参数
+help:
+	@echo ""
+	@echo "常用流程:"
+	@echo "  make init                         安装三个 workspace 的依赖"
+	@echo "  make run                          启动全部前端开发环境（H5 + 微信小程序）"
+	@echo "  make check                        检查三个 workspace"
+	@echo "  make ts                            生成三个前端的 TypeScript RPC"
+	@echo "  make build                        构建管理端、uni-app、Taro 的 H5 + 微信小程序"
+	@echo "  make package                      检查并生成 业务 npm 包"
+	@echo "  make publish                      打包并发布 业务 npm 包"
+	@echo ""
+	@echo "可用目标:"
+	@awk '/^[a-zA-Z\-_0-9]+:/ { \
+	helpMessage = match(lastLine, /^# (.*)/); \
+		if (helpMessage) { \
+			helpCommand = substr($$1, 0, index($$1, ":")-1); \
+			helpMessage = substr(lastLine, RSTART + 2, RLENGTH); \
+			printf "\033[36m  %-20s\033[0m %s\n", helpCommand, helpMessage; \
+		} \
+	} \
+	{ lastLine = $$0 }' $(MAKEFILE_LIST)
+	@echo ""
+	@echo "常用参数（命令行使用 参数=值 覆盖）:"
+	@printf "  %-24s %s\n" "PNPM" "pnpm 命令，当前: $(PNPM)"
+	@printf "  %-24s %s\n" "CI" "是否使用 CI 模式，当前: $(CI)"
+	@printf "  %-24s %s\n" "API_DIR" "Backend Proto 目录，当前: $(API_DIR)"
+	@printf "  %-24s %s\n" "NPM_REGISTRY" "npm registry，当前: $(NPM_REGISTRY)"
+	@printf "  %-24s %s\n" "NPM_ACCESS" "npm 访问级别，当前: $(NPM_ACCESS)"
+	@printf "  %-24s %s\n" "NPM_TAG" "npm dist-tag，当前: $(NPM_TAG)"
+	@printf "  %-24s %s\n" "NPM_PACK_DEST" "pnpm pack 输出目录，当前: $(NPM_PACK_DEST)"
+	@printf "  %-24s %s\n" "NPM_SKIP_GIT_CHECKS" "发布时跳过 pnpm Git 检查，当前: $(NPM_SKIP_GIT_CHECKS)"
+	@echo ""
+	@echo "示例:"
+	@echo "  make run-admin"
+	@echo "  make run-h5"
+	@echo "  make run-mp-weixin"
+	@echo "  make run-uni-app"
+	@echo "  make run-uni-app-h5"
+	@echo "  make check-taro-app"
+	@echo "  make publish NPM_REGISTRY=https://registry.npmjs.org/ NPM_TAG=next"
+
+.DEFAULT_GOAL := help

package/templates/project-frontend/scripts/publish_packages.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+FRONTEND_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
+
+registry="${NPM_REGISTRY:-https://registry.npmjs.org/}"
+access="${NPM_ACCESS:-public}"
+tag="${NPM_TAG:-latest}"
+skip_git_checks="${NPM_SKIP_GIT_CHECKS:-true}"
+expected_version="${NPM_EXPECTED_VERSION:-}"
+
+publish_args=(--registry "${registry}" --access "${access}" --tag "${tag}")
+if [[ "${skip_git_checks}" == "true" ]]; then
+  publish_args+=(--no-git-checks)
+fi
+
+if [[ "$#" -eq 0 ]]; then
+  set -- [[[range .Modules]]]admin/packages/modules/[[[.]]] uni-app/packages/modules/[[[.]]] taro-app/packages/modules/[[[.]]] [[[end]]]
+fi
+
+for package_dir in "$@"; do
+  package_path="${FRONTEND_DIR}/${package_dir}/package.json"
+  if [[ ! -f "${package_path}" ]]; then
+    echo "npm 包配置不存在: ${package_path}" >&2
+    exit 1
+  fi
+
+  metadata="$({ node -e '
+const fs = require("fs")
+const pkg = JSON.parse(fs.readFileSync(process.argv[1], "utf8"))
+if (typeof pkg.name !== "string" || typeof pkg.version !== "string") {
+  throw new Error(`invalid package metadata: ${process.argv[1]}`)
+}
+process.stdout.write(`${pkg.name}\t${pkg.version}`)
+' "${package_path}"; })"
+  IFS=$'\t' read -r package_name package_version <<<"${metadata}"
+
+  if [[ -n "${expected_version}" && "${package_version}" != "${expected_version}" ]]; then
+    echo "npm 包版本与发布 tag 不一致: ${package_name}@${package_version}，期望 ${expected_version}" >&2
+    exit 1
+  fi
+
+  if npm view "${package_name}@${package_version}" version --registry "${registry}" --json >/dev/null 2>&1; then
+    echo "==> 已发布，跳过 ${package_name}@${package_version}"
+    continue
+  fi
+
+  echo "==> 正在发布 ${package_name}@${package_version}"
+  (
+    cd "${FRONTEND_DIR}/${package_dir}"
+    pnpm publish "${publish_args[@]}"
+  )
+  echo "==> 发布完成 ${package_name}@${package_version}"
+done

package/templates/project-frontend/scripts/reinstall_dependencies.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+FRONTEND_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
+
+echo "==> 清理前端全部 node_modules"
+find "${FRONTEND_DIR}" -type d -name node_modules -prune -print -exec rm -rf -- {} +
+
+while IFS= read -r workspace_file; do
+  workspace_dir="${workspace_file%/pnpm-workspace.yaml}"
+
+  # 跳过 CLI 模板等嵌套 workspace，避免把占位项目当作当前项目安装。
+  nested_workspace=false
+  parent_dir="${workspace_dir}"
+  while [[ "${parent_dir}" != "${FRONTEND_DIR}" ]]; do
+    parent_dir="${parent_dir%/*}"
+    if [[ -f "${parent_dir}/pnpm-workspace.yaml" ]]; then
+      nested_workspace=true
+      break
+    fi
+  done
+
+  if [[ "${nested_workspace}" == true ]]; then
+    echo "==> 跳过嵌套 workspace：${workspace_dir#"${FRONTEND_DIR}/"}"
+    continue
+  fi
+
+  echo "==> 安装 ${workspace_dir#"${FRONTEND_DIR}/"} 依赖"
+  (
+    cd "${workspace_dir}"
+    CI=1 pnpm install --frozen-lockfile
+  )
+done < <(find "${FRONTEND_DIR}" -type f -name pnpm-workspace.yaml -print)
+
+echo "==> 前端依赖重装完成"