slidevjs/slidev skill 本地安装使用教程(新手)（skill安装版）

容易踩错的一点是，把 slidevjs/slidev 当成打开就能包办整份 PPT 的按钮。它对应的是Markdown 演示工具，第一轮要先分清产物是什么；如果一上来就放正式汇报、公司模板和几十页材料，失败时很难判断是入口不对、依赖没装好，还是输出格式本来就不匹配。

slidevjs/slidev 真正适合的场景是：给开发者用 Markdown、Vue 和 Vite 写演示稿，代码演示与主题扩展更顺手。但边界也要先放稳：它偏开发者工作流；只想拖拽编辑版式的人可能更适合 PowerPoint。新手先把这个边界写在任务旁边，后面装依赖和跑小样才不会越试越乱。

先看清它交付的到底是哪种结果

这一路线的主要产物是 本地 Slidev 项目、浏览器预览、PDF/PPTX 等导出结果。如果目标是可编辑 PPTX，就要看文字、图片和图表能不能被 PowerPoint 继续改；如果目标是 HTML deck，就要看浏览器预览、翻页、图片路径和移动端比例；如果它只是清单，结果就不是文件，而是一组可继续筛选的候选入口。

适合的人也随产物变化。slidevjs/slidev 更适合愿意先做小样、再决定是否接正式材料的人；只想把一句需求直接变成最终商业 PPT 的人，需要先确认后续编辑和授权成本。这里的选择判断很具体：能不能说清输出、能不能复现、能不能交给同事继续处理。

本地先走最短路径，不要一次装满

准备 Node 环境后用官方创建命令初始化项目，装好依赖再启动预览。 依赖重点放在 Node.js、包管理器、浏览器预览和中文字体；导出 PDF/PPTX 时再看 Playwright 或浏览器环境。

npm init slidev@latest
npm run dev

第一次准备环境时，只保留一个空白目录、一个最短示例和一个能打开结果的工具。需要 API Key、浏览器、Office、字体或模板文件时，也先只填最低限度；如果命令不存在、目录找不到或页面空白，就先停在这一层排查。

第一次试跑只用小稿，别拿正式材料冒险

首轮小稿建议按这个目标来做：用三页 Markdown 小稿跑通 dev 预览，再试导出。内容控制在 3 到 6 页之间，只放一个标题、两三个要点和一张本地图片；模板、动效、长表格和远程素材都等小样通过后再加。

通过的信号要看得见：浏览器能打开 deck，代码块和主题正常渲染，导出文件能被打开。如果只得到一段说明、空白页面、打不开的文件、缺字体提示或路径报错，就不算跑通；这时不要继续扩写需求，而是回到入口、依赖、输出三处逐个排查。

结果检查要盯住文件、页面和可编辑性

检查顺序可以很朴素：先看输出目录有没有新文件，再看文件能不能被目标软件或浏览器打开，接着看图片路径、中文字体、页面比例和备注是否正常。清单类关键词还要多看一层：候选项目有没有许可证、最近维护信号和真实示例。

如果准备把 slidevjs/slidev 放进团队流程，再加一次接近正式格式的中样。把上一版可用结果留着对照，每次只增加一个变量，例如模板、导出格式、API Key、长材料或图片数量；一变多了，失败信号就会失真。

这些情况先别急着继续投入

它偏开发者工作流；只想拖拽编辑版式的人可能更适合 PowerPoint。另外，公开模板、免费素材和第三方清单都要单独看授权；自动生成或 Agent Skill 还要看密钥费用、运行权限和同事能否接手编辑。

把 slidevjs/slidev 用稳的关键，不是把功能表背下来，而是先确认产物边界，再用最短路径跑出小样。等入口、依赖、输出文件和失败信号都清楚了，再接正式材料，返工会少很多。