@liujitcn/kratos-taro-app-cli 0.0.36 → 0.0.38

package/README.md

@@ -25,3 +25,14 @@ JavaScript 调用方也可以直接使用 `scaffoldKratosTaroApp(target, options
 在 Taro workspace 根目录执行 `pnpm test` 会实际打包、解压并运行包内 CLI，核对生成的
 图标内容和本地业务模块，避免只测试源码而遗漏 npm 发布资源。打包产物和生成项目均位于
 临时目录，测试结束后自动清理。
+
+
+### 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/package.json

@@ -7,7 +7,7 @@
     "type": "git",
     "url": "git@github.com:liujitcn/kratos-admin.git"
   },
-  "version": "0.0.36",
+  "version": "0.0.38",
   "type": "module",
   "bin": {
     "kratos-taro-app": "./bin/kratos-taro-app.mjs"
@@ -20,7 +20,8 @@
     "assets",
     "bin",
     "src",
-    "README.md"
+    "README.md",
+    "templates"
   ],
   "publishConfig": {
     "access": "public"

package/src/index.mjs

@@ -1,4 +1,5 @@
-import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { execFileSync } from 'node:child_process'
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { basename, resolve } from 'node:path'
 
 const cliPackage = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
@@ -33,44 +34,6 @@ export function scaffoldKratosTaroApp(targetPath, options = {}) {
     'node_modules\ndist\n.kratos-taro-app-pages-state.json\n.kratos-taro-app-pages-state.json.*\napps/taro-app/src/pages/*\n!apps/taro-app/src/pages/bootstrap/\n!apps/taro-app/src/pages/bootstrap/**\napps/taro-app/src/pages?*/\n',
   )
   write(target, 'pnpm-workspace.yaml', 'packages:\n  - apps/*\n  - packages/modules/*\n')
-  write(
-    target,
-    'package.json',
-    json({
-      name: projectName,
-      description: `Independent pnpm workspace for ${projectName}.`,
-      private: true,
-      packageManager: 'pnpm@10.13.1',
-      scripts: {
-        'prepare:modules':
-          "pnpm --recursive --filter './packages/modules/**' --if-present run build:entries",
-        'dev:h5': 'pnpm prepare:modules && pnpm --filter @local/kratos-taro-app dev:h5',
-        'dev:mp-weixin':
-          'pnpm prepare:modules && pnpm --filter @local/kratos-taro-app dev:mp-weixin',
-        'build:h5': 'pnpm prepare:modules && pnpm --filter @local/kratos-taro-app build:h5',
-        'build:mp-weixin':
-          'pnpm prepare:modules && pnpm --filter @local/kratos-taro-app build:mp-weixin',
-        tsc: 'pnpm --recursive --if-present run tsc',
-      },
-      devDependencies: {
-        '@babel/core': '7.28.4',
-        '@babel/preset-react': '7.28.5',
-        '@types/node': '20.19.9',
-        '@types/react': '18.3.23',
-        '@types/react-dom': '18.3.7',
-        'babel-preset-taro': taroVersion,
-        'cross-env': '7.0.3',
-        esbuild: '0.25.8',
-        sass: '1.89.2',
-        'tsconfig-paths-webpack-plugin': '4.2.0',
-        typescript: '5.8.3',
-        webpack: '5.91.0',
-      },
-      pnpm: {
-        onlyBuiltDependencies: ['@swc/core', '@tarojs/binding', 'esbuild'],
-      },
-    }),
-  )
   write(
     target,
     'tsconfig.json',
@@ -91,14 +54,17 @@ export function scaffoldKratosTaroApp(targetPath, options = {}) {
     }),
   )
   writeWorkspaceReadme(target, projectName)
+  renderWorkspaceTemplates(new URL('../templates/workspace/', import.meta.url), target, { __PROJECT_NAME__: projectName })
   writeEnvironmentFiles(target)
-  writeHost(target, projectName, modules, packages)
+  writeHost(target, projectName, modules, packages, options)
   write(target, 'apps/taro-app/src/static/h5-root-font.js', `${h5RootFontSource}\n`)
   copyFileSync(
     new URL('../assets/favicon.ico', import.meta.url),
     resolve(target, 'apps/taro-app/src/static/favicon.ico'),
   )
   modules.forEach((name) => writeLocalModule(target, projectName, name))
+  modules.forEach((name) => writeModuleLocales(target, name))
+  execFileSync(process.execPath, [resolve(target, 'scripts/sync-locales.mjs'), '--write'], { stdio: 'inherit' })
   return target
 }
 
@@ -115,7 +81,7 @@ export async function run(args = process.argv.slice(2)) {
   }
   const modules = readOptions(args.slice(2), '--module')
   const packages = readOptions(args.slice(2), '--with')
-  const target = scaffoldKratosTaroApp(targetPath, { modules, packages })
+  const target = scaffoldKratosTaroApp(targetPath, { modules, packages, kratosProject: args.includes('--kratos-project') })
   process.stdout.write(`已创建 Taro workspace：${target}\n`)
 }
 
@@ -183,7 +149,8 @@ function writeEnvironmentFiles(target) {
   )
 }
 
-function writeHost(target, projectName, modules, packages) {
+/** 生成 Taro 宿主与平台构建配置。 */
+function writeHost(target, projectName, modules, packages, options) {
   const localDependencies = Object.fromEntries(
     modules.map((name) => [`@local/${name}`, 'workspace:*']),
   )
@@ -202,7 +169,7 @@ function writeHost(target, projectName, modules, packages) {
         'dev:mp-weixin':
           'cross-env NODE_ENV=development node scripts/run-taro.mjs --type weapp --watch --mode development',
         'build:h5':
-          'cross-env KRATOS_TARO_OUTPUT_ROOT=dist/build/h5 node scripts/run-taro.mjs --type h5 --mode production',
+          `cross-env KRATOS_TARO_OUTPUT_ROOT=${options.kratosProject ? '../../../../backend/data/taro-app' : 'dist/build/h5'} node scripts/run-taro.mjs --type h5 --mode production`,
         'build:mp-weixin':
           'cross-env KRATOS_TARO_OUTPUT_ROOT=dist/build/mp-weixin node scripts/run-taro.mjs --type weapp --mode production',
         tsc: 'tsc --noEmit -p tsconfig.json',
@@ -260,19 +227,6 @@ function writeHost(target, projectName, modules, packages) {
 }
 `,
   )
