中文概述 · 根据原始文档整理,完整规则与命令请查看「文件」中的 SKILL.md。
Oil PPT 演示文稿
解决什么问题
把材料转成可逐页编辑的 16:9 HTML 演示文稿,用成熟组件、设计 token 和浏览器检查协助制作,最终构建可离线放映的单文件 HTML。完整原工作流见 ,使用时读取并遵循该文档。
适用与不适用场景
适合产品介绍、设计方案、项目汇报、教程与研究结论。不用于滚动网页、普通文章或单张海报,不承诺将任意已有 PPTX 无损导入或把所有页面无损转换为可编辑 PowerPoint。
需要准备什么输入
准备主题或材料、目标受众、页数偏好与已有图片。环境需要 Python、Node.js、项目声明的构建依赖及本地浏览器能力;无额外 API Key 的要求指本工具本身。原工作流默认搭配外部 oil-tone 改写观众文案,需要概念配图时使用外部 oil-visual:这两个 Skill 未包含在本 ZIP 中,须另行获取;缺少时说明能力缺口,不声称已运行它们。素材、字体和生成工具的许可与配置需单独确认。
三分钟快速开始
将本包解压到 Agent 的 Skill 目录,然后提出:“使用 $oil-ppt,根据这份材料制作一套 16:9 HTML 演示文稿。”从 Skill 根目录运行 scripts/oil-ppt init <项目> 并用 scripts/oil-ppt status <项目> --json 读取下一步;Windows 使用 scripts/oil-ppt.cmd。三分钟可启动工作流,不代表完成视觉确认或整套导出。
完整操作步骤
先读取 与 ,保留其中逐页创作、事实保真、正式预览确认及按需导出的约束。
- 新建项目或读取已有项目状态,按返回的 next 执行下一项;大纲只写每页做什么及主画面。
- 阅读 ,选择 starter,一次编辑一张 slides 页面;先画面、后文字。
- 按需阅读 、 或 ,确认素材来源与权利。
- 检查结构、资源路径、溢出、最低字号与真实浏览器表现;失败时查 。程序检查不等于内容和视觉验收。
- 展示整套真实预览,取得用户视觉确认后构建;只有用户需要 PowerPoint 时导出 PPTX。不修改生成的预览或最终 HTML 来代替源页面修改。
输出示例和可下载文件
典型交付是项目根目录的演示文稿.html;用户需要时附混合可编辑 PPTX。包内保留原始脚本、runtime、starter、参考文档和许可,并附上游演示截图。截图来自上游 README,展示作者的四套演示、十五页页面,不是本次新生成或运行验证的成果。
常见失败及处理方式
缺 Python、Node.js、浏览器或构建依赖时先补环境;缺油式文案或插画配套 Skill 时说明缺口。媒体路径、字号、溢出与导出错误按状态和排错文档修复,只复验改动页。PPTX 是混合可编辑导出,不承诺任意素材和构图完全可编辑;未经正式预览确认不宣称最终视觉交付。
作者、协作者和维护人
原作者:oil-oil(Oil/欧呦)。上游:https://github.com/oil-oil/oil-ppt 。原作按 MIT 许可分发,保留根目录 LICENSE 及图标素材自带许可。本次 FunSkill 适配只增加平台说明、元数据、图标和上游案例截图,不转移原作者署名;适配维护人未指定。
版本、更新时间、最后验证时间
FunSkill 首次适配版本:1.0.0。上游包版本:1.0.0。更新时间及最后结构验证日期:2026-10-06。已核对文件引用、依赖说明、许可与包结构;未执行演示生成、浏览器验收或 PPTX 导出,不把结构检查当作功能实测。
