根据实际运行环境构建正确输出。
使用项目定义的脚本。直接打开文件时使用 offline.html；portable 或 dist 必须通过 HTTP；PDF 和 PPTX 是静态导出。
安装依赖并检查可编辑项目
从项目目录运行命令，并优先使用项目已经定义的包管理器和脚本。
安装依赖
项目中有指定包管理器和 Lockfile 时，按项目约定执行。
npm install启动开发演示
打开终端输出的本地地址，在真实浏览器中检查当前源项目。
npm run dev检查常规生产构建
导出前先解决缺失导入、素材、字体或运行时错误。
npm run build构建单文件离线演示
offline.html 是可移动的交互输出，可以单独复制，并通过 file:// 直接打开。
生成当前离线文件
源文件、样式、字体、图像或媒体最终变化后，再运行本命令。
npm run build:offline打开复制后的文件
把 offline.html 复制到另一个位置，再用当前 Chromium 浏览器打开该副本，验证直接文件播放。
open ./offline.html通过 HTTP 提供 portable 和 dist 目录
portable/ 和 dist/ 是 Web 目录。保持所有生成文件完整，并使用静态 HTTP 服务器或托管服务。
生成兼容静态 HTTP 的版本
完整目录将通过 HTTP 托管或提供服务时，使用这一输出。
npm run build:portable在本地启动静态服务
打开终端输出的 localhost 地址。不能通过双击 portable/index.html 或 dist/index.html 运行。
python3 -m http.server 4173 --directory portable导出静态审阅副本
PDF 和 PPTX 保存渲染后的页面，不包含可编辑 Slidev 源文件或交互运行时。
| 输出 | 示例命令 | 行为 |
|---|---|---|
| npm run export | 用于审阅、打印和分享的静态页面；不保留 Slidev 交互 | |
| PPTX 兼容副本 | npm run export -- --format pptx | 页面内容图像化；不能原生编辑文字，也不保留 Slidev 交互 |
验证真正要交付的输出
命令成功只是开始；还要打开真实文件或托管输出，检查代表性状态。
确认输出是最新的
最终相关源文件修改后重新构建，并确认输出时间和路径属于当前项目。
测试复制后的 offline.html
在无法访问非本地网络时，通过 file:// 打开副本；检查第一页、Hash 直达、键盘翻页、本地素材、交互和控制台。
通过 HTTP 测试目录输出
从真实托管路径检查首次加载、直达地址、素材、刷新、交互和浏览器控制台。
检查 PDF 或 PPTX 页面
在真实导出文件中检查页数、裁切、字体、公式、图表、Logo、来源和溢出。
报告剩余限制
说明哪些交互仍需要 Web 版本，以及所有占位符、缺失素材或未验证状态。