前言¶
把长文、提纲或数据做成汇报 PPT，常见做法是手调母版、逐页粘贴，或让模型吐出不可编辑的截图式幻灯片。前者费时，后者难改、难导出。若你希望在 Agent 对话里用自然语言描述受众和页数，由助手在本地生成可编辑 HTML，并按需导出 PPTX 与 PDF，社区 Skill「PPT 智能生成器｜简诗 AI」走的是另一条路径：固定版本引擎、本地渲染、不依赖在线排版服务。
这是什么¶
「PPT 智能生成器｜简诗 AI」是 SkillHub 坐标 @user_fccf428b/ppt-engine-open 下的办公效率类 Skill（office-efficiency），当前版本 0.1.28，来源为社区（community），发布者为 user_fccf428b。标签标明 requires_api_key=false，安装后无需额外 API Key。
一句话定位：用固定版本的模板引擎，把文章、提纲、数据、图片或主题做成演示文稿；首次运行从 CNB 拉取经 SHA-256 校验的引擎包，之后生成与校验均在本地完成，输出可编辑 HTML，并可导出 PPTX、PDF。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_fccf428b/ppt-engine-open
- 资料地址：https://api.skillhub.cn/user_fccf428b/ppt-engine-open
（SkillHub 页面显示评分 100000、下载 1014 次；以平台当前展示为准。）
核心功能¶
以下能力均来自 Skill 包内 SKILL.md 与配套说明，未超出官方描述。
输入
- 自然语言需求、文章或提纲、结构化数据
- 本地图片或视频（PNG、JPG/JPEG、WebP、GIF、SVG、AVIF；视频 MP4、WebM、MOV、M4V；AVIF 会在本地转换）
输出
- 可离线打开、可在浏览器中继续编辑的 HTML
- 用户明确要求时：PDF，或可编辑 PPTX
版式与页数
- 从 12 套已验收主题中选页并填充内容，可替换布局暴露的图片/视频槽位
- 未指定页数时默认约 10 页且不少于 8 页；建议 8–20 页，更长文稿可分段生成
运行与安全
- 引擎版本、下载地址、字节数与 SHA-256 固定在
references/release.json，校验失败则停止，不跳过校验、不擅自换源 - 用户文档与素材不上传 CNB；CNB 仅提供引擎运行包
- 不自动升级到远端最新版；版本更新通过 SkillHub 上的新版本 Skill 发布
明确不覆盖的能力
- 导入并保真修改任意已有 PPTX
- 直接编辑 Keynote / Google Slides
- 无模板约束地设计全新母版，或将网页/PPT 当作视频剪辑项目
安装与启用¶
Skill 遵循通用 SKILL.md 格式。在 Cursor、Claude Code、Codex 等支持 Skills 的客户端中，需把技能装到该客户端识别的 skills 目录，否则 Agent 无法加载。
方式一：SkillHub CLI（推荐）¶
先确认本机已安装 skillhub：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档执行完整安装（示例来自 https://skillhub.cn/install/skillhub.md）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录。常见路径示例：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装命令（搜索结果显示的正式写法）：
skillhub install ppt-engine-open --namespace user_fccf428b --dir ~/.cursor/skills
将 ~/.cursor/skills 换成你实际使用的目录。安装完成后重启或刷新 Agent，使技能生效。
方式二：让 AI 按官方提示安装¶
SkillHub 页面提供的提示为：根据 https://skillhub.cn/install/skillhub.md 安装 @user_fccf428b/ppt-engine-open。适合已配置 SkillHub 工作流的对话式安装。
运行环境（由 Agent 执行，非终端用户必做项）¶
每次开始生成任务时，Skill 要求 Agent 先准备运行环境：
node <skill-root>/scripts/install-runtime.mjs
脚本最后一行输出引擎根目录绝对路径 <engine-root>。同版本已安装时会直接返回现有路径。完整生成、校验、预览与导出步骤见技能包内 references/engine-workflow.md。
环境要求：故障说明文档写明 Node.js 主版本需 20 及以上；首次安装会下载约 8.5 MB 固定引擎包并在本地安装锁定依赖，同版本只做一次。
典型用法¶
Skill 设计为用户只描述要讲什么，命令与导出由 Agent 完成。下列触发句来自官方 SKILL.md，可直接复现对话意图：
- 「把这篇文章做成 10 页知识讲解 PPT。」
- 「给管理层做一份季度经营汇报，导出可编辑 PPTX。」
- 「把这些调研数据整理成图表型演示文稿。」
- 「用我给的图片做一场产品发布会。」
- 「把这套 SOP 做成员工培训课件。」
默认交付路径（官方流程摘要）：
- 从用户材料提炼标题、受众、页数、重点、主题和输出格式。
- 在同一主题内选择不重复页面，将材料改写为适合演示的短文案。
- 本地生成并完成结构、文案、媒体路径与输出文件校验。
- 返回本机 HTTP 预览地址，或返回 PDF / PPTX 文件。
用户最少只需一句目标；Agent 仅在影响结果时补问受众、页数、格式（默认 HTML；要 PowerPoint 时导出 PPTX）或是否使用本地媒体。请求较模糊时，Agent 应阅读包内 references/scenario-recipes.md 补齐叙事结构。
预览与导出注意：双击 index.html 在 file:// 下可能无法使用导出按钮；应使用渲染脚本提供的 http://127.0.0.1:<port>/ 在浏览器中打开。导出失败时按 references/usage-and-troubleshooting.md 走 export:pptx / export:pdf 等直接导出路径。
任务结束前，Agent 可运行版本检查（可选，网络失败时保持静默）：
node <skill-root>/scripts/check-latest-version.mjs
适用场景与注意¶
适合
- 知识讲解、内部汇报、培训课件、产品发布、数据报告等从零生成的演示稿
- 需要可编辑 HTML 预览，或明确要 PDF / 可编辑 PPTX 的交付
- 希望引擎版本固定、本地处理内容、不配置 API Key 的团队或个人
限制与常见坑
- 不能当作「打开旧 PPTX 改几页」的工具链。
- 页数过多（超过 20 页）会走分段填充，生成与校对更慢。
- 首次运行需联网下载引擎；下载或 SHA-256 校验失败时不要换未知地址或关闭校验。
- 媒体路径应通过工作流暂存到本次演示目录，避免绝对路径或远程 URL 导致换机后失效。
结尾¶
「PPT 智能生成器｜简诗 AI」把演示稿生成收敛为：固定引擎、本地 HTML、可选 PPTX/PDF，由 Agent 按 Skill 文档执行安装与工作流。若要在 Cursor 等环境中启用，从 SkillHub 安装 @user_fccf428b/ppt-engine-open 并指向正确的 skills 目录即可。详情与更新以官方页面为准：https://www.skillhub.cn/skills/user_fccf428b/ppt-engine-open
