| name | ppt-preview |
| description | Build Slidev deck and start local preview server. Use after slides are written to provide a viewable URL. |
PPT Preview
When to Use
After slides-<topic>.md has been written and is ready for visual review.
Process
- Build the deck to static files:
npx slidev build <slides-file> --out <artifact-dir>/site
- Start local preview server:
node scripts/static-preview-server.js --dir=<artifact-dir>/site --port=3045
The server auto-retries ports if occupied. It prints PREVIEW_URL=http://... on success.
- Return the preview URL to the user.
Output
- Built static site in
<artifact-dir>/site/
- Running preview server with accessible URL
- The URL MUST be included in the response to the user
After Preview: Offer Export Options
After returning the preview URL, inform the user of available export options:
预览地址：http://localhost:3045
如需导出文件：
- 导出 PPTX：npx slidev export <slides-file> --format pptx
- 导出 PDF：npx slidev export <slides-file>
- 导出 PNG：npx slidev export <slides-file> --format png
也可以让我直接帮你执行导出命令，或使用 `/ppt-publish` 发布到线上。
PPTX Export Details
- Requires
playwright-chromium: npm install -D playwright-chromium
- All slides exported as images (text not editable in PowerPoint)
- Presenter notes are preserved in the PPTX file
--with-clicks is enabled by default (each v-click step becomes a separate page)- To disable click expansion:
npx slidev export <slides-file> --format pptx --with-clicks false
If the user requests PPTX export, run:
npx slidev export <slides-file> --format pptx --output <artifact-dir>/slides.pptx
Failure Handling
- If build fails: report the error and suggest fixes (usually Slidev syntax issues)
- If port is occupied: the server retries automatically up to 30 ports
- If export fails with browser error: run
npm install -D playwright-chromium first
