gc_i18n 1.4.3 → 1.4.5

package/.qoder/repowiki/zh/content/API /345/217/202/350/200/203.md"

@@ -2,25 +2,22 @@
 
 <cite>
 **本文档中引用的文件**   
+- [package.json](file://package.json) - *版本信息，从1.4.3升级到1.4.4*
 - [gc_i18n.es.js](file://lib/gc_i18n.es.js) - *在最近的提交中更新*
 - [i18nUtils.ts](file://packages/libs/i18nUtils.ts) - *在最近的提交中更新*
 - [service.js](file://packages/libs/service.js) - *在最近的提交中更新，包含关键逻辑变更*
 - [utils.js](file://packages/libs/utils.js) - *在最近的提交中更新，包含 mergeArraysByKey 函数*
 - [packages/index.js](file://packages/index.js) - *库的入口点，包含初始化逻辑*
-- [package.json](file://package.json) - *版本信息，从1.3.12升级到1.4.1*
 </cite>
 
 ## 更新摘要
 **变更内容**   
-- 移除了 `fetchTranslate` 函数中的 `page` 参数，更新了函数签名和参数说明
-- 版本从 1.3.12 升级到 1.4.1
-- 更新了 `service.js` 中 `getTranslate` 方法的文档，以反映其新的行为：当返回 `common` 类型的翻译时，会移除当前路由的数据
-- 更新了 `gc_i18n.es.js` 中 `$t` 方法的文档，详细说明了其新的查找优先级：先查找 `route.key`，再查找 `common.key`，最后查找全局 `key`
-- 更新了 `utils.js` 中 `mergeArraysByKey` 函数的文档，说明了其在合并数据时会移除与 `common` 键匹配的当前路由数据
-- 修正了 `service.js` 中 `fetchTranslate` 和 `getTranslate` 方法的返回值描述，使其与代码实现一致
+- 版本从 1.4.3 升级到 1.4.4
+- 更新了 `packages/index.js` 中路由守卫的 `closeModal` 功能集成
+- 更新了 `gc_i18n.es.js` 中 `$t` 方法的文档，详细说明了其新的查找优先级
+- 更新了 `utils.js` 中 `mergeArraysByKey` 函数的文档
+- 修正了 `service.js` 中 `fetchTranslate` 和 `getTranslate` 方法的返回值描述
 - 更新了所有受影响部分的源代码引用，以反映最新的文件状态
-- **新增**：标准化了后端翻译服务端点，从 `i18n-web//app/getsupportedlangs` 迁移到 `i18n-web/app/getsupportedlangs`
-- **新增**：引入了 `getLanguagesWithCache` 函数，提供带缓存的语言列表获取功能
 
 ## 目录
 1. [简介](#简介)
@@ -40,6 +37,7 @@
 - **语言切换**：通过 `$changeLocale` 方法动态切换当前语言环境。
 - **语言包管理**：通过 `service.js` 提供的接口从后端获取和更新翻译资源。
 - **工具支持**：提供静态分析工具函数，用于提取项目中的翻译键。
+- **模态框关闭**：通过 `closeModal` 方法统一管理 SweetAlert2 模态框的关闭。
 
 **Section sources**
 - [gc_i18n.es.js](file://lib/gc_i18n.es.js)
@@ -116,6 +114,41 @@ $changeLocale(locale: string): Promise<void>
 - [src/view/Home.vue](file://src/view/Home.vue#L2)
 - [src/view/login.vue](file://src/view/login.vue#L2)
 
+### closeModal (关闭模态框方法)
+此方法用于统一关闭 SweetAlert2 弹窗，确保模态框的正确销毁和资源清理。
+
+**方法签名**
+```typescript
+closeModal(): void
+```
+
+**参数**
+- 无参数
+
+**返回值**
+- `void` - 无返回值
+
+**副作用**
+- 关闭当前显示的 SweetAlert2 弹窗
+- 清理弹窗相关的事件监听器和 DOM 元素
+- 触发 `willClose` 和 `didClose` 事件回调
+- 释放内存资源，防止内存泄漏
+
+**使用限制**
+- 仅在 SweetAlert2 弹窗处于激活状态时有效
+- 调用后会触发弹窗的销毁流程，无法恢复
+
+**错误处理建议**
+- 确保在调用前检查弹窗是否已激活
+- 监听 `willClose` 和 `didClose` 事件以处理关闭后的逻辑
+- 在路由切换时自动调用此方法，避免弹窗残留
+
+**新增** 该方法作为 SweetAlert2 的别名方法，提供统一的模态框关闭接口。
+
+**Section sources**
+- [gc_i18n.es.js:1340-1350](file://lib/gc_i18n.es.js#L1340-L1350) - *新增 closeModal 方法实现*
+- [gc_i18n.es.js:1930-1932](file://lib/gc_i18n.es.js#L1930-L1932) - *closeModal 方法别名注册*
+
 ## i18nUtils.ts 工具函数
 `i18nUtils.ts` 文件提供了一个用于静态分析的工具函数，帮助开发者管理和审计翻译资源。
 
@@ -363,6 +396,16 @@ const keys = extractTranslationKeys(MyComponent);
 console.log(keys); // 输出: ["hello", "greeting"]
 ```
 
+### 路由守卫中集成 closeModal
+```javascript
+// 在路由守卫中自动关闭模态框
+this.router.beforeEach(async (to, from, next) => {
+  // 自动关闭配置中心弹窗
+  this.configInstance && this.configInstance.closeModal();
+  // 其他路由逻辑...
+});
+```
+
 ## 错误处理与限制
 - **网络错误**: `service.js` 中的所有异步方法都可能因网络问题而失败。务必使用 `try-catch` 或 `.catch()` 处理 Promise 拒绝。
 - **缓存失效**: `getTranslate` 依赖本地存储。如果用户清除浏览器数据，缓存将丢失，需要重新下载完整语言包。
@@ -371,5 +414,7 @@ console.log(keys); // 输出: ["hello", "greeting"]
 - **逻辑变更**: `getTranslate` 方法现在会移除 `common` 键覆盖的当前路由数据，这可能会影响某些依赖于特定键的组件。
 - **参数变更**: `fetchTranslate` 函数已移除 `page` 参数，使用时请注意更新调用方式。
 - **端点标准化**: 所有翻译服务端点已标准化为 `/i18n-web/...` 结构，确保了后端服务的一致性。
+- **模态框管理**: 新增的 `closeModal` 方法提供了统一的 SweetAlert2 弹窗管理，避免了弹窗残留问题。
+- **版本更新** 本版本为 1.4.4，包含上述重要变更，特别是路由守卫中自动调用 `closeModal` 的功能集成。
 
-**版本更新** 本版本为 1.4.1，包含上述重要变更，特别是后端翻译服务端点的标准化迁移和新增的带缓存语言列表获取功能。
+**版本更新** 本版本为 1.4.4，包含上述重要变更，特别是路由守卫中自动调用 `closeModal` 的功能集成。

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

@@ -24,6 +24,7 @@
 ## 更新摘要
 **变更内容**   
 - 核心I18n类完全重写，引入Vue 2/3兼容层和createI18nCompat函数
+- **新增单元代码支持功能**，在配置系统中引入unitCode属性，默认值为GREENCLOUD，增强了翻译数据结构和处理能力
 - **新增中文语言模式兼容性支持**，通过normalizeLocale方法支持zh-CN和zh-TW的自动规范化
 - **内部代码重构改进**，axios别名从Ve改为je，多个函数重命名等
 - 支持自动版本检测和适配，统一Vue 2和Vue 3的API差异
@@ -42,6 +43,7 @@
 - **安全机制改进**，新增JWT令牌验证和权限控制
 - **SweetAlert2集成优化**，改进变量命名和代码组织结构，提升可读性和维护性
 - **新增智能语言列表缓存机制**，通过getLanguagesWithCache提供缓存和自动失效功能
+- **新增postMessage事件处理功能**，扩展了原有的updateLanguage事件处理机制，允许外部应用程序通过postMessage事件编程关闭模态框
 
 ## 目录
 1. [项目结构分析](#项目结构分析)
@@ -50,9 +52,10 @@
 4. [公共API接口文档](#公共api接口文档)
 5. [RTL方向管理功能](#rtl方向管理功能)
 6. [中文语言模式兼容性](#中文语言模式兼容性)
-7. [文本编辑模式功能](#文本编辑模式功能)
-8. [非组件环境使用](#非组件环境使用)
-9. [样式文件作用](#样式文件作用)
+7. [单元代码支持功能](#单元代码支持功能)
+8. [文本编辑模式功能](#文本编辑模式功能)
+9. [非组件环境使用](#非组件环境使用)
+10. [样式文件作用](#样式文件作用)
 
 ## 项目结构分析
 
@@ -270,7 +273,7 @@ function _r(e, t) {
 
 ### 事件通知机制
 
-事件通知通过自定义事件系统实现，使用mitt事件发射器：
+**更新** 事件通知通过自定义事件系统实现，使用mitt事件发射器，新增了closeModal事件处理功能：
 
 ```javascript
 install(app, opts = {}) {
@@ -282,6 +285,10 @@ install(app, opts = {}) {
     if (event.data.type === "updateLanguage") {
       location.reload();
     }
+    // 新增：监听关闭弹窗消息
+    if (event.data.type === "closeModal") {
+      this.configInstance && this.configInstance.closeModal();
+    }
   });
 }
 ```
@@ -531,6 +538,10 @@ install(app, opts = {}) {
     if (event.data.type === "updateLanguage") {
       location.reload();
     }
+    // 新增：监听关闭弹窗消息
+    if (event.data.type === "closeModal") {
+      this.configInstance && this.configInstance.closeModal();
+    }
   });
 }
 ```
@@ -1032,6 +1043,132 @@ await $changeLocale('zh-CN');  // 切换到简体中文
 - [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)
+
 ## 文本编辑模式功能
 
 ### 文本编辑模式概述
@@ -1632,4 +1769,80 @@ 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/index.js:338-343](file://packages/index.js#L338-L343)
+
+## PostMessage事件处理功能
+
+**新增** I18n类现在支持通过postMessage事件编程控制模态框的关闭，扩展了原有的updateLanguage事件处理机制。
+
+### 事件处理机制
+
+I18n类通过window.addEventListener监听postMessage事件，支持两种类型的事件：
+
+```javascript
+window.addEventListener("message", (event) => {
+  if (event.data.type === "updateLanguage") {
+    location.reload();
+  }
+  // 新增：监听关闭弹窗消息
+  if (event.data.type === "closeModal") {
+    this.configInstance && this.configInstance.closeModal();
+  }
+});
+```
+
+### 事件类型说明
+
+#### updateLanguage事件
+
+- **用途**: 触发语言更新，重新加载页面
+- **触发条件**: 接收到type为"updateLanguage"的消息
+- **行为**: 调用location.reload()重新加载当前页面
+
+#### closeModal事件
+
+- **用途**: 编程式关闭模态框
+- **触发条件**: 接收到type为"closeModal"的消息
+- **行为**: 调用configInstance.closeModal()关闭当前打开的配置模态框
+- **适用场景**: 外部应用程序需要程序化控制模态框的关闭
+
+### 外部应用程序集成
+
+外部应用程序可以通过postMessage API向目标窗口发送关闭模态框的指令：
+
+```javascript
+// 向目标窗口发送关闭模态框指令
+targetWindow.postMessage({ type: "closeModal" }, "*");
+
+// 或者指定目标源
+targetWindow.postMessage({ type: "closeModal" }, "https://your-domain.com");
+```
+
+### 与Earth组件的协同
+
+Earth组件同样支持closeModal事件处理，确保组件间的一致性：
+
+```javascript
+const handleMessage = (event) => {
+  if (event.data && event.data.type === "updateLanguage") {
+    // 从 store 重新读取当前语言
+    currentLocale.value = store2.get("I18N_LANGUAGE") || "zh-CN";
+  }
+  // Earth组件也支持closeModal事件
+  if (event.data && event.data.type === "closeModal") {
+    // Earth组件的关闭逻辑
+  }
+};
+```
+
+### 最佳实践
+
+1. **事件类型区分**: 确保发送的事件类型正确，避免误触发
+2. **目标窗口确认**: 在生产环境中指定具体的目标源，提高安全性
+3. **错误处理**: 添加适当的错误处理机制，防止事件丢失
+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)

package/.qoder/repowiki/zh/content//350/257/255/350/250/200/350/265/204/346/272/220/347/256/241/347/220/206.md

@@ -8,7 +8,7 @@
 - [gc_i18n.es.js](file://lib/gc_i18n.es.js) - *在提交71b90fd中更新了搜索逻辑*
 - [earth.js](file://packages/components/earth.js) - *在提交71b90fd中更新了页面数据处理逻辑*
 - [service.js](file://packages/libs/service.js) - *新增appCode参数支持*
-- [packages/index.js](file://packages/index.js) - *新增appCode参数支持，新增文本编辑模式快捷键绑定*
+- [packages/index.js](file://packages/index.js) - *新增appCode参数支持，新增文本编辑模式快捷键绑定，增强语言兼容性处理*
 - [textEditMode.js](file://packages/libs/textEditMode.js) - *新增文本编辑模式功能*
 - [textEditMode.css](file://packages/libs/textEditMode.css) - *新增文本编辑模式样式*
 </cite>
@@ -27,6 +27,7 @@
 - **更新** [翻译键值对结构](#翻译键值对结构)章节，反映lang/index.json中新增的24个翻译键，扩展了国际化的支持范围
 - **更新** [fetchTranslate函数参数说明](#fetchtranslate函数参数说明)，移除了page参数的使用示例，确保文档与实际代码实现一致
 - **新增** [中文语言环境增强支持](#中文语言环境增强支持)章节，详细说明字符编码处理、中文排版支持等增强功能
+- **新增** [语言兼容性处理机制](#语言兼容性处理机制)章节，详细说明normalizeLocale方法的增强功能，支持更精细的中文变体处理和统一的英文区域变体处理
 
 ## 目录
 1. [项目结构](#项目结构)
@@ -47,6 +48,7 @@
 16. [快捷键绑定机制](#快捷键绑定机制)
 17. [文本编辑模式样式系统](#文本编辑模式样式系统)
 18. [中文语言环境增强支持](#中文语言环境增强支持)
+19. [语言兼容性处理机制](#语言兼容性处理机制)
 
 ## 项目结构
 
@@ -336,6 +338,10 @@ LoadTranslations --> End([应用就绪])
 	"fflhz3": {
 		"zh-cn": "日本語",
 		"zh-tw": "日本語"
+	},
+	"g9ioaz11": {
+		"zh-cn": "{{$values.id ===\"1\" ? \"新建预订\":\"修改预订\"}}",
+		"zh-tw": "{{$values.id ===\"1\" ? \"新建預訂\":\"修改預訂\"}}"
 	}
 }
 ```
@@ -343,6 +349,7 @@ LoadTranslations --> End([应用就绪])
 **更新** 新增了24个翻译条目，包括文本编辑模式的用户界面文本、快捷键说明和操作提示。这些新增条目主要集中在键值对的末尾部分，提供了完整的编辑模式功能支持。新增的翻译键包括：
 - **文本编辑模式界面文本**：`i55x296`、`7vs7of6`、`edmbfk8`（简体中文、繁体中文、日语内容）
 - **语言名称翻译**：`fwrpxp4`、`gkc0dp4`、`fflhz3`（简体中文、繁体中文、日语）
+- **条件翻译**：`g9ioaz11`（根据条件显示不同的翻译内容）
 
 翻译键值对的结构特点：
 - **键命名**：使用随机生成的短字符串作为键名（如qylb2），避免语义化键名带来的维护问题
@@ -357,7 +364,7 @@ LoadTranslations --> End([应用就绪])
 4. **工具友好**：便于自动化工具提取和管理翻译项
 
 **节来源**
-- [index.json:1-130](file://lang/index.json#L1-L130)
+- [index.json:1-134](file://lang/index.json#L1-L134)
 
 ## 语言文件命名规范与目录结构
 
@@ -535,7 +542,7 @@ this.$t('greeting', { name: '张三', count: 5 })
 
 **节来源**
 - [index.js:1-20](file://lang/index.js#L1-L20)
-- [index.json:1-130](file://lang/index.json#L1-L130)
+- [index.json:1-134](file://lang/index.json#L1-L134)
 
 ## JSON与JavaScript语言文件的适用场景
 
@@ -1310,4 +1317,114 @@ function processChineseText(text) {
 - [index.js](file://lang/index.js)
 - [index.json](file://lang/index.json)
 - [textEditMode.js](file://packages/libs/textEditMode.js)
-- [textEditMode.css](file://packages/libs/textEditMode.css)
+- [textEditMode.css](file://packages/libs/textEditMode.css)
+
+## 语言兼容性处理机制
+
+### normalizeLocale方法增强
+
+系统新增了强大的语言兼容性处理机制，通过增强的`normalizeLocale`方法支持更精细的语言变体处理和统一的区域变体处理。
+
+### 方法实现详解
+
+```javascript
+normalizeLocale(locale) {
+  if (!locale) return "zh-CN";
+  // 保留繁体中文变体
+  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"
+  };
+  return localeMap[locale] || locale;
+}
+```
+
+### 支持的语言变体
+
+#### 繁体中文变体保留
+- **zh-TW**：台湾繁体中文
+- **zh-HK**：香港繁体中文  
+- **zh-MO**：澳门繁体中文
+
+这些繁体中文变体将被完整保留，不会被映射到简体中文，确保地区化内容的准确性。
+
+#### 简体中文统一处理
+- **zh-CN**：中国大陆简体中文
+- **zh-SG**：新加坡简体中文
+- **zh-Hans**：简体中文（通用）
+
+所有以"zh-"开头的简体中文变体都会被统一映射到"zh-CN"，确保简体中文内容的一致性。
+
+#### 英文统一处理
+- **en-US**：美国英语
+- **en-GB**：英国英语
+- **en-CA**：加拿大英语
+- **en-AU**：澳大利亚英语
+- **en-IE**：爱尔兰英语
+- **en-NZ**：新西兰英语
+- **en-ZA**：南非英语
+
+所有以"en-"开头的英文变体都会被统一映射到"en-US"，提供统一的英文用户体验。
+
+### 浏览器语言监听
+
+系统还集成了浏览器语言变化监听机制：
+
+```javascript
+setupLanguageChangeListener() {
+  if ("onlanguagechange" in window) {
+    window.addEventListener("languagechange", () => {
+      const newBrowserLanguage = this.normalizeLocale(navigator.language);
+      if (newBrowserLanguage !== this.locale) {
+        this.setLanguage(newBrowserLanguage);
+      }
+    });
+  }
+}
+```
+
+当用户的浏览器语言发生变化时，系统会自动检测并应用合适的语言设置。
+
+### 使用示例
+
+```javascript
+// 不同语言代码的规范化处理
+console.log(normalizeLocale("zh-TW")); // 输出: "zh-TW" (保留不变)
+console.log(normalizeLocale("zh-HK")); // 输出: "zh-HK" (保留不变)
+console.log(normalizeLocale("zh-MO")); // 输出: "zh-MO" (保留不变)
+console.log(normalizeLocale("zh-SG")); // 输出: "zh-CN" (映射到简体中文)
+console.log(normalizeLocale("en-GB")); // 输出: "en-US" (映射到美式英语)
+console.log(normalizeLocale("en-CA")); // 输出: "en-US" (映射到美式英语)
+console.log(normalizeLocale("zh"));    // 输出: "zh-CN" (完全匹配)
+console.log(normalizeLocale("en"));    // 输出: "en-US" (完全匹配)
+```
+
+### 实际应用场景
+
+1. **多地区部署**：支持中国大陆、台湾、香港、澳门等不同地区的语言需求
+2. **全球化应用**：统一处理不同英语国家的语言偏好
+3. **浏览器兼容**：自动适配用户浏览器的语言设置
+4. **动态语言切换**：支持运行时的语言环境调整
+
+### 性能优化考虑
+
+- **快速匹配**：使用简单的字符串比较和前缀检查
+- **缓存机制**：避免重复的语言代码处理
+- **浏览器支持检测**：仅在支持的浏览器中启用语言变化监听
+- **回退机制**：当语言代码无效时自动回退到默认语言
+
+**节来源**
+- [packages/index.js:168-188](file://packages/index.js#L168-L188)
+- [packages/index.js:191-200](file://packages/index.js#L191-L200)

package/.qoder/repowiki/zh/content//351/205/215/347/275/256/351/200/211/351/241/271.md

@@ -8,20 +8,18 @@
 - [lang/index.js](file://lang/index.js)
 - [packages/libs/service.js](file://packages/libs/service.js)
 - [packages/libs/i18nUtils.ts](file://packages/libs/i18nUtils.ts)
+- [packages/libs/textEditMode.js](file://packages/libs/textEditMode.js)
 - [packages/swal.css](file://packages/swal.css)
 - [package.json](file://package.json)
-- [packages/libs/textEditMode.js](file://packages/libs/textEditMode.js)
 - [packages/libs/textEditMode.css](file://packages/libs/textEditMode.css)
 </cite>
 
 ## 更新摘要
 **所做更改**   
-- 版本从1.4.1升级到1.4.2
-- SweetAlert2模态对话框的z-index增强，确保不被其他弹窗遮盖
-- 更新了基础URL配置，将 `https://i18n.ihotel.cn` 更新为 `https://trans.ihotel.cn`
-- 标准化了API端点路径，移除了重复的斜杠
-- 更新了环境配置说明，反映最新的URL变更
-- 修正了iframe配置的URL结构说明
+- 新增了 `unitCode` 配置选项，允许在配置系统中指定单位代码，默认值为 "GREENCLOUD"
+- 更新了版本号至 1.4.3
+- 修正了 `orgCode` 配置的默认值说明，从 "DD" 改为 "GREENCLOUD"
+- 更新了企业环境配置说明，反映 `unitCode` 的作用
 
 ## 目录
 1. [i18n构建配置](#i18n构建配置)  
@@ -126,7 +124,7 @@ external: [
 - **样式**: 提供专门的CSS样式支持编辑模式的视觉反馈
 
 **Section sources**
-- [packages/index.js:67-547](file://packages/index.js#L67-L547)
+- [packages/index.js:67-559](file://packages/index.js#L67-L559)
 
 ## 初始化配置对象
 
@@ -164,6 +162,7 @@ external: [
 - **login**: 是否启用登录功能
 - **messages**: 预定义的语言消息对象
 - **editKeyboard**: 文本编辑模式快捷键，默认为 "ctrl+shift+e"
+- **unitCode**: 单位代码，默认值为 "GREENCLOUD"，用于企业环境中的翻译范围控制
 
 **Section sources**
 - [src/main.js:1-12](file://src/main.js#L1-L12)
@@ -181,7 +180,7 @@ external: [
 | **appCode** | String | null | 任意字符串 | 应用标识符，用于区分不同应用 |
 | **messages** | Object | {} | 包含语言代码为键的对象 | 预定义的语言消息，用于快速加载 |
 | **token** | String | generateJWT(orgCode) 或 localStorage 中的 I18N_TOKEN | JWT token | 用于认证请求语言资源 |
-| **orgCode** | String | null | 任意字符串 | 用于生成 JWT token 的组织代码 |
+| **orgCode** | String | "GREENCLOUD" | 任意字符串 | 用于生成 JWT token 的组织代码 |
 | **loginRouteName** | String | "login" | 任意字符串 | 登录页面的路由名称 |
 | **login** | Boolean | false | true/false | 是否启用登录功能 |
 | **keyboard** | String | "ctrl+shift+l" | 键盘快捷键组合 | 触发展示配置iframe的快捷键 |
@@ -189,6 +188,7 @@ external: [
 | **env** | String | "local" | "local"、"dev"、"production" | 环境模式，决定baseUrl |
 | **locale** | String | 浏览器语言或 "zh-CN" | 有效的语言代码 | 默认语言设置 |
 | **baseUrl** | String | 根据env计算 | "local"、"dev"、"production" 或自定义URL | 语言服务基础URL |
+| **unitCode** | String | "GREENCLOUD" | 任意字符串 | 单位代码，用于企业环境中的翻译范围控制 |
 
 ### 环境配置详解
 
@@ -279,8 +279,19 @@ baseUrl: "https://custom-domain.com"
 | **iframeMinHeight** | String | "480px" | CSS 值 | iframe最小高度 |
 | **iframeBorderStyle** | String | "none" | CSS 值 | iframe边框样式 |
 
+### 企业环境配置详解
+
+**新增** `unitCode` 配置选项用于企业环境中的翻译范围控制：
+
+- **默认值**: `"GREENCLOUD"`
+- **作用**: 控制翻译资源的访问范围，确保不同单位或部门的翻译数据相互隔离
+- **应用场景**: 
+  - 多租户环境下的数据隔离
+  - 不同业务单元的翻译范围控制
+  - 企业内部的权限管理
+
 **Section sources**
-- [packages/index.js:67-547](file://packages/index.js#L67-L547)
+- [packages/index.js:67-559](file://packages/index.js#L67-L559)
 - [vite.config.js:1-72](file://vite.config.js#L1-L72)
 - [packages/swal.css:1-23](file://packages/swal.css#L1-L23)
 - [package.json:13-20](file://package.json#L13-L20)
@@ -316,6 +327,41 @@ const i18nInstance = new gc_i18n({
 });
 ```
 
+### 企业环境配置示例
+
+#### 默认企业环境配置
+```js
+const i18nInstance = new gc_i18n({
+  appCode: "ENTERPRISE_APP",
+  router: router,
+  orgCode: "GREENCLOUD",  // 默认值
+  unitCode: "GREENCLOUD", // 默认值
+  env: "dev"
+});
+```
+
+#### 自定义单位代码配置
+```js
+const i18nInstance = new gc_i18n({
+  appCode: "CUSTOM_UNIT_APP",
+  router: router,
+  orgCode: "CUSTOM_ORG",
+  unitCode: "CUSTOM_UNIT_001",  // 自定义单位代码
+  env: "production"
+});
+```
+
+#### 多租户环境配置
+```js
+const i18nInstance = new gc_i18n({
+  appCode: "MULTI_TENANT_APP",
+  router: router,
+  orgCode: "TENANT_A",
+  unitCode: "UNIT_A_001",  // 租户A的单位代码
+  env: "dev"
+});
+```
+
 ### 环境分离配置示例
 
 #### 本地开发环境
@@ -451,6 +497,6 @@ export default {
 
 **Section sources**
 - [lang/index.js:16-33](file://lang/index.js#L16-L33)
-- [packages/index.js:67-547](file://packages/index.js#L67-L547)
+- [packages/index.js:67-559](file://packages/index.js#L67-L559)
 - [packages/swal.css:1-23](file://packages/swal.css#L1-L23)
 - [packages/libs/textEditMode.css:1-166](file://packages/libs/textEditMode.css#L1-L166)