EditDeck 是一个开源项目,目标是解决做幻灯片时步骤割裂的问题:梳理故事、撰写页面内容、生成视觉、导出 PPT,若需要真正可编辑的演示文稿往往还得重新搭建一遍。EditDeck 将这一过程变为一条连续的工作流。
【用途】 从纯语言需求出发,生成结构化 PPT 大纲与页面级内容;将每页幻灯片渲染为视觉图像并打包成标准 pptx;可从生成的运行目录或已有幻灯片图像继续重建可编辑 pptx。适合希望“先快速拿到视觉草稿,再继续做到可编辑、可用”的工作方式。
【主要能力】
- 单一配置入口:项目默认只读取 config/app.yaml。
- 双工作流支持:从零生成,或从已有图像重新生成可编辑 PPT。
- 完整可编辑流水线:图像解析、元素提取、占位符匹配和浏览器导出均已接通。
- 跨平台支持更完善:浏览器路径可留空,运行时从显式参数、环境变量和系统 PATH 自动检测。
- 覆盖简单:CLI 参数和 Web/API 请求参数均可在运行时覆盖配置文件。
- 提供 Web UI、CLI 和 HTTP API 同一工作流。
【使用方式】
- 安装依赖。
- 编辑配置:修改 config/app.yaml。模板中 api_key 字段默认留空;可继续使用文件中已有的 base_url 地址;更完整的字段参考见 config/README.md。
- 选择运行方式:
- 启动 Web 服务器,浏览器打开访问;Web 入口由 webapp/main.py 提供,适合直接在页面上填写需求、样式和运行参数。
- 直接使用 CLI。 样式输入支持两种模式:style_description(文本)或 style_template(参考图),二选一。 可通过 source_files(多文件)上传参考文件,支持 .txt / .md / .pdf / .docx。 复刻模式下可通过 replica_images(多文件)上传源幻灯片图像,支持 .png / .jpg / .jpeg / .webp。 常用 CLI 场景示例:
- 仅生成图像和标准 PPT;
- 带需求与补充参考文档生成 PPT(支持 pdf、docx、txt、md 等);
- 带样式和上传参考文件生成;
- 生成标准 PPT 后继续生成可编辑 PPT;
- 从已有运行目录继续生成可编辑 PPT;
- 直接从已有图像生成可编辑 PPT。 常用参数: --config-file:指定配置文件,默认 config/app.yaml --style-description:通过文本指定样式 --style-template:通过图像指定样式 --source-file:上传参考文件(可重复) --editable-ppt:图像生成后继续生成可编辑 PPT -edit / --edit:启用当前可用的可编辑资产匹配后端 --mineru-api-key:按需覆盖 mineru.api_key --force-reextract-assets:强制重新提取元素 --disable-asset-reuse:防止单个资产在多个占位符间重复使用 注意:--style-description 与 --style-template 互斥;CLI 参数优先于 YAML 配置。
HTTP API 主要端点: GET /api/health:健康检查 POST /api/generate:同步生成 POST /api/generate/start:异步生成 POST /api/editable/start:从已有 run_id 启动可编辑 PPT 任务 GET /api/generate/status/{job_id}:查询异步任务状态 若要在生成阶段直接产出可编辑 PPT,请求中需包含:generate_editable_ppt=true 和 asset_backend=edit。 可编辑 PPT 的资产提取以及仅图像(扫描)PDF 参考文件解析需要 MinerU。当 config/app.yaml 中没有可用的 mineru.api_key 时,需在请求中显式传入 mineru_api_key。
【配置】 项目保留一个主配置文件。配置分区包括: app:输出目录和默认幻灯片页数 models.text:大纲和文案生成所用的模型 models.editable:可编辑 PPT 生成流水线 models.image:图像生成模型 mineru:页面元素解析与资产提取 回退规则:
- models.image.api_key 为空时,回退到 models.text.api_key
- models.editable.base_url 为空时,回退到 models.text.base_url
- models.editable.api_key 为空时,回退到 models.text.api_key
- mineru.api_key 为空时,进一步回退到 models.editable.api_key,再回退到 models.text.api_key models.editable.browser_path 可留空,运行时依次尝试显式参数、环境变量和系统 PATH。完整示例和字段参考见 config/README.md。
【适用场景】 需要从需求文本快速生成幻灯片视觉草稿并继续产出可编辑 PPT 的个人或团队;希望通过统一配置协调文本模型、图像模型和解析服务的开发者;需要将同一流程接入系统(通过 HTTP API)的工程场景。项目方另设公益站点 editdeck.top 供免费试用,主域不可用时可用备用地址 http://118.195.198.236/;项目加星后每个用户获得 5 次免费生成,每日签到额外增加 1 次免费生成;因服务器成本限制,可能偶尔出现意外错误,欢迎反馈。
【限制与已知问题】 可编辑 PPT 的资产提取和仅图像 PDF 解析依赖 MinerU,缺少可用 mineru.api_key 时需显式传入。浏览器执行或下载失败时,可先留空 models.editable.browser_path;若需显式指定浏览器,可传 --editable-browser-path,或设置环境变量 EDITABLE_PPT_BROWSER_PATH、CHROME_PATH、GOOGLE_CHROME_BIN、CHROMIUM_PATH、BROWSER_PATH;系统无可用浏览器时运行 playwright install chromium。占位符替换异常时,可增大 mineru.max_refine_depth、启用 --force-reextract-assets、启用 --disable-asset-reuse。仅想复用已有资产时可用 --assets-json,但目前最适合在单图模式下直接指定已有的 assets.json。其余具体功能、收费、价格、平台或效果细节,资料中暂未提供。
【展示案例】 项目展示采用左右对比形式(参考 PPTAgent 风格):左侧为仅图像结果,右侧为完全可编辑重建结果。示例需求包括:英文的 AI Productivity Playbook for Knowledge Teams;《AI 客服知识库升级方案》六页 PPT,16:9 宽屏深色科技风,主色深海军蓝、冷青蓝、电光蓝,辅以高亮青色数据强调色,背景深蓝黑渐变、细密网格、弱发光线条和玻璃质感面板,字体采用思源黑体/苹方/微软雅黑体系;《企业 Copilot 落地的双引擎实施路线图》六页 PPT,面向集团管理层,16:9 宽屏学术商务风,以微软红蓝为主色调,搭配浅灰与蓝灰底色,思源黑体/苹方/微软雅黑体系,顶部标题栏+左侧纵向时间轴+右侧斜向分区双引擎构图,卡片统一 18–22px 圆角与轻量阴影。