@liujitcn/kratos-uni-app-cli 0.0.61 → 0.0.64

package/bin/kratos-uni-app.mjs

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import { scaffoldKratosApp } from '../src/index.mjs'
+import { cliMessage } from '../src/messages.mjs'
 
 const args = process.argv.slice(2)
 if (args[0] !== 'create' || !args[1]) {
-  console.error('用法: kratos-uni-app create <目录> [--module <名称>] [--with <包名>]')
+  console.error(cliMessage('usage'))
   process.exitCode = 1
 } else {
   const modules = []
@@ -13,7 +14,7 @@ if (args[0] !== 'create' || !args[1]) {
     if (args[index] === '--module' && args[index + 1]) modules.push(args[++index])
     else if (args[index] === '--with' && args[index + 1]) packages.push(args[++index])
     else if (args[index] === '--kratos-project') kratosProject = true
-    else throw new Error(`未知参数：${args[index]}`)
+    else throw new Error(cliMessage('unknown_argument', { argument: args[index] }))
   }
   scaffoldKratosApp(args[1], { modules, packages, kratosProject })
 }

package/package.json

@@ -7,7 +7,7 @@
     "type": "git",
     "url": "git@github.com:liujitcn/kratos-admin.git"
   },
-  "version": "0.0.61",
+  "version": "0.0.64",
   "type": "module",
   "files": [
     "assets",

package/src/index.mjs

@@ -8,17 +8,18 @@ import {
   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'))
 }
 
 /** 创建独立 Kratos uni-app workspace。 */
 export function scaffoldKratosApp(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)
   const modules = [...new Set(options.modules ?? [])]
   const packages = [...new Set(options.packages ?? [])]
@@ -41,39 +42,7 @@ export function scaffoldKratosApp(targetPath, options = {}) {
   write(
     target,
     'README.md',
-    `# ${projectName}
-
-\`${projectName}\` 是由 \`@liujitcn/kratos-uni-app-cli\` 创建的独立 pnpm workspace，支持 H5 和微信小程序。
-
-## 目录结构
-
-\`\`\`text
-${projectName}
-├── apps/uni-app                 # 私有 uni-app 宿主
-├── packages/modules        # workspace 内本地业务模块
-├── package.json            # 公共命令和开发依赖
-├── pnpm-workspace.yaml     # workspace 包范围
-└── tsconfig.json           # 共享 TypeScript 配置
-\`\`\`
-
-宿主只负责入口、manifest、模块清单和启动；底座能力由 \`@liujitcn/kratos-uni-app-core\` 提供，默认业务页面由 \`@liujitcn/kratos-uni-app-system\` 提供。本地模块通过各自公开入口接入，不跨包相对引用源码。
-
-## 开发
-
-\`\`\`bash
-pnpm install
-pnpm dev:h5
-pnpm dev:mp-weixin
-pnpm build:h5
-pnpm build:mp-weixin
-\`\`\`
-
-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。
-
-模块装配入口是 \`apps/uni-app/src/module-manifest.ts\`。新增、删除或调整模块时同步维护该清单，并在模块自己的 README 中记录页面和接口职责。
-
-生产构建前请在 \`.env.production\` 中填写实际 API 和静态资源地址；该文件默认留空，不应使用本机地址。
-`,
+    renderLocalizedReadme('workspace.md', { __PROJECT_NAME__: projectName }),
   )
   const dependencies = {
     '@liujitcn/kratos-uni-app-core': `^${publicPackageVersion}`,
@@ -119,41 +88,7 @@ H5 通过局域网 IP 访问时，先在仓库根目录运行 bash scripts/gener
   write(
     target,
     'apps/uni-app/README.md',
-    `# @liujitcn/kratos-uni-app
-
-\`apps/uni-app\` 是 \`${projectName}\` 的私有 uni-app 宿主，负责组合模块并提供 H5、微信小程序的构建入口，不承载可复用业务实现。
-
-## 目录结构
-
-\`\`\`text
-apps/uni-app
-├── src
-│   ├── pages/bootstrap      # 固定启动页面
-│   ├── App.vue              # 应用根组件和全局样式入口
-│   ├── main.ts              # Vue 与 Kratos uni-app 启动入口
-│   ├── manifest.json        # uni-app 平台配置
-│   ├── module-manifest.ts   # 唯一模块清单
-│   └── pages.json           # 固定 bootstrap 路由
-├── index.html               # H5 HTML 入口
-├── package.json             # 宿主命令和运行依赖
-└── vite.config.ts           # 模块页面装配与 uni-app 插件
-\`\`\`
-
-## 模块装配
-
-\`src/module-manifest.ts\` 默认注册 core 和 system，并按声明顺序加载本地模块与已发布模块。业务页面、API 和状态应放在所属模块，宿主仅维护组合关系和平台配置。
-
-## 命令
-
-在 workspace 根目录执行：
-
-\`\`\`bash
-pnpm dev:h5
-pnpm dev:mp-weixin
-pnpm build:h5
-pnpm build:mp-weixin
-\`\`\`
-`,
+    renderLocalizedReadme('host.md', { __PROJECT_NAME__: projectName }),
   )
   const imports = [
     "import { coreModule } from '@liujitcn/kratos-uni-app-core/module'",
@@ -232,6 +167,7 @@ import {
   defineConfig,
   kratosApp,
   loadEnv,
+  viteMessage,
   type ConfigEnv,
   type UserConfig,
 } from '@liujitcn/kratos-uni-app-core/vite'
@@ -245,7 +181,7 @@ function resolveHttpsOptions(env, root) {
   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(viteMessage('https_certificate_missing', { keyPath, certPath }))
   }
   return { key: readFileSync(keyPath), cert: readFileSync(certPath) }
 }
@@ -340,29 +276,10 @@ export default defineConfig(({ mode }) => {
     write(
       target,
       `packages/modules/${name}/README.md`,
-      `# @local/${name}
-
-\`@local/${name}\` 是 \`${projectName}\` workspace 内的本地业务模块，通过 \`@liujitcn/kratos-uni-app-core\` 的公开接口接入宿主。
-
-## 目录结构
-
-\`\`\`text
-packages/modules/${name}
-├── src
-│   ├── views               # 模块页面；页面私有组件放在就近 components
-│   ├── index.d.mts         # 模块入口类型
-│   └── index.mjs           # 页面、视图键和图标注册入口
-├── package.json            # 模块名称、依赖和 exports
-└── README.md               # 模块职责与维护说明
-\`\`\`
-
-## 开发约束
-
-- 页面放在 \`src/views\`，并在 \`src/index.mjs\` 的模块定义中登记页面和稳定视图键。
-- 请求、认证、导航和状态能力只通过 \`@liujitcn/kratos-uni-app-core\` 的公开 exports 使用。
-- 页面替换使用稳定视图键，接口不能直接下发任意组件路径。
-- 修改模块后从 workspace 根目录运行对应 H5 或微信小程序命令验证装配结果。
-`,
+      renderLocalizedReadme('module.md', {
+        __PROJECT_NAME__: projectName,
+        __MODULE_NAME__: name,
+      }),
     )
     write(
       target,
@@ -398,7 +315,7 @@ function writeEnvironmentFiles(target) {
   write(
     target,
     '.env.development-h5',
-    'VITE_APP_PORT=5004\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=5004\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,
@@ -414,11 +331,12 @@ function writeEnvironmentFiles(target) {
 
 /** 校验本地业务模块名称。 */
 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 write(root, file, content) {
@@ -449,6 +367,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,38 @@
+const messages = {
+  'zh-CN': {
+    package_version_missing: 'CLI package.json 缺少有效版本',
+    target_exists: '目标目录已存在：{target}',
+    usage: '用法: kratos-uni-app create <目录> [--module <名称>] [--with <包名>]',
+    unknown_argument: '未知参数：{argument}',
+    module_name_invalid: '模块名无效：{name}',
+    package_name_invalid: '包名无效：{name}',
+    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}',
+    usage: 'Usage: kratos-uni-app create <directory> [--module <name>] [--with <package>]',
+    unknown_argument: 'Unknown argument: {argument}',
+    module_name_invalid: 'Invalid module name: {name}',
+    package_name_invalid: 'Invalid package name: {name}',
+    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'
+}
+
+/** 根据环境变量选择 uni-app 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,34 @@
+# @liujitcn/kratos-uni-app
+
+`apps/uni-app` is the private uni-app host for `__PROJECT_NAME__`. It assembles modules and provides H5 and WeChat Mini Program build entry points; reusable business implementations belong in modules.
+
+## Directory Structure
+
+```text
+apps/uni-app
+├── src
+│   ├── pages/bootstrap      # Fixed startup page
+│   ├── App.vue              # Root component and global styles
+│   ├── main.ts              # Vue and Kratos uni-app startup
+│   ├── manifest.json        # uni-app platform configuration
+│   ├── module-manifest.ts   # Single module manifest
+│   └── pages.json           # Fixed bootstrap route
+├── index.html               # H5 HTML entry
+├── package.json             # Host commands and runtime dependencies
+└── vite.config.ts           # Module assembly and uni-app plugins
+```
+
+## Module Assembly
+
+`src/module-manifest.ts` registers core and system by default, then loads local and published modules in declaration order. Keep business pages, APIs, and state in their owning modules; the host only maintains composition and platform configuration.
+
+## Commands
+
+Run from the workspace root:
+
+```bash
+pnpm dev:h5
+pnpm dev:mp-weixin
+pnpm build:h5
+pnpm build:mp-weixin
+```

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

@@ -0,0 +1,22 @@
+# @local/__MODULE_NAME__
+
+`@local/__MODULE_NAME__` is a local business module in the `__PROJECT_NAME__` workspace. It integrates with the host through the public APIs of `@liujitcn/kratos-uni-app-core`.
+
+## Directory Structure
+
+```text
+packages/modules/__MODULE_NAME__
+├── src
+│   ├── views               # Module pages; keep page-specific components nearby
+│   ├── index.d.mts         # Module entry types
+│   └── index.mjs           # Page, view key, and icon registration
+├── package.json            # Module name, dependencies, and exports
+└── README.md               # Module responsibilities and maintenance notes
+```
+
+## Development Rules
+
+- Put pages in `src/views` and register pages and stable view keys in `src/index.mjs`.
+- Use only the public exports of `@liujitcn/kratos-uni-app-core` for requests, authentication, navigation, and state.
+- Replace pages through stable view keys; APIs must not return arbitrary component paths.
+- After changing the module, run the relevant H5 or WeChat Mini Program command from the workspace root to verify assembly.

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

@@ -0,0 +1,32 @@
+# __PROJECT_NAME__
+
+`__PROJECT_NAME__` is an independent pnpm workspace created by `@liujitcn/kratos-uni-app-cli`. It supports H5 and WeChat Mini Programs.
+
+## Directory Structure
+
+```text
+__PROJECT_NAME__
+├── apps/uni-app          # Private uni-app 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, manifest, module list, and startup wiring. Core capabilities are provided by `@liujitcn/kratos-uni-app-core`; default business pages are provided by `@liujitcn/kratos-uni-app-system`. Local modules integrate through their public package entry points and must not use cross-package relative imports.
+
+## Development
+
+```bash
+pnpm install
+pnpm dev:h5
+pnpm dev:mp-weixin
+pnpm build:h5
+pnpm build:mp-weixin
+```
+
+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`.
+
+The module assembly entry is `apps/uni-app/src/module-manifest.ts`. Keep it in sync when adding, removing, or changing modules, and document page and API responsibilities in each module README.
+
+Before a production build, set the real API and static asset URLs in `.env.production`. That file is intentionally blank by default and should not contain localhost addresses.

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

@@ -0,0 +1,34 @@
+# @liujitcn/kratos-uni-app
+
+`apps/uni-app` 是 `__PROJECT_NAME__` 的私有 uni-app 宿主，负责组合模块并提供 H5、微信小程序的构建入口，不承载可复用业务实现。
+
+## 目录结构
+
+```text
+apps/uni-app
+├── src
+│   ├── pages/bootstrap      # 固定启动页面
+│   ├── App.vue              # 应用根组件和全局样式入口
+│   ├── main.ts              # Vue 与 Kratos uni-app 启动入口
+│   ├── manifest.json        # uni-app 平台配置
+│   ├── module-manifest.ts   # 唯一模块清单
+│   └── pages.json           # 固定 bootstrap 路由
+├── index.html               # H5 HTML 入口
+├── package.json             # 宿主命令和运行依赖
+└── vite.config.ts           # 模块页面装配与 uni-app 插件
+```
+
+## 模块装配
+
+`src/module-manifest.ts` 默认注册 core 和 system，并按声明顺序加载本地模块与已发布模块。业务页面、API 和状态应放在所属模块，宿主仅维护组合关系和平台配置。
+
+## 命令
+
+在 workspace 根目录执行：
+
+```bash
+pnpm dev:h5
+pnpm dev:mp-weixin
+pnpm build:h5
+pnpm build:mp-weixin
+```

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

@@ -0,0 +1,22 @@
+# @local/__MODULE_NAME__
+
+`@local/__MODULE_NAME__` 是 `__PROJECT_NAME__` workspace 内的本地业务模块，通过 `@liujitcn/kratos-uni-app-core` 的公开接口接入宿主。
+
+## 目录结构
+
+```text
+packages/modules/__MODULE_NAME__
+├── src
+│   ├── views               # 模块页面；页面私有组件放在就近 components
+│   ├── index.d.mts         # 模块入口类型
+│   └── index.mjs           # 页面、视图键和图标注册入口
+├── package.json            # 模块名称、依赖和 exports
+└── README.md               # 模块职责与维护说明
+```
+
+## 开发约束
+
+- 页面放在 `src/views`，并在 `src/index.mjs` 的模块定义中登记页面和稳定视图键。
+- 请求、认证、导航和状态能力只通过 `@liujitcn/kratos-uni-app-core` 的公开 exports 使用。
+- 页面替换使用稳定视图键，接口不能直接下发任意组件路径。
+- 修改模块后从 workspace 根目录运行对应 H5 或微信小程序命令验证装配结果。

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

@@ -0,0 +1,32 @@
+# __PROJECT_NAME__
+
+`__PROJECT_NAME__` 是由 `@liujitcn/kratos-uni-app-cli` 创建的独立 pnpm workspace，支持 H5 和微信小程序。
+
+## 目录结构
+
+```text
+__PROJECT_NAME__
+├── apps/uni-app          # 私有 uni-app 宿主
+├── packages/modules     # workspace 内本地业务模块
+├── package.json         # 公共命令和开发依赖
+├── pnpm-workspace.yaml  # workspace 包范围
+└── tsconfig.json        # 共享 TypeScript 配置
+```
+
+宿主只负责入口、manifest、模块清单和启动；底座能力由 `@liujitcn/kratos-uni-app-core` 提供，默认业务页面由 `@liujitcn/kratos-uni-app-system` 提供。本地模块通过各自公开入口接入，不跨包相对引用源码。
+
+## 开发
+
+```bash
+pnpm install
+pnpm dev:h5
+pnpm dev:mp-weixin
+pnpm build:h5
+pnpm build:mp-weixin
+```
+
+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`。
+
+模块装配入口是 `apps/uni-app/src/module-manifest.ts`。新增、删除或调整模块时同步维护该清单，并在模块自己的 README 中记录页面和接口职责。
+
+生产构建前请在 `.env.production` 中填写实际 API 和静态资源地址；该文件默认留空，不应使用本机地址。

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 appRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
 const coreRoot = resolve(appRoot, 'packages/core')
@@ -30,7 +31,7 @@ for (const packageFile of packageFiles) {
         ? resolve(packageRoot, prefix)
         : resolve(packageRoot, target)
       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(`uni-app 公开包版本必须保持一致：${versions}`)
+    .join(workspaceMessage('list_separator'))
+  throw new Error(workspaceMessage('public_version_mismatch', { versions }))
 }
 
 for (const sourceFile of allFiles.filter((file) => sourceExtensions.has(extname(file)))) {
@@ -52,13 +53,16 @@ for (const sourceFile of allFiles.filter((file) => sourceExtensions.has(extname(
     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}`,
+        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}`,
+        workspaceMessage('system_alias_forbidden', {
+          location: format(sourceFile, line),
+          specifier,
+        }),
       )
       continue
     }
@@ -66,7 +70,12 @@ for (const sourceFile of allFiles.filter((file) => sourceExtensions.has(extname(
       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
     }
@@ -80,7 +89,11 @@ for (const sourceFile of allFiles.filter((file) => sourceExtensions.has(extname(
       .exportEntries.some(([pattern]) => matchExportPattern(pattern, subpath))
     if (!exported) {
       violations.push(
-        `${format(sourceFile, line)}: ${specifier} 未在 ${packageName} exports 中公开`,
+        workspaceMessage('export_not_public', {
+          location: format(sourceFile, line),
+          specifier,
+          packageName,
+        }),
       )
     }
   }
@@ -88,11 +101,17 @@ for (const sourceFile of allFiles.filter((file) => sourceExtensions.has(extname(
 
 if (violations.length) {
   console.error(
-    `uni-app package exports 检查失败：\n${violations.map((item) => `  ${item}`).join('\n')}`,
+    workspaceMessage('exports_check_failed', {
+      violations: violations.map((item) => `  ${item}`).join('\n'),
+    }),
   )
   process.exit(1)
 }
-console.log(`uni-app 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,52 @@
+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: 'uni-app 公开包版本必须保持一致：{versions}',
+    core_alias_forbidden: '{location}: 非 core 代码不得使用 core 私有别名 {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 包目录异常',
+    system_dir_unexpected: '{packageName}: system 包目录异常',
+    exports_check_failed: 'uni-app package exports 检查失败：\n{violations}',
+    exports_check_passed: 'uni-app 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: 'uni-app public package versions must match: {versions}',
+    core_alias_forbidden:
+      '{location}: Core private aliases cannot be used outside core: {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',
+    system_dir_unexpected: '{packageName}: unexpected system package directory',
+    exports_check_failed: 'uni-app package exports check failed:\n{violations}',
+    exports_check_passed: 'uni-app 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')
@@ -15,21 +16,23 @@ for (const entry of existsSync(modulesRoot)
     .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 (!locales.includes('zh-CN')) {
+    throw new Error(workspaceMessage('missing_default_locale', { module: entry.name }))
+  }
   if (expectedLocales && locales.join(',') !== expectedLocales)
-    throw new Error(`${entry.name} 语言集合不一致`)
+    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}`)
+        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} 语言键集合不一致`)
+      throw new Error(workspaceMessage('key_set_mismatch', { module: entry.name, locale }))
   }
   // 模块在 Vite 配置阶段由 Node 直接加载，使用无需 TS/JSON loader 的原生 ESM。
   const content = [
@@ -42,5 +45,5 @@ for (const entry of existsSync(modulesRoot)
   const file = resolve(directory, 'generated.mjs')
   if (write) writeFileSync(file, content)
   else if (!existsSync(file) || readFileSync(file, 'utf8') !== content)
-    throw new Error(`语言注册产物过期：${file}，请执行 pnpm i18n:sync`)
+    throw new Error(workspaceMessage('bundle_outdated', { file }))
 }