v3.1.0

写 JSON,出 PPT

专为 AI Agent 设计的 JSON 驱动 PPT 生成工具。
结构化描述幻灯片内容与样式,一条命令生成专业 PPTX。

$ curl -fsSL http://180.76.231.199/install.sh | bash

功能特性

从简单文本到复杂组合图表,一个 JSON 文件搞定一切

6 种元素类型

text / image / shape / chart / table / media,自由坐标布局,精确控制每个元素

9 种图表 + Combo

bar / line / area / pie / doughnut / radar / scatter + 双 Y 轴组合图

9 套内置主题

暖光雅致、海洋蓝、暗黑专业等,支持自定义主题色,深浅色一键切换

PPT ↔ JSON 互转

PPTX 反向解析为可构建 JSON,支持文本、图片、图表、表格的无损双向转换

输入校验系统

自动检测 JSON 语法、中文标点误用、坐标越界、字段缺失,构建前拦截错误

Schema 文档系统

三层渐进式文档,专为 AI Agent 设计,按需获取最小化 token 消耗

样式 + HTML + 列表

全局样式复用、HTML 混排、Bullet/Number 列表,表格自动斑马纹和列宽

raw 透传

任意元素通过 raw 字段直接访问 pptxgenjs 全部原生参数,100% 能力覆盖

快速开始

4 步完成你的第一个 PPT

slides.json
{
  "title": "季度汇报",
  "theme": "blue",
  "slides": [{
    "elements": [
      {
        "type": "text",
        "content": "Q4 业绩总结",
        "fontSize": 32,
        "bold": true,
        "position": { "x": 1, "y": 1, "w": 8, "h": 1.2 }
      },
      {
        "type": "chart",
        "chartType": "combo",
        "position": { "x": 1, "y": 2.5, "w": 8, "h": 4 },
        "data": {
          "labels": ["Q1","Q2","Q3","Q4"],
          "series": [
            { "name": "营收", "values": [120,180,250,310], "chartType": "bar" },
            { "name": "增长率", "values": [10,15,22,18], "chartType": "line" }
          ]
        }
      }
    ]
  }]
}
1

安装

curl -fsSL http://180.76.231.199/install.sh | bash
2

生成示例文件

openppt init
3

构建 PPT

openppt build slides.json -o output.pptx
4

反向转换(可选)

openppt convert existing.pptx -o slides.json

已有 PPT 也能转成 JSON,修改后重新构建

全部命令

13 个命令覆盖完整工作流

命令 说明
openppt build <json>JSON → PPT
openppt create -f <json>同 build(flag 风格)
openppt convert <pptx>PPT → JSON
openppt inspect <pptx>检查 PPT 结构
openppt preview <pptx>导出为 PNG(需 LibreOffice)
openppt init生成示例 JSON 文件
openppt themes列出所有主题
openppt schema [path]查看 schema 文档(三层渐进式)
openppt guide显示使用指南
openppt config show/set/reset配置管理
openppt generate-image <prompt>AI 生图
openppt cache clear清除缓存
openppt latex <formula>LaTeX → OMML

一行命令安装

支持 macOS 和 Linux,自动配置环境

$ curl -fsSL http://180.76.231.199/install.sh | bash

Node.js ≥ 18

运行环境必需

📦

npm

随 Node.js 自带

🖼

LibreOffice(可选)

仅 preview 命令需要

内置主题

暖光雅致 海洋蓝 暗黑专业 森林绿 赤焰红 皇家紫 日落橙 极简白 青碧现代