@liujitcn/kratos-admin-cli 0.0.62 → 0.0.65

package/dist/index.js

@@ -3,6 +3,7 @@ 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";
+import { cliMessage, resolveLocale } from "./messages.js";
 const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const templateRoot = resolve(packageRoot, "templates/business-workspace");
 const gitignoreTemplateName = "_gitignore";
@@ -16,11 +17,12 @@ export async function createBusinessWorkspace(options) {
     const target = resolve(cwd, options.projectName);
     const projectName = basename(target);
     const moduleNames = normalizeModuleNames(options.moduleNames);
+    const locale = resolveLocale();
     const primaryModuleName = moduleNames[0];
     const additionalModules = normalizeAdditionalModules(options.additionalModules ?? [], moduleNames);
-    validateName(projectName, "项目名称");
+    validateName(projectName, "project_name_label");
     if (await pathExists(target))
-        throw new Error(`目标目录已存在，拒绝覆盖: ${target}`);
+        throw new Error(cliMessage("target_exists", { target }));
     const packageVersion = await readCliPackageVersion();
     const primaryModuleTokens = createModuleTokens(primaryModuleName, packageVersion);
     const moduleManifestEntries = [
@@ -87,25 +89,25 @@ export async function createBusinessWorkspace(options) {
         __APP_DEPENDENCIES__: formatJsonValue(appDependencies, "  "),
         __MODULE_FILTERS__: modulePackages.map(packageName => `--filter=${packageName}`).join(" "),
         __MODULE_MANIFEST__: moduleManifest,
-        __MODULE_NAMES__: moduleNames.join("、"),
-        __MODULE_PACKAGES__: modulePackages.map(packageName => `\`${packageName}\``).join("、"),
+        __MODULE_NAMES__: moduleNames.join(cliMessage("list_separator")),
+        __MODULE_PACKAGES__: modulePackages.map(packageName => `\`${packageName}\``).join(cliMessage("list_separator")),
         __MODULE_PATHS__: formatJsonValue(modulePaths, "    "),
         __MODULE_TREE__: createModuleTree(moduleNames),
         __MODULE_TABLE_ROWS__: createModuleTableRows(moduleNames)
     };
     await mkdir(target, { recursive: false });
     try {
-        await renderDirectory(templateRoot, target, tokens);
+        await renderDirectory(templateRoot, target, tokens, locale);
         const moduleTemplateRoot = resolve(templateRoot, "packages/modules/__MODULE_NAME__");
         for (const moduleName of moduleNames.slice(1)) {
             await renderDirectory(moduleTemplateRoot, resolve(target, "packages/modules", moduleName), {
                 ...createModuleTokens(moduleName, packageVersion),
                 __PROJECT_NAME__: projectName
-            });
+            }, locale);
         }
         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);
