Communitygithub.com

SlidePatch

使用參考投影片或 PPTX 模板重新設計可編輯的 PowerPoint 內容,同時保留文字、數字、內嵌圖片及原生圖表資料。支援自動模板選取、版面配置、分頁以及圖表字型與色彩比對,包括封面、目錄與章節頁面。也支援將獨立的公式轉換為原生 PowerPoint 方程式,需使用審查後的計劃。包含環境檢查與原生編輯驗證。需要 Windows 與桌面版 Microsoft PowerPoint;圖表驗證另需 Excel。

SlidePatch 是什麼?

SlidePatch 是一個專為 AI 代理設計的專業技能,用於重新樣式化 PowerPoint 簡報,同時確保文字、數字、內嵌圖片和原生圖表的完整性。它支援三種主要操作模式:同一檔案模式(在相同簡報中於投影片間重新樣式化)、獨立模板模式(將投影片佈局比對至外部模板)以及全簡報遷移模式(使用模板重新佈局並分頁整個簡報)。該技能也會將獨立的 LaTeX、MathType 或圖片公式轉換為原生的 PowerPoint 方程式,保留投影片佈局且不影響未指定的物件。需在 Windows 上搭配桌面版 Microsoft PowerPoint 使用,圖表驗證另需 Excel。SlidePatch 包含強健的驗證流程:每個輸出的投影片都會在 PowerPoint 中重新開啟、渲染,並針對字型、背景和可編輯性進行檢查,確保產出的簡報可以立即編輯。它可與支援 Python 指令碼執行和圖片檢視功能的 AI 代理平台(如 Claude Code、Cursor Codex)無縫整合。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ChenYueqi2024/SlidePatch/tree/HEAD/skills/slidepatch

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

SlidePatch 是做什麼的?

使用此技能隨附的指令碼。無論主機代理的工作目錄為何,請相對於此檔案解析其路徑。主機需要具備本地命令執行與圖片檢視功能;此技能沒有 DSH 專屬的 API 或模型 API 金鑰。

對於全新安裝,請執行 python <skill>/scripts/slidepatch.py doctor(如需圖表遷移,請加上 --charts;如需方程式轉換,請加上 --equations)。此指令會檢查相依性與 Office 註冊,但不會開啟應用程式。準備就緒的結果不能取代原生的驗證。

原生方程式轉換

對於將獨立的公式文字、圖片或 MathType/OLE 方程式轉換為原生 PowerPoint 方程式的請求,請使用 inspect-equations 和 convert-equations。請閱讀 references/equations.md 以了解計劃、轉錄與驗證合約。此模式除了需要 Windows/PowerPoint 之外,還需要 Pandoc;其他模式則不需要 Pandoc。它會保留簡報的版面配置、頁數和未指定的物件,不使用任何範本,且不會重新轉換現有的原生方程式。明確的整體物件 LaTeX 會產生候選項目;代理會審查並轉錄圖片與快取的 OLE 預覽,但不會啟動 OLE 或解析 MathType 二進位檔。留下不明確的物件並回報它們。模板遷移目前會拒絕原生方程式,以防止遺失數學結構;請勿將轉換視為自動支援遷移所產生的方程式。

全簡報遷移與分頁

對於請求遷移整個簡報或允許分頁的情況,請優先使用 migrate。請閱讀 references/batch.md 以了解涵蓋範圍合約與證據格式。

python <skill>/scripts/slidepatch.py migrate <source.pptx> --template <template.pptx> --output <new-output.pptx> --evidence <fresh-evidence-directory>

引擎會依序走訪每張來源投影片。它會辨識封面、目錄、編號章節與一般內容頁面;優先使用相符的模板頁面類型;並重複使用原生模板的背景、圖形與版面配置。當沒有專用的目錄模板時,目錄頁面可以使用內容頁面樣式。請在 plan.json 中審查分類與備用方案;這是基於幾何/印刷樣式的推論,並非無限制的影像理解。

保留模板的字型系列、大小、粗細與顏色。原生的文字測量決定容量。在可能的情況下,將完整的群組保留在一起;在長度相等的完整群組頁面分割之間平衡文字量。如果單一群組過大,請在正文物件、段落或句子邊界處分割,並保留精確的字元切片。過大的群組接續頁面會將內容對齊頂端。標題、群組標題與頁尾會作為明確的上下文重複出現;正文切片必須依序且精確地重建來源一次。切勿改寫來源中的數字,或無聲地重新編排目錄。無法在不改變模板印刷樣式的情況下容納的句子,會導致整個操作失敗。

