简体中文 | English

🎨 PPTist

PowerPoint-ist（/'pauəpɔintist/）, 一款基于Web的演示文稿（幻灯片）应用。该应用复刻了Microsoft Office PowerPoint中大多数常用功能，支持文本、图片、形状、线条、图表、表格、视频、音频和公式等多种核心元素类型。用户可以直接在浏览器中编辑和展示幻灯片。

在线试用👉：https://pipipi-pikachu.github.io/PPTist/

中国镜像（定期同步）：Gitee、GitCode

✨ 亮点

1. 开发便捷：基于Vue 3.x和TypeScript构建，不依赖UI组件库，尽可能避免使用第三方组件，从而更易于样式定制和功能扩展。
2. 用户友好：提供无处不在的右键上下文菜单、数十种快捷键以及大量编辑细节优化，力求还原桌面级的应用体验。
3. 功能丰富：支持PowerPoint中大多数常用元素和功能，具备AI生成PPT的能力，支持多种格式导出，并可在移动设备上进行基础编辑与预览。

👀 前排提醒

1. 本项目的目标受众是有Web幻灯片开发需求且具备基本Web开发经验的开发者。提供的链接仅用于演示目的，并不提供任何线上服务。本项目不应直接作为工具使用，也不支持开箱即用。如果您只是需要现成的服务或工具，请考虑其他产品。
2. 这里汇总了一些【常见问题解答】(/doc/Q&A.md)。首次提交Issue或PR时，请务必提前阅读该文档。
3. 如需商业用途，请参阅【商业用途】

🧩 项目定位

本项目严格定位于Web幻灯片编辑/演示应用，而非AI PPT生成器、低代码平台或图像编辑器。以下是针对常见使用场景的推荐程度：

• 低代码平台 / H5编辑器 / 图像编辑器 / 白板（推荐：不推荐）：建议选择专门为此类用途设计的开源项目。
• PPT文件预览工具（推荐：⭐）：导入.pptx文件的功能有限（兼容性约为60%）。除非您对预览精度要求不高，仅需显示基本内容，否则不建议使用。
• AI PPT生成工具（推荐：⭐⭐）：虽然项目提供了基于模板的简单AI生成功能，但这并非核心重点。随着AI技术的发展（从模板生成转向基于HTML或图像的生成），本项目未必会跟随这些趋势。不过，如果您希望构建一个基于模板的AI生成器，并愿意自行实现生成逻辑，PPTist强大的编辑能力将为您提供坚实的基础。
• Office PPT创作工具（推荐：⭐⭐）：PPTist支持许多常见的Office功能及基础的.pptx导出功能。然而，导出结果与原始文件并不完全一致，且如前所述，导入功能也有限制。只有在您可以接受这些限制的情况下才建议选择。
• Web幻灯片编辑/演示应用（推荐：⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐）：这是本项目的首要使用场景。PPTist的核心优势在于其强大的编辑能力和出色的用户体验。您可以在此基础上进行定制或添加独特的节点与功能，以满足特定需求，而无需追求与Office完全兼容。总结：我们的愿景是让您利用PPTist打造一款区别于Microsoft Office的演示产品，而不是仅仅将其作为编辑Office文件的中间工具。

🚀 安装

node.js版本 >= 20

npm install

npm run dev

浏览器访问：http://127.0.0.1:5173/

📚 功能

基础功能

• 操作历史（撤销、重做）
• 快捷键
• 右键菜单
• 导出本地文件（PPTX、JSON、图片、PDF）
• 导入和导出pptist文件
• 打印
• AI PPT

幻灯片页面编辑

• 添加/删除页面
• 复制/粘贴页面
• 调整页面顺序
• 创建节
• 背景设置（纯色、渐变、图片）
• 设置画布尺寸
• 网格线
• 标尺
• 画布缩放和移动
• 主题设置
• 提取幻灯片样式
• 演讲者备注（富文本）
• 幻灯片模板
• 切换动画
• 元素动画（进入、退出、强调）
• 选区面板（隐藏元素、图层排序、元素命名）
• 页面和节点类型的标签（可用于模板相关功能）
• 查找/替换
• 注释

幻灯片元素编辑

• 添加/删除元素
• 复制/粘贴元素
• 拖动移动元素
• 旋转元素
• 缩放元素
• 多元素选择（框选、点选）
• 将多个元素分组
• 批量编辑多个元素
• 锁定元素
• 元素磁性对齐（移动和缩放）
• 调整元素层级
• 将元素对齐到画布
• 将元素对齐到其他元素
• 均匀分布多个元素
• 拖拽添加文本和图片
• 粘贴外部图片
• 设置元素坐标、大小和旋转
• 元素超链接（链接到网页、链接到其他幻灯片页面）

文本

• 富文本编辑（颜色、高亮、字体、字号、粗体、斜体、下划线、删除线、下标、内联代码、引用、超链接、对齐方式、编号、项目符号、段落缩进、清除格式）
• 行高
• 字符间距
• 段落间距
• 首行缩进
• 填充颜色
• 边框
• 阴影
• 透明度
• 竖排文本
• AI改写/扩展/缩写

