@liujitcn/kratos-taro-app-core 0.0.48 → 0.0.50

package/README.md

@@ -41,3 +41,5 @@ pnpm check:exports
 ```
 
 构建产物按模式与平台隔离：开发使用 `dist/dev/h5`、`dist/dev/mp-weixin`，生产默认使用 `dist/build/h5`、`dist/build/mp-weixin`。`KRATOS_TARO_OUTPUT_ROOT` 可覆盖默认目录；仓库宿主及 Kratos 配套项目的 H5 生产构建输出到 `backend/data/taro-app`。微信开发者工具默认指向开发目录，发布时导入生产目录。
+
+应用配置加载成功后，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.48",
+  "version": "0.0.50",
   "type": "module",
   "files": [
     "dist",

package/src/locales/index.ts

@@ -5,6 +5,7 @@
 import Taro from '@tarojs/taro'
 import { create } from 'zustand'
 import type { KratosTaroModule } 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,
@@ -38,7 +39,9 @@ export interface LocaleStoreState {
 
 const DEFAULT_LOCALE: SupportedLocale = GENERATED_DEFAULT_LOCALE
 const LOCALE_STORAGE_KEY = 'kratos-app:locale'
+const defaultLocaleMessages = new Map<SupportedLocale, LocaleMessages>()
 const localeMessages = new Map<SupportedLocale, LocaleMessages>()
+const useLocaleMessagesRevision = create<number>(() => 0)
 const localeChangeHandlers = new Set<() => void | Promise<void>>()
 
 /** 响应式语言 Zustand Store。 */
@@ -106,8 +109,8 @@ export function getSupportedLocales(): SupportedLocale[] {
 
 /** 注册所有模块贡献的语言包并校验语言键集合。 */
 export function registerLocaleMessages(modules: KratosTaroModule[]): 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) => {
@@ -117,7 +120,7 @@ export function registerLocaleMessages(modules: KratosTaroModule[]): 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}`)
@@ -130,6 +133,21 @@ export function registerLocaleMessages(modules: KratosTaroModule[]): 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)
+  })
+  useLocaleMessagesRevision.setState((revision) => revision + 1)
 }
 
 /** 校验公共键和当前业务模块专属的语言键命名空间。 */
@@ -176,6 +194,7 @@ export function t(key: string, params: LocaleParams = {}, locale = getCurrentLoc
 
 /** 在 React 页面中使用响应式国际化能力。 */
 export function useI18n() {
+  useLocaleMessagesRevision()
   const locale = useLocaleStore((state) => state.locale)
   return {
     locale,

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/setting.ts

@@ -1,6 +1,6 @@
 import { create } from 'zustand'
 import { defConfigService } from '../api/base/v1/config'
-import { t } from '../locales'
+import { applyCustomLocaleMessages, t } from '../locales'
 import { BaseConfigSite } from '../rpc/base/v1/config'
 
 const REQUIRED_APP_CONFIGS = [
@@ -36,6 +36,7 @@ export const useSettingStore = create<SettingStoreState>((set, get) => ({
         set({ aiEnabled: false })
         return
       }
+      applyCustomLocaleMessages(response.i18n_customs ?? [])
       const nextData = new Map(response.configs.map((item) => [item.key, item.value]))
       const missing = REQUIRED_APP_CONFIGS.filter(({ key }) => !nextData.get(key))
       if (missing.length) {