README.md

---
title: Excel Translator ZH-VI
emoji: 📖
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: false
---

# 批量Excel翻译工具 (ZH-VI)

这是一个使用 Google Gemini 或 OpenAI 模型，将Excel文件中的中文文本批量翻译成越南语的工具。

This is a tool to batch-translate Chinese text to Vietnamese within an Excel file, powered by Google Gemini or OpenAI models.

## ✨ 功能 (Features)

-   **双引擎支持 (Dual Engine Support)**: 可自由选择使用 Google Gemini 或 OpenAI 作为翻译引擎。
-   **模型选择 (Model Selection)**: 为每个服务提供多种模型选择，以平衡质量、速度和成本。
-   **批量处理 (Batch Processing)**: 自动翻译文件中的所有工作表 (sheets)。
-   **保留格式 (Preserves Formatting)**: 复制原始工作表并仅翻译文本内容，保留单元格样式、合并等。
-   **公式引用更新 (Formula-Aware)**: 自动更新翻译后工作表中的公式引用。
-   **实时日志 (Live Logs)**: 在翻译过程中实时查看进度。
-   **隐私保护 (Privacy-Focused)**: 您的 API Key 和文件内容仅在处理期间使用，不会被存储。

## 🚀 如何使用 (How to Use)

1.  **选择服务**: 从 "Gemini" 和 "OpenAI" 中选择您要使用的翻译服务。
2.  **获取并输入 API Key**:
    -   **Gemini**: 获取您的 [Google Gemini API Key](https://aistudio.google.com/api-keys) 并粘贴到对应输入框。
    -   **OpenAI**: 获取您的 [OpenAI API Key](https://platform.openai.com/api-keys) 并粘贴到对应输入框。
3.  **选择模型**: 从下拉菜单中选择一个模型。
4.  **上传文件**: 上传您的 `.xlsx` 格式的Excel文件。
5.  **开始翻译**: 点击 **"开始翻译 (Translate)"** 按钮。
6.  **下载结果**: 处理完成后，在右侧的下载区域下载您的翻译文件。