@liujitcn/kratos-taro-app-core 0.0.61 → 0.0.64

package/README.md

@@ -20,7 +20,7 @@
 
 - `@liujitcn/kratos-taro-app-core`：启动、模块、导航、状态和常用工具，包含动态路径使用的 `resolveBundledAsset()`。
 - `@liujitcn/kratos-taro-app-core/static/*`：页面图片等可由 Webpack 静态分析的打包资源。
-- `@liujitcn/kratos-taro-app-core/build`：构建期模块描述。
+- `@liujitcn/kratos-taro-app-core/build`：构建期模块描述和双语构建错误文案格式化器。
 - `@liujitcn/kratos-taro-app-core/runner`：Taro 构建装配入口。
 - `api/*`、`components/*`、`rpc/*`、`styles/*`、`utils/*`、`views/*`：白名单子路径。
 

package/dist/build.mjs

@@ -22,6 +22,42 @@ var corePages = {
   }
 };
 
+// src/runner-messages.ts
+var messages = {
+  "zh-CN": {
+    https_certificate_missing: "VITE_APP_HTTPS \u5DF2\u5F00\u542F\uFF0C\u4F46\u672A\u627E\u5230\u8BC1\u4E66\u6587\u4EF6\uFF0C\u8BF7\u5148\u5728\u4ED3\u5E93\u6839\u76EE\u5F55\u8FD0\u884C scripts/generate-dev-cert.sh\uFF1B\u671F\u671B\u8DEF\u5F84\uFF1A{keyPath} \u548C {certPath}",
+    project_name: "\u901A\u7528\u5E94\u7528",
+    unsupported_type: "\u4E0D\u652F\u6301\u7684 Taro \u7C7B\u578B\uFF1A{value}",
+    unknown_argument: "\u672A\u77E5\u53C2\u6570\uFF1A{argument}",
+    type_required: "\u7F3A\u5C11 --type h5|weapp",
+    manifest_missing: "\u6A21\u5757\u6E05\u5355\u672A\u5BFC\u51FA moduleManifest\uFF1A{file}",
+    static_import_missing: "\u6A21\u5757 {name} \u7F3A\u5C11\u9759\u6001 import",
+    build_export_missing: "{packageName}/build \u672A\u5BFC\u51FA buildModule",
+    transaction_mismatch: "Taro \u6784\u5EFA\u4E8B\u52A1\u76EE\u5F55\u4E0D\u5339\u914D\uFF1A{file}",
+    assembly_timeout: "\u7B49\u5F85 Taro \u9875\u9762\u88C5\u914D\u9501\u8D85\u65F6\uFF1A{file}"
+  },
+  "en-US": {
+    https_certificate_missing: "VITE_APP_HTTPS is enabled, but certificate files were not found. Run scripts/generate-dev-cert.sh from the repository root; expected paths: {keyPath} and {certPath}",
+    project_name: "Generic app",
+    unsupported_type: "Unsupported Taro type: {value}",
+    unknown_argument: "Unknown argument: {argument}",
+    type_required: "Missing --type h5|weapp",
+    manifest_missing: "The module manifest does not export moduleManifest: {file}",
+    static_import_missing: "Module {name} is missing a static import",
+    build_export_missing: "{packageName}/build does not export buildModule",
+    transaction_mismatch: "Taro build transaction directory does not match: {file}",
+    assembly_timeout: "Timed out waiting for the Taro page assembly lock: {file}"
+  }
+};
+function resolveRunnerLocale() {
+  const value = process.env.KRATOS_ADMIN_LOCALE ?? process.env.LC_ALL ?? process.env.LANG ?? "";
+  return value.toLowerCase().startsWith("zh") ? "zh-CN" : "en-US";
+}
+function runnerMessage(key, params = {}) {
+  const template = messages[resolveRunnerLocale()][key] ?? messages["en-US"][key] ?? key;
+  return template.replace(/\{([A-Za-z0-9_]+)\}/g, (_, name) => params[name] ?? `{${name}}`);
+}
+
 // src/build.ts
 function defineKratosTaroBuildModule(module) {
   return module;
@@ -34,5 +70,6 @@ var buildModule = defineKratosTaroBuildModule({
 });
 export {
   buildModule,
-  defineKratosTaroBuildModule
+  defineKratosTaroBuildModule,
+  runnerMessage
 };

package/dist/runner.mjs

@@ -15,6 +15,44 @@ import { dirname, relative, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { spawn } from "node:child_process";
 import ts from "typescript";
+
+// src/runner-messages.ts
+var messages = {
+  "zh-CN": {
+    https_certificate_missing: "VITE_APP_HTTPS \u5DF2\u5F00\u542F\uFF0C\u4F46\u672A\u627E\u5230\u8BC1\u4E66\u6587\u4EF6\uFF0C\u8BF7\u5148\u5728\u4ED3\u5E93\u6839\u76EE\u5F55\u8FD0\u884C scripts/generate-dev-cert.sh\uFF1B\u671F\u671B\u8DEF\u5F84\uFF1A{keyPath} \u548C {certPath}",
+    project_name: "\u901A\u7528\u5E94\u7528",
+    unsupported_type: "\u4E0D\u652F\u6301\u7684 Taro \u7C7B\u578B\uFF1A{value}",
+    unknown_argument: "\u672A\u77E5\u53C2\u6570\uFF1A{argument}",
+    type_required: "\u7F3A\u5C11 --type h5|weapp",
+    manifest_missing: "\u6A21\u5757\u6E05\u5355\u672A\u5BFC\u51FA moduleManifest\uFF1A{file}",
+    static_import_missing: "\u6A21\u5757 {name} \u7F3A\u5C11\u9759\u6001 import",
+    build_export_missing: "{packageName}/build \u672A\u5BFC\u51FA buildModule",
+    transaction_mismatch: "Taro \u6784\u5EFA\u4E8B\u52A1\u76EE\u5F55\u4E0D\u5339\u914D\uFF1A{file}",
+    assembly_timeout: "\u7B49\u5F85 Taro \u9875\u9762\u88C5\u914D\u9501\u8D85\u65F6\uFF1A{file}"
+  },
+  "en-US": {
+    https_certificate_missing: "VITE_APP_HTTPS is enabled, but certificate files were not found. Run scripts/generate-dev-cert.sh from the repository root; expected paths: {keyPath} and {certPath}",
+    project_name: "Generic app",
+    unsupported_type: "Unsupported Taro type: {value}",
+    unknown_argument: "Unknown argument: {argument}",
+    type_required: "Missing --type h5|weapp",
+    manifest_missing: "The module manifest does not export moduleManifest: {file}",
+    static_import_missing: "Module {name} is missing a static import",
+    build_export_missing: "{packageName}/build does not export buildModule",
+    transaction_mismatch: "Taro build transaction directory does not match: {file}",
+    assembly_timeout: "Timed out waiting for the Taro page assembly lock: {file}"
+  }
+};
+function resolveRunnerLocale() {
+  const value = process.env.KRATOS_ADMIN_LOCALE ?? process.env.LC_ALL ?? process.env.LANG ?? "";
+  return value.toLowerCase().startsWith("zh") ? "zh-CN" : "en-US";
+}
+function runnerMessage(key, params = {}) {
+  const template = messages[resolveRunnerLocale()][key] ?? messages["en-US"][key] ?? key;
+  return template.replace(/\{([A-Za-z0-9_]+)\}/g, (_, name) => params[name] ?? `{${name}}`);
+}
+
+// src/runner.ts
 var sourceVersionCounter = 0;
 var PAGE_ASSEMBLY_WAIT_TIMEOUT_MS = 3e4;
 var PAGE_ASSEMBLY_POLL_INTERVAL_MS = 25;
@@ -113,7 +151,7 @@ function parseArguments(args) {
     const argument = args[index];
     if (argument === "--type") {
       const value = args[++index];
-      if (value !== "h5" && value !== "weapp") throw new Error(`\u4E0D\u652F\u6301\u7684 Taro \u7C7B\u578B\uFF1A${value}`);
+      if (value !== "h5" && value !== "weapp") throw new Error(runnerMessage("unsupported_type", { value }));
       type = value;
     } else if (argument === "--mode") {
       mode = args[++index] || mode;
@@ -124,10 +162,10 @@ function parseArguments(args) {
     } else if (argument === "--cleanup-only") {
       cleanupOnly = true;
     } else {
-      throw new Error(`\u672A\u77E5\u53C2\u6570\uFF1A${argument}`);
+      throw new Error(runnerMessage("unknown_argument", { argument }));
     }
   }
-  if (!type) throw new Error("\u7F3A\u5C11 --type h5|weapp");
+  if (!type) throw new Error(runnerMessage("type_required"));
   return { type, mode, watch, prepareOnly, cleanupOnly };
 }
 async function loadBuildModules(hostRoot, manifestFile) {
@@ -161,15 +199,15 @@ async function loadBuildModules(hostRoot, manifestFile) {
       }
     });
   });
