@liujitcn/kratos-taro-app-cli 0.0.62 → 0.0.65

package/package.json

@@ -7,7 +7,7 @@
     "type": "git",
     "url": "git@github.com:liujitcn/kratos-admin.git"
   },
-  "version": "0.0.62",
+  "version": "0.0.65",
   "type": "module",
   "bin": {
     "kratos-taro-app": "./bin/kratos-taro-app.mjs"

package/src/index.mjs

@@ -1,11 +1,12 @@
 import { execFileSync } from 'node:child_process'
 import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { basename, resolve } from 'node:path'
+import { cliMessage, resolveCliLocale } from './messages.mjs'
 
 const cliPackage = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
 const publicPackageVersion = cliPackage.version
 if (typeof publicPackageVersion !== 'string' || !publicPackageVersion) {
-  throw new Error('CLI package.json 缺少有效版本')
+  throw new Error(cliMessage('package_version_missing'))
 }
 
 const taroVersion = '4.2.1'
@@ -16,7 +17,7 @@ const h5RootFontSource =
 /** 创建独立 Kratos Taro React workspace。 */
 export function scaffoldKratosTaroApp(targetPath, options = {}) {
   const target = resolve(targetPath)
-  if (existsSync(target)) throw new Error(`目标目录已存在：${target}`)
+  if (existsSync(target)) throw new Error(cliMessage('target_exists', { target }))
   const projectName = basename(target)
   validateProjectName(projectName)
   const modules = [...new Set(options.modules ?? [])]
@@ -74,58 +75,19 @@ export async function run(args = process.argv.slice(2)) {
     printHelp()
     return
   }
-  if (args[0] !== 'create') throw new Error(`不支持的命令：${args[0]}`)
+  if (args[0] !== 'create') throw new Error(cliMessage('unsupported_command', { command: args[0] }))
   const targetPath = args[1]
   if (!targetPath || targetPath.startsWith('--')) {
-    throw new Error('用法: kratos-taro-app create <目录> [--module <名称>] [--with <包名>]')
+    throw new Error(cliMessage('usage'))
   }
   const modules = readOptions(args.slice(2), '--module')
   const packages = readOptions(args.slice(2), '--with')
   const target = scaffoldKratosTaroApp(targetPath, { modules, packages, kratosProject: args.includes('--kratos-project') })
-  process.stdout.write(`已创建 Taro workspace：${target}\n`)
+  process.stdout.write(`${cliMessage('workspace_created', { target })}\n`)
 }
 
 function writeWorkspaceReadme(target, projectName) {
-  write(
-    target,
-    'README.md',
-    `# ${projectName}
-
-\`${projectName}\` 是由 \`@liujitcn/kratos-taro-app-cli\` 创建的独立 pnpm workspace，使用 Taro、React 和 TypeScript，支持 H5 与微信小程序。
-
-## 目录结构
-
-\`\`\`text
-${projectName}
-├── apps/taro-app             # 私有 Taro 宿主
-├── packages/modules          # workspace 内本地业务模块
-├── package.json              # 公共命令和开发依赖
-├── pnpm-workspace.yaml       # workspace 包范围
-└── tsconfig.json             # 共享 TypeScript 配置
-\`\`\`
-
-宿主只负责入口、模块清单和平台构建配置。运行时底座、UI 主题和默认业务页分别由 \`@liujitcn/kratos-taro-app-core\`、\`@liujitcn/kratos-taro-app-ui\` 与 \`@liujitcn/kratos-taro-app-system\` 提供。
-
-## 开发
-
-\`\`\`bash
-pnpm install
-pnpm dev:h5
-pnpm dev:mp-weixin
-pnpm build:h5
-pnpm build:mp-weixin
-pnpm tsc
-\`\`\`
-
-开发产物位于 apps/taro-app/dist/dev/<平台>，生产产物位于 apps/taro-app/dist/build/<平台>（平台为 h5 或 mp-weixin）；Kratos 配套项目的 H5 生产产物输出到 backend/web/taro-app。微信开发者工具默认使用 dist/dev/mp-weixin，发布时导入 dist/build/mp-weixin。
-
-模块装配入口是 \`apps/taro-app/src/module-manifest.ts\`。模块顺序决定静态视图覆盖优先级；新增页面时同步维护模块自己的 \`src/pages.ts\` 和视图映射。
-
-环境文件位于 workspace 根目录，变量名与 uni-app 保持一致：\`VITE_APP_PORT\`、\`VITE_APP_BASE_PATH\`、\`VITE_APP_BASE_API\`、\`VITE_APP_API_URL\`、\`VITE_APP_STATIC_API\`、\`VITE_APP_STATIC_URL\`。H5 会在基础模式文件上叠加对应的 \`*-h5\` 文件。
-
-H5 通过局域网 IP 访问时，先在仓库根目录运行 \`bash scripts/generate-dev-cert.sh 192.168.1.100\` 生成证书，再在 \`.env.development-h5.local\` 中设置 \`VITE_APP_HTTPS=true\`；后端使用 HTTPS 时同时设置 \`VITE_APP_API_URL=https://localhost:7001\`。
-`,
-  )
+  write(target, 'README.md', renderLocalizedReadme('workspace.md', { __PROJECT_NAME__: projectName }))
 }
 
 function writeEnvironmentFiles(target) {
@@ -137,7 +99,7 @@ function writeEnvironmentFiles(target) {
   write(
     target,
     '.env.development-h5',
-    'VITE_APP_PORT=5002\nVITE_APP_HTTPS=false\n# VITE_APP_HTTPS_KEY=../../certs/dev-key.pem\n# VITE_APP_HTTPS_CERT=../../certs/dev-cert.pem\n# 后端使用 HTTPS 时，在 .env.development-h5.local 覆盖 VITE_APP_API_URL=https://localhost:7001\nVITE_APP_BASE_PATH=/\nVITE_APP_BASE_API=/api\nVITE_APP_API_URL=http://localhost:7001\nVITE_APP_STATIC_API=\nVITE_APP_STATIC_URL=http://localhost:7001\n',
+    `VITE_APP_PORT=5002\nVITE_APP_HTTPS=false\n# VITE_APP_HTTPS_KEY=../../certs/dev-key.pem\n# VITE_APP_HTTPS_CERT=../../certs/dev-cert.pem\n# ${cliMessage('https_environment_hint')}\nVITE_APP_BASE_PATH=/\nVITE_APP_BASE_API=/api\nVITE_APP_API_URL=http://localhost:7001\nVITE_APP_STATIC_API=\nVITE_APP_STATIC_URL=http://localhost:7001\n`,
   )
   write(
     target,
@@ -207,16 +169,7 @@ function writeHost(target, projectName, modules, packages, options) {
   write(
     target,
     'apps/taro-app/README.md',
-    `# @local/kratos-taro-app
-
-\`apps/taro-app\` 是 \`${projectName}\` 的私有 Taro React 宿主，负责装配模块并提供 H5、微信小程序构建入口，不承载可复用业务实现。
-
-开发产物位于 apps/taro-app/dist/dev/<平台>，生产产物位于 apps/taro-app/dist/build/<平台>（平台为 h5 或 mp-weixin）；Kratos 配套项目的 H5 生产产物输出到 backend/web/taro-app。微信开发者工具默认使用 dist/dev/mp-weixin，发布时导入 dist/build/mp-weixin。
-
-固定启动页位于 \`src/pages/bootstrap\`。其他模块页面由 core runner 在构建期间临时生成包装器、页面配置与静态资源，构建结束后会自动恢复宿主目录。
-
-通过局域网 IP 访问 H5 时，可复用仓库根 certs 下的共享证书，并在 .env.development-h5.local 中设置 VITE_APP_HTTPS=true；后端使用 HTTPS 时同步设置 VITE_APP_API_URL=https://localhost:7001。
-`,
+    renderLocalizedReadme('host.md', { __PROJECT_NAME__: projectName }),
   )
   write(
     target,
@@ -377,15 +330,10 @@ function writeLocalModule(target, projectName, name) {
   write(
     target,
     `packages/modules/${name}/README.md`,
-    `# @local/${name}
-
-\`@local/${name}\` 是 \`${projectName}\` workspace 内的本地 Taro 业务模块，通过 core 的公开接口接入宿主。
-
-- 页面放在 \`src/views\`，页面配置登记在 \`src/pages.ts\`。
-- 稳定视图键登记在 \`src/index.ts\`，后注册模块具有更高覆盖优先级。
-- 请求、认证、导航和状态能力只能通过公开包入口使用。
-- \`src/build.ts\` 是 runner 使用的构建期描述，不承载运行时逻辑。
-`,
+    renderLocalizedReadme('module.md', {
+      __PROJECT_NAME__: projectName,
+      __MODULE_NAME__: name,
+    }),
   )
   write(
     target,
@@ -457,6 +405,7 @@ import { dirname, resolve } from 'node:path'
 import { defineConfig, type UserConfigExport } from '@tarojs/cli'
 import { dotenvParse } from '@tarojs/helper'
 import TsconfigPathsPlugin from 'tsconfig-paths-webpack-plugin'
+import { runnerMessage } from '@liujitcn/kratos-taro-app-core/build'
 import devConfig from './dev'
 import prodConfig from './prod'
 
@@ -469,7 +418,7 @@ function resolveHttpsOptions(env: Record<string, string>, root: string) {
   const keyPath = resolve(root, env.VITE_APP_HTTPS_KEY || '../../certs/dev-key.pem')
   const certPath = resolve(root, env.VITE_APP_HTTPS_CERT || '../../certs/dev-cert.pem')
   if (!existsSync(keyPath) || !existsSync(certPath)) {
-    throw new Error('VITE_APP_HTTPS 已开启，但未找到证书文件，请先在仓库根目录运行 scripts/generate-dev-cert.sh；期望路径：' + keyPath + ' 和 ' + certPath)
+    throw new Error(runnerMessage('https_certificate_missing', { keyPath, certPath }))
   }
   return { key: readFileSync(keyPath), cert: readFileSync(certPath) }
 }
@@ -619,10 +568,10 @@ function readOptions(args, option) {
     const argument = args[index]
     if (argument === '--kratos-project') continue
     if (argument !== '--module' && argument !== '--with') {
-      throw new Error(`未知参数：${argument}`)
+      throw new Error(cliMessage('unknown_argument', { argument }))
     }
     const value = args[++index]
-    if (!value || value.startsWith('--')) throw new Error(`选项 ${argument} 缺少值`)
+    if (!value || value.startsWith('--')) throw new Error(cliMessage('option_missing_value', { option: argument }))
     if (argument === option) {
       values.push(
         ...value
@@ -636,16 +585,16 @@ function readOptions(args, option) {
 }
 
 function validateProjectName(name) {
-  if (!/^[a-z][a-z0-9-]*$/.test(name)) throw new Error(`项目名必须使用 kebab-case：${name}`)
+  if (!/^[a-z][a-z0-9-]*$/.test(name)) throw new Error(cliMessage('project_name_invalid', { name }))
 }
 
 /** 校验本地业务模块名称。 */
 function validateModuleName(name) {
-  if (!/^[a-z][a-z0-9-]*$/.test(name)) throw new Error(`模块名无效：${name}`)
+  if (!/^[a-z][a-z0-9-]*$/.test(name)) throw new Error(cliMessage('module_name_invalid', { name }))
 }
 
 function validatePackageName(name) {
-  if (!/^(?:@[a-z0-9-]+\/)?[a-z0-9-]+$/.test(name)) throw new Error(`包名无效：${name}`)
+  if (!/^(?:@[a-z0-9-]+\/)?[a-z0-9-]+$/.test(name)) throw new Error(cliMessage('package_name_invalid', { name }))
 }
 
 function toCamelCase(value) {
@@ -665,12 +614,12 @@ function json(value) {
 function printHelp() {
   process.stdout.write(
     [
-      'kratos-taro-app create <目录> [--module <名称[,名称...]>] [--with <包名>]',
+      cliMessage('usage'),
       '',
-      '示例:',
-      '  kratos-taro-app create customer-app',
-      '  kratos-taro-app create business-app --module business,report',
-      '  kratos-taro-app create customer-app --with @acme/customer-module',
+      cliMessage('examples_heading'),
+      cliMessage('example_create'),
+      cliMessage('example_modules'),
+      cliMessage('example_package'),
       '',
     ].join('\n'),
   )
@@ -691,6 +640,18 @@ function renderWorkspaceTemplates(source, target, tokens) {
   }
 }
 
+/** 按 CLI 语言加载并替换 workspace README 模板。 */
+function renderLocalizedReadme(name, tokens) {
+  const template = readFileSync(
+    new URL(`../templates/readmes/${resolveCliLocale()}/${name}`, import.meta.url),
+    'utf8',
+  )
+  return Object.entries(tokens).reduce(
+    (content, [key, value]) => content.replaceAll(key, () => value),
+    template,
+  )
+}
+
 /** 创建业务模块语言源文件及 API、RPC、测试目录，注册产物由同步命令生成。 */
 function writeModuleLocales(target, name) {
   for (const directory of ['src/api', 'src/rpc', 'test']) {

package/src/messages.mjs

@@ -0,0 +1,52 @@
+const messages = {
+  'zh-CN': {
+    package_version_missing: 'CLI package.json 缺少有效版本',
+    target_exists: '目标目录已存在：{target}',
+    unsupported_command: '不支持的命令：{command}',
+    usage: '用法: kratos-taro-app create <目录> [--module <名称>] [--with <包名>]',
+    workspace_created: '已创建 Taro workspace：{target}',
+    unknown_argument: '未知参数：{argument}',
+    option_missing_value: '选项 {option} 缺少值',
+    project_name_invalid: '项目名必须使用 kebab-case：{name}',
+    module_name_invalid: '模块名无效：{name}',
+    package_name_invalid: '包名无效：{name}',
+    examples_heading: '示例:',
+    example_create: '  kratos-taro-app create customer-app',
+    example_modules: '  kratos-taro-app create business-app --module business,report',
+    example_package: '  kratos-taro-app create customer-app --with @acme/customer-module',
+    https_environment_hint: '后端使用 HTTPS 时，在 .env.development-h5.local 中设置 VITE_APP_API_URL=https://localhost:7001。',
+  },
+  'en-US': {
+    package_version_missing: 'CLI package.json is missing a valid version',
+    target_exists: 'The target directory already exists: {target}',
+    unsupported_command: 'Unsupported command: {command}',
+    usage: 'Usage: kratos-taro-app create <directory> [--module <name>] [--with <package>]',
+    workspace_created: 'Taro workspace created: {target}',
+    unknown_argument: 'Unknown argument: {argument}',
+    option_missing_value: 'Option {option} is missing a value',
+    project_name_invalid: 'Project name must use kebab-case: {name}',
+    module_name_invalid: 'Invalid module name: {name}',
+    package_name_invalid: 'Invalid package name: {name}',
+    examples_heading: 'Examples:',
+    example_create: '  kratos-taro-app create customer-app',
+    example_modules: '  kratos-taro-app create business-app --module business,report',
+    example_package: '  kratos-taro-app create customer-app --with @acme/customer-module',
+    https_environment_hint: 'When the backend uses HTTPS, set VITE_APP_API_URL=https://localhost:7001 in .env.development-h5.local.',
+  },
+}
+
+/** 解析脚手架文案所用的语言区域。 */
+export function resolveCliLocale() {
+  return (process.env.KRATOS_ADMIN_LOCALE ?? process.env.LC_ALL ?? process.env.LANG ?? '')
+    .toLowerCase()
+    .startsWith('zh')
+    ? 'zh-CN'
+    : 'en-US'
+}
+
+/** 根据环境变量选择 Taro CLI 文案语言。 */
+export function cliMessage(key, params = {}) {
+  const locale = resolveCliLocale()
+  const template = messages[locale][key] ?? messages['en-US'][key] ?? key
+  return template.replace(/\{([A-Za-z0-9_]+)\}/g, (_, name) => params[name] ?? `{${name}}`)
+}

package/templates/readmes/en-US/host.md

@@ -0,0 +1,9 @@
+# @local/kratos-taro-app
+
+`apps/taro-app` is the private Taro React host for `__PROJECT_NAME__`. It assembles modules and provides H5 and WeChat Mini Program build entry points; reusable business implementations belong in modules.
+
+Development output is under `apps/taro-app/dist/dev/<platform>` and production output under `apps/taro-app/dist/build/<platform>` (`h5` or `mp-weixin`). For a Kratos-integrated project, the H5 production build is written to `backend/web/taro-app`. WeChat Developer Tools should use `dist/dev/mp-weixin`; import `dist/build/mp-weixin` for release.
+
+The fixed startup page is in `src/pages/bootstrap`. The core runner temporarily generates wrappers, page configuration, and static assets for other module pages during builds, then restores the host directory.
+
+To access H5 over a LAN IP, use the shared certificate under the repository's `certs` directory and set `VITE_APP_HTTPS=true` in `.env.development-h5.local`. If the backend uses HTTPS, also set `VITE_APP_API_URL=https://localhost:7001`.

package/templates/readmes/en-US/module.md

@@ -0,0 +1,8 @@
+# @local/__MODULE_NAME__
+
+`@local/__MODULE_NAME__` is a local Taro business module in the `__PROJECT_NAME__` workspace. It integrates with the host through the public core APIs.
+
+- Put pages in `src/views` and register page configuration in `src/pages.ts`.
+- Register stable view keys in `src/index.ts`; modules declared later take precedence when overriding static views.
+- Use only public package entry points for requests, authentication, navigation, and state.
+- `src/build.ts` describes the module to the build-time runner and must not contain runtime logic.

package/templates/readmes/en-US/workspace.md

@@ -0,0 +1,35 @@
+# __PROJECT_NAME__
+
+`__PROJECT_NAME__` is an independent pnpm workspace created by `@liujitcn/kratos-taro-app-cli`. It uses Taro, React, and TypeScript, and supports H5 and WeChat Mini Programs.
+
+## Directory Structure
+
+```text
+__PROJECT_NAME__
+├── apps/taro-app             # Private Taro host
+├── packages/modules          # Local workspace business modules
+├── package.json              # Shared commands and development dependencies
+├── pnpm-workspace.yaml       # Workspace package patterns
+└── tsconfig.json             # Shared TypeScript configuration
+```
+
+The host contains only the entry point, module manifest, and platform build configuration. Runtime foundations, UI theme, and default business pages are provided by `@liujitcn/kratos-taro-app-core`, `@liujitcn/kratos-taro-app-ui`, and `@liujitcn/kratos-taro-app-system`.
+
+## Development
+
+```bash
+pnpm install
+pnpm dev:h5
+pnpm dev:mp-weixin
+pnpm build:h5
+pnpm build:mp-weixin
+pnpm tsc
+```
+
+Development output is under `apps/taro-app/dist/dev/<platform>` and production output under `apps/taro-app/dist/build/<platform>` (`h5` or `mp-weixin`). For a Kratos-integrated project, the H5 production build is written to `backend/web/taro-app`. WeChat Developer Tools should use `dist/dev/mp-weixin`; import `dist/build/mp-weixin` for release.
+
+The module assembly entry is `apps/taro-app/src/module-manifest.ts`. Declaration order determines static view override priority; update each module's `src/pages.ts` and view mapping when adding pages.
+
+Environment files are at the workspace root and use the same names as uni-app: `VITE_APP_PORT`, `VITE_APP_BASE_PATH`, `VITE_APP_BASE_API`, `VITE_APP_API_URL`, `VITE_APP_STATIC_API`, and `VITE_APP_STATIC_URL`. H5 overlays the matching `*-h5` file on the base mode file.
+
+To access H5 over a LAN IP, run `bash scripts/generate-dev-cert.sh 192.168.1.100` from the repository root, then set `VITE_APP_HTTPS=true` in `.env.development-h5.local`. If the backend uses HTTPS, also set `VITE_APP_API_URL=https://localhost:7001`.

package/templates/readmes/zh-CN/host.md

@@ -0,0 +1,9 @@
+# @local/kratos-taro-app
+
+`apps/taro-app` 是 `__PROJECT_NAME__` 的私有 Taro React 宿主，负责装配模块并提供 H5、微信小程序构建入口，不承载可复用业务实现。
+
+开发产物位于 apps/taro-app/dist/dev/<平台>，生产产物位于 apps/taro-app/dist/build/<平台>（平台为 h5 或 mp-weixin）；Kratos 配套项目的 H5 生产产物输出到 backend/web/taro-app。微信开发者工具默认使用 dist/dev/mp-weixin，发布时导入 dist/build/mp-weixin。
+
+固定启动页位于 `src/pages/bootstrap`。其他模块页面由 core runner 在构建期间临时生成包装器、页面配置与静态资源，构建结束后会自动恢复宿主目录。
+
+通过局域网 IP 访问 H5 时，可复用仓库根 certs 下的共享证书，并在 .env.development-h5.local 中设置 VITE_APP_HTTPS=true；后端使用 HTTPS 时同步设置 VITE_APP_API_URL=https://localhost:7001。

package/templates/readmes/zh-CN/module.md

@@ -0,0 +1,8 @@
+# @local/__MODULE_NAME__
+
+`@local/__MODULE_NAME__` 是 `__PROJECT_NAME__` workspace 内的本地 Taro 业务模块，通过 core 的公开接口接入宿主。
+
+- 页面放在 `src/views`，页面配置登记在 `src/pages.ts`。
+- 稳定视图键登记在 `src/index.ts`，后注册模块具有更高覆盖优先级。
+- 请求、认证、导航和状态能力只能通过公开包入口使用。
+- `src/build.ts` 是 runner 使用的构建期描述，不承载运行时逻辑。

package/templates/readmes/zh-CN/workspace.md

@@ -0,0 +1,35 @@
+# __PROJECT_NAME__
+
+`__PROJECT_NAME__` 是由 `@liujitcn/kratos-taro-app-cli` 创建的独立 pnpm workspace，使用 Taro、React 和 TypeScript，支持 H5 与微信小程序。
+
+## 目录结构
+
+```text
+__PROJECT_NAME__
+├── apps/taro-app             # 私有 Taro 宿主
+├── packages/modules          # workspace 内本地业务模块
+├── package.json              # 公共命令和开发依赖
+├── pnpm-workspace.yaml       # workspace 包范围
+└── tsconfig.json             # 共享 TypeScript 配置
+```
+
+宿主只负责入口、模块清单和平台构建配置。运行时底座、UI 主题和默认业务页分别由 `@liujitcn/kratos-taro-app-core`、`@liujitcn/kratos-taro-app-ui` 与 `@liujitcn/kratos-taro-app-system` 提供。
+
+## 开发
+
+```bash
+pnpm install
+pnpm dev:h5
+pnpm dev:mp-weixin
+pnpm build:h5
+pnpm build:mp-weixin
+pnpm tsc
+```
+
+开发产物位于 apps/taro-app/dist/dev/<平台>，生产产物位于 apps/taro-app/dist/build/<平台>（平台为 h5 或 mp-weixin）；Kratos 配套项目的 H5 生产产物输出到 backend/web/taro-app。微信开发者工具默认使用 dist/dev/mp-weixin，发布时导入 dist/build/mp-weixin。
+
+模块装配入口是 `apps/taro-app/src/module-manifest.ts`。模块顺序决定静态视图覆盖优先级；新增页面时同步维护模块自己的 `src/pages.ts` 和视图映射。
+
+环境文件位于 workspace 根目录，变量名与 uni-app 保持一致：`VITE_APP_PORT`、`VITE_APP_BASE_PATH`、`VITE_APP_BASE_API`、`VITE_APP_API_URL`、`VITE_APP_STATIC_API`、`VITE_APP_STATIC_URL`。H5 会在基础模式文件上叠加对应的 `*-h5` 文件。
+
+H5 通过局域网 IP 访问时，先在仓库根目录运行 `bash scripts/generate-dev-cert.sh 192.168.1.100` 生成证书，再在 `.env.development-h5.local` 中设置 `VITE_APP_HTTPS=true`；后端使用 HTTPS 时同时设置 `VITE_APP_API_URL=https://localhost:7001`。

package/templates/workspace/scripts/check-package-exports.mjs

@@ -2,6 +2,7 @@ import { readdir, readFile, stat } from 'node:fs/promises'
 import { dirname, extname, relative, resolve, sep } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import ts from 'typescript'
+import { workspaceMessage } from './locale-messages.mjs'
 
 const workspaceRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
 const coreRoot = resolve(workspaceRoot, 'packages/core')
@@ -30,7 +31,7 @@ for (const packageFile of packageFiles) {
       const prefix = target.includes('*') ? target.slice(0, target.indexOf('*')) : target
       const checkPath = resolve(packageRoot, prefix)
       if (!(await pathExists(checkPath))) {
-        throw new Error(`${metadata.name} 导出目标不存在：${target}`)
+        throw new Error(workspaceMessage('export_target_missing', { name: metadata.name, target }))
       }
     }
   }
@@ -40,8 +41,8 @@ const distinctPublicVersions = new Set(publicPackageVersions.values())
 if (distinctPublicVersions.size > 1 || [...distinctPublicVersions].some((version) => !version)) {
   const versions = [...publicPackageVersions]
     .map(([name, version]) => `${name}@${version}`)
-    .join('、')
-  throw new Error(`Taro 公开包版本必须保持一致：${versions}`)
+    .join(workspaceMessage('list_separator'))
+  throw new Error(workspaceMessage('public_version_mismatch', { versions }))
 }
 
 for (const sourceFile of allFiles.filter((file) => sourceExtensions.has(extname(file)))) {
@@ -51,22 +52,18 @@ for (const sourceFile of allFiles.filter((file) => sourceExtensions.has(extname(
     const specifier = imported.fileName
     const line = source.slice(0, imported.pos).split('\n').length
     if ((specifier === '@' || specifier.startsWith('@/')) && !isWithin(sourceFile, coreRoot)) {
-      violations.push(
-        `${format(sourceFile, line)}: 非 core 代码不得使用 core 私有别名 ${specifier}`,
-      )
+      violations.push(workspaceMessage('core_alias_forbidden', { location: format(sourceFile, line), specifier }))
       continue
     }
     if (specifier.startsWith('@system/') && !isWithin(sourceFile, systemRoot)) {
-      violations.push(
-        `${format(sourceFile, line)}: 非 system 代码不得使用 system 私有别名 ${specifier}`,
-      )
+      violations.push(workspaceMessage('system_alias_forbidden', { location: format(sourceFile, line), specifier }))
       continue
     }
     if (specifier.startsWith('.')) {
       const sourcePackage = findPackageByPath(sourceFile)
       const targetPackage = findPackageByPath(resolve(dirname(sourceFile), specifier))
       if (sourcePackage && targetPackage && sourcePackage !== targetPackage) {
-        violations.push(`${format(sourceFile, line)}: 禁止通过相对路径跨包引用 ${specifier}`)
+        violations.push(workspaceMessage('cross_package_relative_forbidden', { location: format(sourceFile, line), specifier }))
       }
       continue
     }
@@ -79,32 +76,28 @@ for (const sourceFile of allFiles.filter((file) => sourceExtensions.has(extname(
       .get(packageName)
       .exportEntries.some(([pattern]) => matchExportPattern(pattern, subpath))
     if (!exported) {
-      violations.push(
-        `${format(sourceFile, line)}: ${specifier} 未在 ${packageName} exports 中公开`,
-      )
+      violations.push(workspaceMessage('export_not_public', { location: format(sourceFile, line), specifier, packageName }))
     }
   }
 }
 
 for (const [packageName, { packageRoot }] of packages) {
   if (packageName === '@liujitcn/kratos-taro-app-core' && packageRoot !== coreRoot) {
-    violations.push(`${packageName}: core 包目录异常`)
+    violations.push(workspaceMessage('core_dir_unexpected', { packageName }))
   }
   if (packageName === '@liujitcn/kratos-taro-app-ui' && packageRoot !== uiRoot) {
-    violations.push(`${packageName}: UI 包目录异常`)
+    violations.push(workspaceMessage('ui_dir_unexpected', { packageName }))
   }
   if (packageName === '@liujitcn/kratos-taro-app-system' && packageRoot !== systemRoot) {
-    violations.push(`${packageName}: system 包目录异常`)
+    violations.push(workspaceMessage('system_dir_unexpected', { packageName }))
   }
 }
 
 if (violations.length) {
-  console.error(
-    `Taro package exports 检查失败：\n${violations.map((item) => `  ${item}`).join('\n')}`,
-  )
+  console.error(workspaceMessage('exports_check_failed', { violations: violations.map((item) => `  ${item}`).join('\n') }))
   process.exit(1)
 }
-console.log(`Taro package exports 检查通过（${[...packages.keys()].join('、')}）`)
+console.log(workspaceMessage('exports_check_passed', { packages: [...packages.keys()].join(workspaceMessage('list_separator')) }))
 
 async function collectFiles(directory) {
   const files = []

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

@@ -0,0 +1,53 @@
+const messages = {
+  'zh-CN': {
+    missing_default_locale: '{module} 缺少 zh-CN 语言包',
+    locale_set_mismatch: '{module} 语言集合不一致',
+    locale_code_invalid: '语言代码无效：{locale}',
+    key_set_mismatch: '{module}/{locale} 语言键集合不一致',
+    bundle_outdated: '语言注册产物过期：{file}，请执行 pnpm i18n:sync',
+    export_target_missing: '{name} 导出目标不存在：{target}',
+    public_version_mismatch: 'Taro 公开包版本必须保持一致：{versions}',
+    core_alias_forbidden: '{location}: 非 core 代码不得使用 core 私有别名 {specifier}',
+    ui_alias_forbidden: '{location}: 非 UI 代码不得使用 UI 私有别名 {specifier}',
+    system_alias_forbidden: '{location}: 非 system 代码不得使用 system 私有别名 {specifier}',
+    cross_package_relative_forbidden: '{location}: 禁止通过相对路径跨包引用 {specifier}',
+    export_not_public: '{location}: {specifier} 未在 {packageName} exports 中公开',
+    core_dir_unexpected: '{packageName}: core 包目录异常',
+    ui_dir_unexpected: '{packageName}: UI 包目录异常',
+    system_dir_unexpected: '{packageName}: system 包目录异常',
+    exports_check_failed: 'Taro package exports 检查失败：\n{violations}',
+    exports_check_passed: 'Taro package exports 检查通过（{packages}）',
+    list_separator: '、',
+  },
+  'en-US': {
+    missing_default_locale: '{module} is missing the zh-CN locale bundle',
+    locale_set_mismatch: '{module} has a different locale set',
+    locale_code_invalid: 'Invalid locale code: {locale}',
+    key_set_mismatch: 'Locale message keys differ for {module}/{locale}',
+    bundle_outdated: 'Locale bundle is out of date: {file}. Run pnpm i18n:sync.',
+    export_target_missing: '{name} export target does not exist: {target}',
+    public_version_mismatch: 'Taro public package versions must match: {versions}',
+    core_alias_forbidden: '{location}: Core private aliases cannot be used outside core: {specifier}',
+    ui_alias_forbidden: '{location}: UI private aliases cannot be used outside UI: {specifier}',
+    system_alias_forbidden: '{location}: System private aliases cannot be used outside system: {specifier}',
+    cross_package_relative_forbidden: '{location}: Cross-package relative import is forbidden: {specifier}',
+    export_not_public: '{location}: {specifier} is not exposed by {packageName} exports',
+    core_dir_unexpected: '{packageName}: unexpected core package directory',
+    ui_dir_unexpected: '{packageName}: unexpected UI package directory',
+    system_dir_unexpected: '{packageName}: unexpected system package directory',
+    exports_check_failed: 'Taro package exports check failed:\n{violations}',
+    exports_check_passed: 'Taro package exports check passed ({packages})',
+    list_separator: ', ',
+  },
+}
+
+/** 根据工作区语言偏好渲染脚手架诊断文案。 */
+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/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('missing_default_locale', { 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('key_set_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('bundle_outdated', { file }))
 }