文档

在编程智能体中使用“复制提示词”。

一个复制内容里同时包含 Slidev 指令、组件代码、使用示例和禁止编造规则。

从这里开始

根据你手头已有的内容选择正确路径。

01 · PowerPoint

你已有 PPT 或 PPTX

把源文件和一个可写项目文件夹交给智能体。它应保留原 PowerPoint,提取结构和素材,再将内容重建为 Slidev 项目,然后继续设计。

02 · 现有项目

你已经有 Slidev 项目

打开包含 slides.md 和 package.json 的文件夹,再粘贴提示词。智能体应先检查现有主题、组件、素材和脚本,然后再添加或替换页面。

03 · 新项目

你有一个空文件夹

使用独立、可写的文件夹。智能体可以在其中初始化 Slidev、安装依赖、创建所需模块或演示,并验证它能够运行,同时不触碰无关文件。

04 · 没有工作区

你还没有文件夹或没有写入权限

先创建或选择一个独立文件夹,并在编程智能体中打开。如果智能体无法写入,它必须明确说明并给出文件计划,不能声称项目已经保存。授权或换一个文件夹后再继续。

项目生命周期

从复制提示词,到一个以后还能继续打开的项目。

01

1. 创建并保存

把复制的提示词粘贴到已经打开项目文件夹的编程智能体中。真正保存的项目是一组磁盘文件,而不只是预览或聊天回复。

slides.mdcomponents/styles/public/package.jsonREADME.md

02

2. 运行并检查

让智能体安装依赖并使用 package.json 中的脚本。它应报告准确的项目路径、预览地址、命令和错误,而不只是说“完成了”。

npm installnpm run devnpm run build

03

3. 重新打开并继续

以后在编辑器或编程智能体中打开同一文件夹,说明你想修改什么。智能体应先读取现有项目,再从这些文件继续,而不是另生成一套无关内容。

04

4. 构建与导出

把 Web 项目作为可编辑源文件。你可以构建 Web 版本,也可以让智能体验证 PDF/PPTX 导出命令。Slidev 的 PPTX 是基于图片的兼容副本;动画和交互只保留在 Web 演示中。

npm run exportnpm run export -- --format pptx

交付边界

迁移与事实边界

PowerPoint 迁移本质上是重建

Slidev 无法把所有 PowerPoint 布局、字体、动画、图表或嵌入对象完整导入为可编辑 Web 组件。智能体应保留源 PPT/PPTX,记录无法读取的内容,并在新项目中重建叙事与视觉,而不是覆盖原文件。

缺失信息必须保持可见

如果缺少事实、素材、引用或字体,智能体应使用明确的占位符并报告缺口,绝不能为了让页面看起来完整而编造内容。