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

package/README.md

@@ -45,7 +45,7 @@ packages/core
 
 - `@liujitcn/kratos-uni-app-core`：运行时、导航、store 和组件。
 - `@liujitcn/kratos-uni-app-core/module`：模块协议和 core 模块。
-- `@liujitcn/kratos-uni-app-core/vite`：Vite 配置与页面装配插件。
+- `@liujitcn/kratos-uni-app-core/vite`：Vite 配置、页面装配插件和构建错误文案格式化器。
 - `@liujitcn/kratos-uni-app-core/api/*`、`components/*.vue`、`utils/*`、`views/*`：白名单子路径。
 
 ## 公共设置页

package/dist/module.mjs

@@ -33,6 +33,7 @@ var zh_CN_default = {
   "common.action.new": "\u65B0\u5EFA",
   "common.action.open_in_new_window": "\u65B0\u7A97\u53E3\u6253\u5F00",
   "common.action.save": "\u4FDD\u5B58",
+  "common.action.view": "\u67E5\u770B",
   "common.field.language": "\u8BED\u8A00",
   "common.language.en-US": "English",
   "common.language.zh-CN": "\u7B80\u4F53\u4E2D\u6587",
@@ -115,6 +116,7 @@ var zh_CN_default = {
   "core.login.user_name_password": "\u8BF7\u8F93\u5165\u7528\u6237\u540D\u548C\u5BC6\u7801",
   "core.login.wechat": "\u5FAE\u4FE1\u4E00\u952E\u767B\u5F55",
   "core.login.wechat_bind_tip": "\u8BE5\u5FAE\u4FE1\u5C1A\u672A\u7ED1\u5B9A\uFF0C\u8BF7\u767B\u5F55\u5DF2\u6709\u8D26\u53F7\u5B8C\u6210\u7ED1\u5B9A",
+  "core.login.login_failed": "\u767B\u5F55\u5931\u8D25\uFF0C\u8BF7\u91CD\u8BD5",
   "core.login.wechat_failed": "\u5FAE\u4FE1\u767B\u5F55\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5",
   "core.navigation.home": "\u9996\u9875",
   "core.navigation.message": "\u6D88\u606F",
@@ -178,6 +180,7 @@ var en_US_default = {
   "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": "\u7B80\u4F53\u4E2D\u6587",
@@ -260,6 +263,7 @@ var en_US_default = {
   "core.login.user_name_password": "Enter username and password",
   "core.login.wechat": "Continue with WeChat",
   "core.login.wechat_bind_tip": "This WeChat account is not linked. Log in to an existing account to link it.",
+  "core.login.login_failed": "Login failed. Try again.",
   "core.login.wechat_failed": "WeChat login failed. Try again later.",
   "core.navigation.home": "Home",
   "core.navigation.message": "Messages",
@@ -323,6 +327,7 @@ var ja_JP_default = {
   "common.action.new": "\u65B0\u898F",
   "common.action.open_in_new_window": "\u65B0\u3057\u3044\u30A6\u30A3\u30F3\u30C9\u30A6\u304C\u958B\u304D\u307E\u3059",
   "common.action.save": "\u4FDD\u5B58",
+  "common.action.view": "\u8868\u793A",
   "common.field.language": "\u8A00\u8A9E",
   "common.language.en-US": "\u82F1\u8A9E",
   "common.language.zh-CN": "\u7C21\u4F53\u5B57\u4E2D\u56FD\u8A9E",
@@ -405,6 +410,7 @@ var ja_JP_default = {
   "core.login.user_name_password": "\u30E6\u30FC\u30B6\u30FC\u540D\u3068\u30D1\u30B9\u30EF\u30FC\u30C9\u3092\u5165\u529B\u3057\u3066\u304F\u3060\u3055\u3044",
   "core.login.wechat": "WeChat \u30EF\u30F3\u30AF\u30EA\u30C3\u30AF \u30ED\u30B0\u30A4\u30F3",
   "core.login.wechat_bind_tip": "\u3053\u306E WeChat \u30A2\u30AB\u30A6\u30F3\u30C8\u306F\u307E\u3060\u30D0\u30A4\u30F3\u30C9\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002\u30D0\u30A4\u30F3\u30C9\u3092\u5B8C\u4E86\u3059\u308B\u306B\u306F\u3001\u65E2\u5B58\u306E\u30A2\u30AB\u30A6\u30F3\u30C8\u306B\u30ED\u30B0\u30A4\u30F3\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+  "core.login.login_failed": "\u30ED\u30B0\u30A4\u30F3\u306B\u5931\u6557\u3057\u307E\u3057\u305F\u3002\u3082\u3046\u4E00\u5EA6\u304A\u8A66\u3057\u304F\u3060\u3055\u3044\u3002",
   "core.login.wechat_failed": "WeChat \u30ED\u30B0\u30A4\u30F3\u306B\u5931\u6557\u3057\u307E\u3057\u305F\u3002\u5F8C\u3067\u3082\u3046\u4E00\u5EA6\u8A66\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
   "core.navigation.home": "\u30DB\u30FC\u30E0",
   "core.navigation.message": "\u30E1\u30C3\u30BB\u30FC\u30B8",
@@ -468,6 +474,7 @@ var zh_TW_default = {
   "common.action.new": "\u65B0\u5EFA",
   "common.action.open_in_new_window": "\u65B0\u8996\u7A97\u958B\u555F",
   "common.action.save": "\u5132\u5B58",
+  "common.action.view": "\u6AA2\u8996",
   "common.field.language": "\u8A9E\u8A00",
   "common.language.en-US": "English",
   "common.language.zh-CN": "\u7C21\u9AD4\u4E2D\u6587",
@@ -550,6 +557,7 @@ var zh_TW_default = {
   "core.login.user_name_password": "\u8ACB\u8F38\u5165\u4F7F\u7528\u8005\u540D\u7A31\u548C\u5BC6\u78BC",
   "core.login.wechat": "\u5FAE\u4FE1\u4E00\u9375\u767B\u5165",
   "core.login.wechat_bind_tip": "\u8A72\u5FAE\u4FE1\u5C1A\u672A\u7E6B\u7D50\uFF0C\u8ACB\u767B\u5165\u5DF2\u6709\u8CEC\u865F\u5B8C\u6210\u7E6B\u7D50",
+  "core.login.login_failed": "\u767B\u5165\u5931\u6557\uFF0C\u8ACB\u91CD\u8A66",
   "core.login.wechat_failed": "\u5FAE\u4FE1\u767B\u5165\u5931\u6557\uFF0C\u8ACB\u7A0D\u5F8C\u91CD\u8A66",
   "core.navigation.home": "\u9996\u9801",
   "core.navigation.message": "\u6D88\u606F",

package/dist/vite.mjs

@@ -14,6 +14,32 @@ import { createRequire } from "node:module";
 import { dirname, isAbsolute, relative, resolve } from "node:path";
 import uniPlugin from "@dcloudio/vite-plugin-uni";
 import { defineConfig, loadEnv } from "vite";
+
+// src/vite-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}",
+    transaction_mismatch: "uni-app \u6784\u5EFA\u4E8B\u52A1\u76EE\u5F55\u4E0D\u5339\u914D\uFF1A{file}",
+    assembly_timeout: "\u7B49\u5F85 uni-app \u9875\u9762\u88C5\u914D\u9501\u8D85\u65F6\uFF1A{file}",
+    source_path_not_absolute: "\u6A21\u5757\u6E90\u7801\u8DEF\u5F84\u4E0D\u662F\u7EDD\u5BF9\u8DEF\u5F84\uFF1A{path}"
+  },
+  "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}",
+    transaction_mismatch: "The uni-app build transaction directory does not match: {file}",
+    assembly_timeout: "Timed out waiting for the uni-app page assembly lock: {file}",
+    source_path_not_absolute: "The module source path is not absolute: {path}"
+  }
+};
+function resolveViteLocale() {
+  const value = process.env.KRATOS_ADMIN_LOCALE ?? process.env.LC_ALL ?? process.env.LANG ?? "";
+  return value.toLowerCase().startsWith("zh") ? "zh-CN" : "en-US";
+}
+function viteMessage(key, params = {}) {
+  const template = messages[resolveViteLocale()][key] ?? messages["en-US"][key] ?? key;
+  return template.replace(/\{([A-Za-z0-9_]+)\}/g, (_, name) => params[name] ?? `{${name}}`);
+}
+
+// src/vite.ts
 var sourceVersionCounter = 0;
 var PAGE_ASSEMBLY_WAIT_TIMEOUT_MS = 3e4;
 var PAGE_ASSEMBLY_POLL_INTERVAL_MS = 25;
@@ -264,7 +290,7 @@ function readBuildTransaction(transactionFile, inputDir, pagesFile) {
     return;
   const transaction = JSON.parse(readFileSync(transactionFile, "utf8"));
   if (transaction.inputDir !== inputDir || transaction.pagesFile !== pagesFile) {
-    throw new Error(`uni-app \u6784\u5EFA\u4E8B\u52A1\u76EE\u5F55\u4E0D\u5339\u914D\uFF1A${transactionFile}`);
+    throw new Error(viteMessage("transaction_mismatch", { file: transactionFile }));
   }
   return transaction;
 }
@@ -376,7 +402,7 @@ function acquirePageAssemblyLock(lockFile) {
         continue;
       }
       if (Date.now() >= deadline) {
-        throw new Error(`\u7B49\u5F85 uni-app \u9875\u9762\u88C5\u914D\u9501\u8D85\u65F6\uFF1A${lockFile}`);
+        throw new Error(viteMessage("assembly_timeout", { file: lockFile }));
       }
       waitForPageAssembly(PAGE_ASSEMBLY_POLL_INTERVAL_MS);
     }
@@ -539,7 +565,7 @@ function resolveSourceFile(target) {
   ];
   const resolved = candidates.find((candidate) => existsSync(candidate) && statSync(candidate).isFile()) ?? target;
   if (!isAbsolute(resolved))
-    throw new Error(`\u6A21\u5757\u6E90\u7801\u8DEF\u5F84\u4E0D\u662F\u7EDD\u5BF9\u8DEF\u5F84\uFF1A${resolved}`);
+    throw new Error(viteMessage("source_path_not_absolute", { path: resolved }));
   return resolved;
 }
 function dependencyVersionQuery(importer, sourceVersion) {
@@ -569,5 +595,6 @@ export {
   defineConfig,
   kratosApp,
   loadEnv,
-  recoverStalePageTransaction
+  recoverStalePageTransaction,
+  viteMessage
 };

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/api/base/v1/file.ts

@@ -86,7 +86,7 @@ export class FileServiceImpl {
       document.body.removeChild(a)
       window.URL.revokeObjectURL(url)
     } catch (error) {
-      console.error('下载错误:', error)
+      console.error('File download failed:', error)
     }
   }
 }

package/src/bootstrap.ts

@@ -3,9 +3,11 @@ import type { App, Component } from 'vue'
 import { registerKratosAppModules, type KratosAppModule } from './module'
 import {
   applyLanguageConfig,
+  getCurrentLocale,
   initializeLocale,
   registerLocaleChangeHandler,
   registerLocaleMessages,
+  t,
 } from './locales'
 import { initializeAppNavigation } from './navigation'
 import { useSettingStore } from './stores'
@@ -23,15 +25,25 @@ export interface KratosAppBootstrapOptions {
   modules: KratosAppModule[]
 }
 
+function syncH5DocumentTitle(): void {
+  // #ifdef H5
+  if (typeof document === 'undefined') return
+  document.documentElement.lang = getCurrentLocale()
+  document.title = t('core.home.main_title')
+  // #endif
+}
+
 /** 创建 uni-app 实例并注册模块。 */
 export function bootstrapKratosApp(options: KratosAppBootstrapOptions) {
   registerKratosAppModules(options.modules)
   registerLocaleMessages(options.modules)
   initializeLocale()
+  syncH5DocumentTitle()
   void defLanguageService
     .OptionLanguage({})
     .then((response) => {
       applyLanguageConfig(response)
+      syncH5DocumentTitle()
     })
     .catch(() => {
       // 语言公共接口失败时继续使用静态语言包和系统语言。

package/src/locales/en-US.json

@@ -7,6 +7,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": "简体中文",
@@ -89,6 +90,7 @@
   "core.login.user_name_password": "Enter username and password",
   "core.login.wechat": "Continue with WeChat",
   "core.login.wechat_bind_tip": "This WeChat account is not linked. Log in to an existing account to link it.",
+  "core.login.login_failed": "Login failed. Try again.",
   "core.login.wechat_failed": "WeChat login failed. Try again later.",
   "core.navigation.home": "Home",
   "core.navigation.message": "Messages",

package/src/locales/index.ts

@@ -108,18 +108,19 @@ export function registerLocaleMessages(modules: KratosAppModule[]): 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,
@@ -211,10 +212,34 @@ 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

@@ -7,6 +7,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": "簡体字中国語",
@@ -89,6 +90,7 @@
   "core.login.user_name_password": "ユーザー名とパスワードを入力してください",
   "core.login.wechat": "WeChat ワンクリック ログイン",
   "core.login.wechat_bind_tip": "この WeChat アカウントはまだバインドされていません。バインドを完了するには、既存のアカウントにログインしてください。",
+  "core.login.login_failed": "ログインに失敗しました。もう一度お試しください。",
   "core.login.wechat_failed": "WeChat ログインに失敗しました。後でもう一度試してください。",
   "core.navigation.home": "ホーム",
   "core.navigation.message": "メッセージ",

package/src/locales/zh-CN.json

@@ -7,6 +7,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": "简体中文",
@@ -89,6 +90,7 @@
   "core.login.user_name_password": "请输入用户名和密码",
   "core.login.wechat": "微信一键登录",
   "core.login.wechat_bind_tip": "该微信尚未绑定，请登录已有账号完成绑定",
+  "core.login.login_failed": "登录失败，请重试",
   "core.login.wechat_failed": "微信登录失败，请稍后重试",
   "core.navigation.home": "首页",
   "core.navigation.message": "消息",

package/src/locales/zh-TW.json

@@ -7,6 +7,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": "簡體中文",
@@ -89,6 +90,7 @@
   "core.login.user_name_password": "請輸入使用者名稱和密碼",
   "core.login.wechat": "微信一鍵登入",
   "core.login.wechat_bind_tip": "該微信尚未繫結，請登入已有賬號完成繫結",
+  "core.login.login_failed": "登入失敗，請重試",
   "core.login.wechat_failed": "微信登入失敗，請稍後重試",
   "core.navigation.home": "首頁",
   "core.navigation.message": "消息",

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/stores/modules/user.ts

@@ -216,7 +216,7 @@ export const useUserStore = defineStore(
             resolve()
           })
           .catch((error) => {
-            console.log(' refreshToken  刷新失败', error)
+            console.log('Token refresh failed:', error)
             reject(error)
           })
       })

package/src/vite-messages.ts

@@ -0,0 +1,30 @@
+type ViteLocale = 'zh-CN' | 'en-US'
+
+const messages: Record<ViteLocale, Record<string, string>> = {
+  'zh-CN': {
+    https_certificate_missing:
+      'VITE_APP_HTTPS 已开启，但未找到证书文件，请先在仓库根目录运行 scripts/generate-dev-cert.sh；期望路径：{keyPath} 和 {certPath}',
+    transaction_mismatch: 'uni-app 构建事务目录不匹配：{file}',
+    assembly_timeout: '等待 uni-app 页面装配锁超时：{file}',
+    source_path_not_absolute: '模块源码路径不是绝对路径：{path}',
+  },
+  '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}',
+    transaction_mismatch: 'The uni-app build transaction directory does not match: {file}',
+    assembly_timeout: 'Timed out waiting for the uni-app page assembly lock: {file}',
+    source_path_not_absolute: 'The module source path is not absolute: {path}',
+  },
+}
+
+/** 根据环境变量选择 uni-app 构建器错误语言。 */
+function resolveViteLocale(): ViteLocale {
+  const value = process.env.KRATOS_ADMIN_LOCALE ?? process.env.LC_ALL ?? process.env.LANG ?? ''
+  return value.toLowerCase().startsWith('zh') ? 'zh-CN' : 'en-US'
+}
+
+/** 渲染 uni-app 构建器稳定错误文案。 */
+export function viteMessage(key: string, params: Record<string, string> = {}): string {
+  const template = messages[resolveViteLocale()][key] ?? messages['en-US'][key] ?? key
+  return template.replace(/\{([A-Za-z0-9_]+)\}/g, (_, name: string) => params[name] ?? `{${name}}`)
+}

package/src/vite.ts

@@ -15,8 +15,9 @@ import uniPlugin from '@dcloudio/vite-plugin-uni'
 import { defineConfig, loadEnv } from 'vite'
 import type { Plugin, UserConfig } from 'vite'
 import type { KratosAppModule, KratosAppPageConfig } from './module'
+import { viteMessage } from './vite-messages.js'
 
-export { defineConfig, loadEnv }
+export { defineConfig, loadEnv, viteMessage }
 export type { ConfigEnv, UserConfig } from 'vite'
 
 type PageEntry = { path: string; style?: Record<string, unknown> }
@@ -343,7 +344,7 @@ function readBuildTransaction(
   if (!existsSync(transactionFile)) return
   const transaction = JSON.parse(readFileSync(transactionFile, 'utf8')) as BuildTransaction
   if (transaction.inputDir !== inputDir || transaction.pagesFile !== pagesFile) {
-    throw new Error(`uni-app 构建事务目录不匹配：${transactionFile}`)
+    throw new Error(viteMessage('transaction_mismatch', { file: transactionFile }))
   }
   return transaction
 }
@@ -459,7 +460,7 @@ function acquirePageAssemblyLock(lockFile: string): void {
         continue
       }
       if (Date.now() >= deadline) {
-        throw new Error(`等待 uni-app 页面装配锁超时：${lockFile}`)
+        throw new Error(viteMessage('assembly_timeout', { file: lockFile }))
       }
       waitForPageAssembly(PAGE_ASSEMBLY_POLL_INTERVAL_MS)
     }
@@ -637,7 +638,8 @@ function resolveSourceFile(target: string): string {
   ]
   const resolved =
     candidates.find((candidate) => existsSync(candidate) && statSync(candidate).isFile()) ?? target
-  if (!isAbsolute(resolved)) throw new Error(`模块源码路径不是绝对路径：${resolved}`)
+  if (!isAbsolute(resolved))
+    throw new Error(viteMessage('source_path_not_absolute', { path: resolved }))
   return resolved
 }