gc_i18n 1.3.13 → 1.4.1

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

@@ -7,11 +7,13 @@
 - [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.3.13*
 </cite>
 
 ## 更新摘要
 **变更内容**   
-- 更新了服务端点路径：`/i18n-web/sysoption/getsupportedlangs` 已更新为 `/i18n-web/app/getsupportedlangs`
+- 移除了 `fetchTranslate` 函数中的 `page` 参数，更新了函数签名和参数说明
+- 版本从 1.3.12 升级到 1.3.13
 - 更新了 `service.js` 中 `getTranslate` 方法的文档，以反映其新的行为：当返回 `common` 类型的翻译时，会移除当前路由的数据
 - 更新了 `gc_i18n.es.js` 中 `$t` 方法的文档，详细说明了其新的查找优先级：先查找 `route.key`，再查找 `common.key`，最后查找全局 `key`
 - 更新了 `utils.js` 中 `mergeArraysByKey` 函数的文档，说明了其在合并数据时会移除与 `common` 键匹配的当前路由数据
@@ -74,7 +76,7 @@ $t(key: string): string
 **更新** 该方法的查找逻辑已更新，优先级为：`当前路由名.key` > `common.key` > `key`。
 
 **Section sources**
-- [gc_i18n.es.js](file://lib/gc_i18n.es.js#L272-L297) - *更新了 $t 方法的实现*
+- [gc_i18n.es.js:272-297](file://lib/gc_i18n.es.js#L272-L297) - *更新了 $t 方法的实现*
 - [src/view/Home.vue](file://src/view/Home.vue#L19)
 - [src/view/login.vue](file://src/view/login.vue#L10)
 
@@ -108,7 +110,7 @@ $changeLocale(locale: string): Promise<void>
 **更新** 该方法的实现已更新，现在通过调用 `setLanguage` 方法来完成核心逻辑。
 
 **Section sources**
-- [gc_i18n.es.js](file://lib/gc_i18n.es.js#L316-L321) - *更新了 $changeLocale 方法的实现*
+- [gc_i18n.es.js:316-321](file://lib/gc_i18n.es.js#L316-L321) - *更新了 $changeLocale 方法的实现*
 - [src/view/Home.vue](file://src/view/Home.vue#L2)
 - [src/view/login.vue](file://src/view/login.vue#L2)
 
@@ -139,7 +141,7 @@ function extractTranslationKeys(component: any): string[]
 - 开发者手动检查组件，以确保所有翻译键都已定义。
 
 **Section sources**
-- [i18nUtils.ts](file://packages/libs/i18nUtils.ts#L1-L54) - *文件内容未变，但其提取的键会影响 $t 的行为*
+- [i18nUtils.ts:1-54](file://packages/libs/i18nUtils.ts#L1-L54) - *文件内容未变，但其提取的键会影响 $t 的行为*
 
 ## service.js 异步接口
 `service.js` 封装了与后端语言服务通信的异步接口，负责获取和管理翻译数据。
@@ -160,20 +162,17 @@ getLanguages({ baseUrl, token, appCode }: { baseUrl: string; token: string; appC
 **返回值**
 - `Promise<any>` - 一个 Promise，resolve 时返回包含支持语言列表的响应对象。
 
-**更新** 服务端点已从 `/i18n-web/sysoption/getsupportedlangs` 更新为 `/i18n-web/app/getsupportedlangs`。
-
 **Section sources**
-- [service.js](file://packages/libs/service.js#L10-L19)
+- [service.js:63-72](file://packages/libs/service.js#L63-L72)
 
 ### fetchTranslate (获取翻译数据)
-根据应用代码、语言、页面等信息，从后端获取翻译数据。
+根据应用代码、语言等信息，从后端获取翻译数据。
 
 **方法签名**
 ```typescript
-fetchTranslate({ appCode, language, page, lastPullDate, baseUrl, token }: { 
+fetchTranslate({ appCode, language, lastPullDate, baseUrl, token }: { 
   appCode: string; 
   language?: string; 
-  page?: string; 
   lastPullDate?: string; 
   baseUrl: string; 
   token: string; 
@@ -183,7 +182,6 @@ fetchTranslate({ appCode, language, page, lastPullDate, baseUrl, token }: {
 **参数**
 - **appCode**: `string` - 应用的唯一标识码。
 - **language**: `string` (可选, 默认: `"zh-CN"`) - 目标语言。
-- **page**: `string` (可选) - 当前页面标识。
 - **lastPullDate**: `string` (可选) - 上次拉取数据的时间戳，用于增量更新。
 - **baseUrl**: `string` - 后端服务的基础 URL。
 - **token**: `string` - 用于身份验证的授权令牌。
@@ -191,10 +189,10 @@ fetchTranslate({ appCode, language, page, lastPullDate, baseUrl, token }: {
 **返回值**
 - `Promise<any>` - 一个 Promise，resolve 时返回包含翻译数据的对象。如果请求成功，`res.data.result` 为 0，则返回 `res.data.retVal`；否则返回整个 `res` 对象。
 
-**更新** 修正了返回值描述，使其与代码中的 `resolve(res)` 逻辑一致。
+**更新** 移除了 `page` 参数，更新了函数签名和参数说明。
 
 **Section sources**
-- [service.js](file://packages/libs/service.js#L21-L50)
+- [service.js:74-101](file://packages/libs/service.js#L74-L101)
 
 ### getTranslate (获取翻译数据 - 增强版)
 此方法是 `fetchTranslate` 的增强版，它结合了本地存储（`store2`）来实现数据缓存和增量更新。
@@ -233,7 +231,7 @@ getTranslate({ baseUrl, appCode, language, token, routerName }: {
 **更新** 该方法的行为已更新，当从后端获取到 `common` 类型的翻译时，会移除当前路由中同名的翻译数据。
 
 **Section sources**
-- [service.js](file://packages/libs/service.js#L82-L135) - *更新了 getTranslate 方法的实现*
+- [service.js:133-186](file://packages/libs/service.js#L133-L186) - *更新了 getTranslate 方法的实现*
 
 ### userDicts (用户词典)
 提交用户自定义的翻译词典。
@@ -252,7 +250,7 @@ userDicts({ data, token, baseUrl }: { data: any; token: string; baseUrl: string
 - `Promise<any>` - 请求的响应。
 
 **Section sources**
-- [service.js](file://packages/libs/service.js#L61-L70)
+- [service.js:112-121](file://packages/libs/service.js#L112-L121)
 
 ### saveTranslate (保存翻译)
 批量保存翻译数据。
@@ -271,7 +269,7 @@ saveTranslate({ data, token, baseUrl }: { data: any; token: string; baseUrl: str
 - `Promise<any>` - 请求的响应。
 
 **Section sources**
-- [service.js](file://packages/libs/service.js#L72-L81)
+- [service.js:123-132](file://packages/libs/service.js#L123-L132)
 
 ## 使用示例与最佳实践
 
@@ -328,4 +326,6 @@ console.log(keys); // 输出: ["hello", "greeting"]
 - **类型安全**: `extractTranslationKeys` 的参数类型为 `any`，缺乏严格的类型检查，使用时需确保传入的是有效的组件对象。
 - **性能**: 频繁调用 `$changeLocale` 会导致应用重新渲染，应避免在短时间内多次调用。
 - **逻辑变更**: `getTranslate` 方法现在会移除 `common` 键覆盖的当前路由数据，这可能会影响某些依赖于特定键的组件。
-- **服务端点变更**: 注意服务端点已从 `/i18n-web/sysoption/getsupportedlangs` 更新为 `/i18n-web/app/getsupportedlangs`，请确保后端配置正确。
+- **参数变更**: `fetchTranslate` 函数已移除 `page` 参数，使用时请注意更新调用方式。
+
+**版本更新** 本版本为 1.3.13，包含上述重要变更。

package/.qoder/repowiki/zh/content//345/267/245/345/205/267/345/207/275/346/225/260.md

@@ -6,6 +6,7 @@
 - [i18nUtils.ts](file://packages/libs/i18nUtils.ts)
 - [service.js](file://packages/libs/service.js)
 - [index.js](file://packages/index.js)
+- [textEditMode.js](file://packages/libs/textEditMode.js)
 - [gc_i18n.js](file://lib/gc_i18n.js)
 </cite>
 
@@ -34,29 +35,33 @@ A[utils.js] --> |提供| B[通用辅助函数]
 A --> |新增| C[RTL语言检测函数]
 D[i18nUtils.ts] --> |提供| E[i18n专用工具]
 F[service.js] --> |提供| G[外部服务接口]
+H[textEditMode.js] --> |提供| I[文本编辑模式]
 end
 subgraph "入口与整合"
-H[index.js] --> |整合并使用| A
-H --> |整合并使用| D
-H --> |整合并使用| F
+J[index.js] --> |整合并使用| A
+J --> |整合并使用| D
+J --> |整合并使用| F
+J --> |整合并使用| H
 end
 subgraph "核心库"
-I[gc_i18n.js] --> |定义| J[Po, Mo, Pa, qn等函数]
-H --> |依赖| I
+K[gc_i18n.js] --> |定义| L[Po, Mo, Pa, qn等函数]
+J --> |依赖| K
 end
 subgraph "应用层"
-K[src] --> |使用| H
+M[src] --> |使用| J
 end
-A --> H
-D --> H
-F --> H
-I --> H
+A --> J
+D --> J
+F --> J
+H --> J
+K --> J
 ```
 
 **图示来源**
 - [utils.js](file://packages/libs/utils.js)
 - [i18nUtils.ts](file://packages/libs/i18nUtils.ts)
 - [service.js](file://packages/libs/service.js)
+- [textEditMode.js](file://packages/libs/textEditMode.js)
 - [index.js](file://packages/index.js)
 - [gc_i18n.js](file://lib/gc_i18n.js)
 
@@ -65,11 +70,12 @@ I --> H
 - [utils.js](file://packages/libs/utils.js)
 - [i18nUtils.ts](file://packages/libs/i18nUtils.ts)
 - [service.js](file://packages/libs/service.js)
+- [textEditMode.js](file://packages/libs/textEditMode.js)
 - [index.js](file://packages/index.js)
 
 ## 核心工具模块分析
 
-本项目的核心工具模块由 `packages/libs` 目录下的三个文件构成：`utils.js` 提供通用的JavaScript辅助函数；`i18nUtils.ts` 专注于国际化流程中的特定任务，如提取翻译键；`service.js` 则封装了与后端服务器通信的API，用于加载和保存语言包。这些模块在 `packages/index.js` 中被统一导入和整合，最终暴露为一个完整的 `I18n` 类供应用使用。
+本项目的核心工具模块由 `packages/libs` 目录下的四个文件构成：`utils.js` 提供通用的JavaScript辅助函数；`i18nUtils.ts` 专注于国际化流程中的特定任务，如提取翻译键；`service.js` 则封装了与后端服务器通信的API，用于加载和保存语言包；`textEditMode.js` 提供了文本编辑模式功能。这些模块在 `packages/index.js` 中被统一导入和整合，最终暴露为一个完整的 `I18n` 类供应用使用。
 
 ## 国际化工具函数 (i18nUtils.ts)
 
@@ -321,10 +327,12 @@ RTL检测功能完善了国际化系统的用户体验，特别是在处理阿
 
 #### `fetchTranslate`
 - **功能**: 从服务器获取翻译数据。支持通过 `lastPullDate` 参数进行增量拉取。
-- **参数**: `{ appCode, language, page, lastPullDate, baseUrl, token }`
+- **参数**: `{ appCode, language, lastPullDate, baseUrl, token }`
 - **返回**: Promise，解析为翻译数据对象。
 - **HTTP请求**: `GET /i18n-web/kv_translate/kv_translates`
 
+**更新** 移除了 `page` 参数的相关描述，保持与其他文档的一致性。
+
 #### `getTranslate`
 - **功能**: 这是 `service.js` 中最复杂的函数，它结合了本地缓存和远程请求，实现了智能的语言包加载策略。
 - **流程**:
@@ -372,7 +380,7 @@ end
 
 ## 模块整合与协作关系
 
-`packages/index.js` 作为主入口文件，负责将 `utils.js`、`i18nUtils.ts` 和 `service.js` 三个工具模块整合成一个完整的 `I18n` 类。
+`packages/index.js` 作为主入口文件，负责将 `utils.js`、`i18nUtils.ts`、`service.js` 和 `textEditMode.js` 四个工具模块整合成一个完整的 `I18n` 类。
 
 ### 协作流程
 
@@ -384,7 +392,8 @@ end
     -   `getTranslate` 内部会调用 `utils.js` 的 `convertArrayToObject` 将数据转换为 `vue-i18n` 可用的格式。
 4.  **数据加载**: `getTranslate` 函数在 `service.js` 中定义，但其内部调用的 `Uo`、`qn`、`Mo`、`Po` 等函数实际定义在 `lib/gc_i18n.js` 中，这表明 `service.js` 依赖于核心库。
 5.  **RTL方向更新**: 在语言切换时，系统会重新检测RTL状态并更新文档方向。
-6.  **最终整合**: `index.js` 将所有功能整合后，通过 `install` 方法注入到Vue应用中，使 `$t` 等全局函数可用。
+6.  **文本编辑模式**: `textEditMode.js` 提供了额外的文本编辑功能，支持页面和路由级别的翻译管理。
+7.  **最终整合**: `index.js` 将所有功能整合后，通过 `install` 方法注入到Vue应用中，使 `$t` 等全局函数可用。
 
 ### 关键协作点
 -   `index.js` 使用 `i18nUtils.ts` 进行**键的提取**。
@@ -392,6 +401,7 @@ end
 -   `service.js` 使用 `utils.js` 进行**数据的转换和合并**。
 -   `index.js` 使用 `utils.js` 的 `isRTLLocale` 进行**RTL语言检测**。
 -   `service.js` 依赖 `gc_i18n.js` 提供的底层**网络请求和缓存函数**。
+-   `textEditMode.js` 与 `service.js` 协作，提供**文本编辑和翻译管理**功能。
 
 ### RTL功能的完整协作链
 ```mermaid
@@ -413,4 +423,5 @@ G --> H[提供isRTL实例方法]
 - [utils.js](file://packages/libs/utils.js)
 - [i18nUtils.ts](file://packages/libs/i18nUtils.ts)
 - [service.js](file://packages/libs/service.js)
+- [textEditMode.js](file://packages/libs/textEditMode.js)
 - [gc_i18n.js](file://lib/gc_i18n.js)

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

@@ -24,6 +24,8 @@
 ## 更新摘要
 **变更内容**   
 - 核心I18n类完全重写，引入Vue 2/3兼容层和createI18nCompat函数
+- **新增中文语言模式兼容性支持**，通过normalizeLocale方法支持zh-CN和zh-TW的自动规范化
+- **内部代码重构改进**，axios别名从Ve改为je，多个函数重命名等
 - 支持自动版本检测和适配，统一Vue 2和Vue 3的API差异
 - 增强路由守卫机制，支持动态组件加载和翻译键收集
 - 重构翻译查找机制，支持路由特定键和通用键的优先级处理
@@ -47,9 +49,10 @@
 3. [Vue插件安装机制](#vue插件安装机制)
 4. [公共API接口文档](#公共api接口文档)
 5. [RTL方向管理功能](#rtl方向管理功能)
-6. [文本编辑模式功能](#文本编辑模式功能)
-7. [非组件环境使用](#非组件环境使用)
-8. [样式文件作用](#样式文件作用)
+6. [中文语言模式兼容性](#中文语言模式兼容性)
+7. [文本编辑模式功能](#文本编辑模式功能)
+8. [非组件环境使用](#非组件环境使用)
+9. [样式文件作用](#样式文件作用)
 
 ## 项目结构分析
 
@@ -511,7 +514,7 @@ export const getLanguagesWithCache = async ({
 **本节来源**
 - [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-188](file://packages/libs/service.js#L1-L188)
+- [packages/libs/service.js:1-187](file://packages/libs/service.js#L1-L187)
 - [packages/swal.css:1-18](file://packages/swal.css#L1-L18)
 
 ## Vue插件安装机制
@@ -903,6 +906,132 @@ async setLanguage(language = "zh-CN") {
 - [packages/index.js:310-343](file://packages/index.js#L310-L343)
 - [packages/libs/utils.js:3-22](file://packages/libs/utils.js#L3-L22)
 
+## 中文语言模式兼容性
+
+### 语言代码规范化机制
+
+**新增** I18n类引入了normalizeLocale方法，专门处理中文语言模式的兼容性支持：
+
+```javascript
+/**
+ * 规范化语言代码，兼容浏览器语言简写
+ * @param {string} locale - 原始语言代码
+ * @returns {string} 规范化后的语言代码
+ */
+normalizeLocale(locale) {
+  if (!locale) return "zh-CN";
+  // 处理简写形式：zh -> zh-CN, en -> en-US
+  const localeMap = {
+    zh: "zh-CN",
+    en: "en-US"
+  };
+  return localeMap[locale] || locale;
+}
+```
+
+### 中文简体和繁体支持
+
+**新增** 完整的中文语言模式支持，包括简体中文(zh-CN)和繁体中文(zh-TW)：
+
+```javascript
+// 语言资源文件包含简体和繁体中文翻译
+{
+  "qylb2": {
+    "zh-cn": "首页",      // 简体中文
+    "zh-tw": "首頁"       // 繁體中文
+  },
+  "jcve2": {
+    "zh-cn": "测试",
+    "zh-tw": "測試"
+  },
+  "i55x296": {
+    "zh-cn": "简体中文内容",
+    "zh-tw": "簡體中文內容"
+  },
+  "7vs7of6": {
+    "zh-cn": "繁體中文內容",
+    "zh-tw": "繁體中文內容"
+  }
+}
+```
+
+### 自动语言检测和回退机制
+
+**更新** 语言加载时的智能回退机制：
+
+```javascript
+async setLanguage(language = "zh-CN") {
+  // 规范化语言代码
+  language = this.normalizeLocale(language);
+  const commonMessagesKey = "I18N_MESSAGES_COMMON_" + language;
+  let commonMessages = store2.get(commonMessagesKey);
+  if (_.isEmpty(commonMessages)) {
+    try {
+      const lang = await http.get(
+        `https://cdn.ihotel.cn/i18n_messages/${language}.json`
+      );
+      if (lang) {
+        const { data } = lang;
+        commonMessages = data;
+        store2.set(commonMessagesKey, data);
+      }
+    } catch (error) {
+      // 请求失败时，如果是非 zh-CN，则回退到 zh-CN
+      if (language !== "zh-CN") {
+        console.warn(`语言 ${language} 加载失败，回退到 zh-CN`, error);
+        return this.setLanguage("zh-CN");
+      }
+      // 如果 zh-CN 也失败了，使用空对象
+      console.error("zh-CN 语言文件加载失败", error);
+      commonMessages = {};
+    }
+  }
+  // ... 其他语言切换逻辑
+}
+```
+
+### 语言资源文件结构
+
+**新增** 语言资源文件采用JSON格式，支持多语言键值对：
+
+```json
+{
+  "message_key": {
+    "zh-cn": "简体中文翻译",
+    "zh-tw": "繁體中文翻譯",
+    "en-us": "English translation"
+  },
+  "another_key": {
+    "zh-cn": "另一个简体中文翻译",
+    "zh-tw": "另一個繁體中文翻譯"
+  }
+}
+```
+
+### 中文语言模式最佳实践
+
+**新增** 使用中文语言模式的推荐做法：
+
+```javascript
+// 1. 使用规范化的语言代码
+const i18n = new I18n({
+  locale: 'zh',           // 自动规范化为 'zh-CN'
+  appCode: 'MY_APP'
+});
+
+// 2. 在组件中使用翻译
+const translated = $t('page.title');  // 自动选择 zh-CN 或 zh-TW
+
+// 3. 支持动态语言切换
+await $changeLocale('zh-TW');  // 切换到繁体中文
+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)
+
 ## 文本编辑模式功能
 
 ### 文本编辑模式概述
@@ -961,11 +1090,11 @@ swalCSS --> swal2Container
 
 ### 文本编辑模式快捷键配置
 
-文本编辑模式支持自定义快捷键绑定，默认使用"shift+e"组合键：
+文本编辑模式支持自定义快捷键绑定，默认使用"ctrl+shift+e"组合键：
 
 ```javascript
-// 文本编辑模式快捷键，默认为 shift+e，支持自定义传入
-this.editKeyboard = options.editKeyboard || "shift+e";
+// 文本编辑模式快捷键，默认为 ctrl+shift+e，支持自定义传入
+this.editKeyboard = options.editKeyboard || "ctrl+shift+e";
 
 // 绑定文本编辑模式快捷键
 keyboardJS.bind(this.editKeyboard, (e) => {
@@ -1003,7 +1132,7 @@ enableEditMode() {
   // 显示提示
   Swal.fire({
     title: "文本编辑模式已开启",
-    text: "点击带外框的文本即可编辑翻译内容，按 Shift+E 退出",
+    text: "点击带蓝色虚线外框的文本即可编辑翻译内容，按 Ctrl+Shift+E 退出",
     icon: "info",
     timer: 2000,
     showConfirmButton: false,