用途:把 PowerPoint 演示文稿构建过程拆成模板绑定、内容映射、图表生成与校验四步,用 pptx(生成幻灯片)与 excal(画图并导出 PNG)两个 CLI 完成,强调把模板当作约束而非自由排版。
主要能力:一次性从模板初始化 manifest(pptx init)并做兼容性检查(pptx doctor);列出布局与占位符,读取 logical_name、placeholder_type、supported_content_types、required、estimated_text_capacity、EMU 几何信息;查看主题色与素材;用 YAML deck spec 映射标题、正文、备注、表格、图表、图片;支持 markdown-text、@文件引用、幻灯片级 notes;构建后可严格校验(--strict)并输出 JSON 结果;excal 可校验并渲染 .excalidraw 为 PNG(--scale 4、--no-background);支持 manifest diff 做模板版本对比。
使用方式:初始化后用 pptx layouts list、pptx placeholders list 查布局,再写 deck.yaml,执行 pptx deck build 与 pptx validate;配图按占位符宽高比设计,用 excal render 导出,图片可用 image_fit: fit/cover 控制填充方式。若用户提供含内容的 YAML 文件,应逐字段忠实转换,保留 notes、table、chart、image 与来源信息。
适用场景:企业/咨询风格演示、需要专业图表与统一视觉识别的报告;排版原则包括行动式标题、一页一信息、遵循占位符容量、提供数据来源。
限制:需要用户提供真实 .pptx 模板路径;文本渲染不追求完整版面保真度;图片默认 fit,cover 需显式设置;输出文件被占用时需换名;错误码含义与更多参数细节资料未完整说明。