slides 是一个幻灯片全流程创作工具,覆盖从主题研究、风格选择、AI 生成 HTML 到转换可编辑 PPTX / PDF 的流程,并支持从现有幻灯片中提取可复用设计风格、构建个人风格库。
用途:需要从文稿或主题生成精美幻灯片、将 HTML 转换为可编辑 PPTX/PDF、从现有课件提取风格,或围绕主题做结构化研究时使用。纯文档排版(md2word)与图片处理(imagemagick)不属于本技能范围。
主要能力:主题研究可依据主题和受众产出结构化研究报告(research.md)与分页大纲(slides_outline.json);PPTX 转换保留文字为可编辑文本框,位置、字号、颜色精确还原;混合式动态背景在 HTML 中保留 WebGL / ASCII / canvas 动效,导出 PPTX 时只冻结背景层,前景文字、卡片、线条与图片继续逐项重建为原生对象;PDF 基于 Chromium 渲染,交付前逐页核对;支持从现有 HTML 幻灯片提取配色、字体、布局等风格参数并保存为可复用 JSON;内置 38 个预设风格与 12 个完整 HTML 模板文件、共享 _base.css 设计系统;转换前用 Playwright 检查 slide 容器、尺寸、溢出、渐变/inset 阴影、裸 div 文本、远程/base64 图片、文字背景/边框等风险;兼容视口相对单位、flexbox、grid 布局;支持入场动画与页面转场策略,PPTX 导出时自动降级;自动识别 .slide / section 容器进行多页检测与转换;不内置个人信息,讲者身份、联系方式、头像与二维码来自本地配置,未配置时按匿名默认生成;转换引擎不需要云端 API,但 HTML 中的远程字体、图片或脚本仍可能联网。
使用方式:首次安装依赖需在 scripts 目录执行 npm install 与 npx playwright install chromium。文件转换示例:node convert.js slides.html -o output.pptx --background-mode auto;指定 PDF:node convert.js slides.html -o output.pdf --format pdf;同时生成:node convert.js slides.html -o output --format both;目录批量转换:node convert.js ./slides-dir/ -o presentation.pptx;4:3 布局:node convert.js slides.html -o output.pptx --layout 4:3。风格提取:node convert.js slides.html --extract-style -o style.json;提取并保存到风格库:node convert.js slides.html --extract-style --save 商务法律风;列出风格:node convert.js --list-styles。转换前预检:cd scripts && npm run validate -- ../example.html --strict。本地配置可通过 node scripts/init-profile.js 引导或非交互写入,并使用 node scripts/check-profile.js 校验;生成 HTML 时可用 node scripts/load-profile.js --json / --footer / --assets 读取同一份配置。输出支持 PPTX、PDF 或 both,格式参数优先于文件后缀,无可识别后缀时默认 PPTX;多文件/目录输入目前仅支持合并为 PPTX,PDF 或双格式需先组织为一个多页 HTML。
标准流程:需求澄清 → 研究/大纲 → 风格与版式选择 → 生成 HTML → 预检验证 → 转换输出 → 最终 QA(浏览器预览、PPTX 打开、PDF 打开三处复核页面尺寸、文字裁切、图片缺失、PDF 文字可选性、PPTX 前景可编辑性、动态背景静态保留与讲者备注写入)。
适用场景:法律/政务、商务/金融、科技/创意、编辑/网格、教育/学术及行业场景等各类讲座、报告、培训、路演与分享课件;也可从现有课件提取风格并复用。
限制:PPTX 模式下 CSS 渐变需预先光栅化为 PNG;文字元素不能带背景/边框;div 中的裸文本需用 p 等标签包裹;内联元素 margin 不受支持;inset 阴影会损坏 PPTX;远程/base64 图片不稳定需改本地图片;页面溢出在 PPTX 中会被裁切;动态背景不会变成 PowerPoint 动画,auto / freeze 模式只冻结背景帧;PDF 模式对 CSS 更宽容但不要求文字可选,若需文字可选中、可搜索仍应避免正文区域叠加渐变、滤镜或大面积半透明层。