+            await renderDirectory(resolve(packageRoot, "templates/project-frontend"), dirname(target), tokens, locale);
         }
     }
     catch (error) {
@@ -121,12 +123,12 @@ export async function runCli(args = process.argv.slice(2)) {
         return;
     }
     if (args[0] !== "create")
-        throw new Error(`不支持的命令: ${args[0]}`);
+        throw new Error(cliMessage("unsupported_command", { command: args[0] }));
     const projectName = args[1];
     const moduleNames = [...readOptions(args, "--module"), ...readOptions(args, "--modules")];
     const withModules = readOptions(args, "--with");
     if (!projectName || moduleNames.length === 0) {
-        throw new Error("用法: kratos-admin create <project> --module <module[,module...]>");
+        throw new Error(cliMessage("usage"));
     }
     const target = await createBusinessWorkspace({
         projectName,
@@ -134,19 +136,26 @@ export async function runCli(args = process.argv.slice(2)) {
         additionalModules: withModules,
         kratosProject: args.includes("--kratos-project")
     });
-    process.stdout.write(`已创建业务 workspace: ${target}\n`);
+    process.stdout.write(`${cliMessage("workspace_created", { target })}\n`);
 }
 /** 渲染模板目录中的路径和文本占位符。 */
-async function renderDirectory(source, target, tokens) {
+async function renderDirectory(source, target, tokens, locale) {
     await mkdir(target, { recursive: true });
     const entries = await readdir(source, { withFileTypes: true });
+    const localizedReadme = `README.${locale}.md`;
+    const hasLocalizedReadme = entries.some(entry => entry.name === localizedReadme);
     for (const entry of entries) {
-        const renderedName = entry.name === gitignoreTemplateName ? ".gitignore" : replaceTokens(entry.name, tokens).replace(/\.tmpl$/, "");
+        if (entry.name === "README.md" && hasLocalizedReadme)
+            continue;
+        if (/^README\.(zh-CN|en-US)\.md$/.test(entry.name) && entry.name !== localizedReadme)
+            continue;
+        const sourceName = entry.name === localizedReadme ? "README.md" : entry.name;
+        const renderedName = entry.name === gitignoreTemplateName ? ".gitignore" : replaceTokens(sourceName, tokens).replace(/\.tmpl$/, "");
         const sourcePath = join(source, entry.name);
         const targetPath = join(target, renderedName);
         if (entry.isDirectory()) {
             await mkdir(targetPath, { recursive: true });
-            await renderDirectory(sourcePath, targetPath, tokens);
+            await renderDirectory(sourcePath, targetPath, tokens, locale);
             continue;
         }
         const content = await readFile(sourcePath, "utf8");
@@ -157,7 +166,7 @@ async function renderDirectory(source, target, tokens) {
 async function readCliPackageVersion() {
     const packageJson = JSON.parse(await readFile(resolve(packageRoot, "package.json"), "utf8"));
     if (typeof packageJson.version !== "string" || !packageJson.version)
-        throw new Error("CLI package.json 缺少有效版本");
+        throw new Error(cliMessage("package_version_missing"));
     return packageJson.version;
 }
 /** 读取可重复且支持逗号分隔的命令行选项值。 */
@@ -167,7 +176,7 @@ function readOptions(args, option) {
             return [];
         const value = args[index + 1];
         if (!value || value.startsWith("--"))
-            throw new Error(`选项 ${option} 缺少值`);
+            throw new Error(cliMessage("option_missing_value", { option }));
         return value
             .split(",")
             .map(item => item.trim())
@@ -175,26 +184,27 @@ function readOptions(args, option) {
     });
 }
 /** 校验项目与模块名称。 */
-function validateName(value, label) {
+function validateName(value, labelKey) {
+    const label = cliMessage(labelKey);
     if (!kebabNamePattern.test(value))
-        throw new Error(`${label}必须使用 kebab-case: ${value}`);
+        throw new Error(cliMessage("kebab_required", { label, value }));
 }
 /** 规范化自有模块列表并校验保留名称。 */
 function normalizeModuleNames(moduleNames) {
     const normalized = [...new Set(moduleNames.map(name => name.trim()).filter(Boolean))];
     const primaryModuleName = normalized[0];
     if (!primaryModuleName)
-        throw new Error("至少需要一个业务模块名称");
-    normalized.forEach(name => validateName(name, "模块名称"));
+        throw new Error(cliMessage("module_required"));
+    normalized.forEach(name => validateName(name, "module_name_label"));
     const reservedName = normalized.find(name => name === "kratos-admin");
     if (reservedName)
-        throw new Error(`自有模块名称不能使用保留名称: ${reservedName}`);
+        throw new Error(cliMessage("reserved_module", { name: reservedName }));
     return [primaryModuleName, ...normalized.slice(1)];
 }
 /** 规范化额外模块列表并去重。 */
 function normalizeAdditionalModules(moduleNames, currentModules) {
     const normalized = [...new Set(moduleNames.map(name => name.trim()).filter(Boolean))];
-    normalized.forEach(name => validateName(name, "额外模块名称"));
+    normalized.forEach(name => validateName(name, "additional_module_name_label"));
     return normalized.filter(name => name !== "system" && !currentModules.includes(name));
 }
 /** 创建单个自有模块模板使用的占位符。 */
@@ -229,9 +239,7 @@ function createModuleTree(moduleNames) {
 }
 /** 创建 README 中的业务模块目录说明。 */
 function createModuleTableRows(moduleNames) {
-    return moduleNames
-        .map(name => `| \`packages/modules/${name}/\` | 可独立发布的 \`@${name}/admin-module\` 业务 module。 |`)
-        .join("\n");
+    return moduleNames.map(name => cliMessage("module_table_row", { name })).join("\n");
 }
 /** 将 kebab-case 转换为 camelCase。 */
 function toCamelCase(value) {
@@ -261,7 +269,7 @@ function printHelp() {
     process.stdout.write([
         "kratos-admin create <project> --module <module[,module...]> [--module <module>] [--with other] [--kratos-project]",
         "",
-        "示例:",
+        cliMessage("examples_heading"),
         "  kratos-admin create business-admin --module business",
         "  kratos-admin create business-admin --module business,report",
         "  kratos-admin create business-admin --module business --module report",

package/dist/messages.js

@@ -0,0 +1,46 @@
+const messages = {
+    "zh-CN": {
+        project_name_label: "项目名称",
+        module_name_label: "模块名称",
+        additional_module_name_label: "额外模块名称",
+        examples_heading: "示例:",
+        target_exists: "目标目录已存在，拒绝覆盖: {target}",
+        unsupported_command: "不支持的命令: {command}",
+        usage: "用法: kratos-admin create <project> --module <module[,module...]>",
+        package_version_missing: "CLI package.json 缺少有效版本",
+        option_missing_value: "选项 {option} 缺少值",
+        kebab_required: "{label}必须使用 kebab-case: {value}",
+        module_required: "至少需要一个业务模块名称",
+        reserved_module: "自有模块名称不能使用保留名称: {name}",
+        workspace_created: "已创建业务 workspace: {target}",
+        list_separator: "、",
+        module_table_row: "| `packages/modules/{name}/` | 可独立发布为 `@{name}/admin-module` 的业务模块。 |"
+    },
+    "en-US": {
+        project_name_label: "Project name",
+        module_name_label: "Module name",
+        additional_module_name_label: "Additional module name",
+        examples_heading: "Examples:",
+        target_exists: "The target directory already exists; refusing to overwrite: {target}",
+        unsupported_command: "Unsupported command: {command}",
+        usage: "Usage: kratos-admin create <project> --module <module[,module...]>",
+        package_version_missing: "CLI package.json is missing a valid version",
+        option_missing_value: "Option {option} is missing a value",
+        kebab_required: "{label} must use kebab-case: {value}",
+        module_required: "At least one business module is required",
+        reserved_module: "A custom module cannot use the reserved name: {name}",
+        workspace_created: "Business workspace created: {target}",
+        list_separator: ", ",
+        module_table_row: "| `packages/modules/{name}/` | An independently publishable `@{name}/admin-module` business module. |"
+    }
+};
+/** 根据环境变量选择 CLI 文案语言。 */
+export function resolveLocale() {
+    const value = process.env.KRATOS_ADMIN_LOCALE ?? process.env.LC_ALL ?? process.env.LANG ?? "";
+    return value.toLowerCase().startsWith("zh") ? "zh-CN" : "en-US";
+}
+/** 渲染 CLI 稳定消息并替换命名参数。 */
+export function cliMessage(key, params = {}) {
+    const template = messages[resolveLocale()][key] ?? messages["en-US"][key] ?? key;
+    return template.replace(/\{([A-Za-z0-9_]+)\}/g, (_, name) => params[name] ?? `{${name}}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liujitcn/kratos-admin-cli",
-  "version": "0.0.62",
+  "version": "0.0.65",
   "type": "module",
   "description": "Create pnpm workspace projects for kratos-admin business modules",
   "license": "MIT",
@@ -18,6 +18,7 @@
   "files": [
     "dist/index.d.ts",
     "dist/index.js",
+    "dist/messages.js",
     "templates",
     "README.md"
   ],

package/templates/business-workspace/README.en-US.md

@@ -0,0 +1,64 @@
+<!-- prettier-ignore -->
+# __PROJECT_NAME__
+
+An independent business admin workspace built on kratos-admin. It includes a thin host, the System module, and custom modules (__MODULE_NAMES__). Dependencies flow from `apps/admin` to business modules and then to `@liujitcn/kratos-admin-core`.
+
+## Files and directories
+
+```text
+__PROJECT_NAME__
+├── apps/admin
+│   ├── src
+│   ├── package.json
+│   └── README.md
+__MODULE_TREE__
+├── scripts
+│   └── build-package.mjs
+├── .gitignore
+├── package.json
+├── pnpm-workspace.yaml
+├── README.md
+├── tsconfig.json
+└── turbo.json
+```
+
+| Path | Purpose |
+| --- | --- |
+| `apps/admin/` | Runnable thin host that starts the app and selects enabled business modules. |
+__MODULE_TABLE_ROWS__
+| `scripts/build-package.mjs` | Produces publishable module source and TypeScript declarations. |
+| `.gitignore` | Excludes dependencies, caches, and build artifacts. |
+| `package.json` | Defines workspace commands, tooling, and runtime versions. |
+| `pnpm-workspace.yaml` | Defines the host and business module workspace packages. |
+| `README.md` | Documents this workspace's files and development workflow. |
+| `tsconfig.json` | TypeScript configuration and source mappings for custom modules. |
+| `turbo.json` | Defines development, build, package-build, and type-check tasks. |
+
+Each directory containing a `package.json` has its own README with details about that package.
+
+## Development
+
+```bash
+pnpm install
+pnpm dev
+pnpm type:check
+pnpm build
+pnpm build:package
+pnpm package
+```
+
+| Command | Purpose |
+| --- | --- |
+| `pnpm dev` | Starts the `apps/admin` development server. |
+| `pnpm type:check` | Checks types in the host and all business modules. |
+| `pnpm build` | Builds the host application. |
+| `pnpm build:package` | Creates npm publish directories for custom modules. |
+| `pnpm package` | Builds custom modules and creates npm packages. |
+
+Keep business APIs, RPCs, pages, and components in `packages/modules/<module>/src`. Backend menu component paths for business pages must use the module prefix, such as `shop/index/index`.
+
+The host module manifest is `apps/admin/src/module-manifest.ts`. It loads `@liujitcn/kratos-admin-system` first, followed by custom modules in the order given at creation. `apps/admin/src/modules.ts` loads and exports the enabled modules. When adding another module, update the host dependencies and manifest.
+
+Module registration order only controls explicit `staticViews` replacements: a later module replaces the same static view key. Ordinary business pages are isolated by `<module>/<view>` and cannot replace another module's page by reusing its name.
+
+Use Vue Router for navigation between modules. Cross-module code may only use public npm subpaths; the host must not import module `src` directories.

package/templates/business-workspace/README.md

@@ -1,7 +1,7 @@
 <!-- prettier-ignore -->
 # __PROJECT_NAME__
 
-基于 kratos-admin 的独立业务管理端 workspace。默认包含一个薄宿主、System module 和自有 module（**MODULE_NAMES**）；依赖方向为 `apps/admin -> business module -> @liujitcn/kratos-admin-core`。
+基于 kratos-admin 的独立业务管理端 workspace。默认包含一个薄宿主、System module 和自有 module（__MODULE_NAMES__）；依赖方向为 `apps/admin -> business module -> @liujitcn/kratos-admin-core`。
 
 ## 目录与文件
 
@@ -26,7 +26,7 @@ __MODULE_TREE__
 | ------------- | --------------------------------------------------- |
 | `apps/admin/` | 可运行的薄宿主，只负责启动和选择启用的业务 module。 |
 
-**MODULE_TABLE_ROWS**
+__MODULE_TABLE_ROWS__
 | `scripts/build-package.mjs` | 生成自有 module 的发布源码和 TypeScript 声明。 |
 | `.gitignore` | 忽略依赖、缓存和构建产物。 |
 | `package.json` | 声明 workspace 公共命令、工具依赖和运行时版本。 |

package/templates/business-workspace/apps/admin/README.en-US.md

@@ -0,0 +1,58 @@
+<!-- prettier-ignore -->
+# __APP_PACKAGE__
+
+The admin host for `__PROJECT_NAME__`. This private package contains no business logic. It combines `@liujitcn/kratos-admin-system`, custom modules (__MODULE_PACKAGES__), and any selected additional modules.
+
+## Files and directories
+
+```text
+apps/admin
+├── src
+│   ├── main.ts
+│   ├── module-manifest.ts
+│   ├── modules.ts
+│   └── vite-env.d.ts
+├── .env
+├── .env.development
+├── .env.production
+├── favicon.svg
+├── index.html
+├── package.json
+├── README.md
+├── tsconfig.json
+└── vite.config.ts
+```
+
+| Path | Purpose |
+| --- | --- |
+| `src/main.ts` | Passes all default-exported modules to core to start the Vue app. |
+| `src/module-manifest.ts` | Declares module loaders, package names, and optional pre-bundled dependencies. |
+| `src/modules.ts` | Loads and default-exports the modules enabled for this host. |
+| `src/vite-env.d.ts` | Includes Vite client and core global types. |
+| `.env` | Shared app title, port, and other environment variables. |
+| `.env.development` | Development API URL and proxy configuration. |
+| `.env.production` | Production API URL and build configuration. |
+| `favicon.svg` | Browser tab icon for the admin app. |
+| `index.html` | Vite HTML entry point and app mount node. |
+| `package.json` | Declares host commands and core, current module, and extra module dependencies. |
+| `README.md` | Documents this host's files and development workflow. |
+| `tsconfig.json` | TypeScript configuration for the host. |
+| `vite.config.ts` | Combines core configuration with build settings derived from the module manifest. |
+
+## Module composition
+
+`src/module-manifest.ts` is the only source of host module configuration. Each manifest entry declares its npm package, runtime loader, and optional pre-bundled dependencies. `src/modules.ts` loads and default-exports all modules, while `vite.config.ts` derives module scanning settings from the manifest. To add or remove a module, update the host dependency and this manifest.
+
+Registration order only affects explicit `staticViews` replacements: a later module replaces an earlier module's matching static view key. Ordinary business pages are isolated by `<module>/<view>` and cannot replace pages in other modules by sharing a name.
+
+Use Vue Router for navigation between modules. Cross-module code may only import public npm subpaths; the host must not import module `src` directories.
+
+## Commands
+
+```bash
+pnpm --filter __APP_PACKAGE__ dev
+pnpm --filter __APP_PACKAGE__ type:check
+pnpm --filter __APP_PACKAGE__ build
+```
+
+For LAN access, put a shared certificate in the workspace root `certs` directory and set `VITE_HTTPS=true` in `.env.development.local`. You can also specify certificate paths with `VITE_HTTPS_KEY` and `VITE_HTTPS_CERT`.

package/templates/business-workspace/apps/admin/README.md

@@ -1,7 +1,7 @@
 <!-- prettier-ignore -->
 # __APP_PACKAGE__
 
-`__PROJECT_NAME__` 的管理端宿主。该包私有且不实现业务，默认先组合 `@liujitcn/kratos-admin-system`，再组合自有 module **MODULE_PACKAGES** 和所选的其他业务 module。
+`__PROJECT_NAME__` 的管理端宿主。该包私有且不实现业务，默认先组合 `@liujitcn/kratos-admin-system`，再组合自有 module __MODULE_PACKAGES__ 和所选的其他业务 module。
 
 ## 目录与文件
 

package/templates/business-workspace/packages/modules/__MODULE_NAME__/README.en-US.md

@@ -0,0 +1,66 @@
+<!-- prettier-ignore -->
+# __MODULE_PACKAGE__
+
+The __MODULE_PASCAL__ business module for the admin app in `__PROJECT_NAME__`. APIs, RPCs, pages, and business components are maintained together in this package, which can be published to npm and composed into different hosts.
+
+## Files and directories
+
+```text
+packages/modules/__MODULE_NAME__
+├── src
+│   ├── api                       # Request files follow the complete Proto path and service file name
+│   ├── rpc
+│   │   └── README.md             # Proto-generated directory notes
+│   ├── components                # Optional components shared inside this module
+│   ├── views
+│   │   └── index
+│   │       └── index.vue
+│   ├── index.ts
+│   └── module.ts
+├── package.json
+├── README.md
+├── tsconfig.json
+└── tsconfig.package.json
+```
+
+| Path | Purpose |
+| --- | --- |
+| `src/index.ts` | npm entry point exporting `__MODULE_IDENTIFIER__`. |
+| `src/module.ts` | Collects `src/views/**/*.vue` and declares the `__MODULE_NAME__` module. |
+| `src/api/<proto-path>/*.ts` | Request wrappers matching the full Proto path and service filename. |
+| `src/rpc/README.md` | Describes this module's RPC generation directory and public package subpath. |
+| `src/views/index/index.vue` | Starter page included in the template. |
+| `package.json` | Declares dependencies, module entry, API/RPC subpaths, and npm publish settings. |
+| `README.md` | Documents this business module's files and integration workflow. |
+| `tsconfig.json` | Development-time type-check configuration. |
+| `tsconfig.package.json` | Generates declaration files for npm publishing. |
+
+## Development guidelines
+
+- Place APIs under `src/api/<proto-path>` to match the complete Proto path, for example `src/api/base/v1` and `src/api/system/admin/v1`. Keep filenames aligned with service filenames. Preserve full RPC paths under `src/rpc/<proto-domain>/<version>`; do not flatten them.
+- Put pages under `src/views`. Keep page-specific components next to the page; create `src/components` only when multiple pages in this module share a component.
+- Import core capabilities through public subpaths of `@liujitcn/kratos-admin-core`; do not depend on core source directories.
+- Use Vue Router for navigation between modules. Cross-module code reuse requires an explicit public npm export from the other module.
+- Prefix dynamic menu component paths with `__MODULE_NAME__/`. The starter page path is `__MODULE_NAME__/index/index`; `index/index` is not supported.
+- Replace core static pages only by explicitly mapping them in `staticViews` using the `ADMIN_STATIC_VIEWS` export from core.
+
+The module runtime interface is `__MODULE_IDENTIFIER__`, exported from `src/index.ts`. APIs and RPCs are public through `package.json#exports`; pages are registered only through `AdminModule.views` and are not exported as npm subpaths. Add explicit component exports only for genuine cross-module reuse. Files under `src` do not become public automatically.
+
+Host integration:
+
+```ts
+export const adminModuleManifest = [
+  {
+    packageName: "__MODULE_PACKAGE__",
+    load: async () => (await import("__MODULE_PACKAGE__")).__MODULE_IDENTIFIER__
+  }
+];
+```
+
+## Commands
+
+```bash
+pnpm --filter __MODULE_PACKAGE__ type:check
+pnpm --filter __MODULE_PACKAGE__ build:package
+pnpm --filter __MODULE_PACKAGE__ pack
+```

package/templates/business-workspace/packages/modules/__MODULE_NAME__/src/rpc/README.en-US.md

@@ -0,0 +1,14 @@
+# RPC
+
+This directory contains TypeScript generated from the current module's Proto dependencies. Preserve the full Proto path, for example:
+
+```text
+src/rpc
+├── base/v1
+├── common/v1
+└── system/admin/v1
+```
+
+Generate only the services and transitive types used by this module's APIs and pages. Generated files belong to this module and are exposed through the package's `./rpc/*` subpath. Do not generate business RPCs into core or duplicate their models by hand.
+
+Update RPC files only with the generation command configured by the consuming project. Keep relative imports exactly as emitted; do not flatten the directory structure for appearance.

package/templates/business-workspace/scripts/build-package.mjs

@@ -1,6 +1,7 @@
 import { cp, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { execFileSync } from "node:child_process";
 import { resolve } from "node:path";
+import { workspaceMessage } from "./locale-messages.mjs";
 
 const packageRoot = resolve(process.cwd(), process.argv[2] ?? ".");
 const declarationRoot = resolve(packageRoot, "dist/declarations");
@@ -18,4 +19,4 @@ await cp(resolve(packageRoot, "src"), resolve(outputRoot, "src"), { recursive: t
 await cp(declarationRoot, resolve(outputRoot, "declarations"), { recursive: true });
 await writeFile(resolve(outputRoot, "declarations/index.d.ts"), 'export * from "./src/index";\n');
 await rm(declarationRoot, { recursive: true, force: true });
-console.log(`已生成 ${packageJson.name} 发布文件`);
+console.log(workspaceMessage("package_built", { name: packageJson.name }));

package/templates/business-workspace/scripts/locale-messages.mjs

@@ -0,0 +1,29 @@
+const messages = {
+  "zh-CN": {
+    package_built: "已生成 {name} 发布文件",
+    locale_missing_default: "{module} 缺少 zh-CN 语言包",
+    locale_set_mismatch: "{module} 语言集合不一致",
+    locale_code_invalid: "语言代码无效：{locale}",
+    locale_keys_mismatch: "{module}/{locale} 语言键集合不一致",
+    locale_bundle_outdated: "语言注册产物过期：{file}，请执行 pnpm i18n:sync"
+  },
+  "en-US": {
+    package_built: "Built package artifacts for {name}",
+    locale_missing_default: "{module} is missing the zh-CN locale bundle",
+    locale_set_mismatch: "{module} has an inconsistent locale set",
+    locale_code_invalid: "Invalid locale code: {locale}",
+    locale_keys_mismatch: "Locale message keys differ for {module}/{locale}",
+    locale_bundle_outdated: "Locale bundle is out of date: {file}. Run pnpm i18n:sync."
+  }
+};
+
+/** 根据生成工作区的语言偏好渲染脚手架消息。 */
+export function workspaceMessage(key, params = {}) {
+  const locale = (process.env.KRATOS_ADMIN_LOCALE ?? process.env.LC_ALL ?? process.env.LANG ?? "")
+    .toLowerCase()
+    .startsWith("zh")
+    ? "zh-CN"
+    : "en-US";
+  const template = messages[locale][key] ?? messages["en-US"][key] ?? key;
+  return template.replace(/\{([A-Za-z0-9_]+)\}/g, (_, name) => params[name] ?? `{${name}}`);
+}

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

@@ -1,6 +1,7 @@
 import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { dirname, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
+import { workspaceMessage } from './locale-messages.mjs'
 
 const root = resolve(dirname(fileURLToPath(import.meta.url)), '..')
 const modulesRoot = resolve(root, 'packages/modules')
@@ -11,16 +12,16 @@ for (const entry of existsSync(modulesRoot) ? readdirSync(modulesRoot, { withFil
   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} 语言集合不一致`)
+  if (!locales.includes('zh-CN')) throw new Error(workspaceMessage('locale_missing_default', { module: entry.name }))
+  if (expectedLocales && locales.join(',') !== expectedLocales) throw new Error(workspaceMessage('locale_set_mismatch', { module: 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}`)
+    if (!/^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(locale)) throw new Error(workspaceMessage('locale_code_invalid', { 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} 语言键集合不一致`)
+    if (Object.keys(messages[locale]).sort().join('\0') !== keys) throw new Error(workspaceMessage('locale_keys_mismatch', { module: entry.name, locale }))
   }
   const imports = locales.map((locale, index) => `import locale${index} from './${locale}.json'`)
   const content = [
@@ -34,5 +35,5 @@ for (const entry of existsSync(modulesRoot) ? readdirSync(modulesRoot, { withFil
   ].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`)
+  else if (!existsSync(file) || readFileSync(file, 'utf8') !== content) throw new Error(workspaceMessage('locale_bundle_outdated', { file }))
 }