-  if (!moduleNames.length) throw new Error(`\u6A21\u5757\u6E05\u5355\u672A\u5BFC\u51FA moduleManifest\uFF1A${manifestFile}`);
+  if (!moduleNames.length) throw new Error(runnerMessage("manifest_missing", { file: manifestFile }));
   const hostRequire = createRequire(resolve(hostRoot, "package.json"));
   return Promise.all(
     moduleNames.map(async (name) => {
       const packageName = imports.get(name);
-      if (!packageName) throw new Error(`\u6A21\u5757 ${name} \u7F3A\u5C11\u9759\u6001 import`);
+      if (!packageName) throw new Error(runnerMessage("static_import_missing", { name }));
       const buildEntry = hostRequire.resolve(`${packageName}/build`);
       const loaded = await import(pathToFileURL(buildEntry).href);
-      if (!loaded.buildModule) throw new Error(`${packageName}/build \u672A\u5BFC\u51FA buildModule`);
+      if (!loaded.buildModule) throw new Error(runnerMessage("build_export_missing", { packageName }));
       return loaded.buildModule;
     })
   );
@@ -263,7 +301,7 @@ function readBuildTransaction(transactionFile, inputDir, appConfigFile) {
   if (!existsSync(transactionFile)) return;
   const transaction = JSON.parse(readFileSync(transactionFile, "utf8"));
   if (transaction.inputDir !== inputDir || transaction.appConfigFile !== appConfigFile) {
-    throw new Error(`Taro \u6784\u5EFA\u4E8B\u52A1\u76EE\u5F55\u4E0D\u5339\u914D\uFF1A${transactionFile}`);
+    throw new Error(runnerMessage("transaction_mismatch", { file: transactionFile }));
   }
   return transaction;
 }
