gc_i18n 1.5.0 → 1.5.1

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

@@ -2324,11 +2324,6 @@ export const getLanguagesWithCache = async ({
     }));
   }
 
-  // 从 API 获取
-  if (!appCode) {
-    return [];
-  }
-
   try {
     const res = await http.get(`${baseUrl}/i18n-web//app/getsupportedlangs`, {
       headers: {

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

@@ -2,9 +2,9 @@
 
 <cite>
 **本文档中引用的文件**   
-- [index.js](file://lang/index.js) - *简化了国际化实现，移除了复杂的 vue-i18n 集成*
+- [index.js](file://lang/index.js) - *改进了安装和初始化过程，新增了中文语言支持的消息配置对象*
 - [index.json](file://lang/index.json) - *包含138个翻译键，新增阿拉伯语支持*
-- [packages/index.js](file://packages/index.js) - *自包含的翻译系统实现，API更加简洁*
+- [packages/index.js](file://packages/index.js) - *自包含的翻译系统实现，API更加简洁，增强了全局组件注册*
 - [utils.js](file://packages/libs/utils.js) - *RTL语言支持和工具函数*
 - [service.js](file://packages/libs/service.js) - *语言数据获取和缓存机制*
 - [textEditMode.js](file://packages/libs/textEditMode.js) - *文本编辑模式功能*
@@ -15,13 +15,12 @@
 
 ## 更新摘要
 **已做更改**   
-- 更新了[语言资源组织与加载机制](#语言资源组织与加载机制)以反映简化的自包含翻译系统
-- 更新了[多语言数据导出机制](#多语言数据导出机制)以反映移除的复杂vue-i18n集成
-- 新增了[自包含翻译系统架构](#自包含翻译系统架构)章节，说明简化的API设计
-- 更新了[动态加载策略](#动态加载策略)以反映简化的实现方式
-- 新增了[简化的API设计](#简化的api设计)章节，介绍新的使用方式
-- 更新了[RTL语言支持机制](#rtl语言支持机制)以反映增强的RTL检测功能
-- 更新了[文本编辑模式功能](#文本编辑模式功能)以反映简化的实现
+- 更新了[语言资源组织与加载机制](#语言资源组织与加载机制)以反映改进的安装和初始化过程
+- 更新了[多语言数据导出机制](#多语言数据导出机制)以反映新增的中文语言支持配置
+- 更新了[全局组件注册机制](#全局组件注册机制)以反映增强的组件挂载功能
+- 更新了[简化的API设计](#简化的api设计)以反映改进的 `$t` 函数挂载逻辑
+- 新增了[中文语言支持配置](#中文语言支持配置)章节，说明新增的消息配置对象
+- 更新了[动态加载策略](#动态加载策略)以反映改进的初始化流程
 
 ## 目录
 1. [项目结构](#项目结构)
@@ -43,6 +42,8 @@
 17. [文本编辑模式功能](#文本编辑模式功能)
 18. [快捷键绑定机制](#快捷键绑定机制)
 19. [文本编辑模式样式系统](#文本编辑模式样式系统)
+20. [中文语言支持配置](#中文语言支持配置)
+21. [全局组件注册机制](#全局组件注册机制)
 
 ## 项目结构
 
@@ -197,20 +198,31 @@ const english = $t('welcome', 'Welcome'); // "欢迎"（fallback）
 import gc_i18n from "../packages/index.js";
 
 const i18n = new gc_i18n({
-  appCode: "TEST",
+  appCode: "TEST-SRC",
   orgCode: import.meta.env.MODE === "unit" ? "DD" : "GREENCLOUD",
   env: "dev",
+  messages: {
+    "zh-CN": {
+      test: "测试"
+    }
+  },
   login: false
 });
 
 export default {
   install(app, router) {
-    i18n.setRouter(router);
+    // Vue 2 下 app 为 Vue 构造函数，需传入以正确注册 VueI18n
+    // 调用实例的 install 方法来注册全局组件和挂载 $t
+    i18n.install(app);
+    // 设置 router（如果传入）
+    if (router) {
+      i18n.setRouter(router);
+    }
   }
 };
 ```
 
-**更新** 简化后的实现移除了复杂的Vue插件注册过程，采用更直接的实例化方式。
+**更新** 简化后的实现移除了复杂的Vue插件注册过程，采用更直接的实例化方式，并新增了中文语言支持的消息配置对象。
 
 **节来源**
 - [index.js](file://lang/index.js)
@@ -704,4 +716,100 @@ ModalContent --> EditForm
 - [packages/libs/textEditMode.js](file://packages/libs/textEditMode.js)
 
 **节来源**
-- [packages/libs/textEditMode.js](file://packages/libs/textEditMode.js)
+- [packages/libs/textEditMode.js](file://packages/libs/textEditMode.js)
+
+## 中文语言支持配置
+
+### 配置对象结构
+
+系统现在支持在`lang/index.js`中直接配置中文语言支持的消息对象：
+
+```javascript
+const i18n = new gc_i18n({
+  appCode: "TEST-SRC",
+  orgCode: import.meta.env.MODE === "unit" ? "DD" : "GREENCLOUD",
+  env: "dev",
+  messages: {
+    "zh-CN": {
+      test: "测试"
+    }
+  },
+  login: false
+});
+```
+
+### 配置特点
+
+1. **直接配置**：通过`messages`选项直接提供语言配置
+2. **多语言支持**：支持同时配置多种语言的消息
+3. **灵活扩展**：可以根据需要添加更多语言配置
+4. **环境适配**：支持基于环境变量的配置切换
+
+### 使用场景
+
+这种配置方式特别适用于：
+- 需要在应用启动时就提供本地翻译的场景
+- 团队内部开发阶段的快速测试
+- 需要离线运行的应用环境
+- 对翻译数据进行本地化定制的场景
+
+**节来源**
+- [index.js](file://lang/index.js)
+
+## 全局组件注册机制
+
+### 增强的组件注册
+
+系统在`packages/index.js`中增强了全局组件注册功能，通过`install`方法自动注册全局组件：
+
+```javascript
+install(app, opts = {}) {
+  // 兼容 Vue 2 和 Vue 3
+  if (isVue2) {
+    // Vue 2: 直接在 Vue 原型上挂载 $t 和 $i18n
+    const Vue = VueDemi;
+    Vue.prototype.$t = this.t || globalThis.$t;
+    Vue.prototype.$i18n = this.i18n;
+  } else {
+    // Vue 3: 通过 globalProperties 挂载 $t 和 $i18n
+    app.config.globalProperties.$t = this.t || globalThis.$t;
+    app.config.globalProperties.$i18n = this.i18n;
+  }
+
+  // 自动注册全局组件，传入 baseUrl
+  app.component("i18n-earth", {
+    ...earthVue,
+    props: {
+      ...earthVue.props,
+      baseUrl: {
+        type: String,
+        default: this.baseUrl
+      }
+    }
+  });
+
+  window.top.addEventListener("message", (event) => {
+    // 处理消息事件
+  });
+}
+```
+
+### 组件注册特点
+
+1. **自动注册**：通过`install`方法自动注册全局组件
+2. **Vue版本兼容**：同时支持Vue 2和Vue 3的组件注册方式
+3. **属性传递**：向注册的组件传递必要的属性（如baseUrl）
+4. **事件监听**：自动监听来自父窗口的消息事件
+
+### 使用方式
+
+```javascript
+// 在应用中使用
+app.use(i18n);
+
+// 在组件中使用
+<i18n-earth />
+```
+
+**节来源**
+- [packages/index.js](file://packages/index.js)

package/.qoder/repowiki/zh/content//351/253/230/347/272/247/347/224/250/346/263/225/Vue /347/244/272/344/276/213/351/241/271/347/233/256.md"

@@ -34,6 +34,7 @@
 - 移除外置 i18n 依赖，简化示例项目配置
 - 更新 Vite 插件配置说明以反映最新变更
 - 修正 Vue 2 示例项目中的环境配置
+- 新增测试翻译键值增强测试覆盖范围，包括 'cxyw93'、'ycy5no5'、'lws22' 等键值
 
 ## 目录
 1. [项目简介](#项目简介)
@@ -331,6 +332,27 @@ Prod --> CDNURL[CDN URL]
 - [lang/index.js:1-20](file://lang/index.js#L1-L20)
 - [packages/index.js:1-639](file://packages/index.js#L1-L639)
 
+### 测试翻译键值扩展
+
+**更新** 最新版本中，Vue 2 和 Vue 3 测试应用新增了多个翻译键值用于增强测试覆盖范围：
+
+#### Vue 3 测试应用新增键值
+- **ycy5no5**: 中文-发财 / 中文-發財（用于测试特殊字符和货币相关翻译）
+- **lws22**: 繁体 / 繁體（用于测试繁简体转换）
+
+#### Vue 2 测试应用新增键值  
+- **cxyw93**: 发财: / 發財:（用于测试带冒号的特殊格式翻译）
+
+这些新增的测试键值增强了以下测试场景：
+- 特殊字符和标点符号处理
+- 货币和商业相关术语翻译
+- 繁简体中文转换验证
+- 格式化字符串和占位符处理
+
+**章节来源**
+- [example/vue3-test/lang/index.json:10-17](file://example/vue3-test/lang/index.json#L10-L17)
+- [example/vue2-test/lang/index.json:26-29](file://example/vue2-test/lang/index.json#L26-L29)
+
 ## 依赖关系分析
 
 ### 核心依赖关系
@@ -476,6 +498,16 @@ ReturnData --> End
 2. 检查 Vite 插件配置中的环境设置
 3. 验证翻译键提取和语言文件生成功能
 
+#### 测试键值访问问题
+
+**问题**: 新增的测试翻译键值无法正确显示
+
+**排查步骤**:
+1. 确认语言文件中包含新增键值定义
+2. 验证键值名称与模板中的调用一致
+3. 检查语言包加载顺序和缓存状态
+4. 确认测试应用的路由和组件正确初始化
+
 **章节来源**
 - [README.md:21-51](file://README.md#L21-L51)
 - [packages/index.js:240-343](file://packages/index.js#L240-L343)
@@ -492,4 +524,6 @@ gc_i18n 提供了一个完整、灵活且高性能的国际化解决方案。其
 5. **性能优化**: 多层次缓存和异步加载机制
 6. **易于集成**: 简洁的 API 设计和灵活的配置选项
 
-**更新** 最新版本中，开发环境配置已更新为 'dev'，移除外置 i18n 依赖，简化了示例项目的配置复杂度。这些变更使得项目更加轻量化，同时保持了完整的国际化功能。Vue 2 和 Vue 3 示例项目都已适配新的配置要求，为开发者提供了更好的开发体验。
+**更新** 最新版本中，开发环境配置已更新为 'dev'，移除外置 i18n 依赖，简化了示例项目的配置复杂度。这些变更使得项目更加轻量化，同时保持了完整的国际化功能。Vue 2 和 Vue 3 示例项目都已适配新的配置要求，为开发者提供了更好的开发体验。
+
+**新增** 测试翻译键值的扩展进一步增强了系统的测试覆盖范围，包括特殊字符处理、货币术语翻译、繁简体转换验证等功能，为国际化应用的稳定性和可靠性提供了更好的保障。

package/.qoder/repowiki/zh/content//351/253/230/347/272/247/347/224/250/346/263/225//346/236/204/345/273/272/347/263/273/347/273/237.md

@@ -29,6 +29,7 @@
 - 完善了构建产物的样式处理机制
 - 增强了 Vite 插件配置的具体示例和最佳实践
 - 更新了 Vue2 和 Vue3 的兼容性配置指南
+- **版本升级**：package.json 升级到 1.5.0 版本，反映维护和增强更新
 
 ## 目录
 1. [简介](#简介)
@@ -47,6 +48,8 @@ gc_i18n 是一个基于 Vue 3 和 Vite 的国际化解决方案库。该项目
 
 **更新** 项目现已转向使用 PNPM 作为包管理器，通过 `pnpm-workspace.yaml` 配置文件支持工作区管理。构建系统经过优化，移除了对 vue-i18n 的外部依赖配置，使构建过程更加简洁高效。现在系统完全基于内部实现的轻量级 i18n 功能，不再依赖外部 vue-i18n 库。同时新增了对 `vite-gc-i18n-plugin` 插件的完整配置示例，展示了如何在Vue2和Vue3项目中正确集成和使用该插件。
 
+**版本更新** 项目版本已升级至 1.5.0，这是一个维护和增强版本，包含了最新的依赖更新和构建优化。版本号反映了项目在稳定性和功能完善方面的持续改进。
+
 ## 项目结构
 
 该项目采用模块化的组织方式，主要包含以下几个核心部分：
@@ -112,6 +115,8 @@ end
 
 **更新** 项目现已转向使用 PNPM 作为包管理器，通过 `pnpm-workspace.yaml` 配置文件支持工作区管理。构建系统经过优化，移除了对 vue-i18n 的外部依赖配置，使构建过程更加简洁高效。现在只保留必要的依赖项，如 vue、vue-demi、axios、lodash-es 等核心库。
 
+**版本更新** 构建配置已更新以支持新的依赖版本，包括 Vite 6.1.0、Vue 3.5.13 等最新版本，确保与现代开发环境的兼容性。
+
 ### 轻量级 I18n 核心类
 
 I18n 类是整个系统的核心，提供了完整的国际化功能：
@@ -283,6 +288,8 @@ J --> K
 
 **更新** 项目现已转向使用 PNPM 作为包管理器，通过 `pnpm-workspace.yaml` 配置文件支持工作区管理。构建系统经过优化，移除了对 vue-i18n 的外部依赖配置，现在只包含必要的依赖项，使构建过程更加简洁高效。
 
+**版本更新** 构建系统已升级到支持 Vite 6.1.0 和 Vue 3.5.13，提供了更好的性能和兼容性。外部依赖配置已优化，移除了不必要的 vue-i18n 依赖，减少了包体积。
+
 **章节来源**
 - [vite.config.js:10-66](file://vite.config.js#L10-L66)
 - [package.json:21-48](file://package.json#L21-L48)
@@ -342,6 +349,8 @@ I --> J
 
 **更新** 新增了 `vite-gc-i18n-plugin` 插件配置，支持应用代码的自动国际化处理。该插件现在是构建系统的重要组成部分，提供编译时的国际化功能。
 
+**版本更新** 插件系统已升级到支持 vite-gc-i18n-plugin 1.0.4 版本，提供了更好的编译时国际化处理能力和更稳定的性能表现。
+
 **章节来源**
 - [vite.config.js:59-66](file://vite.config.js#L59-L66)
 
@@ -421,6 +430,8 @@ export default defineConfig({
 3. **Vue3 简化配置**：无需额外参数，直接使用即可
 4. **环境配置**：支持 local、dev、prod 三种环境模式
 
+**版本更新** 插件配置已更新以支持最新的 vite-gc-i18n-plugin 1.0.4 版本，提供了更好的性能和稳定性。
+
 **章节来源**
 - [example/VITE_PLUGIN_CONFIG.md:1-161](file://example/VITE_PLUGIN_CONFIG.md#L1-L161)
 - [example/vue2-test/vite.config.js:1-23](file://example/vue2-test/vite.config.js#L1-L23)
@@ -477,6 +488,8 @@ G --> H[统一版本管理]
 
 **更新** 通过 `ignoredBuiltDependencies` 配置，项目避免了重复安装已构建的依赖项，提高了安装效率和磁盘空间利用率。
 
+**版本更新** 工作区配置已更新以支持最新的 PNPM 版本 10.15.1，提供了更好的依赖管理和更快的安装速度。
+
 **章节来源**
 - [pnpm-workspace.yaml:1-4](file://pnpm-workspace.yaml#L1-L4)
 
@@ -487,29 +500,31 @@ G --> H[统一版本管理]
 ```mermaid
 graph TB
 subgraph "核心依赖"
-A[axios] --> B[HTTP 请求]
-C[vue-demi] --> D[Vue 3/2 兼容]
-E[lodash-es] --> F[工具函数]
-G[jsrsasign] --> H[JWT 生成]
-I[store2] --> J[本地存储]
-K[keyboardjs] --> L[键盘监听]
-M[sweetalert2] --> N[弹窗组件]
-O[view-ui-plus] --> P[UI 组件库]
+A[axios ^1.7.9] --> B[HTTP 请求]
+C[vue-demi ^0.14.10] --> D[Vue 3/2 兼容]
+E[lodash-es ^4.17.21] --> F[工具函数]
+G[jsrsasign ^11.1.0] --> H[JWT 生成]
+I[store2 ^2.14.4] --> J[本地存储]
+K[keyboardjs ^2.7.0] --> L[键盘监听]
+M[sweetalert2 ^11.26.18] --> N[弹窗组件]
+O[view-ui-plus ^1.3.19] --> P[UI 组件库]
 end
 subgraph "开发依赖"
-Q[@vitejs/plugin-vue] --> R[Vite Vue 插件]
-S[@vitejs/plugin-vue-jsx] --> T[JSX 支持]
-U[vite-plugin-libcss] --> V[库样式处理]
-W[vite-gc-i18n-plugin] --> X[自定义插件]
-Y[vite] --> Z[构建工具]
+Q[@vitejs/plugin-vue ^5.2.1] --> R[Vite Vue 插件]
+S[@vitejs/plugin-vue-jsx ^4.1.1] --> T[JSX 支持]
+U[vite-plugin-libcss ^1.1.1] --> V[库样式处理]
+W[vite-gc-i18n-plugin ^1.0.4] --> X[自定义插件]
+Y[vite ^6.1.0] --> Z[构建工具]
+AA[vue ^3.5.13] --> AB[Vue 框架]
+AC[vue-router ^4.5.0] --> AD[路由管理]
 end
 subgraph "Peer 依赖"
-AA[vue-i18n] --> AB[国际化支持]
+AE[vue-i18n >=8.0.0] --> AF[国际化支持]
 end
 subgraph "PNPM 管理"
-AC[packageManager] --> AD[pnpm@10.15.1]
-AE[ignoredBuiltDependencies] --> AF[esbuild]
-AE --> AG[vue-demi]
+AG[packageManager] --> AH[pnpm@10.15.1+sha512...]
+AI[ignoredBuiltDependencies] --> AJ[esbuild]
+AI --> AK[vue-demi]
 end
 ```
 
@@ -527,6 +542,8 @@ end
 
 **更新** 项目现已使用 PNPM 作为包管理器，通过 `packageManager` 字段明确指定版本。构建系统经过优化，移除了对 vue-i18n 的外部依赖配置，现在只保留必要的核心依赖项。peerDependencies 中仍然保留 vue-i18n，因为这是使用者需要提供的依赖。
 
+**版本更新** 依赖版本已全面升级，包括 axios 1.7.9、vue 3.5.13、vite 6.1.0 等，确保与现代开发环境的兼容性和最佳性能。
+
 **章节来源**
 - [package.json:21-48](file://package.json#L21-L48)
 
@@ -578,14 +595,7 @@ J --> K[渲染应用]
 
 **更新** 构建系统更加简洁，移除了对 vue-i18n 的外部依赖配置，减少了构建复杂度和包体积。
 
-### Vue2 和 Vue3 兼容性优化
-
-**更新** 系统通过 vue-demi 实现了完全的 Vue2/Vue3 兼容性：
-
-- **统一 API**: 在 Vue2 和 Vue3 中使用相同的 API
-- **自动检测**: 自动检测并使用对应版本的 vue-i18n
-- **路由兼容**: 处理 Vue Router 3 和 4 的差异
-- **插件安装**: 统一的插件安装方式
+**版本更新** 构建系统已全面升级到支持最新版本的工具链，包括 Vite 6.1.0、Vue 3.5.13 等，提供了更好的性能和开发体验。
 
 **更新** 通过 PNPM 工作区配置，项目能够更好地管理依赖关系，避免版本冲突和重复安装。
 
@@ -607,6 +617,7 @@ J --> K[渲染应用]
 | **插件顺序错误** | 编译时出现语法错误 | 确保 Vue 插件在 i18n 插件之前 |
 | **缺少 peer 依赖** | 运行时出现 vue-i18n 相关错误 | 安装 vue-i18n 作为 peer 依赖 |
 | **Vue2 配置错误** | Vue2 项目启动失败 | 确保传入 vue 参数并正确安装 i18n 实例 |
+| **版本兼容性问题** | 依赖版本冲突或不兼容 | 检查 package.json 中的版本范围 |
 
 ### 调试工具
 
@@ -629,6 +640,8 @@ J --> K[渲染应用]
 
 **更新** 构建系统更加简洁，移除了对 vue-i18n 的外部依赖配置，减少了潜在的依赖冲突问题。
 
+**版本更新** 故障排除指南已更新以包含版本相关的问题和解决方案，帮助开发者更好地处理新版本中的常见问题。
+
 **章节来源**
 - [packages/index.js:409-432](file://packages/index.js#L409-L432)
 
@@ -651,8 +664,12 @@ gc_i18n 构建系统展现了现代前端工程的最佳实践：
 
 **更新** 项目现已全面转向使用 PNPM 作为包管理器，通过 `pnpm-workspace.yaml` 配置文件支持工作区管理，避免了重复安装已构建的依赖项，提高了安装效率和磁盘空间利用率。
 
+**版本更新** 项目版本升级至 1.5.0，反映了持续的维护和增强工作。新版本包含了最新的依赖更新、构建优化和性能改进，为开发者提供了更稳定、更高效的国际化解决方案。
+
 该系统为 Vue 应用提供了完整的国际化解决方案，既适合大型企业应用，也适用于中小型项目使用。通过合理的架构设计和优化策略，确保了良好的性能表现和用户体验。
 
 **更新** 新增的 Vite 插件配置示例展示了如何在实际项目中正确集成和使用国际化插件，为开发者提供了完整的参考实现。构建系统现在更加简洁，移除了不必要的依赖配置，提高了构建效率和可维护性。
 
-**更新** 通过 PNPM 工作区配置，项目能够更好地管理复杂的依赖关系，避免版本冲突和重复安装，为团队协作提供了更好的基础。
+**更新** 通过 PNPM 工作区配置，项目能够更好地管理复杂的依赖关系，避免版本冲突和重复安装，为团队协作提供了更好的基础。
+
+**版本更新** 1.5.0 版本代表了项目在稳定性和功能完善方面的重大进步，为未来的功能扩展奠定了坚实的基础。