返回 Skills

Oil PPT 演示文稿

@pws/oil-ppt

—规则评分检测中

逐页创建、修改与检查 16:9 HTML 演示,支持离线放映和按需导出混合可编辑 PPTX。

设计PPT演示文稿HTML逐页编辑离线演示

中文概述 · 根据原始文档整理,完整规则与命令请查看「文件」中的 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。三分钟可启动工作流,不代表完成视觉确认或整套导出。

完整操作步骤

先读取 与 ,保留其中逐页创作、事实保真、正式预览确认及按需导出的约束。

  1. 新建项目或读取已有项目状态,按返回的 next 执行下一项;大纲只写每页做什么及主画面。
  2. 阅读 ,选择 starter,一次编辑一张 slides 页面;先画面、后文字。
  3. 按需阅读 、 或 ,确认素材来源与权利。
  4. 检查结构、资源路径、溢出、最低字号与真实浏览器表现;失败时查 。程序检查不等于内容和视觉验收。
  5. 展示整套真实预览,取得用户视觉确认后构建;只有用户需要 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 导出,不把结构检查当作功能实测。