PPT 与 Presentation
创建 HTML Deck 主预览，并导出可编辑演示文稿交付物。
Raydo 里的 PPT 能力不是“直接吐一个 .pptx 文件”这么简单。标准路径会先生成可预览的 HTML Deck，再派生出 PPTX 或 PDF。
功能状态：预览
演示文稿工作流已经可用，但不同模板、原生导出、PDF/PPTX 派生状态和质量校验仍在持续验证。对外正式汇报前请人工过一遍。
入口
在对话中使用 /deck，也可以基于已有研究结果、项目资料或文档继续生成。
Raydo 的 PPT 边界
- 主预览是 HTML Deck；
PPTX / PDF是派生导出，而不是唯一真相；- 复杂汇报默认走结构化 Presentation Workflow；
- 只有明确说“快速生成 pptx / 只要文件 / 不用排版 / 简单草稿”时，才更接近快速文件导出思路。
适合的任务
- 融资路演、客户汇报、项目复盘、研究简报；
- 有资料、有结论，需要整理成结构化演示稿；
- 研究结果要转成可讲述的 claim spine 和页面结构。
基本流程
输入
/deck，写清楚主题、页数、受众、语言和语气。补充项目、研究结果、文档、现有稿件或必须引用的资料。
等待 Raydo 经过来源梳理、观点主线、视觉规则、页面结构和质量检查。
先看 HTML Deck 主预览，再决定是否需要 PPTX/PDF 派生文件。
最终检查页数、逻辑、信息密度和来源标注，再交付。
写任务时要说明
- 这份 PPT 给谁看；
- 总页数或最大页数；
- 是否允许引用项目内现有研究；
- 更偏“讲故事”“销售汇报”还是“研究简报”；
- 是否需要可编辑的 PPTX。
成功标志
- 主预览逻辑完整，不只是零散页面；
- 页面结构、标题和主张可以直接讲述；
- 项目中有对应交付物，且派生文件状态明确。
更好的使用方法
- 先定义听众和场景，例如“给投资人看的 10 页融资路演”或“给客户看的季度复盘”；
- 先给材料，再要排版。没有资料时，系统只能帮你搭结构，不能替你凭空补证据；
- 一次只要求一种主目标，不要同时要求“研究很深、故事很强、页数很少、信息非常全”；
- 对外汇报优先先看 HTML Deck 主预览，确认逻辑后再拿 PPTX / PDF；
- 如果已经有研究结果，明确写“基于现有研究整理成 deck”，比重新从零开始更稳。
常见报错会出现在哪
| 位置 | 你会看到什么 | 代表什么 |
|---|---|---|
/deck 当前任务 | 规划失败、内容未成稿、无法继续 | 当前这次演示文稿工作流没有顺利走完 |
| HTML Deck 主预览 | 只有结构、内容不完整、主张不连贯 | 主预览已经生成，但输入资料或结构约束还不够 |
| PPTX / PDF 派生导出 | derivative not ready、导出不可用、导出失败 | 主预览存在，但派生文件还没准备好或导出没成功 |
| 模板 / 原生导出阶段 | template unavailable、native export unavailable | 当前模板或本地原生导出桥接能力不可用 |
常见报错与含义
| 常见提示或错误方向 | 用户应如何理解 | 建议先做什么 |
|---|---|---|
| presentation sources missing / 缺少来源资料 | 你要求做 deck，但没有给足够的项目资料或来源 | 先补研究结果、文档、摘要或边界明确的 source refs |
| template unavailable | 当前模板不可用，或模板引用不满足要求 | 先改用默认流程，确认内容结构没问题后再谈模板 |
| template fill failed | 模板填充阶段失败，常见原因是内容结构不完整 | 先把页数、标题层级和页面内容收紧，再重试 |
| native export unavailable | 当前运行环境没有可用的原生 PPTX 导出桥接 | 先用 HTML Deck 审稿，必要时稍后再导出 PPTX |
| presentation pptx derivative not ready | 主预览已存在，但 PPTX 派生文件还没就绪 | 不要立刻重跑全部流程，先等待或刷新导出状态 |
| artifact not found | 你要导出的对象在当前上下文里不存在或已变更 | 回到最新项目版本或最新 deck 再发起导出 |
| command policy denied | 当前导出动作缺少允许的执行边界 | 检查当前项目策略或导出权限，而不是改文案内容 |
建议用户怎么排查
先区分是“内容没生成出来”，还是“内容有了，但 PPTX/PDF 还没出来”。
如果 HTML Deck 已经能看，优先先审结构，不要因为 PPTX 一时没出就整单重做。
补齐受众、页数、主题主线和来源资料，再做第二轮。
如果问题发生在模板或原生导出，先改回默认生成路径，确认内容本身没问题。
如果是导出对象丢失或版本错位，回到最新项目交付物重新发起导出。
截图占位
后续建议补 4 张图：
/deck输入示例、HTML Deck 主预览、PPTX/PDF 派生状态、项目交付物中的 deck 条目。
录屏占位
后续建议补 1 段短录屏：从研究结果出发生成 deck，并查看 HTML Deck 与 PPTX 派生状态。