gc_i18n 1.4.0 → 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//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)

package/.qoder/repowiki/zh/content//351/253/230/347/272/247/347/224/250/346/263/225//351/253/230/347/272/247/347/224/250/346/263/225.md

@@ -25,10 +25,10 @@
 
 ## 更新摘要
 **变更内容**
-- 新增Earth组件v-model双向绑定功能使用示例
-- 添加编辑模式与Earth组件的实际应用场景
-- 完善多语言翻译组件的高级用法说明
-- 更新组件交互流程和数据流转机制
+- 内部重构带来的代码质量提升，包括更清晰的变量命名和函数重命名
+- 增强的RTL语言支持和更健壮的错误处理机制
+- 改进的类型安全和代码组织结构
+- 优化的性能调优技巧和缓存策略
 
 ## 目录
 1. [项目结构分析](#项目结构分析)
@@ -103,10 +103,10 @@ langJson --> index
 **图示来源**
 - [vite.config.js:1-72](file://vite.config.js#L1-L72)
 - [lib/gc_i18n.es.js:1-200](file://lib/gc_i18n.es.js#L1-L200)
-- [packages/index.js:1-512](file://packages/index.js#L1-L512)
-- [packages/libs/textEditMode.js:1-484](file://packages/libs/textEditMode.js#L1-L484)
+- [packages/index.js:1-538](file://packages/index.js#L1-L538)
+- [packages/libs/textEditMode.js:1-200](file://packages/libs/textEditMode.js#L1-L200)
 - [packages/libs/textEditMode.css:1-167](file://packages/libs/textEditMode.css#L1-L167)
-- [packages/components/earth.js:1-339](file://packages/components/earth.js#L1-L339)
+- [packages/components/earth.js:1-200](file://packages/components/earth.js#L1-L200)
 
 ## Vite构建系统迁移
 
@@ -263,7 +263,7 @@ this.router.beforeEach(async (to, from, next) => {
 此机制确保只在需要时才加载语言数据，减少初始加载时间。
 
 **章节来源**
-- [packages/index.js:174-274](file://packages/index.js#L174-L274)
+- [packages/index.js:194-291](file://packages/index.js#L194-L291)
 - [packages/libs/i18nUtils.ts:1-54](file://packages/libs/i18nUtils.ts#L1-L54)
 
 ## 结合后端服务实现实时翻译更新
@@ -321,8 +321,8 @@ async saveTranslate(data) {
 ```
 
 **章节来源**
-- [packages/libs/service.js:1-136](file://packages/libs/service.js#L1-L136)
-- [packages/index.js:407-423](file://packages/index.js#L407-L423)
+- [packages/libs/service.js:1-187](file://packages/libs/service.js#L1-L187)
+- [packages/index.js:428-492](file://packages/index.js#L428-L492)
 
 ## 自定义语言解析器与格式化器
 
@@ -359,7 +359,7 @@ globalThis.$format = function(value, format) {
 
 **章节来源**
 - [lib/gc_i18n.es.js:1-200](file://lib/gc_i18n.es.js#L1-L200)
-- [packages/index.js:295-343](file://packages/index.js#L295-L343)
+- [packages/index.js:294-396](file://packages/index.js#L294-L396)
 
 ## 扩展gc_i18n.js支持新语言特性
 
@@ -394,7 +394,7 @@ async setLanguage(locale) {
 
 **章节来源**
 - [lib/gc_i18n.es.js:1-200](file://lib/gc_i18n.es.js#L1-L200)
-- [packages/index.js:424-466](file://packages/index.js#L424-L466)
+- [packages/index.js:418-423](file://packages/index.js#L418-L423)
 
 ## API兼容性与迁移策略
 
@@ -407,7 +407,7 @@ async setLanguage(locale) {
 const apiEndpoints = {
   // 新版API端点
   NEW: {
-    languages: '/i18n-web/app/getsupportedlangs',
+    languages: '/i18n-web/language/languages',
     translations: '/i18n-web/kv_translate/kv_translates',
     userDicts: '/i18n-web/kv_translate/userDicts',
     batchSave: '/i18n-web/kv_translate/batch'
@@ -502,7 +502,7 @@ class APIMigrationManager {
 
     // 测试新版本端点
     try {
-      const response = fetch('/i18n-web/app/getsupportedlangs');
+      const response = fetch('/i18n-web/language/languages');
       if (response.data && response.data.result === 0) {
         detectionResults.newVersion = true;
       }
@@ -580,8 +580,8 @@ function normalizeResponse(response) {
 ```
 
 **章节来源**
-- [packages/libs/service.js:1-136](file://packages/libs/service.js#L1-L136)
-- [packages/index.js:407-423](file://packages/index.js#L407-L423)
+- [packages/libs/service.js:19-187](file://packages/libs/service.js#L19-L187)
+- [packages/index.js:428-492](file://packages/index.js#L428-L492)
 - [lib/gc_i18n.es.js:45-109](file://lib/gc_i18n.es.js#L45-L109)
 
 ## 性能调优技巧
@@ -658,8 +658,8 @@ async search(data) {
 ```
 
 **章节来源**
-- [packages/index.js:248-273](file://packages/index.js#L248-L273)
-- [packages/libs/service.js:61-81](file://packages/libs/service.js#L61-L81)
+- [packages/index.js:265-291](file://packages/index.js#L265-L291)
+- [packages/libs/service.js:112-132](file://packages/libs/service.js#L112-L132)
 
 ## 环境感知与iframe配置
 
@@ -731,8 +731,8 @@ if ("onlanguagechange" in window) {
 ```
 
 **章节来源**
-- [packages/index.js:84-116](file://packages/index.js#L84-L116)
-- [packages/index.js:131-135](file://packages/index.js#L131-L135)
+- [packages/index.js:85-118](file://packages/index.js#L85-L118)
+- [packages/index.js:133-137](file://packages/index.js#L133-L137)
 - [lang/index.js:26-26](file://lang/index.js#L26-L26)
 - [lib/gc_i18n.es.js:2120-2130](file://lib/gc_i18n.es.js#L2120-L2130)
 
@@ -946,9 +946,9 @@ class TextEditMode {
 ```
 
 **章节来源**
-- [packages/libs/textEditMode.js:1-484](file://packages/libs/textEditMode.js#L1-L484)
+- [packages/libs/textEditMode.js:1-200](file://packages/libs/textEditMode.js#L1-L200)
 - [packages/libs/textEditMode.css:1-167](file://packages/libs/textEditMode.css#L1-L167)
-- [packages/index.js:152-156](file://packages/index.js#L152-L156)
+- [packages/index.js:155-158](file://packages/index.js#L155-L158)
 - [packages/libs/utils.js:1-51](file://packages/libs/utils.js#L1-L51)
 
 ## Earth组件高级用法
@@ -1191,8 +1191,8 @@ const debouncedLanguageChange = debounce((newLocale) => {
 ```
 
 **章节来源**
-- [packages/components/earth.js:1-339](file://packages/components/earth.js#L1-L339)
+- [packages/components/earth.js:1-200](file://packages/components/earth.js#L1-L200)
 - [packages/components/earth.css:1-144](file://packages/components/earth.css#L1-L144)
 - [packages/components/earth.md:1-109](file://packages/components/earth.md#L1-L109)
 - [src/view/Home.vue:19-40](file://src/view/Home.vue#L19-L40)
-- [packages/index.js:493-494](file://packages/index.js#L493-L494)
+- [packages/index.js:523](file://packages/index.js#L523-L523)