前言¶
對外匯報或投材料時，經常需要把中文 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。
