gc_i18n 1.4.6 → 1.4.7

package/.qoder/repowiki/zh/content//346/240/270/345/277/203/345/272/223/345/256/236/347/216/260.md

@@ -2,48 +2,28 @@
 
 <cite>
 **本文档中引用的文件**
-- [packages/index.js](file://packages/index.js) - *核心I18n类完全重写*
-- [packages/libs/service.js](file://packages/libs/service.js) - *核心服务逻辑变更*
-- [packages/libs/utils.js](file://packages/libs/utils.js) - *工具函数库*
-- [packages/libs/i18nUtils.ts](file://packages/libs/i18nUtils.ts) - *翻译键提取工具*
-- [packages/components/earth.js](file://packages/components/earth.js) - *地球组件*
+- [packages/index.js](file://packages/index.js) - *核心I18n类实现*
 - [packages/libs/textEditMode.js](file://packages/libs/textEditMode.js) - *文本编辑模式模块*
 - [packages/libs/textEditMode.css](file://packages/libs/textEditMode.css) - *文本编辑模式样式*
 - [packages/swal.css](file://packages/swal.css) - *SweetAlert2样式集成*
-- [lib/gc_i18n.css](file://lib/gc_i18n.css) - *样式文件*
+- [packages/libs/service.js](file://packages/libs/service.js) - *HTTP服务封装*
 - [lib/gc_i18n.es.js](file://lib/gc_i18n.es.js) - *ES模块构建*
 - [lib/gc_i18n.umd.js](file://lib/gc_i18n.umd.js) - *UMD构建*
 - [lang/index.js](file://lang/index.js) - *语言包入口*
 - [lang/index.json](file://lang/index.json) - *语言资源文件*
-- [src/main.js](file://src/main.js) - *应用入口*
-- [src/App.vue](file://src/App.vue) - *根组件*
 - [package.json](file://package.json) - *项目配置*
 - [vite.config.js](file://vite.config.js) - *构建配置*
 </cite>
 
 ## 更新摘要
 **变更内容**   
-- 核心I18n类完全重写，引入Vue 2/3兼容层和createI18nCompat函数
-- **新增单元代码支持功能**，在配置系统中引入unitCode属性，默认值为GREENCLOUD，增强了翻译数据结构和处理能力
-- **新增中文语言模式兼容性支持**，通过normalizeLocale方法支持zh-CN和zh-TW的自动规范化
-- **内部代码重构改进**，axios别名从Ve改为je，多个函数重命名等
-- 支持自动版本检测和适配，统一Vue 2和Vue 3的API差异
-- 增强路由守卫机制，支持动态组件加载和翻译键收集
-- 重构翻译查找机制，支持路由特定键和通用键的优先级处理
-- **新增翻译函数默认值参数支持**，当翻译不存在时返回默认值
-- **新增全局键集合跟踪机制**，通过__I18N_ALL_KEYS__全局变量记录所有调用过的键
-- **增强文本编辑模式核心功能**，改进键值映射和查找机制
-- 新增JWT令牌生成和管理功能
-- 完善缓存策略，支持本地存储和远程增量更新
-- **新增RTL方向管理功能**，支持从右到左语言的自动检测和文档方向切换
-- **新增文本编辑模式功能**，支持可视化翻译编辑和快捷键绑定
-- **新增editKeyboard配置选项**，允许自定义文本编辑模式快捷键
-- **集成$keyValueMap映射机制**，为文本编辑模式提供键值映射支持
-- **HTTP客户端现代化**，使用独立axios实例避免全局污染
-- **安全机制改进**，新增JWT令牌验证和权限控制
-- **SweetAlert2集成优化**，改进变量命名和代码组织结构，提升可读性和维护性
-- **新增智能语言列表缓存机制**，通过getLanguagesWithCache提供缓存和自动失效功能
-- **新增postMessage事件处理功能**，扩展了原有的updateLanguage事件处理机制，允许外部应用程序通过postMessage事件编程关闭模态框
+- 版本从1.4.5升级到1.4.6，核心库实现重大重构
+- 新增Axios请求拦截器，自动为所有HTTP请求添加Bearer令牌
+- SweetAlert2集成得到改进，移除了复杂的模态框创建系统
+- 简化为直接的SweetAlert2集成，提升可维护性
+- 优化了事件通知机制，改进closeModal事件处理
+- 增强了文本编辑模式的SweetAlert2集成
+- 改进了HTTP客户端的集中式认证管理
 
 ## 目录
 1. [项目结构分析](#项目结构分析)
@@ -52,44 +32,33 @@
 4. [公共API接口文档](#公共api接口文档)
 5. [RTL方向管理功能](#rtl方向管理功能)
 6. [中文语言模式兼容性](#中文语言模式兼容性)
-7. [单元代码支持功能](#单元代码支持功能)
-8. [文本编辑模式功能](#文本编辑模式功能)
-9. [非组件环境使用](#非组件环境使用)
-10. [样式文件作用](#样式文件作用)
+7. [文本编辑模式功能](#文本编辑模式功能)
+8. [非组件环境使用](#非组件环境使用)
+9. [样式文件作用](#样式文件作用)
 
 ## 项目结构分析
 
 ```mermaid
 graph TB
 subgraph "核心模块"
-packages[index.js<br/>service.js<br/>utils.js<br/>i18nUtils.ts<br/>textEditMode.js]
+packages[index.js<br/>textEditMode.js<br/>textEditMode.css<br/>swal.css<br/>service.js]
 end
 subgraph "构建产物"
 lib[lib]
 gc_i18n_es[gc_i18n.es.js]
 gc_i18n_umd[gc_i18n.umd.js]
-gc_i18n_css[gc_i18n.css]
-text_edit_css[textEditMode.css]
-swal_css[swal.css]
 end
 subgraph "语言资源"
 lang[index.js<br/>index.json]
 end
-subgraph "示例应用"
-src[src]
-main_js[main.js]
-app_vue[App.vue]
-end
 subgraph "依赖管理"
 package_json[package.json]
 vite_config[vite.config.js]
 dependencies[依赖配置]
-devDependencies[开发依赖]
 end
 packages --> lib
 lib --> packages
 lang --> packages
-src --> packages
 package_json --> dependencies
 vite_config --> dependencies
 ```
@@ -97,6 +66,7 @@ vite_config --> dependencies
 **图示来源**
 - [packages/index.js](file://packages/index.js)
 - [packages/libs/textEditMode.js](file://packages/libs/textEditMode.js)
+- [packages/libs/service.js](file://packages/libs/service.js)
 - [lib/gc_i18n.es.js](file://lib/gc_i18n.es.js)
 - [lang/index.js](file://lang/index.js)
 - [package.json](file://package.json)
@@ -109,193 +79,27 @@ vite_config --> dependencies
 
 ## 核心逻辑实现
 
-### Vue 2/3兼容层实现
-
-核心I18n类引入了createI18nCompat函数来处理Vue 2和Vue 3的API差异：
-
-```javascript
-function createI18nCompat(options) {
-  if (vueI18n.createI18n) {
-    return vueI18n.createI18n(options);
-  }
-  const VueI18n = vueI18n.default || vueI18n.VueI18n;
-  // Vue 2 下必须先 Vue.use(VueI18n)，否则 new VueI18n() 会报 config undefined
-  const Vue = options.vue;
-  if (Vue) {
-    Vue.use(VueI18n);
-  }
-  const { vue, ...rest } = options;
-  const opts = {
-    locale: options.locale,
-    messages: options.messages || {},
-    silentTranslationWarn: options.silentTranslationWarn,
-    silentFallbackWarn: options.silentFallbackWarn,
-    missingWarn: options.missingWarn,
-    fallbackWarn: options.fallbackWarn,
-    ...rest
-  };
-  const instance = new VueI18n(opts);
-  instance.global = {
-    t: instance.t.bind(instance),
-    setLocaleMessage: instance.setLocaleMessage.bind(instance),
-    locale: {
-      get value() {
-        return instance.locale;
-      },
-      set value(v) {
-        instance.locale = v;
-      }
-    }
-  };
-  return instance;
-}
-```
-
-### 语言切换机制
-
-语言切换通过增强的翻译查找机制实现，支持路由特定键和通用键的优先级处理：
-
-```javascript
-globalThis.$t = this.i18n.global.t = (key, comment) => {
-  // 记录本次调用的原始 key（字符串场景）
-  if (typeof key === "string") {
-    this.translationKeySet.add(key);
-  }
-  // Vue Router 3 (Vue2) currentRoute 为普通对象，Vue Router 4 (Vue3) 为 ref
-  const route = this.router?.currentRoute;
-  const routeName = (route?.value ?? route)?.name;
-  if (routeName) {
-    const routerKey = `${routeName}.${key}`;
-    const routeTranslation = originalT(routerKey);
-    if (routeTranslation !== routerKey && !_.isEmpty(routeTranslation)) {
-      return routeTranslation;
-    } else {
-      const commonKey = `common.${key}`;
-      const commonTranslation = originalT(commonKey);
-      if (commonTranslation !== commonKey) {
-        return commonTranslation;
-      } else {
-        return originalT(key, comment);
-      }
-    }
-  } else {
-    return originalT(key, comment);
-  }
-};
-```
-
-### 路由守卫机制
+### Axios请求拦截器集成
 
-增强的路由守卫机制支持动态组件加载和翻译键的实时收集：
+**更新** 核心I18n类现在集成了Axios请求拦截器，实现了集中式的认证管理：
 
 ```javascript
-initRouterGuards() {
-  if (I18n._routerGuardRegistered) return;
-  I18n._routerGuardRegistered = true;
-  this.router.beforeEach(async (to, from, next) => {
-    const { language, token } = to.query;
-    this.configInstance && this.configInstance.closeModal();
-    this.name = to.name;
-    // 新路由开始前重置本次页面已收集到的 key
-    this.translationKeySet = new Set();
-    token && this.setToken(token);
-
-    if (this.loadI18n) {
-      await this.setLanguage(language || this.locale);
-    }
-    this.loadI18n = false;
-    
-    // 动态加载异步组件并提取翻译键
-    if (to.matched.length > 0) {
-      try {
-        const allTranslationKeys = [];
-        for (const match of to.matched) {
-          let component = match.components?.default;
-          if (
-            typeof component === "function" &&
-            component.toString().includes("import(")
-          ) {
-            component = await component();
-            component = component.default;
-          }
-          if (component) {
-            const keys = extractTranslationKeys(component);
-            allTranslationKeys.push(...keys);
-          }
-        }
-        this.translationKeys = allTranslationKeys;
-      } catch (error) {
-        console.error("加载异步组件时出错:", error);
-        next();
-        return;
-      }
-    }
-    next();
-  });
-
-  // 在每次路由完成后，同步一次运行时收集到的 keys
-  if (!I18n._afterEachGuardRegistered) {
-    I18n._afterEachGuardRegistered = true;
-    this.router.afterEach(async () => {
-      await nextTick();
-      // 合并静态扫描与运行时收集，去重
-      const runtimeKeys = Array.from(this.translationKeySet);
-      const merged = Array.from(
-        new Set([...(this.translationKeys || []), ...runtimeKeys])
-      );
-      this.translationKeys = merged;
-    });
-  }
-}
-```
-
-### 翻译查找机制
-
-翻译查找通过增强的消息解析器实现，支持嵌套键值查找和路由特定键处理：
+// 独立 Axios 实例，避免宿主环境污染全局 axios
+const http = axios.create();
 
-```javascript
-function _r(e, t) {
-  if (!M(e)) return null
-  let n = yn.get(t)
-  if (n || (n = ur(t), n && yn.set(t, n)), !n) return null
-  const a = n.length
-  let s = e, r = 0
-  for (; r < a; ) {
-    const o = n[r]
-    if (ca.includes(o) && le(s)) return null
-    const l = s[o]
-    if (l === void 0 || x(s)) return null
-    s = l, r++
+// 添加请求拦截器，自动带上 token
+http.interceptors.request.use((config) => {
+  // 从 I18N_CONFIG 中获取 token
+  const i18nConfig = store2.get("I18N_CONFIG") || {};
+  const token = i18nConfig.token;
+  if (token) {
+    config.headers.Authorization = `Bearer ${token}`;
   }
-  return s
-}
-```
-
-### 事件通知机制
-
-**更新** 事件通知通过自定义事件系统实现，使用mitt事件发射器，新增了closeModal事件处理功能：
-
-```javascript
-install(app, opts = {}) {
-  app.use(this.i18n);
-  // 自动注册全局组件
-  // app.component("i18n-earth", earthVue);
-
-  window.addEventListener("message", (event) => {
-    if (event.data.type === "updateLanguage") {
-      location.reload();
-    }
-    // 新增：监听关闭弹窗消息
-    if (event.data.type === "closeModal") {
-      this.configInstance && this.configInstance.closeModal();
-    }
-  });
-}
+  return config;
+});
 ```
 
-### HTTP客户端现代化
-
-**更新** 新增独立axios实例，避免宿主环境污染全局axios配置：
+**更新** HTTP客户端现代化，新增独立axios实例，避免宿主环境污染全局axios配置：
 
 ```javascript
 // 独立 Axios 实例，避免宿主环境污染全局 axios
@@ -309,7 +113,6 @@ export const getTranslate = async ({
   routerName
 }) => {
   return new Promise(async (resolve, reject) => {
-    // const appCodeStore = i18nStore.get(appCode);
     const languageStore = store2.namespace(`I18N_${_.toUpper(appCode)}`);
     const options = {
       baseUrl,
@@ -357,36 +160,71 @@ export const getTranslate = async ({
 };
 ```
 
-### 安全机制改进
+### SweetAlert2集成重构
 
-**更新** 新增JWT令牌生成和验证机制：
+**更新** 核心I18n类现在使用直接的SweetAlert2集成，移除了复杂的模态框创建系统：
 
 ```javascript
-// 生成 JWT 的函数
-function generateJWT(orgCode) {
-  const header = {
-    alg: "HS512" // 算法
-  };
-  const payload = {
-    orgCode
-  };
-  const sHeader = JSON.stringify(header);
-  const sPayload = JSON.stringify(payload);
-  const secret = "";
-  // 同步生成 JWT
-  return jws.JWS.sign("HS512", sHeader, sPayload, secret);
-}
+// 直接使用 SweetAlert2 创建配置弹窗
+keyboardJS.bind(this.keyboard, (e) => {
+  const iframeSrc = `${this.baseUrl}/i18n-admin-front/#/config?name=${
+    this.name
+  }&appCode=${this.appCode}&env=${
+    this.env
+  }&translationKeys=${this.translationKeys.join(",")}`;
+  this.swalInstance = Swal.fire({
+    titleText: "多语言管理中心",
+    padding: "0px",
+    showCloseButton: true,
+    showConfirmButton: false,
+    width: "1000px",
+    customClass: {
+      container: "gc_i18n_container",
+      title: "gc_i18n_title",
+      closeButton: "gc_i18n_close_button",
+      htmlContainer: "gc_i18n_html_container"
+    },
+    html: `<iframe src="${iframeSrc}" style="width: 100%; height: 100%;border: none;min-height: 480px;"></iframe>`
+  });
+});
+```
 
-// 设置令牌
-setToken(token) {
-  this.token = token;
-  store2.set("I18N_TOKEN", token);
+### 事件通知机制改进
+
+**更新** 事件通知通过自定义事件系统实现，使用mitt事件发射器，改进了closeModal事件处理功能：
+
+```javascript
+install(app, opts = {}) {
+  app.use(this.i18n);
+  // 自动注册全局组件
+  app.component("i18n-earth", {
+    ...earthVue,
+    props: {
+      ...earthVue.props,
+      baseUrl: {
+        type: String,
+        default: this.baseUrl
+      }
+    }
+  });
+
+  window.addEventListener("message", (event) => {
+    if (event.data.type === "updateLanguage") {
+      location.reload();
+    }
+    // 新增：监听关闭弹窗消息
+    if (event.data.type === "closeModal") {
+      if (this.swalInstance) {
+        this.swalInstance.close();
+      }
+    }
+  });
 }
 ```
 
-### 翻译函数增强
+### 翻译查找机制
 
-**更新** 翻译函数现在支持默认值参数，当翻译不存在时返回默认值：
+翻译查找通过增强的消息解析器实现，支持嵌套键值查找和路由特定键处理：
 
 ```javascript
 globalThis.$t = this.i18n.global.t = (key, defaultValue) => {
@@ -441,88 +279,38 @@ globalThis.$t = this.i18n.global.t = (key, defaultValue) => {
 };
 ```
 
-### 键跟踪机制改进
-
-**更新** 新增全局键集合跟踪机制，通过__I18N_ALL_KEYS__全局变量记录所有调用过的键：
-
-```javascript
-// 用于存储所有调用过的 key，供文本编辑模式使用
-globalThis.__I18N_ALL_KEYS__ = new Set();
-```
-
-### 智能语言列表缓存机制
+### 安全机制改进
 
-**新增** I18n类新增了智能语言列表缓存机制，通过getLanguagesWithCache函数提供缓存和自动失效功能：
+新增JWT令牌生成和验证机制：
 
 ```javascript
-/**
- * 获取语言列表（带缓存）
- * @param {Object} options - 配置选项
- * @param {string} options.baseUrl - API 基础 URL
- * @param {string} options.token - 认证 token
- * @param {string} options.appCode - 应用代码
- * @param {boolean} options.isRemote - 是否强制从远程获取
- * @returns {Promise<Array>} 语言列表
- */
-export const getLanguagesWithCache = async ({
-  baseUrl,
-  token,
-  appCode,
-  isRemote = false
-}) => {
-  // 先从缓存获取
-  const cached = store2.get("I18N_LANGUAGES");
-  if (cached && Array.isArray(cached) && cached.length > 0 && !isRemote) {
-    return cached.map((l) => ({
-      langCode: l.language || l.langCode || l,
-      langName: l.langName || l.language || l
-    }));
-  }
-
-  // 从 API 获取
-  if (!appCode) {
-    return [];
-  }
-
-  try {
-    const res = await http.get(`${baseUrl}/i18n-web/language/languages`, {
-      headers: {
-        appCode,
-        Authorization: token
-      }
-    });
-    if (res.data && res.data.result === 0) {
-      const langs = _.get(res.data, "retVal", []);
-      const formattedLangs = langs.map((l) => ({
-        langCode: l.language || l.langCode || l,
-        langName: l.langName || l.language || l
-      }));
-      store2.set("I18N_LANGUAGES", langs);
-      return formattedLangs;
-    }
-  } catch (error) {
-    console.error("获取语言列表失败:", error);
-  }
+// 生成 JWT 的函数
+function generateJWT(orgCode) {
+  const header = {
+    alg: "HS512" // 算法
+  };
+  const payload = {
+    orgCode
+  };
+  const sHeader = JSON.stringify(header);
+  const sPayload = JSON.stringify(payload);
+  const secret = "";
+  // 同步生成 JWT
+  return jws.JWS.sign("HS512", sHeader, sPayload, secret);
+}
 
-  return [];
-};
+// 设置令牌
+setToken(token) {
+  this.token = token;
+  store2.set("I18N_TOKEN", token);
+}
 ```
 
-### 缓存策略和自动失效
-
-智能缓存机制具有以下特点：
-
-1. **本地缓存优先**：首次调用时从store2本地存储获取缓存数据
-2. **智能判断**：检查缓存数据的有效性（数组类型、长度大于0）
-3. **强制刷新**：通过isRemote参数强制从远程API获取最新数据
-4. **自动存储**：成功获取后自动存储到本地缓存
-5. **格式化输出**：统一返回标准化的语言列表格式
-
 **本节来源**
-- [packages/index.js:67-411](file://packages/index.js#L67-L411)
-- [packages/libs/i18nUtils.ts:1-54](file://packages/libs/i18nUtils.ts#L1-L54)
-- [packages/libs/service.js:1-187](file://packages/libs/service.js#L1-L187)
-- [packages/swal.css:1-18](file://packages/swal.css#L1-L18)
+- [packages/index.js:51-62](file://packages/index.js#L51-L62)
+- [packages/index.js:133-152](file://packages/index.js#L133-L152)
+- [packages/index.js:519-530](file://packages/index.js#L519-L530)
+- [packages/index.js:327-376](file://packages/index.js#L327-L376)
 
 ## Vue插件安装机制
 
@@ -532,15 +320,26 @@ I18n类作为Vue插件，通过install方法进行安装：
 install(app, opts = {}) {
   app.use(this.i18n);
   // 自动注册全局组件
-  // app.component("i18n-earth", earthVue);
+  app.component("i18n-earth", {
+    ...earthVue,
+    props: {
+      ...earthVue.props,
+      baseUrl: {
+        type: String,
+        default: this.baseUrl
+      }
+    }
+  });
 
   window.addEventListener("message", (event) => {
     if (event.data.type === "updateLanguage") {
       location.reload();
     }
-    // 新增：监听关闭弹窗消息
+    // 监听关闭弹窗消息
     if (event.data.type === "closeModal") {
-      this.configInstance && this.configInstance.closeModal();
+      if (this.swalInstance) {
+        this.swalInstance.close();
+      }
     }
   });
 }
@@ -565,7 +364,7 @@ this.i18n = createI18nCompat({
 
 const originalT = this.i18n.global.t;
 
-globalThis.$t = this.i18n.global.t = (key, comment) => {
+globalThis.$t = this.i18n.global.t = (key, defaultValue) => {
   // 记录本次调用的原始 key（字符串场景）
   if (typeof key === "string") {
     this.translationKeySet.add(key);
@@ -573,29 +372,37 @@ globalThis.$t = this.i18n.global.t = (key, comment) => {
   // Vue Router 3 (Vue2) currentRoute 为普通对象，Vue Router 4 (Vue3) 为 ref
   const route = this.router?.currentRoute;
   const routeName = (route?.value ?? route)?.name;
+  let result;
   if (routeName) {
     const routerKey = `${routeName}.${key}`;
     const routeTranslation = originalT(routerKey);
     if (routeTranslation !== routerKey && !_.isEmpty(routeTranslation)) {
-      return routeTranslation;
+      result = routeTranslation;
     } else {
       const commonKey = `common.${key}`;
       const commonTranslation = originalT(commonKey);
       if (commonTranslation !== commonKey) {
-        return commonTranslation;
+        result = commonTranslation;
       } else {
-        return originalT(key, comment);
+        result = originalT(key);
       }
     }
   } else {
-    return originalT(key, comment);
+    result = originalT(key);
   }
+
+  // 如果翻译不存在（返回的是 key 本身），则使用默认值
+  if (result === key && typeof defaultValue === "string" && defaultValue) {
+    result = defaultValue;
+  }
+
+  return result;
 };
 ```
 
 **本节来源**
-- [packages/index.js:400-411](file://packages/index.js#L400-L411)
-- [packages/index.js:242-307](file://packages/index.js#L242-L307)
+- [packages/index.js:505-530](file://packages/index.js#L505-L530)
+- [packages/index.js:306-408](file://packages/index.js#L306-L408)
 
 ## 公共API接口文档
 
@@ -735,9 +542,8 @@ const latestLanguages = await $getLanguages(true)
 ```
 
 **本节来源**
-- [packages/index.js:257-307](file://packages/index.js#L257-L307)
-- [packages/index.js:369-371](file://packages/index.js#L369-L371)
-- [packages/index.js:412-420](file://packages/index.js#L412-L420)
+- [packages/index.js:395-408](file://packages/index.js#L395-L408)
+- [packages/index.js:440-448](file://packages/index.js#L440-L448)
 
 ## RTL方向管理功能
 
@@ -913,15 +719,13 @@ async setLanguage(language = "zh-CN") {
 ```
 
 **本节来源**
-- [packages/index.js:68-136](file://packages/index.js#L68-L136)
-- [packages/index.js:310-343](file://packages/index.js#L310-L343)
-- [packages/libs/utils.js:3-22](file://packages/libs/utils.js#L3-L22)
+- [packages/index.js:410-435](file://packages/index.js#L410-L435)
 
 ## 中文语言模式兼容性
 
 ### 语言代码规范化机制
 
-**新增** I18n类引入了normalizeLocale方法，专门处理中文语言模式的兼容性支持：
+I18n类引入了normalizeLocale方法，专门处理中文语言模式的兼容性支持：
 
 ```javascript
 /**
@@ -931,7 +735,19 @@ async setLanguage(language = "zh-CN") {
  */
 normalizeLocale(locale) {
   if (!locale) return "zh-CN";
-  // 处理简写形式：zh -> zh-CN, en -> en-US
+  // 保留繁体中文变体
+  if (locale === "zh-TW" || locale === "zh-HK" || locale === "zh-MO") {
+    return locale;
+  }
+  // zh-SG 等其它 zh- 开头映射为 zh-CN
+  if (locale.startsWith("zh-")) {
+    return "zh-CN";
+  }
+  // en-* 全部映射为 en-US
+  if (locale.startsWith("en-")) {
+    return "en-US";
+  }
+  // 处理完全匹配形式
   const localeMap = {
     zh: "zh-CN",
     en: "en-US"
@@ -942,7 +758,7 @@ normalizeLocale(locale) {
 
 ### 中文简体和繁体支持
 
-**新增** 完整的中文语言模式支持，包括简体中文(zh-CN)和繁体中文(zh-TW)：
+完整的中文语言模式支持，包括简体中文(zh-CN)和繁体中文(zh-TW)：
 
 ```javascript
 // 语言资源文件包含简体和繁体中文翻译
@@ -968,7 +784,7 @@ normalizeLocale(locale) {
 
 ### 自动语言检测和回退机制
 
-**更新** 语言加载时的智能回退机制：
+语言加载时的智能回退机制：
 
 ```javascript
 async setLanguage(language = "zh-CN") {
@@ -1003,7 +819,7 @@ async setLanguage(language = "zh-CN") {
 
 ### 语言资源文件结构
 
-**新增** 语言资源文件采用JSON格式，支持多语言键值对：
+语言资源文件采用JSON格式，支持多语言键值对：
 
 ```json
 {
@@ -1021,7 +837,7 @@ async setLanguage(language = "zh-CN") {
 
 ### 中文语言模式最佳实践
 
-**新增** 使用中文语言模式的推荐做法：
+使用中文语言模式的推荐做法：
 
 ```javascript
 // 1. 使用规范化的语言代码
@@ -1039,135 +855,8 @@ await $changeLocale('zh-CN');  // 切换到简体中文
 ```
 
 **本节来源**
-- [packages/index.js:168-176](file://packages/index.js#L168-L176)
-- [packages/index.js:437-492](file://packages/index.js#L437-L492)
-- [lang/index.json:1-130](file://lang/index.json#L1-L130)
-
-## 单元代码支持功能
-
-### 单位代码配置机制
-
-**新增** I18n类引入了unitCode属性，用于支持单元代码（组织代码）的配置和管理：
-
-```javascript
-constructor(options = {}) {
-  // ... 其他初始化代码
-  this.unitCode = options.unitCode || "GREENCLOUD";
-  // ... 其他初始化代码
-}
-```
-
-### 默认值设置和环境检测
-
-**更新** 单元代码的默认值设置，结合环境检测机制：
-
-```javascript
-// 在语言包入口中，根据环境模式设置单元代码
-const i18n = new gc_i18n({
-  // ... 其他配置
-  orgCode: import.meta.env.MODE === "unit" ? "DD" : "GREENCLOUD",
-  // ...
-});
-```
-
-### 文本编辑模式中的单元代码集成
-
-**新增** 文本编辑模式中集成了unitCode支持，用于翻译数据的保存和检索：
-
-```javascript
-async saveTranslations(key, values, originalData) {
-  const original = originalData[0];
-  const unitCode = this.unitCode || "GREENCLOUD";
-  
-  const requestData = [];
-  Object.keys(values).forEach(lang => {
-    requestData.push({
-      appCode: this.appCode,
-      page: original.page,
-      key: key,
-      unitCode: unitCode,
-      lang: lang,
-      value: values[lang],
-      fromAi: "F"
-    });
-  });
-
-  const response = await saveTranslate({
-    data: { data: requestData, isLocal: "F" },
-    token: this.token,
-    baseUrl: this.baseUrl
-  });
-
-  return response;
-}
-```
-
-### 单元代码在配置系统中的应用
-
-**新增** 单元代码在配置系统中的完整应用流程：
-
-```javascript
-/**
- * 初始化配置
- */
-async initConfig() {
-  const i18nConfig = store2.get("I18N_CONFIG") || {};
-  const env = i18nConfig.env || "local";
-
-  // 根据环境设置 baseUrl
-  this.baseUrl =
-    !env || env === "local"
-      ? ""
-      : env === "dev"
-        ? "https://test.ihotel.cn"
-        : "https://trans.ihotel.cn";
-  
-  this.appCode = i18nConfig.appCode || "";
-  this.unitCode = i18nConfig.unitCode || "GREENCLOUD";
-  this.token = i18nConfig.token || store2.get("I18N_TOKEN") || "";
-  this.currentLocale = i18nConfig.locale || store2.get("I18N_LANGUAGE") || "zh-CN";
-  
-  await this.loadLanguages();
-}
-```
-
-### 单元代码的默认值策略
-
-**新增** 单元代码的默认值策略，确保在不同环境下的一致性：
-
-```javascript
-// 默认单元代码为 GREENCLOUD
-this.unitCode = options.unitCode || "GREENCLOUD";
-
-// 在语言包入口中，根据模式覆盖默认值
-const unitCode = import.meta.env.MODE === "unit" ? "DD" : "GREENCLOUD";
-```
-
-### 单元代码支持的最佳实践
-
-**新增** 使用单元代码支持的推荐做法：
-
-```javascript
-// 1. 在创建I18n实例时显式设置unitCode
-const i18n = new I18n({
-  unitCode: 'CUSTOM_UNIT_CODE',
-  appCode: 'MY_APP',
-  orgCode: 'ORG123'
-});
-
-// 2. 在不同环境使用不同的unitCode
-const unitCode = import.meta.env.MODE === "unit" ? "DD" : "GREENCLOUD";
-
-// 3. 在文本编辑模式中自动使用配置的unitCode
-await textEditMode.toggle();
-// 编辑的翻译数据将使用配置的unitCode保存
-```
-
-**本节来源**
-- [packages/index.js:70-125](file://packages/index.js#L70-L125)
-- [packages/libs/textEditMode.js:29-50](file://packages/libs/textEditMode.js#L29-L50)
-- [lang/index.js:10](file://lang/index.js#L10)
-- [lib/gc_i18n.es.js:1964-1966](file://lib/gc_i18n.es.js#L1964-L1966)
+- [packages/index.js:168-188](file://packages/index.js#L168-L188)
+- [packages/index.js:449-504](file://packages/index.js#L449-L504)
 
 ## 文本编辑模式功能
 
@@ -1192,6 +881,7 @@ handleElementClick[处理元素点击]
 openEditModal[打开编辑弹窗]
 fetchTranslations[获取翻译数据]
 saveTranslations[保存翻译数据]
+updateTranslatedText[更新翻译文本]
 end
 subgraph "快捷键绑定"
 keyboardJS[keyboardJS库]
@@ -1214,6 +904,7 @@ textEditMode --> handleElementClick
 textEditMode --> openEditModal
 textEditMode --> fetchTranslations
 textEditMode --> saveTranslations
+textEditMode --> updateTranslatedText
 keyboardJS --> editKeyboard
 textEditModeCSS --> i18nEditableText
 textEditModeCSS --> i18nEditModeActive
@@ -1221,9 +912,9 @@ swalCSS --> swal2Container
 ```
 
 **图示来源**
-- [packages/libs/textEditMode.js:14-623](file://packages/libs/textEditMode.js#L14-L623)
-- [packages/index.js:109-156](file://packages/index.js#L109-L156)
-- [packages/swal.css:1-18](file://packages/swal.css#L1-L18)
+- [packages/libs/textEditMode.js:14-624](file://packages/libs/textEditMode.js#L14-L624)
+- [packages/index.js:154-158](file://packages/index.js#L154-L158)
+- [packages/swal.css:1-23](file://packages/swal.css#L1-L23)
 
 ### 文本编辑模式快捷键配置
 
@@ -1269,7 +960,7 @@ enableEditMode() {
   // 显示提示
   Swal.fire({
     title: "文本编辑模式已开启",
-    text: "点击带蓝色虚线外框的文本即可编辑翻译内容，按 Ctrl+Shift+E 退出",
+    text: "点击带外框的文本即可编辑翻译内容，按 Ctrl+Shift+E 退出",
     icon: "info",
     timer: 2000,
     showConfirmButton: false,
@@ -1310,6 +1001,9 @@ scanTextNodes(rootElement) {
     const key = this.findKeyByValue(text);
     if (key) {
       this.wrapTextNode(textNode, key);
+    } else {
+      // 尝试从文本中提取可识别的翻译部分
+      this.wrapPartialTextNode(textNode);
     }
   });
 }
@@ -1317,7 +1011,7 @@ scanTextNodes(rootElement) {
 
 #### 查找翻译键
 
-**更新** 增强的键查找机制，支持更全面的键值映射：
+增强的键查找机制，支持更全面的键值映射：
 
 ```javascript
 findKeyByValue(value) {
@@ -1344,6 +1038,15 @@ findKeyByValue(value) {
     }
   }
 
+  // 从当前路由的翻译中查找（如果存在）
+  const routeMessagesKey = `I18N_MESSAGES_${this.currentLocale}`;
+  const routeMessages = store2.get(routeMessagesKey) || {};
+  for (const [key, val] of Object.entries(routeMessages)) {
+    if (val === value) {
+      return key;
+    }
+  }
+
   // 如果找不到，返回 null
   return null;
 }
@@ -1351,6 +1054,8 @@ findKeyByValue(value) {
 
 #### 打开编辑弹窗
 
+**更新** 使用SweetAlert2直接集成，简化了弹窗创建过程：
+
 ```javascript
 async openEditModal(key) {
   try {
@@ -1358,7 +1063,7 @@ async openEditModal(key) {
     if (key.startsWith("i.") || key.startsWith("pro.")) {
       // 显示 tips 提示
       Swal.fire({
-        text: "框架内部固定翻译，不支持修改",
+        text: "系统字段不支持修改",
         icon: "info",
         timer: 2000,
         showConfirmButton: false,
@@ -1372,6 +1077,20 @@ async openEditModal(key) {
     const translations = await this.fetchTranslations(key);
     console.log("translations", translations);
     const value = translations[0] || "";
+    
+    // 如果没有数据，显示提示
+    if (!value) {
+      Swal.fire({
+        text: "暂无翻译数据",
+        icon: "info",
+        timer: 2000,
+        showConfirmButton: false,
+        position: "top",
+        toast: true
+      });
+      return;
+    }
+
     // 构建编辑表单
     const langInputs =
       value &&
@@ -1393,9 +1112,10 @@ async openEditModal(key) {
         .join("");
 
     const { value: formValues } = await Swal.fire({
-      title: `编辑翻译 - ${key}`,
+      title: `原值参考:${value["zh-CN_raw"]}`,
       html: `
         <div class="i18n-edit-form">
+          <div id="i18n-save-error" style="display: none; margin-bottom: 15px; padding: 10px 15px; background: #fff1f0; border: 1px solid #ffa39e; border-radius: 4px; color: #cf1322; font-size: 13px;"></div>
           ${langInputs}
         </div>
       `,
@@ -1409,18 +1129,50 @@ async openEditModal(key) {
         title: "i18n-edit-modal-title",
         htmlContainer: "i18n-edit-modal-content"
       },
-      preConfirm: () => {
+      preConfirm: async () => {
         const inputs = document.querySelectorAll(".i18n-edit-input");
         const values = {};
         inputs.forEach((input) => {
           values[input.getAttribute("data-lang")] = input.value;
         });
-        return values;
+        
+        // 隐藏之前的错误信息
+        const errorDiv = document.getElementById("i18n-save-error");
+        if (errorDiv) {
+          errorDiv.style.display = "none";
+          errorDiv.textContent = "";
+        }
+
+        // 执行保存
+        try {
+          await this.saveTranslations(key, values, translations);
+          return values;
+        } catch (error) {
+          // 显示错误信息在弹窗顶部
+          if (errorDiv) {
+            errorDiv.textContent =
+              error.message || "保存失败，请检查网络连接或权限";
+            errorDiv.style.display = "block";
+          }
+          // 返回 false 阻止弹窗关闭
+          return false;
+        }
       }
     });
 
     if (formValues) {
-      await this.saveTranslations(key, formValues, translations);
+      // 保存成功后会自动关闭弹窗
+      this.updateTranslatedText(key, formValues);
+
+      // 显示成功提示
+      Swal.fire({
+        text: "保存成功",
+        icon: "success",
+        timer: 1500,
+        showConfirmButton: false,
+        position: "top",
+        toast: true
+      });
     }
   } catch (error) {
     console.error("打开编辑弹窗失败:", error);
@@ -1446,8 +1198,7 @@ async openEditModal(key) {
 /* 可编辑文本的外框样式 */
 .i18n-editable-text {
   position: relative;
-  outline: 2px dashed #2d8cf0 !important;
-  outline-offset: 2px;
+  outline: 1px dashed #2d8cf0 !important;
   cursor: pointer !important;
   background-color: rgba(45, 140, 240, 0.05);
   border-radius: 2px;
@@ -1461,8 +1212,8 @@ async openEditModal(key) {
   box-shadow: 0 0 8px rgba(45, 140, 240, 0.3);
 }
 
-/* 编辑模式提示标签 */
-.i18n-editable-text::after {
+/* 编辑模式提示标签 - 已禁用 */
+/* .i18n-editable-text::after {
   content: attr(data-i18n-key);
   position: absolute;
   top: -20px;
@@ -1483,12 +1234,12 @@ async openEditModal(key) {
 .i18n-editable-text:hover::after {
   opacity: 1;
   visibility: visible;
-}
+} */
 ```
 
 ### SweetAlert2样式集成优化
 
-**更新** SweetAlert2样式集成经过优化，提供更好的视觉体验：
+SweetAlert2样式集成经过优化，提供更好的视觉体验：
 
 ```css
 /* SweetAlert2 容器样式 */
@@ -1515,6 +1266,11 @@ async openEditModal(key) {
 div:where(.swal2-container) button:where(.swal2-close):focus-visible {
   box-shadow: none !important;
 }
+
+/* 全局 SweetAlert2 弹窗 z-index 设置，确保不被其他弹窗遮盖 */
+.swal2-container {
+  z-index: 99999 !important;
+}
 ```
 
 ### 非组件环境使用
@@ -1552,10 +1308,10 @@ if ($isRTL()) {
 ```
 
 **本节来源**
-- [packages/libs/textEditMode.js:1-623](file://packages/libs/textEditMode.js#L1-L623)
+- [packages/libs/textEditMode.js:14-624](file://packages/libs/textEditMode.js#L14-L624)
 - [packages/libs/textEditMode.css:1-166](file://packages/libs/textEditMode.css#L1-L166)
-- [packages/index.js:109-156](file://packages/index.js#L109-L156)
-- [packages/swal.css:1-18](file://packages/swal.css#L1-L18)
+- [packages/index.js:154-158](file://packages/index.js#L154-L158)
+- [packages/swal.css:1-23](file://packages/swal.css#L1-L23)
 
 ## 非组件环境使用
 
@@ -1684,8 +1440,7 @@ div:where(.swal2-container) button:where(.swal2-close):focus-visible {
 /* 可编辑文本的外框样式 */
 .i18n-editable-text {
   position: relative;
-  outline: 2px dashed #2d8cf0 !important;
-  outline-offset: 2px;
+  outline: 1px dashed #2d8cf0 !important;
   cursor: pointer !important;
   background-color: rgba(45, 140, 240, 0.05);
   border-radius: 2px;
@@ -1698,35 +1453,11 @@ div:where(.swal2-container) button:where(.swal2-close):focus-visible {
   background-color: rgba(45, 140, 240, 0.1);
   box-shadow: 0 0 8px rgba(45, 140, 240, 0.3);
 }
-
-/* 编辑模式提示标签 */
-.i18n-editable-text::after {
-  content: attr(data-i18n-key);
-  position: absolute;
-  top: -20px;
-  left: 0;
-  background: #2d8cf0;
-  color: white;
-  font-size: 11px;
-  padding: 2px 6px;
-  border-radius: 3px;
-  white-space: nowrap;
-  opacity: 0;
-  visibility: hidden;
-  transition: all 0.2s ease;
-  z-index: 9999;
-  pointer-events: none;
-}
-
-.i18n-editable-text:hover::after {
-  opacity: 1;
-  visibility: visible;
-}
 ```
 
 ### SweetAlert2样式集成
 
-**更新** SweetAlert2样式集成优化，提供更好的用户体验：
+SweetAlert2样式集成优化，提供更好的用户体验：
 
 ```css
 /* SweetAlert2 容器样式 */
@@ -1753,6 +1484,11 @@ div:where(.swal2-container) button:where(.swal2-close):focus-visible {
 div:where(.swal2-container) button:where(.swal2-close):focus-visible {
   box-shadow: none !important;
 }
+
+/* 全局 SweetAlert2 弹窗 z-index 设置，确保不被其他弹窗遮盖 */
+.swal2-container {
+  z-index: 99999 !important;
+}
 ```
 
 ### 样式特性
@@ -1768,12 +1504,11 @@ div:where(.swal2-container) button:where(.swal2-close):focus-visible {
 **本节来源**
 - [lib/gc_i18n.css](file://lib/gc_i18n.css)
 - [packages/libs/textEditMode.css:1-166](file://packages/libs/textEditMode.css#L1-L166)
-- [packages/swal.css:1-18](file://packages/swal.css#L1-L18)
-- [packages/index.js:338-343](file://packages/index.js#L338-L343)
+- [packages/swal.css:1-23](file://packages/swal.css#L1-L23)
 
 ## PostMessage事件处理功能
 
-**新增** I18n类现在支持通过postMessage事件编程控制模态框的关闭，扩展了原有的updateLanguage事件处理机制。
+I18n类现在支持通过postMessage事件编程控制模态框的关闭，扩展了原有的updateLanguage事件处理机制。
 
 ### 事件处理机制
 
@@ -1786,7 +1521,9 @@ window.addEventListener("message", (event) => {
   }
   // 新增：监听关闭弹窗消息
   if (event.data.type === "closeModal") {
-    this.configInstance && this.configInstance.closeModal();
+    if (this.swalInstance) {
+      this.swalInstance.close();
+    }
   }
 });
 ```
@@ -1803,7 +1540,7 @@ window.addEventListener("message", (event) => {
 
 - **用途**: 编程式关闭模态框
 - **触发条件**: 接收到type为"closeModal"的消息
-- **行为**: 调用configInstance.closeModal()关闭当前打开的配置模态框
+- **行为**: 调用this.swalInstance.close()关闭当前打开的配置模态框
 - **适用场景**: 外部应用程序需要程序化控制模态框的关闭
 
 ### 外部应用程序集成
@@ -1843,6 +1580,138 @@ const handleMessage = (event) => {
 4. **时机控制**: 在模态框真正打开后再发送closeModal事件
 
 **本节来源**
-- [packages/index.js:546-555](file://packages/index.js#L546-L555)
-- [packages/components/earth.js:122-128](file://packages/components/earth.js#L122-L128)
-- [lib/gc_i18n.es.js:2868-2870](file://lib/gc_i18n.es.js#L2868-L2870)
+- [packages/index.js:519-530](file://packages/index.js#L519-L530)
+
+## HTTP客户端集中式认证管理
+
+**新增** I18n类集成了Axios请求拦截器，实现了HTTP请求的集中式认证管理：
+
+### 请求拦截器实现
+
+```javascript
+// 独立 Axios 实例，避免宿主环境污染全局 axios
+const http = axios.create();
+
+// 添加请求拦截器，自动带上 token
+http.interceptors.request.use((config) => {
+  // 从 I18N_CONFIG 中获取 token
+  const i18nConfig = store2.get("I18N_CONFIG") || {};
+  const token = i18nConfig.token;
+  if (token) {
+    config.headers.Authorization = `Bearer ${token}`;
+  }
+  return config;
+});
+```
+
+### 认证令牌管理
+
+**更新** 新增了独立的Axios实例，避免宿主环境对全局axios配置的污染：
+
+```javascript
+// 独立 Axios 实例，避免宿主环境污染全局 axios
+const http = axios.create();
+
+export const getTranslate = async ({
+  baseUrl,
+  appCode,
+  language = "zh-CN",
+  token,
+  routerName
+}) => {
+  return new Promise(async (resolve, reject) => {
+    const languageStore = store2.namespace(`I18N_${_.toUpper(appCode)}`);
+    const options = {
+      baseUrl,
+      appCode,
+      language,
+      token
+    };
+    const lastData = languageStore.get(language);
+
+    if (!lastData || !lastData.lastPullDate) {
+      // 如果是第一次获取
+      const res = await fetchTranslate(options);
+      if (res) {
+        languageStore.set(language, res);
+        resolve(res.translatesDTOs);
+      }
+    } else {
+      const { lastPullDate } = lastData;
+      const res = await fetchTranslate({
+        ...options,
+        lastPullDate
+      });
+      if (res) {
+        // 合并增量数据
+        const langData = _.get(lastData, "translatesDTOs");
+        if (!_.isEmpty(res.translatesDTOs)) {
+          const data = mergeArraysByKey(
+            langData,
+            res.translatesDTOs,
+            routerName
+          );
+          const saveData = {
+            lastPullDate: res.lastPullDate,
+            translatesDTOs: data
+          };
+          const languageStore = store2.namespace(`I18N_${_.toUpper(appCode)}`);
+          languageStore.set(language, saveData, ":"); // Only update the specific key
+          resolve(data);
+        } else {
+          resolve(langData);
+        }
+      }
+    }
+  });
+};
+```
+
+### 服务层HTTP封装
+
+**更新** service.js文件也采用了相同的集中式认证管理模式：
+
+```javascript
+// 独立 Axios 实例，避免宿主环境拦截或修改全局 axios
+const http = axios.create();
+
+export const getLanguagesWithCache = async ({
+  baseUrl,
+  token,
+  appCode,
+  isRemote = false
+}) => {
+  // 先从缓存获取
+  const cached = store2.get("I18N_LANGUAGES");
+  if (cached && Array.isArray(cached) && cached.length > 0 && !isRemote) {
+    return cached.map((l) => ({
+      langCode: l.language || l.langCode || l,
+      langName: l.langName || l.language || l
+    }));
+  }
+
+  // 从 API 获取
+  if (!appCode) {
+    return [];
+  }
+
+  try {
+    const res = await http.get(`${baseUrl}/i18n-web//app/getsupportedlangs`, {
+      headers: {
+        appCode,
+        Authorization: token
+      }
+    });
+```
+
+### 认证流程优势
+
+1. **集中管理**: 所有HTTP请求都通过统一的拦截器处理认证
+2. **自动添加**: 无需在每个请求中手动添加Authorization头
+3. **环境隔离**: 独立的axios实例避免了宿主环境的干扰
+4. **令牌持久化**: 通过store2存储和管理认证令牌
+5. **错误处理**: 统一的认证错误处理机制
+
+**本节来源**
+- [packages/index.js:51-62](file://packages/index.js#L51-L62)
+- [packages/libs/service.js:7-45](file://packages/libs/service.js#L7-L45)