从真实文件、运行状态或渲染结果开始排查。

确认源文件绝对路径和读取权限，让 Agent 说明无法提取的页面或对象。无法直接解析时，请提供 PPTX、PDF 或导出的页面图片。保留原 PowerPoint，不能猜测无法读取的内容。

要求 Agent 给出项目绝对路径和实际写入文件；确认存在 slides.md 和 package.json。如果 Agent 只在聊天中返回代码或预览，请打开可写目录并让它在那里创建项目。

打开 Agent 之前报告的准确源目录，而不是 PDF、PPTX、截图、portable 目录、dist 目录或 offline.html。继续修改前，让 Agent 先检查现有项目。

确认项目运行环境和包管理器可用，从项目目录安装依赖，并使用 package.json 中的脚本。要求 Agent 提供准确命令和开发服务器的完整错误。

先运行常规构建，解决缺失导入、字体、本地素材或运行时错误；确认项目真实导出命令，并报告失败页面和完整错误。预览截图不能证明构建或导出成功。

从当前源项目重新运行 npm run build:offline。把单文件复制到另一个位置，再用当前 Chromium 浏览器通过 file:// 打开副本。素材或交互失败时，应报告控制台错误并重新构建，不能直接修补 HTML。

这是正常现象。保持完整目录不变，并通过 HTTP 提供服务，例如运行 python3 -m http.server 4173 --directory portable。需要 file:// 直接播放时，请使用经过验证的单文件 offline.html。

Slidev 的 PPTX 兼容副本采用图像化页面，这是正常现象。交互请使用 Slidev Web 版本或 offline.html；继续编辑请保留源项目。

让 Agent 根据所需范围取舍、压缩或拆分内容。不要通过缩小文字、继续堆叠项目符号或隐藏重要限定条件来解决密度问题。

在源材料提供真实数值前保留明确占位符，报告缺少的证据，不能为了完成设计而填入看似可信的数字。

确认 Agent 修改的是同一个源目录，预览服务器也从该目录运行；要求它列出改动文件路径，重启正确项目，并重新构建所有交付副本。源项目存在时，绝不能从旧导出继续。

回到可编辑源项目，保留完整 Lockup 和原始比例，留出明确安全区，使用合适背景，并让页码、来源、控件、遮罩和接缝远离该区域；最后检查真实渲染和导出像素。