PPTX 中英双向翻译 Skill

功能说明

将 PowerPoint (.pptx) 文件在中英文之间双向翻译：

触发场景

工作流（标准流程 — 推荐）

> 依赖：需安装 pip install python-pptx，可选安装 pip install "markitdown[pptx]" 用于预览 PPT 内容。

第一步：确认输入文件 + 领域识别

查找用户提供的 PPT 文件，用 markitdown 预览内容，判断 PPT 所属领域：

python3 -m markitdown input.pptx

领域判断：根据内容关键词自动识别，选择对应术语表：
- 农业/遥感：棉花、玉米、冠层、表型、光合、无人机、叶面积指数 → 用农业术语表
- AI/计算机科学：智能体、大模型、记忆、检索、向量数据库、深度学习 → 用 AI 术语表
- 通用学术：其他领域 → 通用翻译规范

第二步：提取文本（段落级）

> 脚本位于 skill 目录下的 scripts/ 子目录，使用相对路径 scripts/translate_pptx_inline.py 调用。

# 中→英（默认）
python3 scripts/translate_pptx_inline.py \
  --mode extract --direction zh2en \
  --input input.pptx \
  --translations-file translations.json

# 英→中
python3 scripts/translate_pptx_inline.py \
  --mode extract --direction en2zh \
  --input input.pptx \
  --translations-file translations.json

输出 JSON 格式（每条 = 一个段落）：

[
  {
    "id": 0,
    "slide": 1,
    "shape_name": "TextBox 15",
    "shape_id": 16,
    "sub_path": "body",
    "para_idx": 0,
    "run_count": 3,
    "location": "slide",
    "original": "搜索引擎、代码运行、API调用结果",
    "translated": "",
    "font_name": "Microsoft YaHei UI",
    "has_existing_english": false,
    "existing_english": ""
  }
]

> ⚡ 双语提示：has_existing_english=true 的条目，existing_english 字段已提取出原文中的英文，可直接填入 translated。

第三步：AI 翻译所有文本

你（Agent）直接翻译所有条目，填写 translated 字段。

> ⚠️ 关键要求：必须用 JSON 中每条的 original 字段完整文本进行翻译，不要手动缩写或从预览中复制。
> 用 id 字段作为索引逐条处理，确保 100% 覆盖，不遗漏任何一条。

翻译要求：
- 以段落为单位翻译，保证语义完整
- 标题使用 Title Case（zh2en 方向）
- 保留数字、公式、单位符号不变
- 学术引用（如 Monteith et al., 1977）保留原文不翻译
- 文件路径保留原文不翻译
- has_existing_english=true 的条目，优先使用 existing_english
- 参考下方术语表保证专业词汇准确
- 已是目标语言的段落（如备注页已是中文），直接复制到 translated

第四步：写入翻译 + 生成 PPT

# 中→英
python3 scripts/translate_pptx_inline.py \
  --mode apply --direction zh2en \
  --input input.pptx \
  --translations-file translations.json \
  --output output_EN.pptx

# 英→中
python3 scripts/translate_pptx_inline.py \
  --mode apply --direction en2zh \
  --input input.pptx \
  --translations-file translations.json \
  --output output_ZH.pptx

此步骤自动完成：
1. 段落级文本替换（翻译写入首 run，清空其余 run）
2. 中文标点清洗
3. 三层字体替换
4. 文本框自动适配（保留原有 spAutoFit/normAutofit，仅对无设置的开启换行+normAutofit）
5. 自动质检（残留中文/标点/重复词/缺失空格）

第五步：查看质检结果

apply 完成后会自动输出质检报告。如果发现问题，修正 JSON 后重新执行第四步。

备选方案（外部 API 全自动模式）

export OPENAI_API_KEY="sk-..."
# 中→英（默认）
python3 scripts/translate_pptx.py \
  --input input.pptx \
  --output output_EN.pptx \
  --model gpt-4o-mini

# 英→中
python3 scripts/translate_pptx.py \
  --direction en2zh \
  --input input.pptx \
  --output output_ZH.pptx \
  --model gpt-4o-mini

翻译质量标准

专业术语表

农业 / 遥感领域

AI / 计算机科学领域

通用学术

字体替换策略（三层覆盖）

常见映射：微软雅黑→Calibri，宋体→Times New Roman，黑体→Arial，思源黑体→Arial

已知限制

输出

最终文件保存为 output_EN.pptx（中→英）或 output_ZH.pptx（英→中），文件名可通过 --output 参数指定。