前言¶
对外汇报或投材料时，经常需要把中文 PPT 做成英文版。手工复制到翻译工具再贴回幻灯片，容易打乱文本框位置、字号和加粗分段；整页导出为图片再翻译，则失去可编辑性。下面介绍一个在 Agent 里用的 Skill：从原文件提取文本，经 AI 中译英后只替换文字，布局与格式尽量与原文一致。
这是什么¶
专业PPT一键翻译是 SkillHub 社区 Skill，坐标 @user_efc825fc/1117，版本 1.0.0，分类 office-efficiency，发布者 user_efc825fc。官方页面：SkillHub，API 入口：https://api.skillhub.cn/user_efc825fc/1117。
它面向「中文 PPT → 英文 PPT」：生成新文件，幻灯片正文与备注中的中文译为英文，并尽量保持原文在页面上的位置、大小以及字号、加粗、颜色等格式，便于译后再微调。
技术路径在简介中写得很清楚：python-pptx 提取文本 → AI 翻译 → python-pptx 回写，仅替换文本内容。页面标签标明 requires_api_key=false（Skill 本身不强制单独配置 API Key；实际翻译仍依赖你所用 Agent 的模型能力）。
在 SkillHub 上该 Skill 评分为 100000，下载 1722 次（数据以 SkillHub 页面为准）。
核心功能¶
以下能力均来自官方 Skill 说明，可按条对照预期。
-
结构化提取
从原始中文 PPT 中提取全部文本（含幻灯片正文与备注），输出结构化 JSON，供翻译阶段使用。 -
AI 中译英
基于 JSON 做中译英，强调专业术语准确性（具体术语表与领域规则以 Skill 内SKILL.md及 Agent 执行为准）。 -
格式保持的回写
将译文写回 PPT，替换原中文，目标是不改位置、大小与可见格式属性。 -
段落级合并翻译
同一段落内若被拆成多个 run，先合并再翻译后写回，避免按 run 逐段翻译造成语义断裂。 -
字体与语言属性
将东亚字体（如微软雅黑）切换为对应英文字体，并将lang从zh-CN调整为en-US。
何时会用到这个 Skill¶
官方说明建议在用户需要把中文 PPT 译成英文，或提到下列意图时启用，例如：PPT翻译、PPT英化、中文PPT转英文、翻译PPT、PPT中译英、PPT translate、convert PPT to English、translate slides、PPT英文版 等。
安装与启用¶
SkillHub 页面提示：按 SkillHub 安装说明 安装坐标 @user_efc825fc/1117。下面是与文档一致的 CLI 流程摘要。
1、检查是否已安装 skillhub CLI
command -v skillhub && skillhub --version
未安装时可执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装到当前 Agent 的 skills 目录
安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。常用路径如下（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令示例（将 <skills 目录> 换成你环境对应路径）：
skillhub install @user_efc825fc/1117 --dir <skills 目录>
也可在对话中把上述安装说明与坐标发给 AI，让其按 SkillHub 页面指引完成安装。安装后按你所用客户端要求刷新或重启 Agent，使 Skill 生效。
典型用法¶
官方资料未给出固定 shell 一键命令；典型流程是在已启用该 Skill 的 Agent 对话中说明需求，并提供待翻译的中文 .pptx 路径（或按 Agent 要求上传文件）。
可复现的操作顺序可以概括为：
- 确认 Skill
@user_efc825fc/1117已安装到当前 Agent 的 skills 目录。 - 在对话中说明要做「中文 PPT 中译英」，并给出源文件路径。
- 由 Agent 按 Skill 定义执行：提取 JSON → 翻译 → 回写，输出新的英文 PPT 文件。
- 在 PowerPoint 或兼容软件中打开结果，检查版式与术语，按需微调。
具体脚本名、中间 JSON 字段与输出文件名以安装后的 SKILL.md 为准；本文不臆造未在官方页面出现的配置项。
适用场景与注意¶
适合谁
- 需要快速产出英文版幻灯片、且希望保留原排版与格式的办公场景。
- 正文与备注都要英化、又不想手动逐框粘贴翻译结果的用户。
- 已在 Cursor、Claude Code、Codex 等支持 Skills 的环境里工作的开发者或运营。
限制与注意
- 依赖 python-pptx 的提取与回写能力：复杂 SmartArt、嵌入对象、部分特殊形状内的文字，官方说明未承诺全覆盖，译后应人工抽检。
- 翻译质量取决于 Agent 所用模型与 Skill 内提示；专业领域术语建议在成稿后统一校对。
- 英文字符长度与中文不同，极端情况下仍可能出现文本框内溢出，需要本地微调字号或换行。
- Skill 标签为 requires_api_key=false，表示 Skill 包本身不要求单独登记 SkillHub API Key；模型调用费用与配额仍由你的 Agent 平台承担。
结尾¶
专业PPT一键翻译把「提取 → 翻译 → 回写」收进一个 Skill，用段落合并与字体/lang 处理减轻版式与语义上的常见损耗。若你正在 SkillHub 上找办公类能力，可直接打开官方页查看版本与说明：https://www.skillhub.cn/skills/user_efc825fc/1117。
