README.md

---

目录

• 为什么做这个
• 旧 PPTX 模板导入编辑
• 客户端导出可编辑 PPTX
• 能做什么
• 使用流程
• 内置 90+ 风格 Skill
• AI 生图与智能配图
• 字体管理
• 动画支持
• 支持本地 Ollama 模型
• 使用问题汇总
  • 别忘了填写模型配置
  • 如何添加图片、视频和 AI 配图到 PPT 中
  • 关于预览模式
  • 关于导出
• 未签名应用打不开的问题(mac已损坏等问题)
• 需求反馈
• 赞助支持
• 参考
• 赞助者
• 贡献者
• License

---

🎯 为什么做这个

让 AI HTML PPT 成为可能。

每次要做分享/汇报/路演/答辩就头疼，纠结PPT排版占了大半时间

市面上AI PPT工具虽然多，但大多生成的是固定格式文件，想微调样式或加入自己想要的动画演示都很麻烦

所以自己写了一个Html版的PPT生成器——初衷是给自己做个工具使用

生成的是HTML版PPT：打开即预览、无需软件、一个浏览器搞定，还能随心改样式/加动效/插代码/导出分享

📥 旧 PPTX 模板导入编辑，接近 100% 还原

已有的 PPTX 模板、历史汇报或客户文件，可以直接导入客户端继续编辑。常规 PPTX 导入后可实现接近 100% 的视觉与结构还原，并转换为应用内可继续拖拽、调整、AI 修改和版本管理的页面；导入时还会提取原文件风格，供后续创建和复用。

PPTX 解析与结构化编辑数据转换均由 Oh My PPT 纯自研。复杂形状、图表、表格、动画、文本混排与极端排版仍在持续优化，实际效果会受原文件的 PowerPoint 特性、字体和素材复杂度影响。

📤 客户端导出为可编辑 PPTX，接近 100% 还原

在客户端完成创作或编辑后，可直接导出为 PowerPoint / Keynote 中继续修改的真实 PPTX。常规场景下，导出文件的视觉与结构还原度接近 100%，并尽量保留文字、图片、颜色、公式和基础布局。

HTML 到可编辑 PPTX 的生成与排版处理由 Oh My PPT 纯自研。文字重叠、混排、复杂图表、表格、形状和动画仍在持续优化。

✅ 能做什么