图片

• 裁剪（自定义、形状、宽高比）
• 圆角
• 滤镜
• 色调（遮罩）
• 翻转
• 边框
• 阴影
• 替换图片
• 重置图片
• 设置为背景

形状

• 绘制任意多边形
• 绘制任意线条（模拟未闭合形状）
• 替换形状
• 填充（纯色、渐变、图片）
• 边框
• 阴影
• 透明度
• 翻转
• 形状格式刷
• 编辑文本（支持富文本，与文本元素的富文本编辑类似）

线条

• 直线、折线、曲线
• 颜色
• 宽度
• 样式（实线、虚线、点线）
• 端点样式

图表（柱状图、条形图、折线图、面积图、散点图、饼图、甜甜圈图、雷达图）

• 图表类型转换
• 数据编辑
• 背景填充
• 主题颜色
• 坐标系和轴文字颜色
• 网格颜色
• 其他图表设置
• 边框

表格

• 添加/删除行和列
• 主题设置（主题颜色、表头、总计行、第一列、最后一列）
• 合并单元格
• 单元格样式（填充颜色、文字颜色、粗体、斜体、下划线、删除线、对齐方式）
• 边框

视频

• 预览封面设置
• 自动播放

音频

• 图标颜色
• 自动播放
• 循环播放

公式

• LaTeX编辑
• 颜色设置
• 公式线条粗细设置

幻灯片放映

• 画笔工具（笔/形状/箭头/荧光笔标注、橡皮擦、黑板模式）
• 预览所有幻灯片
• 底部缩略图导航
• 计时器工具
• 激光指针
• 自动播放
• 演讲者视图
• 观众视图

移动端

• 基本编辑
  • 添加/删除/复制/备注/撤销重做页面
  • 插入文本、图片、矩形、圆形
  • 通用元素操作：移动、缩放、旋转、复制、删除、调整层级、对齐
  • 元素样式：文本（粗体、斜体、下划线、删除线、字号、颜色、对齐方式）、填充颜色
• 基本预览
• 播放预览

👀 常见问题

一些常见问题：FAQ

🎯 补充

目前尚无完整的开发文档，但以下文档可能对您有所帮助：

• 项目目录与数据结构
• Canvas与元素基础
• 如何自定义一个元素
• 关于AIPPT

以下是一些辅助开发工具/仓库：

• 导入PPTX文件参考：pptxtojson
• 绘制形状：svgPathCreator

📄 许可证

AGPL-3.0许可证 | 版权所有 © 2020-至今 pipipi-pikachu

🧮 商业用途

如果您希望将本项目用于商业目的，恳请您尊重开源精神，严格遵守AGPL-3.0协议，回馈开源社区。或联系作者获取独立的商业授权。

🧮 商业用途

• 本项目禁止闭源商用，如果你希望将其用于商业项目，请尊重开源，严格遵循 AGPL-3.0 协议，回馈开源社区；
• 如果你因为任何原因，无法执行 AGPL-3.0 协议，可以选择：
  1. 使用早期 Apache 2.0 协议版本（最后更新时间为2022年5月，已停止维护，点击此处下载）；
  2. 成为项目的重要贡献者（先违反协议后再成为贡献者不适用此项），包括：
     • 你的代码被本项目作为依赖引用，包括：npm安装、文件引用、代码片段引用（引用处会注明）；
     • 你给本项目提交过重要的 PR 或 Issue（由作者主观判断，符合的 PR 或 Issue 会打上important contribution标签）；
  3. 邮件联系作者付费获取独立的商业授权（违反协议后被作者找到的不适用此项）。独立授权价格：
     • 一年：2999元；
     • 永久：5699元（不含税）；
• 建议优先考虑执行AGPL-3.0协议，如需付费获取独立的商业授权，请务必在联系作者前阅读以下内容：
  • 独立商业授权表示：
    • 作者单独出具商业授权协议文件（邮件联系作者获取），双方按流程签署协议；
    • 允许将代码用于商业行为，且不必执行 AGPL-3.0 协议；
    • 授权对象可以是个人或组织（企业），允许授权对象名下的所有产品使用本项目代码；
  • 授权流程：
    1. 被授权方确认协议内容，若无异议，需提供协议中所需的个人/企业信息；
    2. 由作者补充好协议双方信息后打印签字，并将电子扫描件发给被授权方；
    3. 被授权方收到后，将协议打印盖章，再扫描电子档发回给作者，此时协议开始生效；
    4. 被授权方在协议规定时间内支付费用，并保留好支付凭证，授权结束；
  • 授权不等于出售软件或服务：
    • 不存在其他“商业版本”、不提供任何API/SDK/在线服务/技术支持/技术咨询/定制开发；
    • 不提供可直接交付的产品，你仍需从本仓库获取代码自行开发；
    • 该软件无法开箱即用，至少也得自行接入后端能力（使用本项目需要有最基本的web开发经验）；
    • 不保证未来版本的兼容性，不保证代码没有bug；
    • 作者不承担任何因使用本项目代码而导致的直接或间接损失；
    • 务必提前做好调研，判断该软件是否符合需求，包括：功能（是否能满足业务需求）和开发（是否上手当前技术栈/实现方案）；
