# PPT 生成与交付

工具：inspect_ppt_template（读取原模板文本锚点）、generate_pptx（生成文件，需要审批）。

- plain：传入 title、template=plain、slides，每页 title/body/sources。适合简洁的可编辑文字页，最多20页。尚不提供自动图表、配图或复杂排版。
- swads：先检查模板，传入 template=swads、replacements（id/oldText/newText），原生表格使用 tableCells（id/row/column/text，行列从0开始）。保留原模板的全部页面和对象，原位替换文字和表格单元格。不能假装无关旧内容已经删除，不能承诺图片和图表自动重做。
- 模板缺失、锚点不匹配、导入/校验/渲染失败均报错，不降级为文字大纲。
- 文件使用独立 UUID 路径，不覆盖源模板或旧交付。结构校验、重新导入和逐页渲染通过后记录 SHA-256。
- UI 提供下载链接，下载时核对哈希。PPT请求须有本次运行成功产物才能完成，最多补试2次，取消/拒批后停止。
- 自动检查不保证业务事实正确或每页视觉效果完美，重要交付仍应查看渲染图。

## 运行依赖

当前复用本机 Codex 随附的 Artifact Tool 和校验脚本，不需要在 Beryl 里调用 Codex 插件。它不是独立打包的公共 npm 依赖，迁移机器必须单独配置可用运行时。

可通过 PPT_RUNTIME_ROOT 指定包含 node/、python/ 的运行时目录，通过 PPT_SKILL_DIR 指定 presentations 技能目录。默认指向当前主目录下的 Codex 26.905.11957 路径。模板文件为 .agents/skills/artifact-template-sw-ads-tiktok/assets/reference.pptx；Git网页此前未上传的大模板需要另行部署。

## 验证

在 apps/server 执行：

- `pnpm exec tsx ../../scripts/verify-ppt.mts`：生成及校验2页测试文件。
- `pnpm exec tsx ../../scripts/verify-ppt.mts --template`：导入模板、替换文字并逐页渲染副本。
- `pnpm exec tsx ../../scripts/verify-ppt-agent.mts`：真实模型生成、自动批准自己测试会话的PPT写入，并检验下载接口。消耗一次模型调用，不读取客户数据。