-  write(
-    target,
-    'apps/taro-app/tsconfig.json',
-    json({
-      extends: '../../tsconfig.json',
-      compilerOptions: {
-        baseUrl: '.',
-        paths: { '@/*': ['src/*'] },
-        types: ['node', '@tarojs/taro', '@tarojs/components'],
-      },
-      include: ['src', 'config', 'types'],
-    }),
-  )
   write(target, 'apps/taro-app/config/dev.ts', platformConfig(true))
   write(target, 'apps/taro-app/config/prod.ts', platformConfig(false))
   const modulePackages = [
@@ -343,22 +297,6 @@ function writeHost(target, projectName, modules, packages) {
     'apps/taro-app/src/app.scss',
     "@use '@liujitcn/kratos-taro-app-ui/styles/theme.scss';\n@use '@liujitcn/kratos-taro-app-core/styles/base.scss';\n",
   )
-  write(
-    target,
-    'apps/taro-app/src/app.tsx',
-    `import type { PropsWithChildren } from 'react'
-import { useLaunch } from '@tarojs/taro'
-import { bootstrapKratosTaroApp } from '@liujitcn/kratos-taro-app-core'
-import { moduleManifest } from './module-manifest'
-import './app.scss'
-
-/** Taro 宿主根组件。 */
-export default function App({ children }: PropsWithChildren) {
-  useLaunch(() => bootstrapKratosTaroApp({ modules: moduleManifest }))
-  return children
-}
-`,
-  )
   write(target, 'apps/taro-app/src/module-manifest.ts', moduleManifest(modules, packages))
   write(
     target,
@@ -387,6 +325,7 @@ export default function BootstrapPage() {
   )
 }
 
+/** 生成本地 Taro 模块与独立构建入口。 */
 function writeLocalModule(target, projectName, name) {
   const identifier = `${toCamelCase(name)}Module`
   write(
@@ -409,6 +348,7 @@ function writeLocalModule(target, projectName, name) {
         './package.json': './package.json',
       },
       scripts: {
+        build: 'pnpm build:entries && pnpm pack --pack-destination ../../../dist/npm',
         'build:entries':
           'esbuild src/build.ts --bundle --platform=node --format=esm --packages=external --outfile=dist/build.mjs',
         tsc: 'tsc --noEmit -p tsconfig.json',
@@ -457,12 +397,14 @@ export const ${toCamelCase(name)}Pages: Record<string, KratosTaroPageConfig> = {
     `packages/modules/${name}/src/index.ts`,
     `import { defineKratosTaroModule } from '@liujitcn/kratos-taro-app-core'
 import { ${toCamelCase(name)}Pages } from './pages'
+import { LOCALE_MESSAGES } from './locales/generated'
 
 /** ${name} 业务模块。 */
 export const ${identifier} = defineKratosTaroModule({
   name: '@local/${name}',
   pages: ${toCamelCase(name)}Pages,
   views: {},
+  messages: LOCALE_MESSAGES,
 })
 `,
   )
@@ -486,17 +428,18 @@ export const buildModule = defineKratosTaroBuildModule({
   )
 }
 
+/** 生成模块清单，导入别名避免本地 system 与内置模块重名。 */
 function moduleManifest(modules, packages) {
   const imports = [
     "import { coreModule } from '@liujitcn/kratos-taro-app-core'",
     "import { systemModule } from '@liujitcn/kratos-taro-app-system'",
-    ...modules.map((name) => `import { ${toCamelCase(name)}Module } from '@local/${name}'`),
+    ...modules.map((name, index) => `import { ${toCamelCase(name)}Module as localModule${index} } from '@local/${name}'`),
     ...packages.map((name, index) => `import packageModule${index} from '${name}'`),
   ]
   const members = [
     'coreModule',
     'systemModule',
-    ...modules.map((name) => `${toCamelCase(name)}Module`),
+    ...modules.map((_, index) => `localModule${index}`),
     ...packages.map((_, index) => `packageModule${index}`),
   ]
   return `${imports.join('\n')}\n\n/** 宿主唯一模块清单，顺序决定静态视图覆盖优先级。 */\nexport const moduleManifest = [${members.join(', ')}]\n`
@@ -649,10 +592,12 @@ export default ${JSON.stringify(
 `
 }
 
+/** 读取重复模块参数并识别项目集成开关。 */
 function readOptions(args, option) {
   const values = []
   for (let index = 0; index < args.length; index += 1) {
     const argument = args[index]
+    if (argument === '--kratos-project') continue
     if (argument !== '--module' && argument !== '--with') {
       throw new Error(`未知参数：${argument}`)
     }
@@ -674,9 +619,9 @@ function validateProjectName(name) {
   if (!/^[a-z][a-z0-9-]*$/.test(name)) throw new Error(`项目名必须使用 kebab-case：${name}`)
 }
 
+/** 校验本地业务模块名称。 */
 function validateModuleName(name) {
   if (!/^[a-z][a-z0-9-]*$/.test(name)) throw new Error(`模块名无效：${name}`)
-  if (name === 'system') throw new Error('模块名不能使用保留名称：system')
 }
 
 function validatePackageName(name) {
@@ -710,3 +655,28 @@ function printHelp() {
     ].join('\n'),
   )
 }
+
+/** 渲染随 CLI 发布的宿主与工具链模板。 */
+function renderWorkspaceTemplates(source, target, tokens) {
+  for (const entry of readdirSync(source, { withFileTypes: true })) {
+    const input = new URL(entry.name + (entry.isDirectory() ? '/' : ''), source)
+    const output = resolve(target, entry.name)
+    if (entry.isDirectory()) {
+      mkdirSync(output, { recursive: true })
+      renderWorkspaceTemplates(input, output, tokens)
+    } else {
+      const content = Object.entries(tokens).reduce((value, [key, replacement]) => value.replaceAll(key, replacement), readFileSync(input, 'utf8'))
+      writeFileSync(output, content)
+    }
+  }
+}
+
+/** 创建业务模块语言源文件及 API、RPC、测试目录，注册产物由同步命令生成。 */
+function writeModuleLocales(target, name) {
+  for (const directory of ['src/api', 'src/rpc', 'test']) {
+    write(target, `packages/modules/${name}/${directory}/.gitkeep`, '')
+  }
+  for (const locale of ['zh-CN', 'en-US', 'zh-TW', 'ja-JP']) {
+    write(target, `packages/modules/${name}/src/locales/${locale}.json`, '{}\n')
+  }
+}

package/templates/workspace/.eslintrc.cjs

@@ -0,0 +1,19 @@
+module.exports = {
+  root: true,
+  extends: ['taro/react'],
+  parserOptions: {
+    project: false,
+    requireConfigFile: false,
+  },
+  rules: {
+    'react/react-in-jsx-scope': 'off',
+  },
+  ignorePatterns: [
+    '**/dist/**',
+    '**/src/rpc/**',
+    'node_modules/**',
+    'apps/taro-app/src/pages/**',
+    '!apps/taro-app/src/pages/bootstrap/**',
+    'apps/taro-app/src/pagesMember/**',
+  ],
+}

package/templates/workspace/apps/taro-app/src/app.tsx

@@ -0,0 +1,19 @@
+import type { PropsWithChildren } from 'react'
+import { useDidHide, useDidShow, useLaunch } from '@tarojs/taro'
+import { bootstrapKratosTaroApp } from '@liujitcn/kratos-taro-app-core'
+import {
+  pauseNotificationPolling,
+  resumeNotificationPolling,
+} from '@liujitcn/kratos-taro-app-system'
+import { moduleManifest } from './module-manifest'
+import './app.scss'
+
+/** Taro 宿主根组件。 */
+export default function App({ children }: PropsWithChildren) {
+  useLaunch(() => {
+    bootstrapKratosTaroApp({ modules: moduleManifest })
+  })
+  useDidShow(() => resumeNotificationPolling())
+  useDidHide(() => pauseNotificationPolling())
+  return children
+}

package/templates/workspace/apps/taro-app/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": { "@/*": ["src/*"] },
+    "types": ["node", "@tarojs/taro", "@tarojs/components"],
+    "allowImportingTsExtensions": true,
+    "noEmit": true
+  },
+  "include": ["src", "config", "types"]
+}

package/templates/workspace/apps/taro-app/types/assets.d.ts

@@ -0,0 +1,5 @@
+// Taro 构建器将 PNG 资源导入转换为可访问的图片地址。
+declare module '*.png' {
+  const url: string;
+  export default url;
+}

package/templates/workspace/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "__PROJECT_NAME__",
+  "description": "Independent pnpm workspace for __PROJECT_NAME__.",
+  "private": true,
+  "packageManager": "pnpm@10.13.1",
+  "scripts": {
+    "prepare:modules": "pnpm --recursive --filter './packages/modules/**' --if-present run build:entries",
+    "dev:h5": "pnpm prepare:modules && pnpm --filter @local/kratos-taro-app dev:h5",
+    "dev:mp-weixin": "pnpm prepare:modules && pnpm --filter @local/kratos-taro-app dev:mp-weixin",
+    "build:h5": "pnpm prepare:modules && pnpm --filter @local/kratos-taro-app build:h5",
+    "build:mp-weixin": "pnpm prepare:modules && pnpm --filter @local/kratos-taro-app build:mp-weixin",
+    "tsc": "pnpm --recursive --if-present run tsc",
+    "test": "node --test",
+    "build:packages": "pnpm --recursive --filter './packages/modules/**' run build",
+    "check:exports": "pnpm run prepare:modules && node scripts/check-package-exports.mjs",
+    "lint": "eslint . --fix --ext .js,.mjs,.ts,.tsx",
+    "i18n:sync": "node scripts/sync-locales.mjs --write",
+    "i18n:check": "node scripts/sync-locales.mjs"
+  },
+  "devDependencies": {
+    "@babel/core": "7.28.4",
+    "@babel/preset-react": "7.28.5",
+    "@types/node": "20.19.9",
+    "@types/react": "18.3.23",
+    "@types/react-dom": "18.3.7",
+    "babel-preset-taro": "4.2.1",
+    "cross-env": "7.0.3",
+    "esbuild": "0.25.8",
+    "sass": "1.89.2",
+    "tsconfig-paths-webpack-plugin": "4.2.0",
+    "typescript": "5.8.3",
+    "webpack": "5.91.0",
+    "@tarojs/plugin-platform-h5": "4.2.1",
+    "@tarojs/plugin-platform-weapp": "4.2.1",
+    "eslint": "8.57.1",
+    "eslint-config-taro": "4.2.1",
+    "eslint-plugin-react": "7.37.5",
+    "eslint-plugin-react-hooks": "4.6.2",
+    "less": "4.8.1",
+    "prettier": "3.6.2",
+    "ts-proto": "2.7.7",
+    "turbo": "2.5.5"
+  },
+  "pnpm": {
+    "overrides": {
+      "swiper": "12.1.2",
+      "tmp": "0.2.6"
+    },
+    "onlyBuiltDependencies": [
+      "@swc/core",
+      "@tarojs/binding",
+      "@tarojs/cli",
+      "esbuild"
+    ],
+    "ignoredBuiltDependencies": [
+      "@nutui/nutui-react-taro",
+      "@parcel/watcher",
+      "core-js",
+      "core-js-pure"
+    ],
+    "auditConfig": {
+      "ignoreCves": [
+        "CVE-2022-25900",
+        "CVE-2024-29415",
+        "CVE-2025-25975",
+        "CVE-2022-37620",
+        "CVE-2026-53486",
+        "CVE-2026-10732",
+        "CVE-2025-71330",
+        "CVE-2025-71329",
+        "CVE-2026-39243"
+      ]
+    }
+  }
+}

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

@@ -0,0 +1,152 @@
+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'
+
+const workspaceRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const coreRoot = resolve(workspaceRoot, 'packages/core')
+const uiRoot = resolve(workspaceRoot, 'packages/ui')
+const systemRoot = resolve(workspaceRoot, 'packages/modules/system')
+const ignoredDirectories = new Set(['.git', '.turbo', 'dist', 'node_modules'])
+const sourceExtensions = new Set(['.js', '.mjs', '.ts', '.tsx'])
+const allFiles = await collectFiles(workspaceRoot)
+const packageFiles = allFiles.filter((file) => file.endsWith(`${sep}package.json`))
+const packages = new Map()
+const publicPackageVersions = new Map()
+const violations = []
+
+for (const packageFile of packageFiles) {
+  const metadata = JSON.parse(await readFile(packageFile, 'utf8'))
+  if (!metadata.name || !metadata.exports) continue
+  if (!metadata.private) {
+    publicPackageVersions.set(metadata.name, metadata.version)
+
+  }
+  const packageRoot = dirname(packageFile)
+  const exportEntries = Object.entries(metadata.exports)
+  packages.set(metadata.name, { packageRoot, exportEntries })
+  for (const [, value] of exportEntries) {
+    for (const target of collectTargets(value)) {
+      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}`)
+      }
+    }
+  }
+}
+
+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}`)
+}
+
+for (const sourceFile of allFiles.filter((file) => sourceExtensions.has(extname(file)))) {
+  if (sourceFile.includes(`${sep}src${sep}rpc${sep}`)) continue
+  const source = await readFile(sourceFile, 'utf8')
+  for (const imported of ts.preProcessFile(source, true, true).importedFiles) {
+    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}`,
+      )
+      continue
+    }
+    if (specifier.startsWith('@system/') && !isWithin(sourceFile, systemRoot)) {
+      violations.push(
+        `${format(sourceFile, line)}: 非 system 代码不得使用 system 私有别名 ${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}`)
+      }
+      continue
+    }
+    const packageName = [...packages.keys()].find(
+      (name) => specifier === name || specifier.startsWith(`${name}/`),
+    )
+    if (!packageName) continue
+    const subpath = specifier === packageName ? '.' : `./${specifier.slice(packageName.length + 1)}`
+    const exported = packages
+      .get(packageName)
+      .exportEntries.some(([pattern]) => matchExportPattern(pattern, subpath))
+    if (!exported) {
+      violations.push(
+        `${format(sourceFile, line)}: ${specifier} 未在 ${packageName} exports 中公开`,
+      )
+    }
+  }
+}
+
+for (const [packageName, { packageRoot }] of packages) {
+  if (packageName === '@liujitcn/kratos-taro-app-core' && packageRoot !== coreRoot) {
+    violations.push(`${packageName}: core 包目录异常`)
+  }
+  if (packageName === '@liujitcn/kratos-taro-app-ui' && packageRoot !== uiRoot) {
+    violations.push(`${packageName}: UI 包目录异常`)
+  }
+  if (packageName === '@liujitcn/kratos-taro-app-system' && packageRoot !== systemRoot) {
+    violations.push(`${packageName}: system 包目录异常`)
+  }
+}
+
+if (violations.length) {
+  console.error(
+    `Taro package exports 检查失败：\n${violations.map((item) => `  ${item}`).join('\n')}`,
+  )
+  process.exit(1)
+}
+console.log(`Taro package exports 检查通过（${[...packages.keys()].join('、')}）`)
+
+async function collectFiles(directory) {
+  const files = []
+  for (const entry of await readdir(directory, { withFileTypes: true })) {
+    if (entry.isDirectory() && ignoredDirectories.has(entry.name)) continue
+    const path = resolve(directory, entry.name)
+    if (entry.isDirectory()) files.push(...(await collectFiles(path)))
+    else files.push(path)
+  }
+  return files
+}
+
+function collectTargets(value) {
+  if (typeof value === 'string') return [value]
+  if (!value || typeof value !== 'object') return []
+  return Object.values(value).flatMap(collectTargets)
+}
+
+async function pathExists(path) {
+  try {
+    await stat(path)
+    return true
+  } catch {
+    return false
+  }
+}
+
+function matchExportPattern(pattern, subpath) {
+  if (!pattern.includes('*')) return pattern === subpath
+  const escaped = pattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&').replace('\\*', '.+')
+  return new RegExp(`^${escaped}$`).test(subpath)
+}
+
+function findPackageByPath(file) {
+  return [...packages.values()].find(({ packageRoot }) => isWithin(file, packageRoot))
+}
+
+function isWithin(file, directory) {
+  const path = relative(directory, file)
+  return path === '' || (!path.startsWith('..') && !path.startsWith(sep))
+}
+
+function format(file, line) {
+  return `${relative(workspaceRoot, file)}:${line}`
+}

package/templates/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`)
+}