25 lines
2.1 KiB
Markdown
25 lines
2.1 KiB
Markdown
# 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写入，并检验下载接口。消耗一次模型调用，不读取客户数据。
|