SlideStage 是什么

SlideStage 是一组围绕 .stage 演示包构建的工具：把 HTML 幻灯片打包成一个可移植文件，在本地浏览器、桌面应用或自托管平台中播放和管理。

它的核心目标是同时保留两件事：

• HTML/CSS/JavaScript 演示的高保真表现力。
• 单文件交付、上传、归档和复现的稳定性。

适合谁

SlideStage 适合已经用 HTML 制作演示内容的人：设计师、开发者、产品团队、研究团队和需要长期保存演示资产的组织。

如果你只想把一份 HTML deck 发给别人播放，可以用 slidestage-pack 生成 .stage 文件，再交给 SlideStage Lite 打开。

如果你需要团队共享、上传、权限、笔记和批注持久化，可以把 .stage 文件上传到 SlideStage Pro。

产品组成

SlideStage Lite

SlideStage Lite 是本地优先的播放器和转换器。它在浏览器或桌面应用中打开 .stage 文件，不需要账号、后端或上传。

Lite 负责：

• 打开和播放 .stage 演示包。
• 提供演讲者工具、激光笔、画笔、聚光、备注和第二屏观众窗口。
• 把 HTML deck、zip 或已有 .stage 转换为严格的 .stage 包。
• 在浏览器端执行沙箱隔离和按包授权。

SlideStage Pro

SlideStage Pro 是自托管团队平台。它把 Lite 的播放能力放进一个多用户系统中，增加服务端存储、账号、邀请、笔记、批注和 Docker 部署。

Pro 负责：

• 管理团队的 .stage 资料库。
• 上传、下载、查看和版本化演示包。
• 保存服务端笔记和批注。
• 用管理员邀请控制注册。
• 在 VPS 上通过 Docker Compose 部署。

slidestage-pack

slidestage-pack 是 Agent skill 和 CLI 工具，用来把已有 HTML 幻灯片打包为 .stage。

它负责：

• 识别 reveal.js、impress.js、huashu-design、html-ppt-skill、普通 HTML 和已有 .stage。
• 自动选择 split、wrap、single 或 passthrough 模式。
• 生成 manifest.json、复制资源、抽取 speaker notes。
• 校验路径安全、manifest 合法性和文件大小限制。

.stage 是中心契约

.stage 是一个 zip 容器，根目录包含 manifest.json，并包含实际的 slide HTML、资源、缩略图和可选的离线镜像信息。

这个格式由 @slidestage/spec 定义。Lite、Pro 和 Pack 都依赖同一套格式规则，因此同一个 .stage 文件应该能在三者之间一致播放、上传和校验。

推荐工作流

最常见的路径是：

1. 用任意 HTML 幻灯片框架制作 deck。
2. 用 slidestage-pack 或 Lite 转换器打包成 .stage。
3. 拖进 SlideStage Lite 本地播放，或上传到 SlideStage Pro 团队资料库。

这个流程让制作工具保持开放，同时让交付格式稳定。