@liujitcn/kratos-uni-app-core 0.0.49 → 0.0.51

package/README.md

@@ -69,3 +69,5 @@ import KratosSettingsPage from '@liujitcn/kratos-uni-app-core/components/KratosS
 扩展内容由产品模块自行组织完整卡片。页面顺序固定为业务扩展、MFA 与语言、微信设置、退出登录；产品模块可以注册自己的物理页面，并通过后注册的 `SETTINGS` viewKey 覆盖 system 默认包装页。
 
 构建与验证命令见 [workspace 文档](../../README.md)。
+
+应用配置加载成功后，core 会将 `i18n_customs` 按 `locale + key` 覆盖已注册的本地文案，并刷新页面翻译。仅覆盖已有 key 的非空文案；未配置或已删除的覆盖项恢复本地默认值，未知语言和未知 key 忽略。切换语言时沿用配置重载流程。

package/package.json

@@ -7,7 +7,7 @@
     "type": "git",
     "url": "git@github.com:liujitcn/kratos-admin.git"
   },
-  "version": "0.0.49",
+  "version": "0.0.51",
   "type": "module",
   "files": [
     "dist",

package/src/locales/index.ts

@@ -2,8 +2,9 @@
  * uni-app 国际化运行时：合并 core 和业务模块语言包，并向 Vue 页面、请求工具暴露统一翻译入口。
  * 各语言 JSON 由模块定义文件导入，不能在 JSON 文件内添加注释。
  */
-import { readonly, ref } from 'vue'
+import { reactive, readonly, ref } from 'vue'
 import type { KratosAppModule } from '../module'
+import type { I18nCustomItem } from '../rpc/base/v1/config'
 import type { OptionLanguageResponse } from '../rpc/base/v1/language'
 import {
   DEFAULT_LOCALE as GENERATED_DEFAULT_LOCALE,
@@ -30,7 +31,8 @@ export interface LocaleOption {
 
 const DEFAULT_LOCALE: SupportedLocale = GENERATED_DEFAULT_LOCALE
 const LOCALE_STORAGE_KEY = 'kratos-app:locale'
-const localeMessages = new Map<SupportedLocale, LocaleMessages>()
+const defaultLocaleMessages = new Map<SupportedLocale, LocaleMessages>()
+const localeMessages = reactive(new Map<SupportedLocale, LocaleMessages>())
 const localeChangeHandlers = new Set<() => void | Promise<void>>()
 const mutableLocaleState = ref<SupportedLocale>(DEFAULT_LOCALE)
 const mutableLanguageOptions = ref<LocaleOption[]>([])
@@ -100,8 +102,8 @@ export function getSupportedLocales(): SupportedLocale[] {
 
 /** 注册所有模块贡献的语言包并校验语言键集合。 */
 export function registerLocaleMessages(modules: KratosAppModule[]): void {
-  localeMessages.clear()
-  SUPPORTED_LOCALES.forEach((locale) => localeMessages.set(locale, {}))
+  defaultLocaleMessages.clear()
+  SUPPORTED_LOCALES.forEach((locale) => defaultLocaleMessages.set(locale, {}))
   modules.forEach((module) => {
     const expectedKeys = requiredLocaleKeys(module.messages?.[DEFAULT_LOCALE] || {})
     SUPPORTED_LOCALES.forEach((locale) => {
@@ -111,7 +113,7 @@ export function registerLocaleMessages(modules: KratosAppModule[]): void {
       if (keys.join('\u0000') !== expectedKeys.join('\u0000')) {
         throw new Error(`${module.name} 的 ${locale} 语言包键集合不一致`)
       }
-      const target = localeMessages.get(locale) as LocaleMessages
+      const target = defaultLocaleMessages.get(locale) as LocaleMessages
       Object.keys(messages).forEach((key) => {
         if (!isAllowedLocaleKey(module.name, key)) {
           throw new Error(`${module.name} 的语言键命名空间无效: ${key}`)
@@ -129,6 +131,20 @@ export function registerLocaleMessages(modules: KratosAppModule[]): void {
       })
     })
   })
+  applyCustomLocaleMessages([])
+}
+
+/** 按语言和已有 key 覆盖本地文案，每次重新应用以清除已删除的自定义配置。 */
+export function applyCustomLocaleMessages(customs: I18nCustomItem[]): void {
+  SUPPORTED_LOCALES.forEach((locale) => {
+    const messages = { ...(defaultLocaleMessages.get(locale) ?? {}) }
+    customs.forEach((item) => {
+      if (parseSupportedLocale(item.locale) !== locale || !item.key || !item.value) return
+      if (!Object.prototype.hasOwnProperty.call(messages, item.key)) return
+      messages[item.key] = item.value
+    })
+    localeMessages.set(locale, messages)
+  })
 }
 
 /** 校验公共键和当前业务模块专属的语言键命名空间。 */

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

@@ -40,6 +40,18 @@ export interface GetConfigResponse {
   configs: ConfigItem[];
   /** AI 助手是否可用 */
   ai_enabled: boolean;
+  /** 全部语言的自定义国际化覆盖项 */
+  i18n_customs: I18nCustomItem[];
+}
+
+/** 全部语言的自定义国际化覆盖项。 */
+export interface I18nCustomItem {
+  /** 语言区域 */
+  locale: string;
+  /** 国际化语言键 */
+  key: string;
+  /** 自定义翻译内容 */
+  value: string;
 }
 
 /** Base系统配置公共服务 */

package/src/stores/modules/setting.ts

@@ -2,7 +2,7 @@ import { defConfigService } from '../../api/base/v1/config'
 import { defineStore } from 'pinia'
 import { ref } from 'vue'
 import { BaseConfigSite } from '../../rpc/base/v1/config'
-import { t } from '../../locales'
+import { applyCustomLocaleMessages, t } from '../../locales'
 
 const REQUIRED_APP_CONFIGS = [
   { key: 'serviceProtocol', nameKey: 'core.protocol.service' },
@@ -36,6 +36,7 @@ export const useSettingStore = defineStore('setting', () => {
         aiEnabled.value = false
         return
       }
+      applyCustomLocaleMessages(res.i18n_customs ?? [])
       const nextData = new Map<string, string>()
       res.configs.forEach((item) => {
         nextData.set(item.key, item.value)