# batch-translation-system

> 批量翻译系统完全指南。包含架构、添加翻译源、进度追踪、语言检测、报告生成。(project)

- Author: gaojie
- Repository: Claudate/ClaudingBot
- Version: 20260128231404
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/Claudate/ClaudingBot
- Web: https://mule.run/skillshub/@@Claudate/ClaudingBot~batch-translation-system:20260128231404

---

---
name: batch-translation-system
description: 批量翻译系统完全指南。包含架构、添加翻译源、进度追踪、语言检测、报告生成。(project)
---

# 批量翻译系统快速指南

## 使用场景

扩展翻译功能、添加翻译源、调试翻译问题时使用此 Skill。

## 系统架构

```
mcp-server/
├── src/
│   ├── batch-translate.ts        # 主入口
│   ├── batch-processor.ts        # 核心处理
│   ├── language-detector.ts      # 语言检测
│   ├── progress-manager.ts       # 进度追踪
│   ├── translators.ts            # 翻译管理器
│   └── translators/              # 翻译实现
│       └── baidu-ai.ts
├── data/
│   ├── progress/
│   └── reports/
└── scripts/
    └── run-batch-translate.js    # 启动脚本
```

## 运行批量翻译

```bash
# 基本用法
npm run batch-translate

# 指定翻译源（baidu, google, deepl, bing, etc.）
npm run batch-translate -- --source baidu

# 限制数量
npm run batch-translate -- --limit 100

# 从指定 ID 开始
npm run batch-translate -- --start-id 123

# 完整示例
npm run batch-translate -- --source baidu --limit 50 --start-id 100
```

## 添加新翻译源

```typescript
// mcp-server/src/translators/myservice.ts
export async function translateMyService(
  text: string,
  targetLanguage: string,
  sourceLanguage?: string
): Promise<string> {
  try {
    // 调用 API
    const response = await fetch('https://api.myservice.com/translate', {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${process.env.MYSERVICE_KEY}` },
      body: JSON.stringify({
        text,
        target: targetLanguage,
        source: sourceLanguage || 'auto',
      }),
    });

    const data = await response.json();
    return data.translatedText;
  } catch (error) {
    throw new Error(`MyService 翻译失败: ${error}`);
  }
}
```

## 注册翻译源

```typescript
// mcp-server/src/translators.ts
import { translateMyService } from './translators/myservice';

export const translators = {
  baidu: { translate: translateBaidu },
  google: { translate: translateGoogle },
  deepl: { translate: translateDeepl },
  myservice: { translate: translateMyService },  // 新增
};
```

## 进度追踪

```typescript
// 进度文件保存位置
mcp-server/data/progress/

// 进度恢复：系统自动读取最后的进度文件
npm run batch-translate  // 自动继续

// 清除进度（重新开始）
rm mcp-server/data/progress/*.json
npm run batch-translate
```

## 语言检测

```typescript
// 自动检测源语言
const sourceLanguage = await detectLanguage(text);

// 或手动指定
const translation = await translate(text, 'en', 'zh');
```

## 查看报告

```bash
# 生成的报告位置
mcp-server/data/reports/

# 查看最新报告
ls -lt mcp-server/data/reports/ | head -5

# 生成格式：translation-report-YYYY-MM-DD-HHmmss.json
```

## 常见问题

### 翻译缓慢
- 减少 batch size：使用 `--limit 50`
- 检查 API 限额

### 翻译失败
- 检查 API Key 是否正确
- 查看错误日志
- 尝试其他翻译源

### 数据不完整
- 运行修复命令重新翻译缺失部分
- 检查数据库 `is_processed` 字段