文档

排查智能体生成 Slidev 演示时的问题。

从文件访问、项目保存到构建导出，按实际错误逐项定位问题。

问题组 01

文件与项目

确认源文件的绝对路径，并确认智能体拥有读取权限。让它报告无法提取的页面或对象。如果不能直接解析，可导出 PDF 或页面图片作为视觉参考。保留原 PowerPoint，不要让智能体猜测无法读取的内容。

要求智能体给出项目绝对路径和实际写入的文件列表。确认文件夹中存在 slides.md 和 package.json。如果它只在聊天中返回代码，请打开一个可写文件夹并让它在那里创建文件。

重新打开智能体之前报告的准确文件夹，而不是导出的 PDF 或 PPTX。Slidev 文件夹才是可编辑源文件。继续修改前，先让智能体检查现有文件。

问题组 02

确认 Node.js 和项目所用的包管理器可用，在项目文件夹中安装依赖，并使用 package.json 定义的脚本。让智能体报告准确命令和开发服务器的完整错误。

先执行常规构建，修复缺失导入、字体或本地素材，再尝试导出。让智能体验证项目真实的导出命令，并报告失败页面和完整错误。预览截图不能证明项目能够构建或导出。

这是正常现象：Slidev 的 PPTX 输出基于图片。动画、键盘控制与交互状态只能在 Web 演示中使用；PPTX 或 PDF 应视为静态演示和审阅副本。

问题组 03

让智能体把内容拆到另一页，而不是缩小文字或继续增加项目符号。

在源材料提供真实数值前，保留带方括号的占位符。