open-slide:专为 AI Agent 打造的幻灯片框架,用自然语言生成 React 投影片(7,000+ Star 分析)

4 分鐘閱讀時長

發布時間:

open-slide:专为 AI Agent 打造的幻灯片框架

GitHub stars GitHub forks License: MIT Vercel OSS

The slide framework built for agents. 你的 Agent 写 React,open-slide 负责画布、缩放、导航、热重载与演示模式。

open-slide 封面


📊 项目速览

項目資料
名稱open-slide
授權MIT(© Yiwei Ho)
Stars⭐ 7,082(2026-08-27)
Forks498
開啟 Issue90
開發語言TypeScript
版本@open-slide/core v1.19.1
技術棧React 18 + Vite + Tailwind CSS + shadcn
建立時間2026-04-26(不到一年)
Homepageopen-slide.dev
官方定位全球首個為 AI 編碼 Agent 優化的投影片框架

🎯 核心概念:什麼是 open-slide?

一句話說明

把「用自然语言描述简报」→「Agent 写出真正可运行的 React 组件」→「框架负责渲染、缩放、导航与演示」

一般投影片工具(PowerPoint、Google Slides)用的是受限的 DSL或視覺化編輯器。 open-slide 不同:每一頁都是一個真正的 React 組件(Page component),你可以用全部 React + CSS 的能力自由發揮。

關鍵差異表

維度PowerPoint / Google Slidesopen-slide
本質視覺化編輯器React 程式碼框架
每頁形式專屬 DSL / 視覺物件React.FC 組件
畫布尺寸可變固定 1920 × 1080(全 HD)
內容密度有限無限(可寫任何 React 程式碼)
AI Agent 協作支援度低原生內建
部署需匯出/上傳靜態 HTML + 一鍵部署
客製化受模板限制完全自由

核心設計哲學

Slides are visual code. Agents are great at writing code.

投影片本質是「視覺化的程式碼」,而 AI Agent 最擅長寫程式碼。 open-slide 就是那個把「做關於 X 的投影片」變成精美、可簡報的簡報的缺失執行環境。


✨ 四大亮點功能

🤖 1. Agent-native 作者工具(Agent 原生撰寫)

open-slide 與所有編碼 Agent 相容(Claude Code、Codex、Cursor、OpenCode 等)。 Scaffolder 內建了兩個核心 skills:

Skill功能
/create-slide從頭到尾草擬一整套簡報。會問四個問題:① 主題與美學、② 頁數、③ 文字密度、④ 動態 vs 靜態。自動選擇 id、規劃結構、寫出頁面
/slide-authoring技術參考文件。涵蓋 1920 × 1080 畫布、字體比例、配色、佈局規則。Agent 在寫程式前會先讀它
import type { Page } from '@open-slide/core';

// 每一頁都是一個 React 組件,預設匯出一個 Page 陣列
const Cover: Page = () => (
  <div className="flex h-full w-full items-center justify-center">
    <h1 className="text-[120px] font-bold">Hello, open-slide</h1>
  </div>
);

const pages: Page[] = [Cover];
export default pages;

export const meta = { title: 'Hello' };

🎯 2. 瀏覽器內 Inspector(互動式評審)

在 dev server 中點擊任何元素即可附上評論:

“make this red”(改成紅色) “change to ‘Open Slide Rocks’“(改文字) “shrink the headline”(縮小標題)

  • 評論會持久化存成 @slide-comment 標記(source code 中)
  • 執行 /apply-comments,Agent 就會套用所有待處理的編輯並清除標記
Loop:present → click to comment → /apply-comments → repeat

🖼️ 3. Assets Manager + svgl Logo 搜尋

功能說明
資產管理面板每場簡報的圖片、影片、字型都在一個面板中管理
svgl Logo 目錄內建整合 svgl.app,搜尋並拖放任何品牌 Logo(SVG 格式)
免找檔案不用再滿世界找 SVG 圖示

🎬 4. 專業演示模式(Present Mode)

  • 全螢幕播放 + 鍵盤導航
  • 講者模式(Presenter mode):
    • 目前/下一頁預覽
    • 講者備忘錄(Speaker notes)
    • 計時器(Timer)
  • 為真實演講舞台設計,不只是瀏覽器分頁

📦 5. 匯出靜態 HTML 與 PDF

  • 一行指令即可匯出:
    • 自包含的靜態 HTML 網站(含所有資源)
    • 適合列印的 PDF
  • 可離線分享,不需要伺服器

📁 6. 簡報管理器(Slide Manager)

  • 把簡報分組到資料夾
  • 支援自訂 emoji 與拖曳重新排序
  • 當簡報超過三套時,用來快速找到需要的檔案

🚀 7. 部署友善(Deploy-friendly)

  • 輸出純靜態 build
  • 一鍵部署到:Vercel、Cloudflare Pages、Zeabur、Netlify,或任何靜態主機
  • 不需要伺服器、不需要 runtime、沒有鎖定

🏗️ 技術架構

Repo 結構:pnpm + Turbo 單倉(Monorepo)

