gc_i18n 1.3.10 → 1.3.11

package/.qoder/repowiki/zh/content//351/253/230/347/272/247/347/224/250/346/263/225//346/226/207/346/234/254/347/274/226/350/276/221/346/250/241/345/274/217/345/212/237/350/203/275.md

@@ -18,21 +18,17 @@
 
 ## 更新摘要
 **变更内容**
-- 翻译保存机制重构：从批量处理重构为单个保存操作，提升代码简洁性和用户体验
-- 编辑对话框标题优化：从通用格式更新为显示原值参考，提供更好的用户反馈
-- 新增 saveTranslate 服务函数集成：统一翻译保存接口，增强功能一致性
-- 改进的错误处理和调试功能：增强的错误信息显示和用户反馈机制
-- 错误消息文本优化：将"框架内部固定翻译，不支持修改"更新为更简洁的"系统字段不支持修改"
-- 代码格式化优化：改善了代码可读性和维护性
-- 新增完整的 TextEditMode 类实现，提供可视化的文本编辑功能
+- 版本升级至 v1.3.10，新增完整的 TextEditMode 类实现
 - 新增部分文本翻译编辑能力，支持文本节点中的部分翻译内容识别
-- 新增改进的翻译键跟踪机制，包含多层缓存策略
-- 新增增强的错误处理和用户反馈机制，包括安全保护和提示信息
-- 新增视觉样式的优化，改进了编辑模式的视觉效果
-- 增强的安全保护机制，支持框架内部固定翻译的保护
-- 完善的用户体验设计，包括编辑弹窗和状态提示
-- 优化的翻译数据获取和保存流程
-- 增强的错误处理和用户反馈机制
+- 改进翻译保存机制，从批量处理重构为单个保存操作
+- 增强安全保护机制，支持框架内部固定翻译的保护
+- 改进错误处理和用户反馈机制，包括保存错误容器和详细错误信息
+- 编辑对话框标题优化，从通用格式更新为显示原值参考
+- 新增 saveTranslate 服务函数集成，统一翻译保存接口
+- 新增智能文本节点扫描机制，支持部分匹配和批量处理
+- 新增多层缓存策略，包含全局映射、本地存储和路由翻译
+- 新增 HTML 转义功能，增强安全性
+- 新增更新页面上已翻译文本功能，支持实时预览
 
 ## 目录
 1. [简介](#简介)
@@ -60,6 +56,9 @@
 - 新增安全保护机制，防止修改框架内部固定翻译
 - 新增改进的翻译键跟踪机制，提供更准确的翻译定位
 - **新增** 翻译保存机制重构，从批量处理优化为单个保存操作，提升代码简洁性和用户体验
+- **新增** 智能文本节点扫描机制，支持部分匹配和批量处理
+- **新增** 多层缓存策略，包含全局映射、本地存储和路由翻译
+- **新增** HTML 转义功能，增强安全性
 
 ## 项目结构
 
@@ -149,6 +148,7 @@ class TextEditMode {
 +async fetchTranslations(key)
 +async saveTranslations(key, values, originalTranslations)
 +escapeHtml(text)
++updateTranslatedText(key, values)
 }
 class I18n {
 -string editKeyboard
@@ -162,7 +162,7 @@ I18n --> TextEditMode : "控制"
 ```
 
 **图表来源**
-- [packages/libs/textEditMode.js:14-575](file://packages/libs/textEditMode.js#L14-L575)
+- [packages/libs/textEditMode.js:14-623](file://packages/libs/textEditMode.js#L14-L623)
 - [packages/index.js:70-160](file://packages/index.js#L70-L160)
 
 ### 键盘快捷键系统
@@ -208,6 +208,8 @@ L[状态指示器]
 M[安全保护机制]
 N[部分文本编辑]
 O[翻译键跟踪]
+P[HTML 转义]
+Q[实时更新]
 end
 A --> D
 B --> D
@@ -224,11 +226,13 @@ E --> L
 E --> M
 E --> N
 E --> O
+E --> P
+E --> Q
 ```
 
 **图表来源**
 - [packages/index.js:70-516](file://packages/index.js#L70-L516)
-- [packages/libs/textEditMode.js:14-575](file://packages/libs/textEditMode.js#L14-L575)
+- [packages/libs/textEditMode.js:14-623](file://packages/libs/textEditMode.js#L14-L623)
 
 ## 详细组件分析
 
@@ -274,7 +278,7 @@ TextMode->>User : 刷新页面
 
 **图表来源**
 - [packages/index.js:152-156](file://packages/index.js#L152-L156)
-- [packages/libs/textEditMode.js:89-575](file://packages/libs/textEditMode.js#L89-L575)
+- [packages/libs/textEditMode.js:89-623](file://packages/libs/textEditMode.js#L89-L623)
 
 ### 文本节点扫描机制
 
@@ -346,6 +350,7 @@ ReturnKey --> End([返回翻译键])
 | 关闭按钮 | 关闭弹窗 | 无 | 无 |
 | 错误提示 | 显示保存错误信息 | 无 | 无 |
 | **新增** 保存错误容器 | 显示保存失败信息 | 无 | 错误处理 |
+| **新增** 原值参考显示 | 显示原始翻译值 | 无 | 无 |
 
 **更新** 新增了安全保护机制，对框架内部固定翻译（以 `i.` 或 `pro.` 开头）进行保护，防止用户修改。新增改进了错误处理，包括保存失败的详细错误信息显示。
 
@@ -379,6 +384,25 @@ ReturnSuccess --> End
 - [packages/libs/textEditMode.js:527-557](file://packages/libs/textEditMode.js#L527-L557)
 - [packages/libs/service.js:72-81](file://packages/libs/service.js#L72-L81)
 
+### 安全保护机制
+
+**更新** 新版本引入了重要的安全保护机制，防止修改框架内部固定翻译：
+
+```mermaid
+flowchart TD
+Start([开始编辑]) --> CheckKey["检查翻译键"]
+CheckKey --> IsInternal{"是否为内部翻译?"}
+IsInternal --> |是| ShowWarning["显示警告信息"]
+IsInternal --> |否| LoadData["加载翻译数据"]
+ShowWarning --> BlockEdit["阻止编辑"]
+BlockEdit --> End([结束])
+LoadData --> OpenModal["打开编辑弹窗"]
+OpenModal --> End
+```
+
+**图表来源**
+- [packages/libs/textEditMode.js:371-383](file://packages/libs/textEditMode.js#L371-L383)
+
 ## 依赖关系分析
 
 ### 核心依赖关系图
@@ -410,6 +434,7 @@ Z[lang/index.js] --> AA[语言配置]
 BB[src/view/Home.vue] --> CC[主页视图]
 DD[packages/libs/textEditMode.css] --> EE[编辑模式样式]
 FF[packages/libs/textEditMode.js] --> GG[部分文本处理]
+HH[lang/index.json] --> II[翻译数据]
 end
 A --> M
 C --> Q
@@ -427,11 +452,12 @@ V --> M
 X --> M
 DD --> M
 EE --> M
+II --> M
 ```
 
 **图表来源**
 - [packages/index.js:1-516](file://packages/index.js#L1-L516)
-- [packages/libs/textEditMode.js:1-575](file://packages/libs/textEditMode.js#L1-L575)
+- [packages/libs/textEditMode.js:1-623](file://packages/libs/textEditMode.js#L1-L623)
 - [packages/libs/service.js:1-136](file://packages/libs/service.js#L1-L136)
 
 ### 模块耦合度分析
@@ -446,6 +472,8 @@ EE --> M
 | 服务层 | 中等 | 低 | API 请求封装 |
 | UI 组件 | 高 | 低 | 视觉呈现 |
 | 工具函数 | 高 | 低 | 通用工具方法 |
+| **新增** 安全保护模块 | 高 | 低 | 翻译类型验证 |
+| **新增** 错误处理模块 | 高 | 低 | 异常情况处理 |
 
 ## 性能考虑
 
@@ -460,6 +488,8 @@ EE --> M
 5. **安全检查优化**：对框架内部翻译的检查在编辑前进行，避免不必要的 API 调用
 6. **新增** 部分文本处理优化：智能识别和处理文本节点中的部分翻译内容，减少 DOM 操作次数
 7. **新增** 保存机制优化：单个保存操作替代批量处理，减少内存占用和网络请求
+8. **新增** HTML 转义优化：只在必要时进行转义，提升性能
+9. **新增** 实时更新优化：只更新受影响的元素，避免全页面刷新
 
 ### 性能优化建议
 
@@ -473,6 +503,8 @@ EE --> M
 | 安全检查缓存 | 缓存翻译类型检查结果 | 减少重复计算 |
 | **新增** 内存清理 | 及时清理部分文本包装元素 | 释放内存资源 |
 | **新增** 保存机制优化 | 单个保存操作替代批量处理 | 提升代码简洁性和性能 |
+| **新增** HTML 转义优化 | 按需转义减少计算量 | 提升渲染性能 |
+| **新增** 实时更新优化 | 精确更新受影响元素 | 减少重绘重排 |
 
 ## 故障排除指南
 
@@ -491,6 +523,8 @@ EE --> M
 | **新增** 保存失败 | 编辑后无法保存更改 | 权限不足或网络错误 | 检查用户权限和网络状态 |
 | **新增** 部分文本匹配错误 | 文本被错误地分割 | 匹配算法问题 | 检查 wrapMultipleTextParts |
 | **新增** 保存错误显示问题 | 错误信息不显示或显示异常 | DOM 操作失败 | 检查错误容器创建 |
+| **新增** HTML 转义问题 | 特殊字符显示异常 | 转义功能失效 | 检查 escapeHtml 函数 |
+| **新增** 实时更新失败 | 保存后页面未更新 | 更新函数执行失败 | 检查 updateTranslatedText |
 
 ### 调试工具
 
@@ -503,6 +537,8 @@ EE --> M
 5. **安全检查日志**：显示翻译类型验证过程
 6. **新增** 部分文本调试：显示文本匹配和包装过程
 7. **新增** 保存机制调试：显示保存数据构建和 API 调用过程
+8. **新增** HTML 转义调试：显示字符转义过程
+9. **新增** 实时更新调试：显示元素更新过程
 
 **章节来源**
 - [packages/libs/textEditMode.js:369-485](file://packages/libs/textEditMode.js#L369-L485)
@@ -524,6 +560,10 @@ EE --> M
 8. **新增** 改进的错误处理：提供详细的错误信息和用户反馈
 9. **新增** 翻译保存机制重构：从批量处理优化为单个保存操作，提升代码简洁性和用户体验
 10. **新增** 编辑对话框标题优化：显示原值参考，提供更好的用户反馈
+11. **新增** 智能文本节点扫描：自动识别和处理部分翻译内容
+12. **新增** 多层缓存策略：包含全局映射、本地存储和路由翻译
+13. **新增** HTML 转义功能：增强安全性
+14. **新增** 实时更新机制：保存后立即更新页面显示
 
 ### 技术亮点
 
@@ -536,6 +576,8 @@ EE --> M
 - **新增** 用户反馈：详细的错误提示和状态通知
 - **新增** 内存优化：高效的内存管理和清理机制
 - **新增** 保存机制优化：单个保存操作替代批量处理，提升代码简洁性和性能
+- **新增** HTML 转义优化：按需转义减少计算量
+- **新增** 实时更新优化：精确更新受影响元素，减少重绘重排
 
 ### 安全改进
 
@@ -560,4 +602,16 @@ EE --> M
 - **统一接口**：集成 saveTranslate 服务函数，增强功能一致性
 - **错误处理**：改进的错误信息显示和用户反馈机制
 
-该功能的成功实现展示了现代前端国际化解决方案的最佳实践，为类似项目提供了宝贵的参考经验。新版本的文本编辑模式不仅提升了开发效率，还增强了系统的安全性和可靠性，特别是在部分文本编辑、错误处理和保存机制方面的改进，为用户提供了更加完善和可靠的翻译管理体验。
+**新增** 安全保护机制：
+- **翻译类型验证**：自动识别框架内部翻译
+- **用户提示**：友好的错误信息显示
+- **操作阻止**：防止修改受保护的翻译
+
+**新增** HTML 转义功能：
+- **字符安全**：防止 XSS 攻击
+- **按需转义**：提升性能表现
+- **兼容性保证**：确保特殊字符正确显示
+
+该功能的成功实现展示了现代前端国际化解决方案的最佳实践，为类似项目提供了宝贵的参考经验。新版本的文本编辑模式不仅提升了开发效率，还增强了系统的安全性和可靠性，特别是在部分文本编辑、错误处理、保存机制和安全保护方面的改进，为用户提供了更加完善和可靠的翻译管理体验。
+
+**版本信息**：当前版本为 v1.3.10，包含了上述所有新增功能和改进。