简体中文 | English

🎨 PPTist

PowerPoint-ist（/'pauəpɔintist/），一个基于 Web 的在线演示文稿（幻灯片）应用，还原了大部分 Office PowerPoint 常用功能，支持文字、图片、形状、线条、图表、表格、视频、音频、公式几种最常用的元素类型，可以在 Web 浏览器中编辑/演示幻灯片。

在线体验地址👉：https://pipipi-pikachu.github.io/PPTist/

✨ 项目特色

易开发：基于 Vue3.x + TypeScript 构建，不依赖UI组件库，尽量避免第三方组件，样式定制更轻松、功能扩展更方便。
易使用：随处可用的右键菜单、几十种快捷键、无数次编辑细节打磨，力求还原桌面应用级体验。
功能丰富：支持 PPT 中的大部分常用元素和功能，支持AI生成PPT、支持多种格式导出、支持移动端基础编辑和预览...

👀 前排提示

本项目是一个 “Web 幻灯片应用” ，而不是 “低代码平台”、“H5 编辑器”、“图片编辑器” 、“白板应用”等。
本项目的目标受众是有Web幻灯片开发需求的开发者，需要有基础的web开发经验，提供的链接只是一个演示地址，不提供任何在线服务。你不应该直接将本项目作为工具使用，也不支持开箱即用。如果你只是需要一个服务或工具，可以选择更优秀和成熟的产品，例如：Slidev、revealjs 等。
这里总结了一些常见问题，第一次提 Issues 和 PR 时，务必提前阅读此文档。

🚀 项目运行

npm install

npm run dev

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

注意：如果你将本项目部署在自己的服务器上，发现无法初始化成功，那是因为初始化的数据是放在作者私人对象存储中的，不对外开放，你需要把数据转移到自己的服务器/对象存储服务/数据库/前端本地

🐳 Docker 部署

打包成 nginx 静态镜像。镜像不含任何环境相关的值和密钥，所有配置在容器启动时注入，因此同一份镜像可以跑在任何环境，改配置不需要重新构建。

构建

docker build --platform linux/arm64 -t pptist:2.0.0 .

--platform 决定目标机器架构，先用 uname -m 确认：aarch64 → linux/arm64，x86_64 → linux/amd64。架构不匹配的话，对方 docker load 之后只会得到一句 exec format error。

运行

docker run -d --name pptist -p 8080:80 \
  -e SPEAKING_API_HOST=https://your-api-host \
  -e AZURE_SPEECH_KEY=xxxxxxxx \
  -e AZURE_SPEECH_REGION=eastasia \
  -e TZ=Asia/Shanghai \
  pptist:2.0.0

配置项

变量	必填	说明
`SPEAKING_API_HOST`	✅	后端 API 地址。必须是浏览器能访问到的地址（公网域名或 `http://服务器IP:8000`），不能填容器名。不传会回落到代码内置的默认域名
`AZURE_SPEECH_KEY`	✅	Azure Speech 密钥，前端 TTS 朗读用。不传则朗读功能直接报错
`AZURE_SPEECH_REGION`	✅	Azure 区域，如 `eastasia`
`TZ`		时区。不传则容器为 UTC，只影响 nginx 日志时间

⚠️ AZURE_SPEECH_KEY 会写进浏览器可读的 /config.js，任何人都能取走。这是既有设计（前端直连 Azure）遗留的问题；改成运行时注入只解决了灵活性，没有解决这一点。

验证

curl http://localhost:8080/config.js

三个值都应该非空。为空说明对应的环境变量没传进去，输出里自带说明文字。

改配置

用新的 -e 参数重跑容器即可，不需要重新构建镜像：

docker rm -f pptist
docker run -d --name pptist -p 8080:80 -e SPEAKING_API_HOST=... pptist:2.0.0

原理：nginx 启动时用 envsubst 把 config.js.template 渲染成 /config.js，页面在 app bundle 之前同步加载它。代码的读取优先级是 window.__APP_CONFIG__ > import.meta.env.VITE_* > 硬编码兜底，所以本地 npm run dev 和原有的构建部署方式行为完全不变。

📚 功能列表

基础功能

历史记录（撤销、重做）
快捷键
右键菜单
导出本地文件（PPTX、JSON、图片、PDF）
导入导出特有 .pptist 文件
打印
AI生成PPT

幻灯片页面编辑
页面添加、删除
页面顺序调整
页面复制粘贴
幻灯片分节
背景设置（纯色、渐变、图片）
设置画布尺寸
网格线
标尺
画布缩放、移动
主题设置
提取已有幻灯片风格
演讲者备注（富文本）
幻灯片模板
翻页动画
元素动画（入场、退场、强调）
选择面板（隐藏元素、层级排序、元素命名）
页面和节点类型标注（可用于模板相关功能）
查找/替换
批注