• 📥 旧 PPTX 模板导入编辑，接近 100% 还原 — 将已有 PPTX 模板、历史文件导入客户端，转为可继续拖拽、调整、AI 修改和版本管理的页面；底层解析与结构化转换均为纯自研
• 📤 客户端导出可编辑 PPTX，接近 100% 还原 — 在客户端完成创作或编辑后，导出为 PowerPoint / Keynote 中可继续修改的真实 PPTX；底层生成与排版均为纯自研，复杂对象仍持续优化
• 💬 主题创作 — 填写主题、详细描述和页面设置，AI 自动规划大纲、配色与排版，生成完整演示稿
• 🔀 多任务生成 — 可同时提交多个生成任务并行执行，不用等一个完成再创建下一个，后台生成完成时自动弹出通知
• 📐 多尺寸 / 多内容格式画布 — 不只支持传统 PPT 尺寸，也支持宽屏演示、4:3 投屏、竖屏 9:16、竖版 3:4、方图 1:1、小红书图文等格式，生成、预览、编辑和导出都会保留真实比例
• 📄 从文档创建 — 也支持上传 txt、md、csv、docx 文档，自动整理主题、页数和详细描述，生成时继续参考原文件内容生成创意PPT
• 🌐 HTML 编辑 — 导入单个 HTML 文件后可在应用内直接编辑和保存，支持 AI 修改、素材添加、历史管理、预览和导出
• 🧱 模板库与模板创建 — 可将已生成或已编辑的演示保存为模板，也支持 PPTX 导入为模板，并可复用模板创建新的 PPT 会话
• 🎨️ 图片识别生成风格与大纲 — 支持上传截图/设计稿，自动识别视觉特征并生成独特风格与演示大纲(需要支持多模态模型的AI)
• 🖼️ AI 生图与智能配图 — 创建时可开启自动配图，AI 会根据当前页内容、版式留白和所选风格按需生成插画、背景与视觉素材；不会为了配图而机械地给每页塞图
• ✨ 编辑页生图工作台 — 可根据当前页标题和大纲生成提示词，指定补充描述与图片尺寸后生图；结果可预览、插入画布或一键设为页面背景
• 🏷️ 支持生图的风格筛选 — 风格库会标识可生图的风格，可筛选后使用与页面视觉方向一致的配图
• 🔒 本地优先 — 会话、源文档、素材和生成结果保存在自己的电脑；不需要 Oh My PPT 账号或平台云端。调用你配置的 AI / 生图服务时，相关请求会发送给该服务商
• 🔤 字体管理 — 内置 14 款精选 Google 字体（含中文），支持上传本地字体，创建时可分别指定标题和正文字体，也可交给 AI 自动匹配
• 🎨 内置 90+ 风格SKILL — 极简白、赛博霓虹、包豪斯、日式简约、小红书白… 也支持自定义风格
• ✏️ 对话式修改 — 对着某一页说"标题换个颜色""加个数据图表"，精准修改不用重做
• 🖱️ 可视化编辑 — 一切可见元素皆可拖拽和调整大小，一切元素皆可检选并让 AI 修改
• 📸 插入图片和视频 — 编辑模式下直接上传图片和视频到页面，支持从素材库或本地文件添加，也能与 AI 生成图片混用
• 📋 复制元素 — 一键复制任意元素（文字、图片、视频等），自动偏移并独立可编辑
• ↩️ 撤销和重做 — 编辑过程中随时撤销和重做操作，最后再统一保存为版本记录
• 🗑️ 删除元素 — 支持删除任意元素，也支持快捷键快速删除
• 🖥️ 演示模式 — 一键进入全屏演示播放，键盘左右键或点击切换页面
• 📝 演讲稿生成 — 支持为整套幻灯片或当前页生成演讲稿，内置正式演讲、轻松对话、叙事风格和自定义风格
• 🎬 动画演示 — 支持 16+ 种页面切换动画，也支持基于 Anime.js v4 的基础整元素动画
• 🎞️ 单个元素动画设置 — 编辑时可选中文字、图片、图表等单个元素，设置入场、强调或退出效果，并调整自动/点击触发、时长和方向
• 🧮 数学公式渲染 — 支持常见 LaTeX 公式显示，适合课堂、教学、技术分享等场景
• 📄 其他格式导出 — 支持 PDF、批量 PNG、PNG 长图和 MP4 视频
• 🏷️ 会话管理 — 会话列表可区分 AI 创建和 PPTX 导入，也支持修改演示稿名称
• 🧩 更稳的页面生成 — 生成时会按所选画布尺寸与内容高度预算组织页面，减少内容溢出
• 🔄 历史版本回退 — 自动保存每次修改记录，支持任意版本一键回退，改错了也不怕，随时回到满意的状态
• 📦 一键打包 — 将 HTML 演示稿打包为单个可执行文件，双击即可打开预览，无需安装任何软件（有浏览器就行）
• 💾 会话生成的创意PPT导入导出 — 编辑页面一键导出会话生成的创意 PPT，另一台电脑导入后可继续二次编辑，跨设备协作无缝衔接

🔄 使用流程

💡 导入旧 PPTX 模板继续编辑，或选择创作方式 → 确认主题 / 资料 / 页数 / 尺寸格式 / 风格 / 字体 / 配图 → AI 生成 HTML 演示稿 → 预览、演示、编辑 → 从客户端导出接近 100% 还原的可编辑 PPTX、PDF / PNG / PNG 长图 / MP4 / HTML 打包文件

