前言¶
要把一份 .pptx 交給大模型做改寫、審計或二次生成，常見做法是整包上傳或逐頁截圖。前者往往丟層級和版面語義，後者難維護、也難和後續流水線對齊。若你希望輸出一份可被程序消費、又儘量保留「這一頁在講什麼、文字怎麼分層」的結構化結果，就需要專門的頁面識別流程。
下面介紹 SkillHub 社區技能 PPT Page Recognition 一鍵將你的PPT所有內容轉爲json文件（座標 @user_65333ed1/ppt-page-recognition，當前版本 1.0.10）。它面向本地 PowerPoint 文件，把頁面內容與結構語義整理成 JSON，並預留視覺補全步驟，方便在 Agent 裏串成完整任務。
這是什麼¶
PPT Page Recognition 由社區發佈者 user_65333ed1（SkillHub 頁面標註作者爲阿東）維護，分類爲 office-efficiency，來源爲 community。官方說明其用途是：識別本地 PPT 的頁面內容與結構語義，儘可能完整保留可見文本、層級關係和版面意圖，並輸出適合 AI 後續生成與審計的結構化 JSON。
在 SkillHub 上，該技能標籤爲 requires_api_key=false（無需單獨配置 API Key）。截至頁面展示數據：評分 100000，下載 7843 次，安裝 256 次。
核心功能¶
結合官方簡介與 SkillHub 頁面說明，可覈實的能力包括：
- 本地 PPT 識別：讀取
.pptx，恢復頁面層面的結構與語義，輸出標準 JSON，而不是僅做純文本抽取。 - 結構化保留：強調可見文本、層級關係與版面意圖，使結果便於後續生成或合規審計類任務複用。
- 視覺補全鏈路：識別流程中若產生 vision_tasks，需要繼續調用當前 Agent 的視覺能力補全，並將結果合併進最終 JSON；推薦提示語也明確要求走完視覺補充。
- 文件配合建議：官方文件提示爲「請儘量同時上傳 PPT 和 PDF 文件」，以便在需要時提高版式與視覺信息的覆蓋度。
安裝與啓用¶
SkillHub 提供統一安裝指引。在已安裝 skillhub CLI 的前提下，將技能安裝到當前 Agent 實際使用的 skills 目錄（安裝到錯誤目錄會導致 Agent 無法加載，需按環境自行確認路徑）。
檢查 CLI：
command -v skillhub && skillhub --version
若未安裝，可按 SkillHub 安裝文檔執行完整安裝或僅 CLI 安裝（見 SkillHub 安裝與優先源配置）。
安裝本技能：
官方頁面給出的安裝提示爲：根據上述安裝文檔，安裝座標 @user_65333ed1/ppt-page-recognition。對應 CLI 形式示例：
skillhub install user_65333ed1/ppt-page-recognition --dir <你的 Agent skills 目錄>
常見客戶端 skills 目錄（摘自 SkillHub 安裝文檔，以你本機爲準）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝後按你所用 IDE 或 Agent 的慣例刷新或重啓，使新技能可被加載。
典型用法¶
官方推薦的可復現對話方式如下。
- 在對話中啓用該 Skill，並儘量同時提供 PPT 與 PDF（若僅有 PPT，仍可按技能流程識別，但視覺相關信息可能不完整，需結合後續 vision_tasks 處理）。
- 發送推薦提示語，讓 Agent 跑完整流程：
請使用這個 Skill 完整識別目標 PPT，如果出現 vision_tasks，請繼續完成視覺補充並輸出最終結果。
- 先執行識別流程，得到結構化 JSON；若輸出中出現 vision_tasks，不要在此停步——繼續用當前環境支持的視覺能力補全，再合併爲最終結果。
技能基於通用 SKILL.md 格式；具體子命令或腳本以安裝包內文檔爲準，本文不展開未在官方頁面列出的配置項。
適用場景與注意¶
適合誰
- 需要把演示稿轉成機器可讀 JSON，再交給大模型做提綱重寫、要點核對或模板化生成的辦公與內容團隊。
- 在 Agent 工作流裏做「上傳 PPT → 結構化 → 下游生成」的中間環節，且能接受按頁補全視覺信息的步驟。
使用注意
- 視覺能力：流程依賴 Agent 在出現 vision_tasks 時繼續調用視覺補全；若當前模型不支持視覺，應先切換到支持視覺的模型，否則無法按官方說明完成合並。
- PPT 與 PDF：官方建議雙文件一併提供；僅 PPT 時識別仍可進行，但版式與圖像類信息的覆蓋可能不足。
- 安裝路徑：
skillhub install必須使用--dir指向當前 Agent 的 skills 目錄，避免裝到默認./skills/而未被加載。 - 數據與版本：功能描述以 SkillHub 頁面與 v1.0.10 爲準；社區技能更新後請以頁面版本號與 SKILL 包內容覈對。
結尾¶
PPT Page Recognition 把「本地 .pptx → 結構化 JSON → 可選視覺補全」串成一條可在 Agent 裏複用的識別鏈路，適合需要保留層級與版面語義、又要對接後續 AI 生成或審計的場景。
官方 Skill 地址：https://api.skillhub.cn/user_65333ed1/ppt-page-recognition
SkillHub 展示頁：https://www.skillhub.cn/skills/user_65333ed1/ppt-page-recognition
