# 多语言本地化翻译工具

这是一个基于大语言模型的本地化翻译工具，可以自动处理并翻译各种本地化文件（.ts、.js、.json）中的文本内容。

## 功能特点

1. 支持多种文件格式
   - TypeScript (.ts)
   - JavaScript (.js)
   - JSON (.json)

2. 智能文件处理
   - 自动识别文件中的语言代码（如：en-US, zh-CN）
   - 自动备份原始文件
   - 保持源文件格式和结构

3. 高效批处理
   - 支持整个目录的批量处理
   - 自动创建输出目录结构
   - 并发处理多个文件
   - 支持单文件处理

4. 安全特性
   - 自动文件备份
   - 错误处理和日志记录
   - 格式验证和清理

## 使用说明

### 文件命名规范

翻译文件需要在文件名中包含语言代码，例如：
- messages.en-US.ts
- translations.zh-CN.json

支持的语言代码格式：
- xx-XX（如：zh-CN, en-US）
- xx-xx（如：zh-cn, en-us）

### Cursor 配置说明

1. 打开 Cursor 设置
2. 找到 MCP 配置
3. 根据操作系统输入对应配置：

#### Mac 用户
```json
{
  "mcpServers": {
    "transform": {
      "command": "node",
      "args": [
        "{\"apiKey\":\"你的API密钥\",\"modelName\":\"你使用的模型名称\",\"baseUrl\":\"API基础URL\"}"
      ]
    }
  }
}
```

#### Windows 用户
```json
{
  "mcpServers": {
    "transform": {
      "command": "cmd",
      "args": [
        "/c",
        "node",
        "{\"apiKey\":\"你的API密钥\",\"modelName\":\"你使用的模型名称\",\"baseUrl\":\"API基础URL\"}"
      ]
    }
  }
}
```

### 注意事项

1. 文件处理
   - 处理前会自动备份原文件
   - 备份文件格式：`原文件名.backup.时间戳.扩展名`
   - 跳过不符合命名规范的文件

2. 错误处理
   - 单个文件处理失败不会影响其他文件
   - 控制台会输出处理状态和错误信息

3. 性能优化
   - 大文件会自动分块处理
   - 默认每块最大处理 500 个键值对
   - 并发处理多个文件提高效率

4. 路径问题
    - 请使用绝对路径，相对路径会查找代码执行位置