FastPPT 是一个本地优先的 AI 演示文稿工作区。它把 Claude Code、OpenAI Codex、Slidev 实时预览、主题 Skill 和可编辑 PPTX 导出整合到同一套工作流中。
浏览器负责编辑、预览与导出捕获；本地 fastppt 命令负责工作区文件、Agent 会话、主题、Skill、MCP、Slidev 进程和 PPTX 转换。
FastPPT Web
│ HTTP + WebSocket
▼
本地 Gateway（127.0.0.1:4317）
├── Claude Code / Codex Harness
├── Slidev 实时预览
├── Theme + Skill 管理
├── 工作区文件与 SQLite 状态
└── Slidewave 可编辑 PPTX 导出
- 在同一个工作区中让用户和 Agent 编辑 Slidev Markdown。
- 支持 Claude Code 与 OpenAI Codex 会话、审批、恢复和审计。
- 自动安装基础 Skill、主题 Skill 和 MCP 配置。
- 提供内置主题，也可以从现有 PPTX 提取并生成新主题。
- 支持图片、复杂 CSS、背景、透明度、字体嵌入和溢出检查。
- 将浏览器中的 Slidev 页面导出为可继续编辑的 PPTX。
- 所有文件、缓存、导出和运行状态默认保留在本地。
- Node.js 22 或更高版本
- pnpm 10（仅源码开发需要）
- 现代浏览器
- Claude Code 或 Codex CLI（只使用对应 Agent 时需要）
源码工作区的共享包从官方 npm registry 消费：apps/web/package.json 中的 @fastrd/ui-foundation、@fastrd/ui-vue，以及 packages/harness-codex/package.json 中的 @fastrd/harness-transport 均精确锁定 0.1.2。在仓库根目录执行 pnpm install --frozen-lockfile --registry=https://registry.npmjs.org/，统一使用根 pnpm-lock.yaml。更新锁前先用 npm view <包名>@0.1.2 version dist --json --registry=https://registry.npmjs.org/ 确认版本、tarball 和 provenance；发布尚未可用时等待发布完成，不切换到 GitHub tarball。
全局安装：
pnpm add --global @fastppt/cli也可以安装到当前项目：
pnpm add --save-dev @fastppt/cli
pnpm exec fastppt --help安装后，内置主题会同步到 $HOME/.fastppt/themes
CLI 升级会刷新内置主题，但不会删除用户导入的额外主题。
进入包含 slides.md 的目录并启动：
cd /path/to/your-deck
fastppt start --open也可以在任意目录指定工作区：
fastppt start --dir /path/to/your-deck默认地址：
- Web：https://fastppt.vercel.app
- Gateway：http://127.0.0.1:4317
- 健康检查：http://127.0.0.1:4317/health
- 完整诊断：http://127.0.0.1:4317/ready
在工作区创建 slides.md：
---
theme: slidev-theme-landing
title: FastPPT Demo
---
# 使用 Agent 制作演示文稿
在浏览器中继续编辑、预览并导出 PPTX。
---
## 第二页
- Slidev 实时预览
- Claude Code / Codex 协作
- 可编辑 PPTX 导出然后运行：
fastppt start --open# 启动当前工作区
fastppt
# 指定工作区、端口并打开 Web
fastppt start --dir ./deck --port 4317 --open
# 查看运行状态
fastppt status --dir ./deck
# 检查主题、Skill、MCP、Slidev、Harness 和导出运行时
fastppt doctor --dir ./deck
# 输出 JSON，便于脚本处理
fastppt status --json
fastppt doctor --json
# 停止当前工作区注册的 Gateway
fastppt stop --dir ./deck查看全部参数：
fastppt --helpgit clone https://github.com/FastR-D/FastPPT-slidev.git
cd FastPPT
pnpm install
pnpm dev --dir ./examples/demo-deck本地开发地址：
- Web：http://127.0.0.1:4318
- Gateway：http://127.0.0.1:4317
常用检查：
pnpm typecheck
pnpm lint
pnpm test
pnpm build
# 浏览器端到端测试
pnpm --filter @fastppt/e2e testapps/cli 可发布的 fastppt 命令
apps/gateway Fastify 本地服务与任务编排
apps/web Vue 3 工作区界面
packages/fastppt-mcp Agent 使用的 MCP 工具
packages/fastppt-skill 基础 Skill 与托管安装器
packages/harness-claude Claude Agent SDK 适配器
packages/harness-codex Codex app-server 适配器
packages/slidev-host Slidev 预览进程管理
packages/slidewave DOM 捕获与可编辑 PPTX 转换
packages/theme-registry 主题注册、校验与加载
packages/fonts 浏览器与 PPTX 共用字体
themes/ 内置 Slidev 主题与主题 Skill
examples/ 示例工作区
tests/e2e 浏览器端到端测试
运行时目录：
$HOME/.fastppt/themes 用户主题目录
<workspace>/.fastppt/runtime Gateway 连接信息
<workspace>/.fastppt/state SQLite 状态
<workspace>/.fastppt/exports PPTX 导出结果
<workspace>/.claude/skills Claude Skills
<workspace>/.agents/skills Codex Skills
FastPPT 会自动把 .fastppt/、.claude/、.codex/、.agents/ 和托管 MCP 配置加入工作区 .gitignore。
FastPPT 在以下项目与工作流基础上进行集成、迁移或参考设计：
- Slidev：Markdown 演示文稿、Vue 组件、主题与实时预览基础。
- PptxGenJS：PowerPoint 文件生成基础。
- Model Context Protocol：Agent 与 FastPPT 工具之间的标准协议。
- OpenAI Codex：Codex CLI 与 app-server 会话能力。
- Claude Agent SDK：Claude Harness 能力。
- pptx-renderer：PPTX 解析与渲染实现参考。
- open-kimi-ppt-skill：PPT 生成 Skill、内容组织和设计流程参考。
@fastppt/slidewave：项目内维护的浏览器捕获与可编辑 PPTX 转换分支。
内置主题可能来自不同的上游 Slidev 主题。每个主题的来源、改动和许可证信息记录在对应目录的 THIRD_PARTY_NOTICES.md 与 UPSTREAM_LICENSE 中。
| 文档 | 内容 |
|---|---|
| 开发入门 | 本地开发、CLI、环境配置与贡献流程 |
| 系统架构 | Gateway、Web、Harness、主题、事件与导出边界 |
| 产品演进规划 | 产品领域、实施顺序和发布切片 |
| PPTX / Theme / Motion 深化计划 | 参考实现、导出能力、主题转换、动画样式与验收 |
| 结构化内容原生导出计划 | 原生表格、数据图表、图示连接关系与分期验收 |
| HTTP API | 健康检查、工作区、会话、主题、预览和导出接口 |
| FastPPT Skill | Agent 制作、检查和导出演示文稿的基础流程 |
| Slidewave 说明 | 浏览器捕获、快照协议与服务端转换入口 |
| 可编辑 PPTX | Slidev 到可编辑 PowerPoint 的转换设计 |
| pptx-renderer 参考 | PPTX 渲染参考项目 |
| Kimi PPT Skill 参考 | PPT 生成 Skill 参考项目 |
fastppt 同时提供服务管理和核心操作命令。CLI 与 MCP 复用同一套
服务、参数 schema、工作区路径策略和浏览器捕获逻辑。
fastppt --help
fastppt tools list --json
fastppt skills install --dir ./deck --json
fastppt theme list --dir ./deck --json
fastppt theme import --dir ./deck --file references/template.pptx --name MyTheme
fastppt theme create --dir ./deck --input-file theme-create.json --json
fastppt theme design --dir ./deck --input-file theme-design.json --json
fastppt deck write --dir ./deck --path slides.md --content-file draft.md
fastppt deck format --dir ./deck --path slides.md
fastppt deck validate --dir ./deck --path slides.md --json
fastppt deck generate --dir ./deck --input-file generation.json --json
fastppt session status --dir ./deck --harness codex --session <id> --json
fastppt preview start --dir ./deck --path slides.md
fastppt deck export --dir ./deck --path slides.md --output-name presentation.pptx --json任何核心工具都可通过 fastppt tools call <工具名> --input-file args.json 调用，
tools list 会返回完整参数 schema。--json 输出结构化结果与错误；校验失败、
溢出、检查不可用或 Skill 安装冲突会返回非零退出码。修改已有 deck 时，先读取
revision，再通过 deck write --revision <revision> 防止覆盖并发修改。
新增两项流程 Skill，随 CLI 打包并由 skills install 安装到 Codex 和 Claude：
fastppt-theme-create：从设计契约创建主题，或从 PPTX 提取，再编译设计系统、生成主题 Skill、检查五页样例。fastppt-ppt-generate：从用户 brief 到 deck 生成、验证、预览检查和可编辑 PPTX 导出。
主题工具和本地 Markdown 操作可以独立运行。AI 生成与预览需要先启动 Gateway；
渲染检查和 PPTX 捕获需要连接 FastPPT 浏览器预览。deck generate 返回后台任务回执，
需通过 session status 检查实际结果。在 Gateway 运行期间创建或修改主题后，运行
fastppt theme rescan 更新其注册表。
完整参数示例见 CLI 参考， 流程见 主题创建 Skill 与 PPT 生成 Skill。