路徑套件角色
packages/core@open-slide/core核心執行環境(首頁、投影片檢視器、演示模式、Inspector)、Vite plugin、open-slide dev/build/preview CLI
packages/cli@open-slide/clinpx @open-slide/cli init 建立器 + 專案模板
apps/demoprivate範本工作區,用 workspace:* 消耗 @open-slide/core。用於本地開發框架
apps/webprivate行銷網站(Next.js)

關鍵技術選型

技術用途
React 18投影片組件基礎
Vite 5.4快速建構與 dev server
Tailwind CSS 4.2樣式系統
shadcnUI 元件庫
TypeScript 5.9類型安全
Biome程式碼格式化與 Lint
Changeset版本管理
PlaywrightE2E 測試
tsdown套件打包

🛠️ 安裝與使用

快速開始

# 1. 建立新的投影片工作區
npx @open-slide/cli init my-slide

# 2. 進入目錄
cd my-slide

# 3. 安裝依賴並啟動 dev
pnpm install
pnpm dev

三個核心 CLI 指令

指令功能
open-slide dev啟動 dev server
open-slide build建立靜態網站
open-slide preview預覽生產 build

設定檔 open-slide.config.ts

所有選填欄位:

import type { OpenSlideConfig } from '@open-slide/core';

const openSlideConfig: OpenSlideConfig = {
  slidesDir: 'slides',   // 投影片目錄
  port: 5173,            // dev server 連接埠
};

export default openSlideConfig;

部署到子路徑(Subpath)

可用 base 欄位部署到子目錄(內網資料夾、GitHub Pages 專案網站、反向代理):

const openSlideConfig: OpenSlideConfig = {
  base: '/my-slides/',   // 前後都要有斜線
};

內建導出的模組(Exports)

import {
  CANVAS_WIDTH,        // 1920
  CANVAS_HEIGHT,       // 1080
  MorphElement,        // 跨頁淡入淡出的元素過渡
  type Page,
  type SlideMeta,
  type SlideModule,
  type SlideTransition,
  type OpenSlideConfig,
} from '@open-slide/core';

📝 投影片撰寫規則

投影片放在 slides/<kebab-case-id>/index.tsx,預設匯出一個 Page 陣列:

// slides/hello/index.tsx
import type { Page } from '@open-slide/core';

const Title: Page = () => (
  <div className="flex h-full w-full items-center justify-center">
    <h1 className="text-[120px] font-bold text-blue-600">
      我的投影片
    </h1>
  </div>
);

const Content: Page = () => (
  <div className="p-20">
    <h2 className="text-[80px] font-bold">核心內容</h2>
    <ul className="text-[60px] space-y-4">
      <li>✓ 功能一</li>
      <li>✓ 功能二</li>
    </ul>
  </div>
);

const pages: Page[] = [Title, Content];
export default pages;

三種撰寫方式

方式說明
方式 1:純寫程式直接編輯 slides/<id>/index.tsx,完全掌控
方式 2:AI Agent 協助用 /create-slide 讓 Agent 從頭到尾寫好
方式 3:混合模式Agent 起草 → Inspector 點選微調 → /apply-comments 套用

🔑 核心概念比較表

概念說明
Page一頁投影片的 React 組件
SlideModule整個投影片模組(含 pages + meta)
SlideMeta簡報的中繼資料(標題、作者等)
SlideTransition跨頁過渡效果
MorphElement跨頁元素淡入淡出的過渡元件
@slide-commentInspector 評論的持久化標記
open-slide.config.ts專案設定檔(slidesDir、port、base)

💰 授權與支持

項目說明
授權MIT — 可自由使用、修改、商業化
作者Yiwei Ho(@1weiho)
支持ko-fi.com/D1D11YPUP1
Vercel OSS被收錄於 Vercel OSS 計畫

📈 為什麼值得關注?

  1. 開創性定位:全球首個專為 AI 編碼 Agent 優化的投影片框架
  2. 降低門檻:一句話提示 → 精美簡報,不需學複雜工具
  3. 高度客製化:真正的 React 程式碼,不受 DSL 限制
  4. 部署簡潔:靜態 HTML + 一鍵部署
  5. 團隊協作:Inspector + apply-comments 流程適合團隊迭代
  6. 技術現代:React 18 + Vite + Tailwind + TS,生態完整

🚀 適合誰使用?

使用者適用原因
AI 應用開發者快速生成技術簡報、產品演示
團隊Inspector + apply-comments 協作流程
教育訓練自然語言即可生成教學投影片
行銷團隊快速產出行銷簡報並一鍵部署
設計團隊真正 React 程式碼,無限客製化

總結

open-slide 是一個為 AI Agent 時代而生的投影片框架:

自然語言提示 → AI Agent 寫 React → 框架負責渲染與演示

它打破了傳統投影片工具的 DSL 限制,讓每一頁都是真正可運行的 React 組件。 配合內建的 /create-slide、/apply-comments、Inspector、Assets Manager、演示模式與一鍵部署, 讓「做投影片」變成純屬內容創作的體驗。

對於已經在使用 Claude Code、Codex、Cursor 的開發者來說,open-slide 是必試的工具。


本文於 2026-08-27 整理自 github.com/1weiho/open-slide