幻灯片元素编辑
元素添加、删除
元素复制粘贴
元素拖拽移动
元素旋转
元素缩放
元素多选（框选、点选）
多元素组合
多元素批量编辑
元素锁定
元素吸附对齐（移动和缩放）
元素层级调整
元素对齐到画布
元素对齐到其他元素
多元素均匀分布
拖拽添加图文
粘贴外部图片
元素坐标、尺寸和旋转角度设置
元素超链接（链接到网页、链接到其他幻灯片页面）

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

图片
裁剪（自定义、按形状、按纵横比）
圆角
滤镜
着色（蒙版）
翻转
边框
阴影
替换图片
重置图片
设置为背景图

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

线条
直线、基础折线/曲线
颜色
宽度
样式（实线、虚线、点线）
端点样式

图表（柱状图、条形图、折线图、面积图、散点图、饼图、环形图、雷达图）
图表类型转换
数据编辑
背景填充
主题色
坐标轴/坐标文字颜色
网格颜色
堆积模式、平滑曲线等

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

视频
预览封面设置
自动播放

音频
图标颜色
自动播放
循环播放

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

幻灯片放映
画笔工具（画笔/形状/箭头/荧光笔标注、橡皮擦除、黑板模式）
全部幻灯片预览
触底显示缩略图导航
计时器工具
激光笔
自动放映
演讲者视图

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

🎯 开发

目前没有完整的开发文档，但下面这些文档可能会对你有一些帮助：

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

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

📄 版权声明/开源协议

🧮 商业用途

本项目禁止闭源商用，如果你希望将PPTist用于商业项目盈利，请尊重开源，严格遵循 AGPL-3.0 协议，回馈开源社区（这是作者倡导的）；
如果你因为任何原因，必须要闭源商用，无法执行 AGPL-3.0 协议，可以选择：
1. 使用早期的 Apache 2.0 协议版本（该版本最后更新时间为2022年5月，目前已停止维护，点击此处可下载代码）；
2. 成为项目的重要贡献者，包括：
  - 你的代码被本项目作为依赖引用，包括：npm安装、script/style等文件引用、代码片段引用（引用处会注明）；
  - 你给本项目提交过重要的 PR 或 Issue（由作者主观判断，符合的 PR 或 Issue 会打上important contribution标签）；
  - 你长期参与到本项目的维护/推进工作中，如为本项目：提供了有效的周边工具、制作了大量模板等（由作者主观判断）；
  - 先违反协议后再成为贡献者不适用此项；
3. 邮件联系作者付费获取独立的商业授权。独立授权价格：
  - 一年1999元
  - 三年2999元
  - 永久5499元（不含税）
  - 违反协议后被作者找到的，不适用于以上价格
建议优先考虑执行AGPL-3.0协议，如需付费获取独立的商业授权，还请注意：
- 独立商业授权表示：单独授权您将代码用于商业行为，且不必执行 AGPL-3.0 协议；
- 仅授权（而非出售软件或服务），不存在其他“高级版本/付费版本/完整版本”、不提供任何在线服务/技术支持/技术咨询/定制开发、也不提供可直接交付的产品；
- 该软件无法开箱即用，至少也需自行接入后端数据读取/存储相关能力。因此，使用本项目需要有最基本的web开发经验（能理解什么是前端&后端、数据从哪来&怎么存、什么是接口、什么是跨域等）；
- 授权后，仍禁止将源代码二次售卖、授权、开源或恶意传播；
- 授权后，如有需要，作者可提供当前AIPPT相关后台逻辑和当前模板数据以供参考（但都非常简单，无任何核心逻辑，更建议自己实现）；
- 请务必提前做好基础调研，判断PPTist是否符合需求，包括：功能（是否能满足业务需求）和开发（是否接受当前技术栈/实现方案）；
- 作者没法提供法律文件来证明“我的Github帐号属于我”，如介意这一点，请考虑其他途径；
- 不接受黑名单/耻辱柱对象通过付费获取独立的商业授权或贡献代码；
- 作者倡导异步沟通，不加微信/QQ/手机号等，有任何授权相关疑问请邮件联系，谢谢理解；
- 提需求/报bug/询问技术方案等非授权相关咨询，请在 Issues 中进行。

🔔 其他说明

什么是 AGPL-3.0 协议

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

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

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

README_zh.md 13 KB Lịch sử Raw