# translateppt

**Repository Path**: picksan/translateppt

## Basic Information

- **Project Name**: translateppt
- **Description**: PPT翻译工具
将PPT中的中文文字翻译成英文，保留图片和格式。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-30
- **Last Updated**: 2026-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PPT翻译工具

将PPT中的中文文字翻译成英文，保留图片和格式。

## 安装依赖

```bash
pip install python-pptx requests
```

## 使用方式

### 方式1：交互界面（推荐）

```bash
python ppt_tool.py
```

按提示选择操作编号，输入文件名即可。

### 方式2：命令行

**第一步：提取文字**

```bash
python translate_ppt.py extract 你的文件.pptx
```

**第二步：翻译（大模型）**

```bash
python translate_ppt.py translate 你的文件.txt --key 密钥 --url API地址 --model 模型名
```

**第二步：翻译（手动）**

直接用文本编辑器打开txt文件，在每行第三列填写翻译。

**第三步：替换到PPT**

```bash
python translate_ppt.py apply 你的文件.pptx 你的文件.txt
```

## txt文件格式

每行一条，用 `|||` 分隔：

```
序号|||原文|||翻译
```

示例：

```
0|||运动与健康|||Exercise and Health
1|||你知道运动有什么好处吗？|||Do you know the benefits of exercise?
```

- 序号从0开始
- 翻译列留空表示未翻译，第三步会跳过
- 可以手动编辑翻译内容

## 配置文件

第二步翻译时会询问是否保存配置，保存后生成 `config.json`：

```json
{
  "api_key": "你的密钥",
  "api_url": "https://token-plan-cn.xiaomimimo.com",
  "model": "mimo-v2.5"
}
```

之后翻译自动读取配置，不再询问。

## 断点续翻

翻译中途报错或中断？没关系：

- 每翻译一条就自动保存到txt文件
- 下次再运行第二步，自动跳过已翻译的内容
- 翻译失败的不会保存，下次自动重试

## 支持的API格式

兼容OpenAI接口的服务均可使用，例如：

| 服务 | URL | 模型 |
|------|-----|------|
| 硅基流动 | `https://api.siliconflow.cn` | `Qwen/Qwen2.5-7B-Instruct` |
| DeepSeek | `https://api.deepseek.com` | `deepseek-chat` |
| 小米MiMo | `https://token-plan-cn.xiaomimimo.com` | `mimo-v2.5` |
| OpenAI | `https://api.openai.com` | `gpt-4o-mini` |

## 文件说明

| 文件 | 说明 |
|------|------|
| `ppt_tool.py` | 命令行交互界面 |
| `translate_ppt.py` | 命令行脚本（支持子命令） |
| `config.json` | API配置文件（自动生成） |