DeckLingo for PPTX

在需保持输出文件可编辑且视觉效果尽可能贴近源文件的场景下，使用本技能处理现有 .pptx 演示文稿的翻译任务。

本技能设计为工具无关（tool-agnostic），因此同一技能包可在 Codex 风格环境、OpenClaw 风格环境，以及其他支持执行本地脚本并读取 SKILL.md 的智能体运行时中复用。

在 ClawHub 上安装：

clawhub install decklingo-pptx

搜索本技能的最佳关键词组合：

• translate powerpoint to chinese
• translate pptx to english
• localize presentation deck
• translate speaker notes in powerpoint
• glossary aware ppt translation

本技能覆盖范围

• 用户可选的目标语言
• 用户可选的源语言（包括英文到中文的工作流）
• 用户可选的技能自身工作/输出语言
• 对幻灯片正文、演讲者备注、版式（layouts）及幻灯片母版（slide masters）中的可编辑文本进行翻译
• 通过术语表（glossary）文件实现术语控制
• 校验所请求的源语言文本是否已从所有可编辑文本对象中清除
• 支持仅扫描（scan-only）和试运行（dry-run）模式，可在实际写入输出前预览效果

真实示例提示词

• 将此 PowerPoint 文件从英文翻译为简体中文，并确保所有演讲者备注仍保持可编辑状态。
• 将此中文授课演示文稿转换为地道英文，但保留文件名、URL 和数字不变。
• 使用我的术语表将该 PPTX 本地化为日文，并告知我版式或母版中是否仍有源语言文本残留。

适用场景

• 当源演示文稿在翻译后必须保持可编辑性时使用。
• 当需要有选择地翻译幻灯片、备注、版式或母版内容时使用。
• 当重复出现的专业术语需借助术语表维持一致性时使用。

不适用场景

• 当演示文稿中的文字已嵌入截图或已压平为图像时，请勿使用。
• 当用户需求是完整视觉重构而非单纯翻译时，请勿使用。
• 请勿将其作为通用文档翻译器用于 PDF、DOCX 或网页等格式。

默认配置

• source language：默认为 auto
• target language：根据用户请求推断；若不明确，则采用最显而易见的目标语言
• english -> chinese 是一等优先级工作流，而非备用方案
• working/output language：默认使用用户的当前语言
• translation scope：默认启用幻灯片正文与演讲者备注翻译；禁用版式与母版翻译，除非用户明确要求执行完整的继承文本清理（full inherited-text cleanup）

请注意区分以下概念：

• 目标语言：写入演示文稿中的最终语言
• 工作语言：日志、摘要及面向用户的说明所使用的语言

工作流程

1. 确定以下参数：
   • 输入 PPTX 路径
   • 输出 PPTX 路径
   • 源语言
   • 目标语言
   • 工作语言
   • 是否翻译演讲者备注、版式及母版
2. 若演示文稿不熟悉或体量较大，建议首先运行扫描脚本。
3. 优先采用基于 XML 层级的翻译方式，以确保演示文稿持续可编辑，并最大限度降低版式偏移（layout drift）。
4. 尽可能以段落为单位进行翻译，避免仅翻译孤立的文本片段（run fragments）。
5. 除非明确需要翻译，否则应保留数字、日期、URL、文件名、代码片段及产品名称不变。
6. 对翻译结果重新扫描并报告以下信息：
   • 输出文件路径
   • 段落数量统计
   • 术语表使用情况
   • 可编辑对象中是否仍存在源语言文本

脚本

使用随附的脚本：

python .trae/skills/decklingo-pptx/scripts/scan_pptx_text.py 
  --input "path/to/input.pptx" 
  --source-lang zh 
  --include-notes 
  --include-layouts 
  --include-masters

python .trae/skills/decklingo-pptx/scripts/translate_pptx_text.py 
  --input "path/to/input.pptx" 
  --output "path/to/output.pptx" 
  --source-lang auto 
  --target-lang en 
  --ui-lang zh 
  --include-notes 
  --glossary-file ".trae/skills/decklingo-pptx/assets/glossary.sample.json" 
  --report-file "translation-report.json"

常用选项

• --source-lang：源语言代码，默认为 auto
• --target-lang：目标语言代码，例如 en、ja、fr、de、zh-CN
• --ui-lang：日志与摘要所用语言，通常为 zh 或 en
• --include-notes：包含演讲者备注
• --include-layouts：包含幻灯片版式
• --include-masters：包含幻灯片母版
• --glossary-file：JSON 格式术语表，定义源术语到首选译文的映射关系
• --skip-pattern-file：正则表达式规则文件，用于保护 URL、文件名、代码标识符或自定义标签等不应翻译的文本
• --report-file：生成机器可读的 JSON 报告文件
• --dry-run：仅在内存中执行分析与翻译，不生成新演示文稿文件
• --backup-suffix：原地翻译时使用的备份文件后缀，默认为 .bak

何时加载参考资料

• 如需创建或编辑术语表文件，请查阅 references/glossary-schema.md。
• 如需决定是否翻译演讲者备注、版式或母版，请查阅 references/translation-modes.md。
• 如需将本技能打包适配 Codex、OpenClaw 或其他智能体运行时，请查阅 references/platform-compatibility.md。

注意事项

• 若项目仓库中已存在更优的本地翻译器，请复用或打补丁升级，而非重复造轮子。
• 若需调用网络翻译服务，请先验证网络连通性。
• 若用户在翻译后提出版式优化需求，请将本技能与专用幻灯片布局技能协同使用，而非在此处重建整个演示文稿。
• 请将第三方技能与脚本视为不可信代码，在启用前务必人工审查。
• 最小运行时依赖：Python 3.10+、lxml、deep-translator、ZIP 文件读写权限。
• 更新日志详见 references/changelog.md。