• 不接受黑名单/耻辱柱或存在违反协议行为的对象通过任何形式获取商业授权；
• 作者倡导异步沟通（正式、信息量大、信息整合度高），不加私人微信/QQ/手机号等，有任何授权相关疑问请邮件联系，谢谢理解；
• 提需求/报bug/询问技术方案等非授权相关咨询，请在 Issues 中进行。

🔔 其他说明

什么是 AGPL-3.0 协议

协议的核心要求用通俗的语言解释如下：

• 开源义务：如果你用了 AGPL 的代码，无论你或你的下游怎么使用/修改，都必须把你最终的代码全部完整公开出来（不只是给出修改的部分，也不是说换个框架重写一遍就能和原始代码脱离关系了），并继续以 AGPL 协议开源（强调：必须延续 AGPL 协议，保持开源的传染性，不能更换其他协议）。
• 网络服务也要开源：即使你只是用 AGPL 的代码做了一个网站或网络服务，别人通过网络用你的服务时，你也需要遵守上一条开源义务。
• 保留版权声明：你不能删掉代码里原来的作者信息和许可证声明，得告诉大家这代码是从哪儿来的。
• 不能加额外限制：你不能在衍生出来的 AGPL 代码上加一些限制，比如不让别人再分发代码，或者要求别人付费才能使用代码（包括但不限于：要求别人购买授权/服务/产品等）。
• 免责声明：作者不保证代码没有 bug，也不对使用后果负责。

详细协议内容见官方文档：AGPL-3.0 协议

声明

Github、Gitee等代码托管平台存在一些仓库基于本项目代码进行了二次开发，但未遵守AGPL-3.0协议，擅自删除了AGPL-3.0协议许可证声明或改用其他协议，作者在此提醒：这些仓库的代码在事实上仍然属于AGPL-3.0协议，切勿受其误导。

PPTist 快速上手指南

PPTist 是一个基于 Web 的演示文稿（幻灯片）应用，复刻了 Microsoft Office PowerPoint 的大部分常用功能。它支持文本、图片、形状、图表、表格、音视频及公式等多种元素，可直接在浏览器中进行编辑和演示。

1. 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• Node.js: 版本需 >= 20
• 包管理器: npm (随 Node.js 安装)
• 代码托管: 推荐访问国内镜像源以获取更快的克隆速度
  • Gitee: https://gitee.com/pptist/PPTist
  • GitCode: https://gitcode.com/pipipi-pikachu/PPTist

注意：本项目定位为面向开发者的 Web 幻灯片编辑/演示应用源码，而非开箱即用的在线 SaaS 服务。您需要具备基础的 Web 开发经验进行二次开发或部署。

2. 安装步骤

方式一：使用国内镜像源（推荐）

# 从 Gitee 克隆项目
git clone https://gitee.com/pptist/PPTist.git

# 进入项目目录
cd PPTist

# 安装依赖
npm install

方式二：从 GitHub 克隆

git clone https://github.com/pipipi-pikachu/PPTist.git
cd PPTist
npm install

3. 基本使用

安装完成后，启动本地开发服务器即可在浏览器中体验完整功能。

启动项目

在项目根目录下运行：

npm run dev

访问应用

终端显示启动成功后，在浏览器地址栏输入：

http://127.0.0.1:5173/

核心功能速览

进入页面后，您可以立即体验以下核心操作：

• 页面管理：添加/删除幻灯片、调整顺序、设置背景与主题。
• 元素编辑：
  • 文本：支持富文本编辑（字体、颜色、段落、列表等）。
  • 媒体：插入并裁剪图片、嵌入视频/音频、编辑 LaTeX 公式。
  • 图形：绘制形状、线条，支持组合、对齐、分布及磁吸吸附。
  • 数据：创建并编辑图表（柱状图、饼图等）和表格。
• 交互操作：支持快捷键操作、右键菜单、拖拽移动、缩放旋转及多选批量编辑。
• 演示模式：点击播放按钮进入全屏演示，支持激光笔、画笔标注、演讲者视图及自动播放。
• 文件操作：支持导出为 PPTX、PDF、图片或 JSON 格式，也可导入现有的 PPTist 文件。

进阶开发

若需进行二次开发（如自定义元素或对接后端），可参考项目目录下的文档：

• 项目结构与数据结构：/doc/DirectoryAndData.md
• 画布与元素基础：/doc/Canvas.md
• 自定义元素指南：/doc/CustomElement.md

许可说明：本项目采用 AGPL-3.0 协议开源。如需用于闭源商业项目，请严格遵循协议要求公开源码，或联系作者获取独立商业授权。