用途:面向 SahayakAI 教育流程,创建、编辑和分析 .pptx 演示文稿,例如把教案生成为幻灯片、制作教师用视觉材料。.pptx 本质是包含 XML 与资源的 ZIP 包,可按任务选择不同工具与流程。
主要能力:读取与分析内容时,可用 python -m markitdown path-to-file.pptx 将文档转为 Markdown 提取文本;需要批注、演讲者备注、版式、动画、设计元素或复杂格式时,需解包读取原始 XML。关键结构包括 ppt/presentation.xml、ppt/slides/slide{N}.xml、ppt/notesSlides/notesSlide{N}.xml、ppt/comments/modernComment_*.xml、ppt/slideLayouts/、ppt/slideMasters/、ppt/theme/、ppt/media/。可从 ppt/theme/theme1.xml 读取配色与字体,从 slide1.xml 采样实际字体与颜色。
使用方式:无模板创建教育演示时走 html2pptx 工作流,先完整阅读 html2pptx.md,为每页创建 HTML(如 16:9 用 720pt × 405pt),用 p、h1-h6、ul、ol 承载文本,图表/表格区域用 class="placeholder",渐变与图标先用 Sharp 栅格化为 PNG;再用 html2pptx.js 转换,用 PptxGenJS 添加图表表格,pptx.writeFile() 保存,并用 thumbnail.py 生成缩略图检查文字截断、重叠、位置与对比度。编辑现有演示需解包、改 XML、校验、打包,命令为 unpack.py、validate.py、pack.py。使用模板时先提取文本与缩略图,建立 template-inventory.md,再用 rearrange.py 复制重排幻灯片,用 inventory.py 提取文本清单。
适用场景:教案幻灯片、教师视觉材料、基于模板的演示生成与既有 PPTX 编辑。
限制:资料未提供收费、价格、平台支持范围与效果保证;部分脚本路径为项目内绝对路径,若不存在需用 find . -name "unpack.py" 定位。创建前须先说明设计思路,仅用 Web 安全字体,并遵守布局与校验要求。