分清源文件和生成输出。

修改 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 服务器否
PDF文档阅读器否
PPTX 兼容副本演示软件;页面内容为图像否

安全继续已有项目

先检查,再完成范围明确的修改,最后只从当前可编辑源项目重新构建。

  • 确认项目路径

    确认 slides.md 和 package.json 属于你想修改的 Deck。

  • 检查现有约定

    添加或替换页面前,先阅读当前主题、组件、样式、素材、脚本和说明。

  • 保护无关用户工作

    不要删除、恢复、覆盖或重排用途不属于本次修改的文件。

  • 重新构建当前状态

    修改后,从当前源项目重新生成 offline.html 和所有受影响导出。