首页支持几种常用入口：

• 主题创作：填写主题、尺寸格式和详细描述，生成完整演示稿、竖版内容、方图或小红书图文。
• 对话创作：先通过多轮对话梳理主题、资料、受众、结构和每页重点，适合需求还不够清晰、资料较复杂，或者需要先共同推敲大纲的场景。
• 上传文档解析：上传 txt、md、csv、docx 等文件，让应用先整理主题、页数和详细描述，生成时继续参考原文件内容。
• 从模板创建：在模板页选择已保存的模板，可直接复制为可编辑 PPT 会话，也可以输入新主题/大纲或上传文档解析后，沿用模板版式、配色和视觉节奏重新生成内容。

文档解析会检查大纲和页数是否一致：例如大纲里写了 5 页，创建页也会尽量填成 5 页。你的文档只会保存在本地工作目录中，应用会把它整理成 AI 更容易读取的文本。

如果已经有现成的旧 PPTX 模板，也可以在首页点击「导入 PPTX」。常规文件可接近 100% 还原为应用里的可编辑页面，继续预览、调整位置和对话修改。

无论是导入后编辑的模板，还是客户端新创建的演示稿，都可以从客户端导出为可在 PowerPoint / Keynote 中继续编辑、常规场景还原度接近 100% 的 PPTX。

也可以将现有会话保存到模板库，或在模板页导入 PPTX 作为模板，后续反复复用同一套结构和视觉风格创建新的 PPT 会话。

如果你已在「设置」中配置并验证生图模型，创建时可开启「启用生图」。选择带有「支持生图」标识的风格后，生成过程会在真正需要视觉素材的位置，结合页面内容和风格方向自动配图。自动配图会增加生成耗时；关闭它时，仍可在编辑页按需手动生图。

生成后可以进入预览或演示模式，也可以在编辑页继续拖拽元素、插入图片/视频、对话修改、回退历史版本，并为整套幻灯片或当前页生成演讲稿。

🎨 内置 90+ 风格 Skill

想制作自己的风格 Skill，可以使用官方风格生成包：arcsin1/style-generate-skill。它适合把参考设计、配色和排版要求整理成可导入 Oh My PPT 的风格包。

🖼️ AI 生图与智能配图

生图能力分为两个入口，分别适合整套生成和局部补图：

使用场景	怎么使用	结果
创建整套演示稿	在「设置 → 生图模型」新增并验证模型；创建页勾选「启用配图生成」，选择一个带「支持生图」标识的风格	AI 仅在合适的视觉位置自动生成插画、背景或视觉元素，并保留文字安全区与风格一致性
编辑已有页面	打开编辑页的生图面板，参考当前页内容生成提示词或自行填写，选择模型和尺寸后生成	可预览生成结果，插入画布继续排版，或直接设为当前页背景

支持配置多个生图服务，并在创建或编辑时选择要使用的模型。当前内置 Provider 包括即梦 3.0 / 4.0、Agnes AI、Seedream、硅基流动、Gemini，以及 OpenAI 兼容的图片接口。不同模型的可用尺寸、速度、成本和内容策略由对应服务商决定。

推荐先在「设置 → 生图模型」完成一次真实测试：应用会按默认分辨率生成测试图片，验证成功后才能保存该配置。文本生成模型与生图模型是两套独立配置；例如本地 Ollama 可负责文字生成，但自动配图仍需单独配置支持生图的服务。

自动配图不会改变你选择的页面尺寸，也不会覆盖手动上传的图片。所有成功生成的图片会归档到当前会话的本地素材目录，可继续编辑、替换、导出或随会话迁移。请注意，提交生图时提示词和必要的页面语义会发送到你所选择的生图 Provider；请按该 Provider 的隐私政策和内容政策使用。

🔤 字体管理

内置 14 款精选 Google 字体（含中文字体），同时支持上传本地 .woff2 字体文件，可自定义字体名称、分类（无衬线/衬线/手写/等宽等）、用途（标题/正文）和语言类型（拉丁/CJK）。