此模式支援一般的可編輯文字、支援的來源文字預留位置,以及結構清晰的內嵌圖片/原生圖表。來源預留位置的限制請參閱 references/plan.md。關於媒體頁面,請閱讀 references/media.md:圖片及其裁切保持原生狀態,圖表保留內嵌的工作簿,關聯的標題會在版面配置與分頁期間留在其資產旁。媒體頁面使用內容模板。非文字的裝飾、不支援的預留位置、群組、動畫、外部連結與模糊結構仍不受支援。任何頁面的失敗都會阻止整個輸出作品的發佈;切勿交付部分完成的簡報。每張產生的頁面都會被重新開啟、渲染,並根據其模板字型/背景進行檢查,並在單獨的校樣副本中實際編輯和儲存。在所有頁面、文字與媒體檢查通過後,才會發佈輸出。

審查每一張 after-N.png,尤其是封面/章節標題、目錄頁面備用方案與分頁邊界。在 report.json 中閱讀每頁檢查與可編輯性頁面列表。交付已驗證的 PPTX、預覽圖,以及一份簡短的原始到輸出頁面對應摘要。當頁面被分割時,請說明重複的上下文是刻意的。原始檔案保持不變。

同一檔案模式(計劃 v1)

  • 輸入是現有的 .pptx;來源與參考是該檔案中具有相同設計與版面配置且隱藏母片圖形的不同投影片。
  • 來源:一般的圖案、線條與水平文字方塊。參考:這些加上裝飾性圖片。在任一選取的投影片上,不得有群組、預留位置、圖表、SmartArt、動畫、轉場、超連結或旋轉物件。
  • 每個來源文字物件精確對應到一個參考文字物件,反之亦然。來源的非文字圖案必須被明確標示為要取代的裝飾。如果某個物件可能包含有意義的視覺證據,請停止以進行澄清。
  • 此操作會用參考物件原生的複本來取代來源投影片的本地物件,並以精確的來源字串填入它們。它會採用參考的印刷樣式,包括對強調的變更;它不保證保留來源的字元格式。
  • 不支援內容摘要、頁面分割、自動縮小字型或將圖片重建為可編輯內容。如果選取的投影片不符合這些限制,請解釋具體的限制,而不是透過不相關的工具重建簡報。

獨立模板模式(計劃 v2)

對於來源投影片與模板位於不同 PPTX 檔案中的情況,請使用 apply-template。此模式會產生一張新的投影片,尺寸與模板相同;它不會改寫來源簡報,也不會包含其他模板投影片。當使用者要求保留來源簡報的其他投影片時,請選擇 v1。

檢查兩個檔案,包括現在列在 inheritance 下的繼承版面配置/母片圖形。檢視實際的預覽圖,並選擇一個內容頁面,而不是假設投影片 2 是合適的模板。保留品牌與裝飾。明確將每個本地模板物件分類為保留的裝飾或移除的範例內容;請勿保留不相關的模板照片作為來源內容的證據。

為每個來源文字物件建立一個放置區。放置區會指定一個普通的文字承載模板形狀作為樣式捐贈者,並以點為單位給出邊界。同一個捐贈者可以服務多個放置區,因此來源與模板的文字數量可能不同。引擎會在模板內部複製原生物件,保留其版面配置/母片與佈景主題。文字直接來自來源;計劃中不包含替換字串。不支援字型縮小與內容改寫。

來自 v1 的來源限制同樣適用,但 v2 也接受 支援的來源文字預留位置。空的文字安全插槽會被明確記錄為已丟棄;啟用的繼承來源文字會導致拒絕,而不是被無聲地省略。樣式捐贈者必須是普通的未旋轉水平文字形狀,而不是預留位置/群組。模板版面配置/母片裝飾保持原生狀態,包括繼承的圖片與未使用的版面配置預留位置。保留的本地裝飾不得包含文字。計劃會記錄哪些物件被移除;自動規劃可以提出這些決策,而代理會審查其意義。

自動版面配置(偏好的獨立模板方式)

對於僅包含文字且具有清晰標題與正文(包括支援的來源文字預留位置)的來源,請先執行:

python <skill>/scripts/slidepatch.py plan-template <source.pptx> --template <template.pptx> --source-slide 1 --out <fresh-planning-directory>

這會產生一個標準的 v2 plan.json,無需手動提供目標頁面、形狀 ID 或座標。selection.json 記錄了推斷的來源角色、候選模板頁面、基於幾何的裝飾決策、候選版面配置、尺寸測量與拒絕原因。狀態 planned 表示存在一個計劃,並不表示 PPTX 已通過最終驗證。

