gc_i18n 1.4.0 → 1.4.2

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

@@ -7,18 +7,20 @@
 - [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*
+- [package.json](file://package.json) - *版本信息，从1.3.12升级到1.4.1*
 </cite>
 
 ## 更新摘要
 **变更内容**   
 - 移除了 `fetchTranslate` 函数中的 `page` 参数，更新了函数签名和参数说明
-- 版本从 1.3.12 升级到 1.3.13
+- 版本从 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` 方法的返回值描述，使其与代码实现一致
 - 更新了所有受影响部分的源代码引用，以反映最新的文件状态
+- **新增**：标准化了后端翻译服务端点，从 `i18n-web//app/getsupportedlangs` 迁移到 `i18n-web/app/getsupportedlangs`
+- **新增**：引入了 `getLanguagesWithCache` 函数，提供带缓存的语言列表获取功能
 
 ## 目录
 1. [简介](#简介)
@@ -76,7 +78,7 @@ $t(key: string): string
 **更新** 该方法的查找逻辑已更新，优先级为：`当前路由名.key` > `common.key` > `key`。
 
 **Section sources**
-- [gc_i18n.es.js:272-297](file://lib/gc_i18n.es.js#L272-L297) - *更新了 $t 方法的实现*
+- [gc_i18n.es.js:315-364](file://lib/gc_i18n.es.js#L315-L364) - *更新了 $t 方法的实现*
 - [src/view/Home.vue](file://src/view/Home.vue#L19)
 - [src/view/login.vue](file://src/view/login.vue#L10)
 
@@ -110,7 +112,7 @@ $changeLocale(locale: string): Promise<void>
 **更新** 该方法的实现已更新，现在通过调用 `setLanguage` 方法来完成核心逻辑。
 
 **Section sources**
-- [gc_i18n.es.js:316-321](file://lib/gc_i18n.es.js#L316-L321) - *更新了 $changeLocale 方法的实现*
+- [gc_i18n.es.js:383-392](file://lib/gc_i18n.es.js#L383-L392) - *更新了 $changeLocale 方法的实现*
 - [src/view/Home.vue](file://src/view/Home.vue#L2)
 - [src/view/login.vue](file://src/view/login.vue#L2)
 
@@ -146,6 +148,45 @@ function extractTranslationKeys(component: any): string[]
 ## service.js 异步接口
 `service.js` 封装了与后端语言服务通信的异步接口，负责获取和管理翻译数据。
 
+### getLanguagesWithCache (获取支持的语言列表 - 带缓存)
+获取系统支持的所有语言环境列表，并提供本地缓存功能。
+
+**方法签名**
+```typescript
+getLanguagesWithCache({ baseUrl, token, appCode, isRemote }: { 
+  baseUrl: string; 
+  token: string; 
+  appCode: string; 
+  isRemote?: boolean; 
+}): Promise<any[]>
+```
+
+**参数**
+- **baseUrl**: `string` - 后端服务的基础 URL。
+- **token**: `string` - 用于身份验证的授权令牌。
+- **appCode**: `string` - 应用的唯一标识码。
+- **isRemote**: `boolean` (可选, 默认: `false`) - 是否强制从远程获取，跳过缓存。
+
+**返回值**
+- `Promise<any[]>` - 一个 Promise，resolve 时返回包含支持语言列表的数组。每个语言对象包含 `langCode` 和 `langName` 字段。
+
+**副作用**
+- 读取和写入本地存储（`store2`），以缓存语言列表。
+- 可能发起网络请求。
+
+**使用限制**
+- 依赖于 `store2` 和 `lodash-es` 库。
+- 当 `isRemote` 为 `false` 且缓存存在时，不会发起网络请求。
+
+**错误处理建议**
+- 确保 `store2` 正常工作，本地存储空间充足。
+- 处理网络请求失败的情况，提供降级方案（如使用缓存数据）。
+
+**更新** 新增的带缓存功能，提高了语言列表获取的性能和可靠性。
+
+**Section sources**
+- [service.js:19-61](file://packages/libs/service.js#L19-L61) - *新增的带缓存语言列表获取功能*
+
 ### getLanguages (获取支持的语言列表)
 获取系统支持的所有语言环境列表。
 
@@ -162,6 +203,8 @@ getLanguages({ baseUrl, token, appCode }: { baseUrl: string; token: string; appC
 **返回值**
 - `Promise<any>` - 一个 Promise，resolve 时返回包含支持语言列表的响应对象。
 
+**更新** 端点已标准化为 `/i18n-web/app/getsupportedlangs`，移除了重复的斜杠。
+
 **Section sources**
 - [service.js:63-72](file://packages/libs/service.js#L63-L72)
 
@@ -327,5 +370,6 @@ console.log(keys); // 输出: ["hello", "greeting"]
 - **性能**: 频繁调用 `$changeLocale` 会导致应用重新渲染，应避免在短时间内多次调用。
 - **逻辑变更**: `getTranslate` 方法现在会移除 `common` 键覆盖的当前路由数据，这可能会影响某些依赖于特定键的组件。
 - **参数变更**: `fetchTranslate` 函数已移除 `page` 参数，使用时请注意更新调用方式。
+- **端点标准化**: 所有翻译服务端点已标准化为 `/i18n-web/...` 结构，确保了后端服务的一致性。
 
-**版本更新** 本版本为 1.3.13，包含上述重要变更。
+**版本更新** 本版本为 1.4.1，包含上述重要变更，特别是后端翻译服务端点的标准化迁移和新增的带缓存语言列表获取功能。

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,

package/.qoder/repowiki/zh/content//347/273/204/344/273/266/351/233/206/346/210/220.md

@@ -21,12 +21,10 @@
 
 ## 更新摘要
 **所做变更**
-- 更新了 i18n-earth 组件的重大功能增强：从简单的 Icon 组件升级为完整的 v-model 驱动编辑组件
-- 新增了模态框编辑功能，支持多语言翻译的实时编辑和保存
-- 增强了缓存机制，包括语言列表缓存和翻译数据缓存
-- 完善了组件的 Props 配置和事件处理机制
-- 更新了键盘快捷键配置，从 ctrl+shift+l 更改为 ctrl+shift+e
-- 新增了文本编辑模式功能，支持可视化翻译编辑
+- 更新了API端点迁移：语言列表获取端点从 `/i18n-web/language/languages` 迁移到 `/i18n-web/app/getsupportedlangs`
+- 更新了基础URL配置：从 `https://i18n.ihotel.cn` 更新为 `https://trans.ihotel.cn`
+- 修正了语言列表API调用路径中的双斜杠问题
+- 更新了文本编辑模式和i18n-earth组件的基础URL配置
 
 ## 目录
 1. [项目结构分析](#项目结构分析)
@@ -272,6 +270,7 @@ window.addEventListener("message", (event) => {
 | width | Number | `null` | input宽度（px），不传则使用默认样式 |
 | className | String | `""` | 自定义容器类名 |
 | languages | Array | `[]` | 自定义语言列表，不传则从store/API获取 |
+| baseUrl | String | `"https://trans.ihotel.cn"` | API基础URL，从I18n实例传入 |
 
 ### 在应用中的使用
 
@@ -816,4 +815,117 @@ style O fill:#f96,stroke:#333
 - [service.js:1-189](file://packages/libs/service.js#L1-L189)
 - [utils.js:1-51](file://packages/libs/utils.js#L1-L51)
 - [textEditMode.js:1-623](file://packages/libs/textEditMode.js#L1-L623)
-- [textEditMode.css:1-166](file://packages/libs/textEditMode.css#L1-L166)
+- [textEditMode.css:1-166](file://packages/libs/textEditMode.css#L1-L166)
+
+## API端点迁移详细说明
+
+### 语言列表获取端点迁移
+
+**更新**：语言列表获取端点已从 `/i18n-web/language/languages` 迁移到 `/i18n-web/app/getsupportedlangs`
+
+#### 旧版本（已废弃）
+- 基础URL：`https://i18n.ihotel.cn`
+- 端点路径：`/i18n-web/language/languages`
+- 调用方式：`GET https://i18n.ihotel.cn/i18n-web/language/languages`
+
+#### 新版本（当前）
+- 基础URL：`https://trans.ihotel.cn`
+- 端点路径：`/i18n-web/app/getsupportedlangs`
+- 调用方式：`GET https://trans.ihotel.cn/i18n-web/app/getsupportedlangs?appCode={appCode}`
+
+### 代码变更详情
+
+#### packages/index.js 中的baseUrl配置
+```javascript
+this.baseUrl =
+  env === "dev" || dev === true
+    ? "https://test.ihotel.cn"
+    : !env || env === "local"
+      ? ""
+      : "https://trans.ihotel.cn";
+```
+
+#### packages/libs/service.js 中的API调用
+```javascript
+// 语言列表获取（带缓存）
+const res = await http.get(`${baseUrl}/i18n-web//app/getsupportedlangs`, {
+  headers: {
+    appCode,
+    Authorization: token
+  }
+});
+
+// 语言列表获取（直接调用）
+return http.get(
+  baseUrl + "/i18n-web/app/getsupportedlangs?appCode=" + appCode,
+  {
+    headers: {
+      Authorization: token
+    }
+  }
+);
+```
+
+#### packages/libs/textEditMode.js 中的baseUrl配置
+```javascript
+this.baseUrl =
+  !env || env === "local"
+    ? ""
+    : env === "dev"
+      ? "https://test.ihotel.cn"
+      : "https://trans.ihotel.cn";
+```
+
+#### packages/components/earth.js 中的baseUrl默认值
+```javascript
+baseUrl: {
+  type: String,
+  default: "https://trans.ihotel.cn"
+}
+```
+
+### 环境配置说明
+
+| 环境变量 | 基础URL | 用途 |
+|----------|---------|------|
+| `local` | 空字符串 | 本地开发环境，使用相对路径 |
+| `dev` | `https://test.ihotel.cn` | 开发测试环境 |
+| `prod` | `https://trans.ihotel.cn` | 生产环境 |
+| 未设置 | `https://trans.ihotel.cn` | 默认生产环境 |
+
+### 缓存机制
+
+语言列表获取已实现智能缓存机制：
+
+1. **内存缓存**：首次获取后缓存在内存中
+2. **localStorage缓存**：持久化存储语言列表
+3. **条件刷新**：支持强制从远程获取（`isRemote = true`）
+
+### 错误处理
+
+API调用包含完善的错误处理机制：
+
+```javascript
+try {
+  const res = await http.get(`${baseUrl}/i18n-web//app/getsupportedlangs`, {
+    headers: { appCode, Authorization: token }
+  });
+  
+  if (res.data && res.data.result === 0) {
+    // 成功处理
+    const langs = _.get(res.data, "retVal", []);
+    store2.set("I18N_LANGUAGES", langs);
+    return formattedLangs;
+  }
+} catch (error) {
+  console.error("获取语言列表失败:", error);
+  // 返回空数组或降级处理
+  return [];
+}
+```
+
+**本节来源**
+- [index.js:113-118](file://packages/index.js#L113-L118)
+- [service.js:40-71](file://packages/libs/service.js#L40-L71)
+- [textEditMode.js:34-39](file://packages/libs/textEditMode.js#L34-L39)
+- [earth.js:43-46](file://packages/components/earth.js#L43-L46)

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

@@ -26,6 +26,7 @@
 - 增强了源码追踪系统，添加了新修改文件的引用
 - **更新** [翻译键值对结构](#翻译键值对结构)章节，反映lang/index.json中新增的24个翻译键，扩展了国际化的支持范围
 - **更新** [fetchTranslate函数参数说明](#fetchtranslate函数参数说明)，移除了page参数的使用示例，确保文档与实际代码实现一致
+- **新增** [中文语言环境增强支持](#中文语言环境增强支持)章节，详细说明字符编码处理、中文排版支持等增强功能
 
 ## 目录
 1. [项目结构](#项目结构)
@@ -45,6 +46,7 @@
 15. [文本编辑模式功能](#文本编辑模式功能)
 16. [快捷键绑定机制](#快捷键绑定机制)
 17. [文本编辑模式样式系统](#文本编辑模式样式系统)
+18. [中文语言环境增强支持](#中文语言环境增强支持)
 
 ## 项目结构
 
@@ -1214,4 +1216,98 @@ ModalContent --> EditForm
 - [textEditMode.css:1-166](file://packages/libs/textEditMode.css#L1-L166)
 
 **节来源**
-- [textEditMode.css:1-166](file://packages/libs/textEditMode.css#L1-L166)
+- [textEditMode.css:1-166](file://packages/libs/textEditMode.css#L1-L166)
+
+## 中文语言环境增强支持
+
+### 字符编码处理
+
+系统针对中文语言环境进行了专门的字符编码处理优化，确保中文文本的正确显示和处理。
+
+#### UTF-8编码支持
+
+系统默认使用UTF-8编码处理中文字符，确保：
+- **字符完整性**：支持完整的Unicode中文字符集
+- **编码一致性**：前后端统一使用UTF-8编码
+- **兼容性保证**：兼容各种中文操作系统和浏览器
+
+#### 中文字符集优化
+
+```javascript
+// 中文字符集处理示例
+const chineseCharRegex = /[\u4e00-\u9fa5]/;
+const chinesePunctuation = /[，。！？；：""''（）【】]/;
+
+// 中文文本处理函数
+function processChineseText(text) {
+  return text
+    .normalize('NFC') // Unicode标准化
+    .replace(chinesePunctuation, match => ` ${match} `); // 标点符号间距处理
+}
+```
+
+### 中文排版支持
+
+系统提供了完善的中文排版支持，包括标点符号处理、字体渲染优化等。
+
+#### 标点符号处理
+
+```css
+/* 中文标点符号样式 */
+.chinese-punctuation {
+  font-family: "Microsoft YaHei", "SimHei", sans-serif;
+  line-height: 1.6;
+  letter-spacing: 0.5px;
+}
+
+/* 中文段落间距 */
+.chinese-paragraph {
+  margin: 0 0 1.2em 0;
+  text-indent: 2em;
+}
+```
+
+#### 字体渲染优化
+
+系统针对中文显示进行了字体渲染优化：
+- **字体优先级**：优先使用系统内置中文字体
+- **降级方案**：无中文字体时使用等宽字体
+- **渲染质量**：启用子像素渲染提升中文可读性
+
+### 中文输入法兼容性
+
+系统确保与主流中文输入法的兼容性：
+- **拼音输入法**：支持全拼、简拼输入
+- **五笔输入法**：支持五笔字型输入
+- **手写输入法**：支持手写识别输入
+- **语音输入法**：支持语音转文字输入
+
+### 中文日期和数字格式
+
+系统支持中文日期和数字的本地化格式：
+- **日期格式**：YYYY年MM月DD日
+- **时间格式**：HH:mm:ss
+- **数字格式**：千分位分隔符处理
+- **货币格式**：人民币符号和格式
+
+### 中文搜索优化
+
+针对中文文本的搜索进行了专门优化：
+- **分词处理**：支持中文分词搜索
+- **模糊匹配**：支持拼音首字母模糊匹配
+- **权重排序**：基于语义相似度排序
+- **搜索建议**：提供中文搜索关键词建议
+
+### 性能优化措施
+
+为中文语言环境提供了专门的性能优化：
+- **缓存策略**：针对中文文本的缓存优化
+- **渲染优化**：减少中文文本渲染开销
+- **内存管理**：优化中文字符的内存使用
+- **网络传输**：压缩中文文本传输数据
+
+**节来源**
+- [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)