Rosetta

🚀 Rosetta

Rosetta 是一款由人工智能驅動的 Excel 翻譯命令行工具，它能夠在翻譯 Excel 文件的同時，完美保留文件的格式、公式和數據完整性。

🚀 快速開始

Rosetta 藉助 Claude AI 對 Excel 文件中的所有文本進行翻譯，且不會破壞以下內容：

• 公式和計算
• 格式（字體、顏色、邊框）
• 合併單元格和佈局
• 圖表和圖像
• 下拉菜單
• 富文本（單元格內的粗體、斜體）

✨ 主要特性

• 精準翻譯：利用 Claude AI 進行文本翻譯，保證翻譯質量。
• 格式保留：在翻譯過程中，完整保留 Excel 文件的格式、公式、合併單元格等內容。
• 多語言支持：支持多種目標語言的翻譯。
• 靈活配置：可指定源語言、目標語言、輸出文件路徑、翻譯的工作表等。
• 即時進度：通過 Server-Sent Events (SSE) 實現即時翻譯進度跟蹤。
• MCP 集成：支持與 Claude Desktop 和 Claude Web 進行 MCP 集成。

📦 安裝指南

安裝 Rosetta

從 PyPI 安裝：

pip install rosetta-xl

設置 API 密鑰

你需要從 Anthropic 獲取 Claude API 密鑰。

1. 訪問 console.anthropic.com
2. 創建賬戶（或登錄）
3. 進入 API Keys 並創建新密鑰
4. 複製密鑰（以 sk-ant- 開頭）

設置 API 密鑰有以下幾種方式：

Linux/macOS

export ANTHROPIC_API_KEY=sk-ant-your-key-here

Windows (Command Prompt)

set ANTHROPIC_API_KEY=sk-ant-your-key-here

Windows (PowerShell)

$env:ANTHROPIC_API_KEY="sk-ant-your-key-here"

或者在工作目錄中創建一個 .env 文件：

ANTHROPIC_API_KEY=sk-ant-your-key-here

⚠️ 重要提示

API 使用由 Anthropic 計費。請查看 anthropic.com/pricing 獲取當前費率。翻譯一個典型的 Excel 文件通常只需幾美分。

💻 使用示例

基礎用法

# 翻譯為法語
rosetta input.xlsx -t french

# 翻譯為西班牙語並指定輸出文件名
rosetta input.xlsx -t spanish -o translated.xlsx

# 指定源語言（默認自動檢測）
rosetta input.xlsx -s english -t german

# 僅翻譯特定工作表
rosetta input.xlsx -t french --sheets "Sheet1" --sheets "Data"

# 添加上下文以提高翻譯質量（例如特定領域術語）
rosetta input.xlsx -t french -c "Medical terminology document"

高級用法

翻譯價格表到多種語言

rosetta prices.xlsx -t french -o prices_fr.xlsx
rosetta prices.xlsx -t german -o prices_de.xlsx
rosetta prices.xlsx -t spanish -o prices_es.xlsx

翻譯帶有上下文的醫療表格

rosetta patient_form.xlsx -t french -c "Medical intake form with clinical terminology"

僅翻譯 "Questions" 工作表

rosetta survey.xlsx -t japanese --sheets "Questions"

📚 詳細文檔

選項說明

故障排除

"ANTHROPIC_API_KEY not set"

• 確保已導出密鑰：export ANTHROPIC_API_KEY=sk-ant-...
• 或者創建一個包含密鑰的 .env 文件

"Invalid API key"

• 檢查密鑰是否以 sk-ant- 開頭
• 確保從 console.anthropic.com 複製了完整的密鑰

"Rate limit exceeded"

• 你已達到 Anthropic 的速率限制。等待一分鐘後再試
• 或者減小批量大小：rosetta input.xlsx -t french -b 20

🔧 技術細節

工作原理

1. 從 Excel 文件中提取所有文本單元格
2. 將文本分批發送到 Claude AI 進行翻譯
3. 將翻譯結果寫回文件，同時保留所有格式
4. 保存翻譯後的文件

你的原始文件不會被修改。

Web 應用和 API

Rosetta 還包含一個 Web 應用程序和 REST API，用於基於瀏覽器的翻譯。

運行 API 服務器

# 使用 uv 安裝（推薦）
uv sync

# 啟動服務器
uv run uvicorn rosetta.api:app --reload

# 或者使用 pip
pip install -e .
uvicorn rosetta.api:app --reload

API 默認運行在 http://localhost:8000。

運行前端

cd frontend
npm install
npm run dev

前端運行在 http://localhost:5173 並連接到 API。

API 端點

即時進度

/translate-stream 端點使用 Server-Sent Events (SSE) 即時流式傳輸翻譯進度。在不支持 SSE 的網絡（例如企業代理）中，前端會自動回退到標準的 /translate 端點。

MCP 集成

Rosetta 包含適用於 Claude Desktop 和 Claude Web 的 MCP（Model Context Protocol）服務器。

對於 Claude Desktop（本地）

將以下內容添加到你的 Claude Desktop 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "rosetta": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/rosetta", "python", "-m", "rosetta.api.mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-key-here"
      }
    }
  }
}

使用方法：使用本地文件路徑以獲得最佳效果。

Translate ~/Downloads/report.xlsx to French

對於 Claude Web（瀏覽器）

注意：截至 2026 年 1 月，Claude.ai 尚不支持在瀏覽器中使用自定義 MCP 服務器。

當前建議：使用 Web 應用 進行基於瀏覽器的翻譯。

詳細說明請參閱 MCP_USAGE.md。

📄 許可證

本項目採用 MIT 許可證。

📦 要求

• Python 3.11+
• Anthropic API 密鑰