zhouwei713/luobo-ppt

解决的问题

AI 生成的演示文稿通常以扁平图像（无法编辑）的形式呈现，或者看起来模板化严重，或者文字被压缩到无法阅读，或者在未经允许的情况下重写了原文，亦或是丢失了公式和编号注释。本项目将这些痛点转化为可检查的规则，在您获取文件之前进行严格把控。

工作原理

两条路径共享同一个设计引擎。在美化路径中，它读取现有的 .pptx 并将所有内容提取为结构化的 deck.json（页面内容）和 style.json（颜色、字体、布局）。在生成路径中，它接收主题、文章或脚本并自行编写幻灯片。两条路径都会进入 plan.json（布局规划），然后脚本绘制插图、组装原生 PowerPoint 文件、渲染预览、运行自动检查，并提供五个维度的自我评估。

脚本处理确定性工作（布局、保真度检查、渲染），而 Agent 处理内容理解和审美判断。该项目保证在美化过程中不会丢失原文中的任何一个字符：它存储每个段落并在完成后逐页比较，如果缺少任何内容，会报错并指出页面和句子。它还在大纲设计阶段强制执行每种布局的容量限制（例如，漏斗图最多 5 层，每个标签不超过 26 个字符），从而尽早发现不合适的内容。

渲染预览默认使用 LibreOffice；如果未安装，它会根据布局数据绘制近似效果（约 10 秒内生成 12 页）。它可以在没有任何图像生成模型的情况下运行——背景、装饰和插图均通过程序绘制——并可选择调用 OpenAI、Gemini、Volcano Ark、HiAPI 或任何兼容 OpenAI 的端点以获取更丰富的插图，如果调用失败则回退到程序绘图。对于照片需求，它可以搜索公共图像库（CC0、公有领域、CC BY、CC BY-SA，以及带密钥的 Pexels/Unsplash/Pixabay），裁剪照片以适应布局，并列出来源。它还支持脚本或教学幻灯片的动画展示（卡片和步骤逐一出现），并在幻灯片之间使用淡入淡出过渡；静态预览可以辅以故事板 GIF。

输出始终是原生的、可编辑的 .pptx：文本是真实的文本框，表格是真实的表格，图表是 PowerPoint 原生图表，您可以双击进行编辑。它适用于 PowerPoint、WPS 和 Keynote。

适用人群

适用于任何希望通过 AI 编码 Agent（Claude Code、Codex、Gemini CLI、Cursor、Copilot 或任何支持 SKILL.md 的 Agent）创建或重新设计演示文稿的人。它适合演讲稿视频、文章转幻灯片、需要样式重构的普通工作报告或课件、包含大量公式的科学/数学幻灯片、带有大量截图的 AI 工具教程、需要原生表格/图表的竞争分析和数据审查，以及需要更大最小字号的会议室投影。

亮点

• 两种工作模式：根据主题或文章生成幻灯片，或根据参考图像美化现有的 .pptx——原始文本保持不变。
• 始终生成原生可编辑的 .pptx：真实的文本、真实的表格、可双击编辑的 PowerPoint 图表。
• 14 种内置视觉样式（mint-fresh, business-blue, warm-orange, dark-tech, lavender-soft, paper-notes, black-gold, geo-blocks, cobalt-type, ink-lime, pastel-mist, wave-launch, ink-magazine, swiss-grid），可通过名称选择。
• 严格的保真度 QA：无字符丢失、无溢出、无对比度问题；自我评估从统一性、层级、细节、沟通和节奏五个维度提供具体证据评分。
• 程序化插图——无需任何 AI 图像模型即可工作，并可选择使用商业安全的图像搜索或您自己的照片。
• 公式保留：将公式对象转换为纯文本数学，以便在任何软件中显示和编辑。
• 针对截图（带编号标注）和丰富内容（如时间轴、漏斗图、中心辐射图、2x2 矩阵、SWOT、PEST、波特五力模型和商业模式画布）的特殊布局。
• 支持公司品牌模板（.pptx 或 .potx）：保留母版中的徽标、色条、页脚，使用模板的主题颜色和字体，并自动调整深色或浅色封面的文字颜色。
• 可选的“快速模式”以跳过中间确认步骤；详尽的更新日志展示了持续的改进（例如，处理宽数字、明亮的品牌颜色、手绘线条、按页面锁定手动编辑以及模板读取）。