# keynote-pptx-doctor：修復 Keynote 打不開的 pptx：技能書與協作來源 PowerPoint 能開、Keynote 卻打不開？先檢查 pptx 結構，再另存修復副本。 ## 工坊收錄說明 內容與行銷 要把簡報交給 Keynote 使用者的人、用程式產生 pptx、需要查封裝問題的開發者。 一份自製 pptx 的封裝診斷紀錄、另存副本，以及 Keynote 逐頁比較結果或尚未驗證的清單。 把能重現問題的自製簡報交給不同系統的夥伴比對，區分封裝修復與版面驗收，再回原作補案例。 先用自製 pptx 留一份原檔，在瀏覽器入口診斷，或執行 python3 scripts/diagnose.py suspect.pptx。 ## 封面與來源署名 作者：ken-kk 封面插畫：/art/skills/keynote-pptx-doctor.webp 原作者 GitHub：https://github.com/kieiken/keynote-pptx-doctor 登入自由工坊並連結自己的 GitHub，即可在技能書加星或取消星星。 原作數據：/api/v1/github/books/keynote-pptx-doctor/metrics Stars、Forks、追蹤數、未結 Issues 與 PR 合計、最近程式更新時間以 GitHub 回覆為準；數據附核對時間，讀取失敗不冒充零。 ## 讀者與格式 簡報封裝診斷與修復 Skill - 要把簡報交給 Keynote 使用者的人 - 用程式產生 pptx、需要查封裝問題的開發者 ## 功能與使用範圍 MIT。可在瀏覽器本機診斷／修復，或用 Python 3 標準庫腳本；也能作為 Claude Code Skill。README 說明不改投影片內容、瀏覽器不傳檔，工坊未驗證傳輸與修復結果。封裝修好不等於版面完整，仍要在目標 Keynote 比對圖片、文字與備註；Quick Look 驗證需 macOS。不是所有損壞都可修復，務必保留原檔。 - 檢查有備註卻未註冊 notes master、遺失關聯與 [Content_Types].xml 缺項。 - 找出媒體位元與副檔名不符、presentation 元素順序錯誤與不合法 XML。 - 瀏覽器可拖入多檔並下載副本／ZIP；scripts/diagnose.py 可診斷單檔、資料夾或遞迴批次另存。 ## 開始前準備 - 一份不含機密的自製測試 pptx，以及完整原始備份。 - 瀏覽器或 Python 3（只用標準庫）；先讀 README「What it checks」。 - 要驗證能否實際開啟，需目標版本的 Keynote；qlmanage 的 Quick Look 檢查需 Mac。 ## 第一個練習 1. 先用自製 pptx 留一份原檔，在瀏覽器入口診斷，或執行 python3 scripts/diagnose.py suspect.pptx。 2. 依診斷結果用 python3 scripts/diagnose.py suspect.pptx --fix out.pptx 另存，不覆蓋原檔；仍有問題的檔案另列。 3. 在目標 Keynote 開 out.pptx，逐頁比對版面、媒體與備註；批次處理也要保留每檔狀態與未修復項目。 ## 練習成果 一份自製 pptx 的封裝診斷紀錄、另存副本，以及 Keynote 逐頁比較結果或尚未驗證的清單。 ## 專案與授權 原作 Repo：https://github.com/kieiken/keynote-pptx-doctor 從原作建立自己的版本：https://github.com/kieiken/keynote-pptx-doctor/fork 工坊整合參考：https://github.com/kieiken/keynote-pptx-doctor 記錄的授權：MIT ## 一起改這本技能書 在原作 Issues 提供最小自製 pptx、diagnose.py 結果與 Keynote 版本，說明預期與實際差異；保留 ken-kk 與 MIT 來源，不附公司簡報或未授權媒體。 原作 Repo：https://github.com/kieiken/keynote-pptx-doctor 預設 PR 目標：kieiken/keynote-pptx-doctor:main 從原作建立自己的版本：https://github.com/kieiken/keynote-pptx-doctor/fork 原作 PR：https://github.com/kieiken/keynote-pptx-doctor/pulls 工坊整合參考：https://github.com/kieiken/keynote-pptx-doctor 工坊整合任務專用 Fork：https://github.com/kieiken/keynote-pptx-doctor/fork 工坊任務：https://github.com/kieiken/keynote-pptx-doctor/issues 工坊 PR：https://github.com/kieiken/keynote-pptx-doctor/pulls GitHub Milestones：https://github.com/kieiken/keynote-pptx-doctor/milestones 先閱讀原作現行的貢獻規則。Fork 不會自動回饋原作；修改要以 PR 提交，由原作維護者決定是否合併。工坊整合任務可在工坊審查，另外記錄回饋原作的 PR 或未回送原因。 以下是入口與建議，不代表已認領或已完成。以 GitHub 最新 Issue、PR 與維護者確認為準。 - 第一份可重用的共同成果（建議里程碑）：提交可重現案例、來源與驗證結果，由維護者審查；這是建議里程碑，尚未建立為 GitHub milestone。 ### 改善簡報封裝診斷與修復 Skill的第一個案例 · 建議任務 在原作 Issues 提供最小自製 pptx、diagnose.py 結果與 Keynote 版本，說明預期與實際差異；保留 ken-kk 與 MIT 來源，不附公司簡報或未授權媒體。 - 驗收：一份自製 pptx 的封裝診斷紀錄、另存副本，以及 Keynote 逐頁比較結果或尚未驗證的清單。 記錄實際驗證與未執行項目；以原作 Issue／PR 協調。 Agent Skill：/development/skills/keynote-pptx-doctor/SKILL.md 協作 JSON：/api/v1/skills/keynote-pptx-doctor/collaboration ## 參與開發 在原作 Issues 提供最小自製 pptx、diagnose.py 結果與 Keynote 版本，說明預期與實際差異；保留 ken-kk 與 MIT 來源，不附公司簡報或未授權媒體。 工坊 Issue／PR 協調入口：https://github.com/kieiken/keynote-pptx-doctor/issues 先讀該 Repo 根目錄 README.md、AGENTS.md、CONTRIBUTING.md；原始程式、測試及來源授權留在該專案。平台介紹與公會收錄則在 freedom-platform 的 modules/community 維護。 要改善平台介紹：https://github.com/FreeTWAI/freedom-platform/issues ## 閱讀與來源 閱讀原始專案：https://github.com/kieiken/keynote-pptx-doctor/blob/b7d2a1299f2776e481681d8fa326095cae5053f6/README.md 核對日期：2026-10-20 核對版本：b7d2a1299f2776e481681d8fa326095cae5053f6 - README.md：https://github.com/kieiken/keynote-pptx-doctor/blob/b7d2a1299f2776e481681d8fa326095cae5053f6/README.md - LICENSE：https://github.com/kieiken/keynote-pptx-doctor/blob/b7d2a1299f2776e481681d8fa326095cae5053f6/LICENSE 專案網站：https://kieiken.github.io/keynote-pptx-doctor/ ## 共創原則 GitHub Issue 是待辦與協調來源，PR 是審查與合併紀錄。先確認任務範圍，再用自己的分支完成相關驗證；保留上游與實際貢獻者。Fork 不等於平台認證、已測試運行或新授權。 完整結構化目錄：/api/v1/development-map