用途:pptx-profile 是 PPTX-from-layouts 流水线的第 1 步(Profile)。它把任意 .pptx 模板解析成真实版式的地图,回答“我的模板实际有哪些版式、每个版式适合做什么”。其输出供第 2 步 pptx-author 编写 slides.md、第 3 步 pptx-from-layouts 渲染使用。
主要能力:运行后生成两个文件——your-template-layout-catalog.md(面向作者的人类可读版式菜单,列出每个可提示版式的 [HINT:] 名称、占位符及使用场景)和 your-template-config.json(面向渲染引擎的机器映射,把能力映射到真实版式索引/名称,供 generate.py --config 使用)。目录中的 Hintable layouts 表只列出引擎能填充的版式,其中的名称都是安全的 [HINT:] 值;折叠区列出文件中的全部原始版式供参考。
使用方式:需 Python 3.10+ 与 python-pptx(pip install python-pptx)。命令:python scripts/catalog.py /path/to/your-template.pptx --name your-template --output-dir ./build。选项:--catalog-only 跳过配置只生成目录;--name 设置输出基名(默认取文件名)。后续第 2 步用 [HINT: layout_name] 编写 slides.md,并以 pptx-author/scripts/lint_hints.py slides.md --config your-template-config.json 校验;第 3 步用 pptx-from-layouts/scripts/generate.py slides.md -o deck.pptx --template your-template.pptx --config your-template-config.json --validate 渲染。
适用场景与限制:模板只需分析一次,目录与配置可在该模板的所有后续演示中复用。仓库内置的 Inner Chapter 模板已预先分析(templates/inner-chapter-config.json),跳过第 1 步时作为默认。配置步骤会调用同仓库的 pptx-from-layouts 技能。若需全自动的品牌化引导(品牌色、字体、冒烟测试),可用 pptx-template-onboarder 子代理封装本步骤。资料未提供收费、价格或平台信息。