open-slide

环境要求

• Node.js 环境（脚手架通过 npx 执行，需本机有 npm/npx）
• 一个编码 Agent，如 Claude Code、Codex 或 Cursor
• 可访问网络的终端

安装与启动步骤

1. 1初始化幻灯片项目

   在任意工作目录执行脚手架命令，README 示例会创建名为 my-slide 的项目。

   npx @open-slide/cli init my-slide

   复制

2. 2进入项目目录

   脚手架生成的项目目录名为 my-slide，进入后再继续后续操作。

   cd my-slide

   复制

3. 3让 Agent 起草整套幻灯片

   在项目中调用脚手架自带技能 /create-slide，它会询问主题与风格、页数、文字密度、动效或静态四个问题并规划结构。

   /create-slide

   复制

4. 4按规范撰写页面

   调用 /slide-authoring 技能，让 Agent 读取 1920×1080 画布、字号体系、配色与布局规则后再写 React 页面。

   /slide-authoring

   复制

5. 5启动开发预览

   在项目里启动开发服务器查看渲染效果，并用工具栏的 comment 模式点选或框选元素留言修改意见（README 未给出具体启动命令，请查看脚手架生成的项目脚本）。

6. 6构建并部署静态产物

   项目输出为纯静态构建，可直接一键部署到 Vercel、Cloudflare Pages、Zeabur、Netlify 或任意静态托管（README 未给出具体构建命令）。

如何确认成功

开发服务器启动后浏览器中出现固定 1920×1080 的幻灯片画布，可切换页面、热更新并进入 present 演示模式。

常见问题

注意事项

• 页面是任意 React 组件，而非受限 DSL，灵活性来自 React 生态。
• 每页固定渲染到 1920 × 1080 画布。
• 产物是纯静态构建，无服务器、无运行时、无锁定，可部署到任意静态托管。
• README 未提供开发服务器与构建的具体命令，需以脚手架生成的项目脚本为准。