# PPTist **Repository Path**: pptist/PPTist ## Basic Information - **Project Name**: PPTist - **Description**: PowerPoint-ist（/'pauəpɔintist/），一个基于 Web 的在线演示文稿（幻灯片）应用，还原了大部分 Office PowerPoint 常用功能。可以在 Web 浏览器中编辑/演示幻灯片，支持AIPPT。商用请遵守AGPL-3协议或购买授权。 - **Primary Language**: TypeScript - **License**: AGPL-3.0 - **Default Branch**: master - **Homepage**: https://github.com/pipipi-pikachu/PPTist - **GVP Project**: Yes ## Statistics - **Stars**: 691 - **Forks**: 136 - **Created**: 2021-02-01 - **Last Updated**: 2025-09-05 ## Categories & Tags **Categories**: doc-tools **Tags**: None ## README

stars forks license language issue gitee

简体中文 | [English](README.md) # 🎨 PPTist > PowerPoint-ist（/'pauəpɔintist/），一个基于 Web 的在线演示文稿（幻灯片）应用，还原了大部分 Office PowerPoint 常用功能，支持 文字、图片、形状、线条、图表、表格、视频、音频、公式 几种最常用的元素类型，可以在 Web 浏览器中编辑/演示幻灯片。 在线体验地址👉：[https://pipipi-pikachu.github.io/PPTist/](https://pipipi-pikachu.github.io/PPTist/) # ✨ 项目特色 1. 易开发：基于 Vue3.x + TypeScript 构建，不依赖UI组件库，尽量避免第三方组件，样式定制更轻松、功能扩展更方便。 2. 易使用：随处可用的右键菜单、几十种快捷键、无数次编辑细节打磨，力求还原桌面应用级体验。 3. 功能丰富：支持 PPT 中的大部分常用元素和功能，支持AI生成PPT、支持多种格式导出、支持移动端基础编辑和预览... # 👀 前排提示 1. 本项目是一个 “Web 幻灯片应用” ，而不是 “低代码平台”、“H5 编辑器”、“图片编辑器” 、“白板应用”等。 2. 本项目的目标受众是有Web幻灯片开发需求的开发者，需要有基础的web开发经验，提供的链接只是一个演示地址，不提供任何在线服务。你不应该直接将本项目作为工具使用，也不支持开箱即用。如果你只是需要一个服务或工具，可以选择更优秀和成熟的产品，例如：[Slidev](https://sli.dev/)、[revealjs](https://revealjs.com/) 等。 3. 这里总结了一些[常见问题](/doc/Q&A.md)，第一次提 Issues 和 PR 时，务必提前阅读此文档。 # 🚀 项目运行 ``` npm install npm run dev ``` 浏览器访问：http://127.0.0.1:5173/ # 📚 功能列表 ### 基础功能 - 历史记录（撤销、重做） - 快捷键 - 右键菜单 - 导出本地文件（PPTX、JSON、图片、PDF） - 导入导出特有 .pptist 文件 - 打印 - AI生成PPT ### 幻灯片页面编辑 - 页面添加、删除 - 页面顺序调整 - 页面复制粘贴 - 幻灯片分节 - 背景设置（纯色、渐变、图片） - 设置画布尺寸 - 网格线 - 标尺 - 画布缩放、移动 - 主题设置 - 提取已有幻灯片风格 - 演讲者备注（富文本） - 幻灯片模板 - 翻页动画 - 元素动画（入场、退场、强调） - 选择面板（隐藏元素、层级排序、元素命名） - 页面和节点类型标注（可用于模板相关功能） - 查找/替换 - 批注 ### 幻灯片元素编辑 - 元素添加、删除 - 元素复制粘贴 - 元素拖拽移动 - 元素旋转 - 元素缩放 - 元素多选（框选、点选） - 多元素组合 - 多元素批量编辑 - 元素锁定 - 元素吸附对齐（移动和缩放） - 元素层级调整 - 元素对齐到画布 - 元素对齐到其他元素 - 多元素均匀分布 - 拖拽添加图文 - 粘贴外部图片 - 元素坐标、尺寸和旋转角度设置 - 元素超链接（链接到网页、链接到其他幻灯片页面） #### 文字 - 富文本编辑（颜色、高亮、字体、字号、加粗、斜体、下划线、删除线、角标、行内代码、引用、超链接、对齐方式、序号、项目符号、段落缩进、清除格式） - 行高 - 字间距 - 段间距 - 首行缩进 - 填充色 - 边框 - 阴影 - 透明度 - 竖向文本 - AI改写/扩写/缩写 #### 图片 - 裁剪（自定义、按形状、按纵横比） - 圆角 - 滤镜 - 着色（蒙版） - 翻转 - 边框 - 阴影 - 替换图片 - 重置图片 - 设置为背景图 #### 形状 - 绘制任意多边形 - 绘制任意线条（未封闭形状模拟） - 替换形状 - 填充（纯色、渐变、图片） - 边框 - 阴影 - 透明度 - 翻转 - 形状格式刷 - 编辑文字（支持富文本，与文字元素的富文本编辑功能近似） #### 线条 - 直线、基础折线/曲线 - 颜色 - 宽度 - 样式（实线、虚线、点线） - 端点样式 #### 图表（柱状图、条形图、折线图、面积图、散点图、饼图、环形图、雷达图） - 图表类型转换 - 数据编辑 - 背景填充 - 主题色 - 坐标轴/坐标文字颜色 - 网格颜色 - 堆积模式、平滑曲线等 #### 表格 - 行、列添加删除 - 主题设置（主题色、表头、汇总行、第一列、最后一列） - 合并单元格 - 单元格样式（填充色、文字颜色、加粗、斜体、下划线、删除线、对齐方式） - 边框 #### 视频 - 预览封面设置 - 自动播放 #### 音频 - 图标颜色 - 自动播放 - 循环播放 #### 公式 - LaTeX编辑 - 颜色设置 - 公式线条粗细设置 ### 幻灯片放映 - 画笔工具（画笔/形状/箭头/荧光笔标注、橡皮擦除、黑板模式） - 全部幻灯片预览 - 触底显示缩略图导航 - 计时器工具 - 激光笔 - 自动放映 - 演讲者视图 ### 移动端 - 基础编辑 - 页面添加、删除、复制、备注、撤销重做 - 插入文字、图片、矩形、圆形 - 元素通用操作：移动、缩放、旋转、复制、删除、层级调整、对齐 - 元素样式：文字（加粗、斜体、下划线、删除线、字号、颜色、对齐方向）、填充色 - 基础预览 - 播放预览 # 🎯 开发 目前没有完整的开发文档，但下面这些文档可能会对你有一些帮助： - [项目目录与数据结构](/doc/DirectoryAndData.md) - [画布与元素的基本原理](/doc/Canvas.md) - [如何自定义一个元素](/doc/CustomElement.md) - [关于AIPPT](/doc/AIPPT.md) 下面是一些辅助开发的工具/仓库： - 导入PPTX文件参考：[pptxtojson](https://github.com/pipipi-pikachu/pptxtojson) - 绘制形状：[svgPathCreator](https://github.com/pipipi-pikachu/svgPathCreator) # 📄 版权声明/开源协议 [AGPL-3.0 License](/LICENSE) | Copyright © 2020-PRESENT [pipipi-pikachu](https://github.com/pipipi-pikachu) # 🧮 商业用途 - 本项目禁止闭源商用，如果你希望将PPTist用于商业项目盈利，请尊重开源，**严格遵循 [AGPL-3.0 协议](https://www.gnu.org/licenses/agpl-3.0.html)**，回馈开源社区（这是作者倡导的）； - 如果你因为任何原因，必须要闭源商用，无法执行 AGPL-3.0 协议，可以选择： 1. 使用早期的 Apache 2.0 协议版本 [（该版本最后更新时间为2022年5月，目前已停止维护，点击此处可下载代码）](https://github.com/pipipi-pikachu/PPTist/archive/f1a35bb8e045124e37dcafd6acbf40b4531b69aa.zip)； 2. 成为项目的重要贡献者，包括： - 你的代码被本项目作为依赖引用，包括：npm安装、script/style等文件引用、代码片段引用（引用处会注明）； - 你给本项目提交过重要的 PR 或 Issue（由作者主观判断，符合的 PR 或 Issue 会打上`important contribution`标签）； - 你长期参与到本项目的维护/推进工作中，如为本项目：提供了有效的周边工具、制作了大量模板等（由作者主观判断）； - 先违反协议后再成为贡献者不适用此项； 3. [邮件联系作者](mailto:pipipi_pikachu@163.com)付费获取独立的商业授权。独立授权价格： - 一年1999元； - 三年2999元； - 永久5499元（不含税）； - 违反协议后被作者找到的，不适用于以上价格； - 建议优先考虑执行AGPL-3.0协议，如需付费获取独立的商业授权，还请注意： - 独立商业授权表示：单独授权您将代码用于商业行为，且不必执行 AGPL-3.0 协议； - 仅授权（而非出售软件或服务），不存在其他“高级版本/付费版本/完整版本”、不提供任何在线服务/技术支持/技术咨询/定制开发、也不提供可直接交付的产品； - 该软件无法开箱即用，至少也需自行接入后端数据读取/存储相关能力。因此，使用本项目需要有最基本的web开发经验（能理解什么是前端&后端、数据从哪来&怎么存、什么是接口、什么是跨域等）； - 授权后，仍禁止将源代码二次售卖、授权、开源或恶意传播； - 授权后，如有需要，作者可提供当前AIPPT相关后台逻辑和当前模板数据以供参考（但都非常简单，无任何核心逻辑，更建议自己实现）； - 请务必提前做好基础调研，判断PPTist是否符合需求，包括：功能（是否能满足业务需求）和开发（是否接受当前技术栈/实现方案）； - 作者没法提供法律文件来证明“我的Github帐号属于我”，如介意这一点，请考虑其他途径； - 不接受[黑名单/耻辱柱](/doc/Blacklist.md)对象通过付费获取独立的商业授权或贡献代码； - 作者倡导异步沟通，**不加微信/QQ/手机号等**，有任何授权相关疑问请邮件联系，谢谢理解； - 单纯的提需求/报bug/询问技术方案等非授权相关咨询，请在 [Issues](https://github.com/pipipi-pikachu/PPTist/issues) 中进行。作者不接受邮件提需求/报bug/询问技术方案。 --- # 🔔 其他说明 ## 什么是 AGPL-3.0 协议 协议的核心要求用通俗的语言解释如下： - **开源义务**：如果你用了 AGPL 的代码，无论你或你的下游怎么使用/修改，都必须把你最终的代码全部完整公开出来（不只是给出修改的部分，也不是说换个框架重写一遍就能和原始代码脱离关系了），并继续以 AGPL 协议开源，保持开源的传染性。 - **网络服务也要开源**：即使你只是用 AGPL 的代码做了一个网站或网络服务，别人通过网络用你的服务时，你也需要遵守上一条**开源义务**。 - **保留版权声明**：你不能删掉代码里原来的作者信息和许可证声明，得告诉大家这代码是从哪儿来的。 - **不能加额外限制**：你不能在 AGPL 代码上加一些限制，比如不让别人再分发代码，或者要求别人付费才能使用代码。 - **免责声明**：作者不保证代码没有 bug，也不对使用后果负责。 详细协议内容见官方文档：[AGPL-3.0 协议](https://www.gnu.org/licenses/agpl-3.0.html)