汉化 OpenClaw 的 Control UI 界面
# OpenClaw Control UI 汉化脚本
一个用于将 OpenClaw Control UI 界面汉化为中文的用户脚本，支持实时翻译和智能缓存。
## ✨ 主要功能
### 🌐 智能翻译
- **精确匹配翻译**：支持 3000+ 常用词汇的精确翻译
- **正则表达式翻译**：智能匹配动态内容（如时间、数字、状态等）
- **属性翻译**：自动翻译 placeholder、title、aria-label 等属性
- **实时监测**：使用 MutationObserver 自动捕获并翻译新加载的内容
### ⚡ 性能优化
- **翻译缓存**：使用 Map 缓存翻译结果，避免重复计算
- **批量处理**：分批处理 DOM 节点，减少页面卡顿
- **智能防抖**：过滤无关 DOM 变化，降低 CPU 占用
- **标记机制**：已翻译内容不会重复处理
### 🎨 界面定制
- **设置面板**：友好的图形化设置界面
- **自定义翻译**：支持添加个人翻译词条
- **字体大小调节**：可选择正常/大号字体
- **深色模式适配**：自动适配深色主题
### 🔧 调试工具
- **翻译统计**：查看翻译覆盖率和未翻译内容
- **高亮显示**：标记页面中未翻译的文本
- **性能监控**：显示翻译耗时和节点数量
- **导出功能**：导出未翻译文本列表用于改进
## 📦 安装方法
### 前置要求
- 安装浏览器扩展：[Tampermonkey](https://www.tampermonkey.net/) 或 [Violentmonkey](https://violentmonkey.github.io/)
### 安装步骤
1. 打开 Tampermonkey 管理面板
2. 点击"添加新脚本"
3. 复制粘贴 `openclaw-chinese-localization.user.js` 的内容
4. 保存并启用脚本
## 🚀 使用说明
### 基本使用
1. 访问 OpenClaw Control UI 页面（默认：http://localhost:18789）
2. 脚本会自动加载并翻译页面
3. 点击右下角的设置按钮（⚙️图标）可打开设置面板
### 设置选项
#### 基本设置
- **启用汉化**：开启/关闭翻译功能
- **翻译属性**：是否翻译 HTML 元素属性
- **智能正则翻译**：启用正则表达式匹配翻译
#### 显示设置
- **字体大小**：正常 / 大号
- **高亮代码块**：实验性功能，高亮代码区域
#### 自定义翻译
- 在设置面板中添加自定义翻译词条
- 格式：原文 → 译文
- 立即生效，自动保存到本地
### 控制台命令
在浏览器控制台（F12）中可使用以下命令：
```javascript
// 重新翻译页面
openclawI18n.retranslate()
// 强制重新翻译（清除缓存）
openclawI18n.retranslateForce()
// 启用调试模式
openclawI18n.debug.enable()
// 显示翻译统计
openclawI18n.debug.printStats()
// 高亮未翻译文本
openclawI18n.debug.toggleHighlight()
// 测试特定文本的翻译
openclawI18n.debug.testTranslate("Hello World")
// 导出未翻译文本列表
openclawI18n.debug.exportUntranslated()
// 快速开关翻译功能
openclawI18n.toggle()
// 打开设置面板
openclawI18n.openSettings()
// 添加自定义翻译
openclawI18n.add("原文", "译文")
```
## 📊 性能特性
### v2.2 性能优化
- 翻译速度提升 **60-80%**
- CPU 占用降低 **50-70%**
- 显著减少页面卡顿
- 更高效的内存管理
### 优化技术
- Map 缓存机制
- 批量 DOM 处理
- 智能 MutationObserver 过滤
- 防抖延迟优化
- 翻译标记避免重复处理
## 🎯 翻译覆盖范围
### 界面模块
- ✅ 导航菜单（Chat、Control、Overview 等）
- ✅ 频道管理（WhatsApp、Telegram、Discord 等）
- ✅ 代理/会话管理
- ✅ 配置设置页面
- ✅ 日志调试界面
- ✅ 按钮和操作提示
### 动态内容
- ✅ 时间格式（如 "2 hours ago"）
- ✅ 文件大小（如 "1.5 MB"）
- ✅ 状态信息（Online、Offline 等）
- ✅ 错误提示和警告
- ✅ 数量统计（如 "5 items selected"）
## ❓ 常见问题
### 为什么有些文本没有翻译？
1. 可能是新增的内容，尚未添加到词库
2. 使用控制台命令 `openclawI18n.debug.exportUntranslated()` 导出未翻译文本
3. 在设置面板中添加自定义翻译
### 页面卡顿怎么办？
1. v2.2 版本已大幅优化性能
2. 如仍有卡顿，可尝试关闭"智能正则翻译"选项
3. 检查浏览器控制台是否有错误信息
### 如何禁用翻译？
- 方法一：在设置面板中取消勾选"启用汉化"
- 方法二：在 Tampermonkey 中禁用脚本
- 方法三：使用控制台命令 `openclawI18n.toggle()`
### 翻译错误怎么办？
1. 在设置面板的"自定义翻译"中添加正确的翻译
2. 自定义翻译优先级高于默认翻译
3. 可以覆盖任何默认翻译
## 🔄 更新日志
### v2.2 (最新)
- ✨ 新增翻译缓存机制
- ⚡ 性能优化：翻译速度提升 60-80%
- 🐛 修复 MutationObserver 过度触发问题
- 🎨 优化批量处理逻辑
- 📉 降低 CPU 占用 50-70%
- 🔧 改进调试工具
### v2.0
- 完整的设置面板 UI
- 自定义翻译功能
- 调试工具集成
- 深色模式支持
## 📝 技术说明
### 技术栈
- 原生 JavaScript (ES6+)
- MutationObserver API
- LocalStorage 数据持久化
- TreeWalker DOM 遍历
### 浏览器兼容性
- ✅ Chrome/Edge (推荐)
- ✅ Firefox
- ✅ Safari
- ⚠️ 需要支持 ES6+ 特性
## 📄 许可证
MIT License
---
**作者**：You
**版本**：v2.2
**更新时间**：2024
如有问题或建议，欢迎反馈！