規劃器使用字型層級與空間鄰近性來關聯標題與正文;它不使用形狀名稱或模板頁碼。它需要一個不同的頂層標題,能辨識短字型的底部頁尾,並支援分組的行/列或無標題的段落。它搜尋橫列、堆疊、兩欄與三欄版面配置,使用 PowerPoint 以原始模板字型大小計算的原生文字邊界。文字會自動換行;不進行字串改寫或字型縮小。候選方塊不得相互重疊或與保留的裝飾重疊。全頁背景與未使用的版面配置預留位置會被排除在障礙物檢查之外。

閱讀 selection.json,檢視 source.png 與所選的 template-N.png,並檢查角色關聯與範例圖片的移除是否合理。自動圖片分類使用幾何與附近的標題,而非影像理解。請勿聲稱具有通用的語義匹配能力。對於明確的結果,直接使用產生的計劃執行 apply-template,然後審查渲染後的輸出。使用者無需提供座標或批准其請求已涵蓋的常規選擇。

如果單頁規劃拒絕了模糊的角色、不確定的裝飾、不支援的物件或超載的內容,請閱讀記錄的原因。當授權分頁時,請使用 migrate。否則,在使用經過審查的明確 v2 計劃之前,請先檢查實際物件。切勿無聲地省略內容、縮小字型或更改授權的頁面範圍。包含圖片、非文字裝飾、混合/不明確的層級結構、圖表或群組的來源,仍然需要明確或不受支援的工作流程。

執行

將 requirements.txt 安裝到 Python 3.10+ 的虛擬環境中。所有指令都使用該直譯器。桌面版 PowerPoint 必須可在登入的 Windows 工作階段中使用。首先進行檢查:

python <skill>/scripts/slidepatch.py inspect <source.pptx> --out <fresh-inspection-directory>

閱讀 inventory.json,並檢視相關的 slide-N.png 預覽圖。使用實際的物件與外觀來匹配內容角色。切勿從其順序推斷形狀 ID,或從記憶中重建受保護的文字。

對於同一檔案模式,請使用 references/plan.md 中的 schema 建立一個 JSON 計劃。對於獨立模板,請優先使用 plan-template;當自動推論不適用時,再使用手動審查的 v2 計劃。從目前的庫存中複製雜湊值與 ID。保留使用者預期的範圍。一個清晰授權、且映射明確的請求可以直接執行;僅當從檔案中無法解決實質的內容歧義時才提出詢問。

python <skill>/scripts/slidepatch.py apply <source.pptx> --plan <plan.json> --output <new-output.pptx> --evidence <fresh-evidence-directory>

對於獨立模板,也請檢查它,然後使用 v2 計劃:

python <skill>/scripts/slidepatch.py inspect <template.pptx> --out <fresh-template-inspection>
python <skill>/scripts/slidepatch.py apply-template <source.pptx> --template <template.pptx> --plan <v2-plan.json> --output <new-output.pptx> --evidence <fresh-evidence-directory>

引擎會暫存已編輯的簡報,在 PowerPoint 中重新開啟並渲染它,比較精確的文字物件與數字,檢查非目標投影片,並在單獨的校樣副本上測試真實的文字編輯與形狀移動。只有在這些檢查通過後,才會發佈輸出。它絕不會呼叫 PowerPoint 的 Quit 或關閉不相關的簡報。原生複製/貼上使用系統剪貼簿。

模板模式則會檢查單一投影片的結果、兩個原始檔案的雜湊值、所有本地來源字串、已儲存的原生物件,以及前/後相同的渲染裝飾圖層。允許現有的裝飾溢色;新內容必須符合邊界。它使用原生的 Duplicate 而不使用剪貼簿。PPTX 仍可能包含未使用的模板版面配置、母片或媒體;此原型不會清理隱藏的套件資產。

審查與交付

閱讀 report.json;退出狀態與報告都必須指示成功。檢視 before-<source>.png、before-<reference>.png 與 after-<source>.png。檢查樣式是否匹配,以及是否有裁切、非預期的重疊或不正確的閱讀順序。幾何檢查不能取代視覺審查。

對於模板模式,檢視 source-before.png、template-before.png、after-1.png,以及 template-shell.png 與 output-shell.png。根據模板的視覺語言檢查新的組合;僅匹配文字字串是不夠的。

交付新的 PPTX 以及預覽圖,並提供一份關於檢查與範圍的簡潔摘要。editability-proof.pptx 故意包含一個編輯標記,作為證據,而非最終交付物。如果任何檢查失敗,請回報問題;切勿將暫存或校樣檔案作為最終簡報交付。在重試時選擇新的路徑,並保留失敗的證據。

相關技能