前言¶
要把一份 .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