创建演示稿时，可以分别指定标题字体和正文字体，也可以交给 AI 根据演示主题和风格自动匹配最合适的字体组合。导出 PPTX 时，已使用的字体会自动嵌入到文件中，确保在其他电脑上打开时字体显示一致。

🎬 动画支持

Oh My PPT 的页面是 HTML 幻灯片，支持 16+ 种页面切换动画，并内置本地 Anime.js v4 动画运行时。生成或编辑页面时，可以让 AI 为标题、数据卡片、图片、图表容器、步骤模块等整块元素添加演示动画。

除了由 AI 自动添加动画，也可以在编辑模式中直接选中单个元素，为它设置入场、强调或退出效果，并调整自动播放或点击触发、动画时长和进入方向。

动画更偏向真实演讲场景：让内容按讲述节奏逐步出现，而不是一页内容一次性全部铺开。适合汇报、路演、课堂演示和产品讲解。

目前支持这些常用表达：

• 淡入：模块出现时轻量过渡。
• 位移入场：从上、下、左、右短距离滑入，适合标题、卡片和列表。
• 缩放强调：关键数字或结论卡片轻微放大后回落。
• 错峰展示：多张卡片或多条要点按顺序依次出现。
• 点击逐条出现：演示时通过点击逐步展开内容，方便按讲述节奏推进。

更推荐使用“整个元素”的动画，而不是把文字拆成很多碎片逐字乱动。这样画面更稳、可读性更好，也更适合导出和二次编辑。动画主要用于引导视线和表达层级，不建议做复杂时间线、高频闪烁、无限循环或大幅抖动。

🦙 支持本地 Ollama 模型（OpenAI 兼容）

项目支持通过 OpenAI 兼容协议 接入本地 Ollama。

在「设置」页面这样填写即可：

• provider: openai
• base_url: http://127.0.0.1:11434/v1
• model: 你本地拉取的模型名（例如 qwen2.5-coder:14b），建议支持 14B+（或云端强模型）
• api_key: 任意非空字符串（例如 ollama）

说明：

• Ollama 默认不校验 API Key，但应用侧会做“非空”校验，所以不能留空。
• 推荐使用 14B+（或云端强模型）做接入生成。
• OpenAI 官方端点不会携带非标准的 thinking 参数，避免返回 400 Unknown parameter；配置其他 OpenAI 兼容 base_url 时仍会请求关闭 thinking，避免工具调用等多轮链路丢失 reasoning_content。
• Ollama 配置用于文本生成、文档解析和编辑对话；需要生图或自动配图时，请在「设置 → 生图模型」另行配置支持图片生成的 Provider。

关于使用问题汇总

别忘了填写模型配置

推荐：deepseek v4、kimi、doubao、qwen、glm、xiaomi-mimo、minimax等等更多国产模型、以及gpt、claude、等等国外模型

在「设置 → 文本模型」页面填写用于创作、解析和编辑的模型配置，否则无法生成演示稿。

若要使用 AI 生图或自动配图，再到「设置 → 生图模型」添加对应 Provider 的完整 JSON 配置并点击「验证」。验证会实际生成一张测试图片；验证成功后才能保存该生图模型，随后即可在创建页和编辑页中选择使用。

如何添加图片、视频和 AI 配图到 PPT 中

本地图片和视频会复制到当前会话的本地素材目录。编辑页既可以从素材库或本地文件插入，也可以打开生图面板：让 AI 根据当前页内容补全提示词，或输入自己的描述，生成后插入画布或设为背景。

注：Oh My PPT 不会把本地素材上传到自己的云端；但主动调用 AI 生图时，请求会发送到你配置的生图服务商。

关于预览模式

支持键盘（左右键）切换，支持演示模式，全屏演示模式，ESC退出演示模式

关于导出

