用途:作为创建或编辑演示幻灯片的参考材料,帮助按模板风格生成完整 deck。
主要能力:技能目录包含 container_tools(独立 Python 脚本)、artifact_tool(API 文档与示例)、pptxgenjs_helpers(PptxGenJS 的 JavaScript 辅助函数)、slide_templates(可选模板,从 Overview.png 开始)。辅助 API 版本 1.2.0,提供 autoFontSize、calcTextBox、calcTextBoxHeightSimple、imageSizingCrop、imageSizingContain、svgToDataUri、latexToSvgDataUri、getImageDimensions、safeOuterShadow、codeToRuns,以及布局诊断的 warnIfSlideHasOverlaps、warnIfSlideElementsOutOfBounds、alignSlideElements、distributeSlideElements。
使用方式:必须用 PptxGenJS 实现幻灯片,即使使用模板也要遵循模板的视觉风格、排版、间距、配色与布局约定;简单快速编辑可使用 python-pptx 或 artifact_tool。使用 pptxgenjs_helpers 时直接导入调用,不要复制其代码到交付源文件。在自己工作目录中编码,完成并验证后再复制到目标位置。容器脚本通过 -h 查看用法,例如 render_slides.py <input.pptx>、slides_test.py <input.pptx>、create_montage.py --input_dir <imgs_dir> --output_file <montage.png>、ensure_raster_image.py --input_files <img_path1> ...。默认页面 16:9(PptxGenJS LAYOUT_WIDE),如用户上传 4:3 图片要求重做则设为 4:3;未定义时用 getSlideDimensions 推导,精确计算优先 (7.5 / 9) * 16。图片避免使用内置 sizing 参数,改用 imageSizingCrop(默认,居中裁剪)、imageSizingContain(完整可见)或直接 addImage(纹理背景)。远程图片先下载或转为 data URI,左右翻转用 flipH: true。交付前必须修复所有严重文字重叠、非预期重叠与非预期越界警告。每个外部素材和非平凡外部断言需在演讲者备注中加入 [Sources] 块。
适用场景:制作或编辑演示文稿、依据模板重建幻灯片、批量渲染与检查布局。
限制:资料未提供具体收费、价格、平台兼容性与效果保证;部分脚本与 API 的具体参数细节需运行 -h 或查阅对应文档。