分清源文件和生成输出。
修改 Slidev 项目,再重新生成离线与静态输出。不要把派生文件当成创作源文件直接修补。
项目目录是可编辑的权威来源
预览、聊天回复、截图、PDF、PPTX、离线文件或托管构建都不能替代创作 Deck 的项目文件。
Agent 应报告项目绝对路径,并使用项目自己定义的脚本。继续工作时,打开同一目录,先检查当前源文件,再开始修改。
生成文件应能从当前源文件重建。输出早于项目时,应重新构建,不能直接修改输出。
- 把源材料与生成输出分开。
- 保留原 PowerPoint 或其他用户文件。
- 条件允许时使用版本控制或其他可恢复历史。
- 把每次导出视为某一个源文件状态的交付副本。
常见源文件和目录
项目可以包含更多文件;以下路径说明主要创作职责。
| 路径 | 职责 |
|---|---|
| slides.md | 页面顺序、页面内容、Frontmatter 和页面级组合 |
| components/ | 可复用 Vue 组件、图表、数据视图和交互演示元素 |
| styles/ | 项目级视觉变量、排版、布局规则以及打印或动效行为 |
| public/ | 运行时需要的本地图像、字体、媒体、数据和其他素材 |
| package.json | 依赖,以及开发、构建、离线输出和导出的准确命令 |
| README.md | 安装、编辑、播放、构建、导出、迁移和继续项目的方法 |
生成输出是可替换的交付副本
相关内容变化后重新生成这些输出,并且不要从它们继续编辑。
| 输出 | 运行环境 | 是否为可编辑源文件 |
|---|---|---|
| offline.html | 当前 Chromium 浏览器中的 file:// 直接播放 | 否 |
| portable/ | 静态 HTTP 服务器 | 否 |
| dist/ | 静态 HTTP 服务器 | 否 |
| 文档阅读器 | 否 | |
| PPTX 兼容副本 | 演示软件;页面内容为图像 | 否 |
安全继续已有项目
先检查,再完成范围明确的修改,最后只从当前可编辑源项目重新构建。
确认项目路径
确认 slides.md 和 package.json 属于你想修改的 Deck。
检查现有约定
添加或替换页面前,先阅读当前主题、组件、样式、素材、脚本和说明。
保护无关用户工作
不要删除、恢复、覆盖或重排用途不属于本次修改的文件。
重新构建当前状态
修改后,从当前源项目重新生成 offline.html 和所有受影响导出。