PowerPoint 自動字幕與影片
將現有的本機 PPTX 轉換為可編輯的字幕簡報與影片。保留原始簡報不變。字幕是原生的 PowerPoint 文字方塊，帶有進入與退出效果，而非扁平化的投影片影像或僅 SRT 檔案。
輸入與決定
在開始製作前，先確定特定的來源 PPTX（絕對路徑、確切的附件名稱或明確識別的開啟簡報）、輸出目錄、持續時間策略、字幕語言與字幕來源。字幕來源可以是命名的文件、使用者提供的逐頁文字、命名的旁白檔案，或明確要求從簡報中草稿生成。確認參考的檔案存在，且字幕與實際投影片順序相符。如果在對話中來源簡報或字幕來源仍然不明確，僅詢問缺少的資訊；不要選取無關的歷史簡報或虛構的腳本源。一個帶有佔位符路徑的貼上範例請求並非實際的輸入簡報。
識別要包含的任何真實媒體。重複使用提供的素材與測量值。如果未提供音檔，則根據投影片內容撰寫簡潔的字幕；不要將其描述為語音轉錄。當有音檔存在時，使字幕與實際旁白對齊。
有關從投影片草擬字幕、接受逐頁文字或文件，以及根據文字長度估算時間，請參閱字幕撰寫與時間設定。包含的 scripts/captions-to-timeline.py 可將標準化的 Markdown/TXT 轉換為動畫 CSV，並可調整英文單字與中文字元的閱讀速度。當有旁白時，使用實際的語音時間。
在加入動畫前，先產生 UTF-8 時間軸。請參閱時間軸合約以了解架構與時間計算公式。投影片在檔案中的位置 (slide_index) 可能與其列印頁碼 (slide_number) 不同。九張投影片或 160 秒並非通用預設值。
字幕優先輸入
支援兩種字幕準備路徑：(A) 從指定的 PPTX 草擬；(B) 標準化使用者提供的字幕而不重新草擬。對於路徑 B，保留措辭、順序、數值與單位；僅在要求時才進行翻譯或潤飾。將未解決的分頁對應與建議的意義修改編輯保留在單獨的審閱筆記中。當請求此階段性工作流程時，這兩種路徑都可以在生產前收斂於使用者審閱、編輯與確認。支援草稿-編輯-生產的工作流程：當要求時，自動讀取指定的簡報並儲存標準的逐頁字幕草稿與單獨的審閱筆記。不需要使用者先手動填寫範本。在審閱筆記中標記無法讀取的內容與不確定的陳述，而不是虛構字幕。當使用者要求在生產前進行人工審閱時，提供草稿並等待編輯後的檔案。在後續的生產階段，將該編輯後的檔案視為字幕的來源真相；保留其措辭，根據它重新計算時間，並且不要用新的簡報衍生腳本覆蓋它。此審閱階段是請求的工作流程範圍，並非明確授權的一次性匯出的強制關卡。
開始新的字幕工作流程時，請協助使用者以標準的逐頁格式提供字幕。說明 ## Slide N 標識實際的 PPTX 投影片，且每一行 - 是一個提示。接受命名的字幕檔案或貼上帶有投影片標籤的文字。在計算時間之前，將 Word 或非結構化的草稿標準化為 UTF-8 的 captions.md。將視覺指示與任務說明保留在字幕文字之外。檢查投影片順序、遺失的頁面與未取代的範本佔位符。當使用者選擇了提供腳本的工作流程時，不要虛構遺失的字幕；僅在要求時才從簡報中草擬。如果使用者僅要求整理字幕文件，則在提供該文件與對應檢查後停止，不繼續進行動畫/匯出。重複使用已有效的字幕檔案，而不是重複輸入。對於端到端的影片請求，標準化是中繼步驟：繼續進行時間設定、原生動畫、匯出與實際播放品質確認，無需不必要的批准關卡。僅在明確請求此有限範圍時，或在未解決的遺失輸入阻止進一步工作時，才在字幕文件後停止。
生產前的版面審閱
對於需要使用者審閱的階段性工作流程，在動畫前保留一致的底部字幕區域。從投影片高度的 10%–15% 左右開始，根據實際字幕長度與可讀性進行調整，而非強制固定比例。保留原始樣式與測量內容。重新定位或適度調整主體內容大小；切勿為了模擬空白區域而覆蓋原始內容。保持座標軸、圖表標題、頁尾與標誌清晰可見。在更改版面時保留現有的動畫。
提供單獨的可編輯版面 PPTX 與 PDF/逐頁審閱預覽。在預覽中顯示每張投影片最長的字幕以檢查文字是否合適；不要在生產來源中留下預覽字幕佔位符。標記擁擠的頁面。當使用者要求人工版面確認時，等待確認後再進行最終動畫/匯出，然後使用已確認的版面簡報與已確認的字幕檔案作為生產輸入。將輔助條帶的放置/字型設定與已批准的版面匹配；不要盲目使用預設值。重複使用已批准的版面，而不是重複此階段。明確授權一次性工作流程時，不需要額外的審閱關卡。
工作流程
- 檢查並準備簡報。 保留圖表、表格、媒體、備註與現有設計。在繪圖標籤與影片輸出區域外保留一個底部字幕條帶。必要時先重新排列內容。根據實際投影片尺寸調整字幕大小。將字幕限制在一到兩行。
- 撰寫並檢查時間軸。 為每個提示賦予唯一的
CAPTION_…形狀名稱。檢查每個提示的邊界、間隙、重疊、投影片持續時間與累積影片時間。將最終 CSV 與輸出保存在一起。 - 建立原生字幕效果。 在 Windows 桌面版 PowerPoint 上，當其前置條件符合時使用提供的輔助指令碼。它透過 PowerPoint 物件模型建立可編輯的文字方塊與原生的淡入/淡出效果。其時間模型使用自動的 After Previous 效果，這避免了 With Previous 鏈中絕對延遲的模糊性。
- 設定自動投影片切換。 使用每張投影片的時間軸持續時間，停用點擊切換，並使用錄製的投影片時間與動畫進行匯出。保留不相關的簡報功能。
- 透過 PowerPoint 匯出。 提供動畫版 PPTX、實際 MP4、最終 CSV 與請求的 PDF/PNG。靜態預覽顯示每張投影片的第一個提示；PPTX 保留所有提示。遺失的示範影片保留為明確標記的佔位符。
- 驗證實際輸出。 檢查渲染的投影片並在每個提示內部、跨投影片邊界以及選定的淡出處取樣檢查 MP4。確認持續時間、可讀的字幕、正確的消失以及沒有殘留的字幕文字。僅憑 XML 檢查、SRT 檔案或匯出完成狀態無法確認正確播放。明確報告未經驗證的項目。
輔助指令碼
scripts/add-subtitles-and-export.ps1 接受本機 PPTX 與時間軸 CSV。它會寫入一個副本、加入字幕、匯出 PDF/PNG，除非另有要求，否則還會匯出 MP4。它拒絕現有的動畫序列或字幕物件，因為合併這些序列需要深思熟慮的製作。對於已加入動畫的來源，請使用現有的簡報工具保留並調整現有時間軸，而不是清除所有效果。
pwsh -NoProfile -File "<skill>/scripts/add-subtitles-and-export.ps1" `
-InputPptx "C:/work/presentation.pptx" `
-TimelineCsv "C:/work/subtitle_timeline.csv" `
-OutputDirectory "C:/work/captioned-output"
僅透過目前環境允許的執行方法執行。輔助指令碼需要已安裝 Microsoft PowerPoint 的 Windows 桌面登入工作階段。沙箱 COM 登入工作階段錯誤是環境限制：使用批准的桌面執行路徑或原生 UI，並保留任何必要的批准邊界。不要削弱安全性設定或繞過執行原則。
對於影片品質確認，偏好使用可用的媒體解碼器。可選的 scripts/extract-video-frames.ps1 使用 Windows 媒體解碼，需要 PowerShell 7 並以 STA 模式執行。在疑難排解或調整現有動畫時，請參閱 Office 播放與匯出注意事項。
完成
提供所請求檔案的簡潔連結。說明是否已檢查 MP4 的實際時間與字幕變更。保持資格限定範圍狹窄：識別缺失的真實媒體或未測試的播放，但不要暗示佔位符證明了實況示範。
有關適合同事的英文說明，請使用工作流程逐步解說。