目前支持五种导出方式，另可将 HTML 演示稿打包为独立打开的文件：

• PDF：适合直接分享、归档和打印。
• PNG：一键批量导出所有页面图片，适合插入文档、Notion、公众号或社媒内容。
• PNG 长图：将整套页面纵向拼接成一张长图，适合发社媒、聊天分享、长文档预览和移动端阅读。
• 可编辑 PPTX：采用纯自研导出底层，导出为可在 PowerPoint / Keynote 中继续编辑的文件。常规场景还原度接近 100%，会尽量保留文字、图片、颜色、公式和基础布局；文字重叠、混排、复杂图表、表格、形状和动画仍持续优化。
• MP4：导出为视频文件，适合发布到社媒、发送给客户或在不方便播放 PPT 的场景中使用。
• HTML 打包文件：将演示稿和运行资源打包，双击即可在浏览器中打开预览和演示。

📦 未签名应用打不开的问题

目前发布包可能还没有进行系统级代码签名，所以 macOS 或 Windows 第一次打开时可能会出现安全提示。这个提示通常不是应用损坏，而是系统对“未签名/未公证应用”的默认拦截。

macOS

如果 macOS 提示“无法打开”“已损坏”“无法验证开发者”，可以按下面任意一种方式处理。

方式一：右键打开

1. 打开「访达」或「应用程序」文件夹。
2. 找到 OhMyPPT.app。
3. 右键点击应用，选择「打开」。
4. 在弹窗里再次点击「打开」。

这种方式通常只需要做一次，之后就可以正常双击打开。

方式二：清除隔离属性

如果右键打开仍然不行，可以在终端执行：

xattr -cr /Applications/OhMyPPT.app

然后重新打开应用。

如果你把应用放在了其他目录，请把命令里的路径替换成实际路径，例如：

xattr -cr ~/Downloads/OhMyPPT.app

Windows

Windows 可能会因为安装包未签名而触发 SmartScreen 提示，例如“Windows 已保护你的电脑”。这是未签名应用常见的系统提示。

处理方式：

1. 在提示窗口点击「更多信息」。
2. 确认应用名称是 OhMyPPT。
3. 点击「仍要运行」。

如果下载后被浏览器或杀毒软件拦截，可以先确认安装包来自本项目的 GitHub Releases 页面，再选择保留或允许运行。

建议只从官方 Release 地址下载安装包，避免使用第三方转存文件。

🙌 需求反馈

如果你有新需求、功能建议或发现问题，欢迎在仓库提交 Issue或者国内加入反馈群。

  |   📱 微信群   |   💬 QQ群

我会持续跟进并优化体验。

赞助支持

目前主要由我一人开发和维护，如果您觉得 Oh My PPT 对您有所帮助，可以赞助支持一下（不要超过 ¥5，以及备注好你的 GitHub ID），谢谢。

 

参考

• @arcsin1/pptx2json — Oh My PPT 纯自研的可编辑 PPTX 导入底层，用于解析 PPTX 并转换为可继续编辑的结构化真实数据；后续会持续完善复杂形状、图表、表格、动画等还原能力。
• @arcsin1/html2pptx — Oh My PPT 纯自研的可编辑 PPTX 导出底层，用于将 HTML 转换为可继续编辑的真实 PPTX 文件；后续会持续完善复杂形状、图表、表格、动画等还原能力。
• arcsin1/style-generate-skill — Oh My PPT 官方风格生成 Skill，用于把参考设计、配色、排版和场景要求整理成可导入应用的风格包。
• ui-ux-pro-max-skill
• html-ppt-skill

💖 赞助者

特别感谢每一位支持过 Oh My PPT 的朋友！你们的鼓励和赞助是持续迭代的最大动力。

查看 SponsorsList.md 获取完整赞助者列表。

贡献者

Thanks to all contributors!

License

This project is licensed under the Apache License 2.0 © 2026 arcsin1 <zy19931129@gmail.com>.