保留可编辑源项目,并重新构建每一份交付副本。
真正完成的演示是一个实际项目目录,不只是预览或聊天回复。检查源文件,从最终状态重建输出,并明确报告交付结果。
从需求走到真实保存的项目
创建源项目,在真实浏览器中检查,修复演示,再从最终状态重新生成输出。
创建并保存
Agent 应把 Slidev 项目写入独立目录,并报告绝对路径和重要文件。
运行并检查
安装依赖,使用项目真实脚本启动,在浏览器中检查代表性页面和交互状态。
审阅并修复
检查故事、证据、视觉系统、排版、品牌、动效、溢出和导出表现;交付前先修复实际发现的问题。
重新构建所有所需输出
源文件或素材最终修改后,重新构建 offline.html 和所有静态或 HTTP 输出,不能复用旧导出。
报告交付结果
说明项目路径、开发命令与地址、offline.html、所需导出、已完成检查、占位符和已知限制。
把它当作演示检查,而不只是检查代码
构建成功不能证明叙事、品牌、证据或真实渲染页面正确。
故事与决策
每一页应承担一个清楚职责,整套顺序应把目标受众带向所需结论或行动。
事实、来源与不确定性
核对论点、标签、单位、引用和限定条件;缺少数值时保持可见,不能用看似可信的内容代替。
视觉系统与原创性
检查排版、配色、图像、图表和版式是否适合当前主题和受众,而不是落回通用模板。
品牌与 Logo 完整性
确认 Logo 完整、安全区明确、比例正确、背景合适,并且没有与页码、来源或其他页面元素碰撞。
真实页面与状态
检查真实视口、代表性交互、减弱动效、打印或静态导出以及离线播放;同时检查溢出和浏览器控制台。
为不同用途交付正确文件
源项目始终是权威;离线、HTTP、PDF 和 PPTX 都是从当前状态重新生成的交付副本。
| 输出 | 适合保留做什么 | 不能用来做什么 |
|---|---|---|
| Slidev 源项目 | 继续编辑、重新构建、检查和以后修改 | 在没有项目环境的机器上直接播放 |
| offline.html | 可移动的交互单文件,通过 file:// 直接打开 | 继续编辑演示源文件 |
| portable/ 或 dist/ | 从静态 HTTP 服务器播放交互演示 | 直接 file:// 播放或源文件编辑 |
| 静态审阅、打印或分发 | Slidev 交互或继续编辑 | |
| PPTX 兼容副本 | 在演示软件中静态播放 | 原生可编辑内容、Web 交互或继续源项目 |
从源项目继续编辑
打开同一项目目录,让 Agent 检查当前文件,完成修改,再重新构建受影响的输出。
存在可编辑项目时,不要从 PDF、PPTX、截图、portable 目录、dist 目录或 offline.html 继续。这些输出不包含完整创作状态。
修改前,Agent 应确认当前项目路径、包脚本、源文件、本地素材和已有约定;修改后重新执行受影响的浏览器、离线和导出检查。
- 只保留一个权威项目目录。
- 记录实际修改的文件。
- 旧预览仍然打开时,重启正确项目。
- 相关源文件变化后,重新构建 offline.html 和所需导出。