@@ -362,7 +400,7 @@ function acquirePageAssemblyLock(lockFile) {
         unlinkSync(lockFile);
         continue;
       }
-      if (Date.now() >= deadline) throw new Error(`\u7B49\u5F85 Taro \u9875\u9762\u88C5\u914D\u9501\u8D85\u65F6\uFF1A${lockFile}`);
+      if (Date.now() >= deadline) throw new Error(runnerMessage("assembly_timeout", { file: lockFile }));
       waitForPageAssembly(PAGE_ASSEMBLY_POLL_INTERVAL_MS);
     }
   }

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": [
     "dist",

package/src/bootstrap.ts

@@ -11,6 +11,7 @@ import {
 } from './stores'
 import {
   applyLanguageConfig,
+  getCurrentLocale,
   initializeLocale,
   registerLocaleChangeHandler,
   registerLocaleMessages,
@@ -33,6 +34,7 @@ function syncH5DocumentTitle(): void {
   const titleElement = document.querySelector('title')
   const appTitle = titleElement?.dataset.appTitle || t('core.home.main_title')
   const applyTitle = () => {
+    document.documentElement.lang = getCurrentLocale()
     if (document.title !== appTitle) document.title = appTitle
   }
   applyTitle()
@@ -50,6 +52,7 @@ export function bootstrapKratosTaroApp(options: KratosTaroBootstrapOptions): voi
     .OptionLanguage({})
     .then((response) => {
       applyLanguageConfig(response)
+      syncH5DocumentTitle()
     })
     .catch(() => {
       // 语言公共接口失败时继续使用静态语言包和系统语言。

package/src/build.ts

@@ -22,3 +22,5 @@ export const buildModule = defineKratosTaroBuildModule({
   root: packageRoot,
   pages: corePages,
 })
+
+export { runnerMessage } from './runner-messages.js'

package/src/locales/en-US.json

@@ -8,6 +8,7 @@
   "common.action.new": "New",
   "common.action.open_in_new_window": "Open in new window",
   "common.action.save": "Save",
+  "common.action.view": "View",
   "common.field.language": "Language",
   "common.language.en-US": "English",
   "common.language.zh-CN": "简体中文",

package/src/locales/index.ts

@@ -115,18 +115,18 @@ export function registerLocaleMessages(modules: KratosTaroModule[]): void {
     const expectedKeys = requiredLocaleKeys(module.messages?.[DEFAULT_LOCALE] || {})
     SUPPORTED_LOCALES.forEach((locale) => {
       const messages = module.messages?.[locale]
-      if (!messages) throw new Error(`${module.name} 缺少 ${locale} 语言包`)
+      if (!messages) throw new Error(localeRuntimeMessage('missing_bundle', { module: module.name, locale }))
       const keys = requiredLocaleKeys(messages)
       if (keys.join('\u0000') !== expectedKeys.join('\u0000')) {
-        throw new Error(`${module.name} 的 ${locale} 语言包键集合不一致`)
+        throw new Error(localeRuntimeMessage('key_set_mismatch', { module: module.name, locale }))
       }
       const target = defaultLocaleMessages.get(locale) as LocaleMessages
       Object.keys(messages).forEach((key) => {
         if (!isAllowedLocaleKey(module.name, key)) {
-          throw new Error(`${module.name} 的语言键命名空间无效: ${key}`)
+          throw new Error(localeRuntimeMessage('namespace_invalid', { module: module.name, key }))
         }
         if (Object.prototype.hasOwnProperty.call(target, key)) {
-          throw new Error(`${locale} 语言键重复: ${key}`)
+          throw new Error(localeRuntimeMessage('duplicate_key', { locale, key }))
         }
         assertLocalePlaceholders(module.name, key, messages[key], module.messages?.[DEFAULT_LOCALE]?.[key] || '')
         target[key] = messages[key]
@@ -212,10 +212,19 @@ function assertLocalePlaceholders(
   const placeholders = (value: string) =>
     [...value.matchAll(/\{([A-Za-z0-9_]+)\}/g)].map((match) => match[1]).sort()
   if (placeholders(message).join('\u0000') !== placeholders(sourceMessage).join('\u0000')) {
-    throw new Error(`${moduleName} 的 ${key} 占位符集合不一致`)
+    throw new Error(localeRuntimeMessage('placeholder_mismatch', { module: moduleName, key }))
   }
 }
 
+function localeRuntimeMessage(key: string, params: Record<string, string>): string {
+  const locale = getCurrentLocale().toLowerCase().startsWith('zh') ? 'zh-CN' : 'en-US'
+  const templates: Record<string, Record<string, string>> = {
+    'zh-CN': { missing_bundle: '{module} 缺少 {locale} 语言包', key_set_mismatch: '{module} 的 {locale} 语言包键集合不一致', namespace_invalid: '{module} 的语言键命名空间无效: {key}', duplicate_key: '{locale} 语言键重复: {key}', placeholder_mismatch: '{module} 的 {key} 占位符集合不一致' },
+    'en-US': { missing_bundle: '{module} is missing the {locale} locale bundle', key_set_mismatch: '{module} has inconsistent keys in the {locale} locale bundle', namespace_invalid: 'Invalid locale key namespace for {module}: {key}', duplicate_key: 'Duplicate locale key in {locale}: {key}', placeholder_mismatch: 'Placeholder set mismatch for {module}: {key}' },
+  }
+  return (templates[locale][key] ?? key).replace(/\{([A-Za-z0-9_]+)\}/g, (_, name: string) => params[name] ?? `{${name}}`)
+}
+
 function requiredLocaleKeys(messages: LocaleMessages): string[] {
   return Object.keys(messages)
     .filter((key) => !key.startsWith('common.language.'))

package/src/locales/ja-JP.json

@@ -8,6 +8,7 @@
   "common.action.new": "新規",
   "common.action.open_in_new_window": "新しいウィンドウが開きます",
   "common.action.save": "保存",
+  "common.action.view": "表示",
   "common.field.language": "言語",
   "common.language.en-US": "英語",
   "common.language.zh-CN": "簡体字中国語",

package/src/locales/zh-CN.json

@@ -8,6 +8,7 @@
   "common.action.new": "新建",
   "common.action.open_in_new_window": "新窗口打开",
   "common.action.save": "保存",
+  "common.action.view": "查看",
   "common.field.language": "语言",
   "common.language.en-US": "English",
   "common.language.zh-CN": "简体中文",

package/src/locales/zh-TW.json

@@ -8,6 +8,7 @@
   "common.action.new": "新建",
   "common.action.open_in_new_window": "新視窗開啟",
   "common.action.save": "儲存",
+  "common.action.view": "檢視",
   "common.field.language": "語言",
   "common.language.en-US": "English",
   "common.language.zh-CN": "簡體中文",

package/src/rpc/base/v1/oauth.ts

@@ -191,14 +191,30 @@ export interface UnbindOauthAccountRequest {
 export interface OauthProvider {
   /** 登录方式标识 */
   provider: string;
+  /** 登录方式名称 */
+  name: string;
+  /** 登录方式提示语 */
+  description: string;
+  /** 图标键或图片地址 */
+  icon: string;
+  /** Provider个性化配置JSON对象 */
+  config: { [key: string]: any } | undefined;
 }
 
 /** 个人中心三方账号绑定信息 */
 export interface OauthBinding {
   /** 登录方式标识 */
   provider: string;
+  /** 登录方式名称 */
+  name: string;
+  /** 登录方式提示语 */
+  description: string;
   /** 是否已绑定 */
   bound: boolean;
+  /** 图标键或图片地址 */
+  icon: string;
+  /** Provider个性化配置JSON对象 */
+  config: { [key: string]: any } | undefined;
 }
 
 /** Base三方登录公共服务 */

package/src/rpc/google/protobuf/struct.ts

@@ -0,0 +1,80 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.8
+//   protoc               unknown
+// source: google/protobuf/struct.proto
+
+/* eslint-disable */
+
+/**
+ * `NullValue` is a singleton enumeration to represent the null value for the
+ * `Value` type union.
+ *
+ * The JSON representation for `NullValue` is JSON `null`.
+ */
+export enum NullValue {
+  /** NULL_VALUE - Null value. */
+  NULL_VALUE = 0,
+}
+
+/**
+ * `Struct` represents a structured data value, consisting of fields
+ * which map to dynamically typed values. In some languages, `Struct`
+ * might be supported by a native representation. For example, in
+ * scripting languages like JS a struct is represented as an
+ * object. The details of that representation are described together
+ * with the proto support for the language.
+ *
+ * The JSON representation for `Struct` is JSON object.
+ */
+export interface Struct {
+  /** Unordered map of dynamically typed values. */
+  fields: Map<string, any | undefined>;
+}
+
+export interface Struct_FieldsEntry {
+  key: string;
+  value: any | undefined;
+}
+
+/**
+ * `Value` represents a dynamically typed value which can be either
+ * null, a number, a string, a boolean, a recursive struct value, or a
+ * list of values. A producer of value is expected to set one of these
+ * variants. Absence of any variant indicates an error.
+ *
+ * The JSON representation for `Value` is JSON value.
+ */
+export interface Value {
+  /** The kind of value. */
+  kind:
+    | //
+    /** Represents a null value. */
+    { $case: "null_value"; null_value: NullValue }
+    | //
+    /** Represents a double value. */
+    { $case: "number_value"; number_value: number }
+    | //
+    /** Represents a string value. */
+    { $case: "string_value"; string_value: string }
+    | //
+    /** Represents a boolean value. */
+    { $case: "bool_value"; bool_value: boolean }
+    | //
+    /** Represents a structured value. */
+    { $case: "struct_value"; struct_value: { [key: string]: any } | undefined }
+    | //
+    /** Represents a repeated `Value`. */
+    { $case: "list_value"; list_value: Array<any> | undefined }
+    | undefined;
+}
+
+/**
+ * `ListValue` is a wrapper around a repeated field of values.
+ *
+ * The JSON representation for `ListValue` is JSON array.
+ */
+export interface ListValue {
+  /** Repeated field of dynamically typed values. */
+  values: any[];
+}

package/src/runner-messages.ts

@@ -0,0 +1,40 @@
+type RunnerLocale = 'zh-CN' | 'en-US'
+
+const messages: Record<RunnerLocale, Record<string, string>> = {
+  'zh-CN': {
+    https_certificate_missing: 'VITE_APP_HTTPS 已开启，但未找到证书文件，请先在仓库根目录运行 scripts/generate-dev-cert.sh；期望路径：{keyPath} 和 {certPath}',
+    project_name: '通用应用',
+    unsupported_type: '不支持的 Taro 类型：{value}',
+    unknown_argument: '未知参数：{argument}',
+    type_required: '缺少 --type h5|weapp',
+    manifest_missing: '模块清单未导出 moduleManifest：{file}',
+    static_import_missing: '模块 {name} 缺少静态 import',
+    build_export_missing: '{packageName}/build 未导出 buildModule',
+    transaction_mismatch: 'Taro 构建事务目录不匹配：{file}',
+    assembly_timeout: '等待 Taro 页面装配锁超时：{file}',
+  },
+  'en-US': {
+    https_certificate_missing: 'VITE_APP_HTTPS is enabled, but certificate files were not found. Run scripts/generate-dev-cert.sh from the repository root; expected paths: {keyPath} and {certPath}',
+    project_name: 'Generic app',
+    unsupported_type: 'Unsupported Taro type: {value}',
+    unknown_argument: 'Unknown argument: {argument}',
+    type_required: 'Missing --type h5|weapp',
+    manifest_missing: 'The module manifest does not export moduleManifest: {file}',
+    static_import_missing: 'Module {name} is missing a static import',
+    build_export_missing: '{packageName}/build does not export buildModule',
+    transaction_mismatch: 'Taro build transaction directory does not match: {file}',
+    assembly_timeout: 'Timed out waiting for the Taro page assembly lock: {file}',
+  },
+}
+
+/** 根据环境变量选择 Taro 构建器错误语言。 */
+function resolveRunnerLocale(): RunnerLocale {
+  const value = process.env.KRATOS_ADMIN_LOCALE ?? process.env.LC_ALL ?? process.env.LANG ?? ''
+  return value.toLowerCase().startsWith('zh') ? 'zh-CN' : 'en-US'
+}
+
+/** 渲染 Taro 构建器稳定错误文案。 */
+export function runnerMessage(key: string, params: Record<string, string> = {}): string {
+  const template = messages[resolveRunnerLocale()][key] ?? messages['en-US'][key] ?? key
+  return template.replace(/\{([A-Za-z0-9_]+)\}/g, (_, name: string) => params[name] ?? `{${name}}`)
+}

package/src/runner.ts

@@ -15,6 +15,7 @@ import { pathToFileURL } from 'node:url'
 import { spawn } from 'node:child_process'
 import ts from 'typescript'
 import type { KratosTaroBuildModule } from './build'
+import { runnerMessage } from './runner-messages.js'
 
 type PageEntry = {
   route: string
@@ -158,7 +159,7 @@ function parseArguments(args: string[]): CliOptions {
     const argument = args[index]
     if (argument === '--type') {
       const value = args[++index]
-      if (value !== 'h5' && value !== 'weapp') throw new Error(`不支持的 Taro 类型：${value}`)
+      if (value !== 'h5' && value !== 'weapp') throw new Error(runnerMessage('unsupported_type', { value }))
       type = value
     } else if (argument === '--mode') {
       mode = args[++index] || mode
@@ -169,10 +170,10 @@ function parseArguments(args: string[]): CliOptions {
     } else if (argument === '--cleanup-only') {
       cleanupOnly = true
     } else {
-      throw new Error(`未知参数：${argument}`)
+      throw new Error(runnerMessage('unknown_argument', { argument }))
     }
   }
-  if (!type) throw new Error('缺少 --type h5|weapp')
+  if (!type) throw new Error(runnerMessage('type_required'))
   return { type, mode, watch, prepareOnly, cleanupOnly }
 }
 
@@ -217,18 +218,18 @@ async function loadBuildModules(
       }
     })
   })
-  if (!moduleNames.length) throw new Error(`模块清单未导出 moduleManifest：${manifestFile}`)
+  if (!moduleNames.length) throw new Error(runnerMessage('manifest_missing', { file: manifestFile }))
 
   const hostRequire = createRequire(resolve(hostRoot, 'package.json'))
   return Promise.all(
     moduleNames.map(async (name) => {
       const packageName = imports.get(name)
-      if (!packageName) throw new Error(`模块 ${name} 缺少静态 import`)
+      if (!packageName) throw new Error(runnerMessage('static_import_missing', { name }))
       const buildEntry = hostRequire.resolve(`${packageName}/build`)
       const loaded = (await import(pathToFileURL(buildEntry).href)) as {
         buildModule?: KratosTaroBuildModule
       }
-      if (!loaded.buildModule) throw new Error(`${packageName}/build 未导出 buildModule`)
+      if (!loaded.buildModule) throw new Error(runnerMessage('build_export_missing', { packageName }))
       return loaded.buildModule
     }),
   )
@@ -342,7 +343,7 @@ function readBuildTransaction(
   if (!existsSync(transactionFile)) return
   const transaction = JSON.parse(readFileSync(transactionFile, 'utf8')) as BuildTransaction
   if (transaction.inputDir !== inputDir || transaction.appConfigFile !== appConfigFile) {
-    throw new Error(`Taro 构建事务目录不匹配：${transactionFile}`)
+    throw new Error(runnerMessage('transaction_mismatch', { file: transactionFile }))
   }
   return transaction
 }
@@ -455,7 +456,7 @@ function acquirePageAssemblyLock(lockFile: string): void {
         unlinkSync(lockFile)
         continue
       }
-      if (Date.now() >= deadline) throw new Error(`等待 Taro 页面装配锁超时：${lockFile}`)
+      if (Date.now() >= deadline) throw new Error(runnerMessage('assembly_timeout', { file: lockFile }))
       waitForPageAssembly(PAGE_ASSEMBLY_POLL_INTERVAL_MS)
     }
   }