LearnPrompt/humanize-ppt
AST-based outline director for human-centered AI presentation workflows.
Humanize PPT – AI驱动的“可讲”幻灯片演示文稿
是什么 – Humanize PPT 是一个小型基于 Python 的编排层，将原始材料（Markdown、笔记、数据）转化为 可演示 的幻灯片文稿。它本身不渲染视觉设计；而是决定 故事的流动（即“AST”——观众状态转移大纲），判断哪些页面需要图像、SVG 图表或短视频，并将这些决策交给下游渲染技能（HTML 幻灯片生成器、原生 PowerPoint 导出器、Remotion 视频生产器等）。渲染完成后，它会运行自动 演示检查，标记出“好看但无法讲解”的幻灯片（例如，被徽章遮挡的文字、缺少演讲者笔记），并生成修复提示供渲染器使用。
核心理念
| 概念 | Humanize PPT 的作用 |
|---|---|
| AST 大纲 | 解析源材料，生成 JSON 计划（slide_plan.json），记录每页幻灯片的观众初始状态、目标状态及幻灯片意图。 |
| 视觉增强 | 为每页幻灯片判断是否需要图像、确定性 SVG 图表或 Remotion 视频，并将请求（提示词 + 目标路径）写入计划。实际资产由插件技能如 baoyu-image-gen（本地 Codex CLI）或 remotion-video-production 生成。 |
| 风格画廊 | 在大纲确定前，可让渲染器生成 ≥4 个封面页候选，让用户在不承诺完整文稿的前提下选择视觉风格。 |
| 演示检查 | 下游渲染器完成后，Humanize PPT 扫描输出结果，与 AST 计划对比，自动报告“失败”幻灯片（如文字溢出、徽章遮挡文字、缺少演讲者笔记）。它会生成 fix_prompt.md，可反馈给渲染器进行第二次运行（最多 3 次迭代）。 |
| 演示模式 | 生成一个轻量级 HTML 演讲者外壳（presenter-shell.html），显示当前幻灯片、计时器、演讲者笔记、下一页预览和幻灯片地图，让你在最终文稿渲染前即可进行排练。 |
如何融入 AI 代理工作流
- 作为技能安装 – 像 Claude‑Code、Codex 或 Hermes 这样的代理可通过一行命令添加该技能（
npx skills add LearnPrompt/humanize-ppt）。 - 向代理发出指令 – “使用 Humanize PPT 将此 Markdown 转为中文 PPT，然后用
guizang-ppt-skill原生渲染，用baoyu-image-gen配图，用 Remotion 制作视频。” - Humanize PPT 运行 – 它创建 AST 计划，生成简要说明（
guizang-production-prompt.md、ppt-master-production-prompt.md等），并交给选定的渲染器。 - 渲染器生成文稿 – 生成 HTML 幻灯片集、原生
.pptx文件或一组 MP4 视频。 - 自动 QA – Humanize PPT 读取渲染文件，运行三轮检查，返回简洁报告（
qa_report.md）和任何修复提示。 - 迭代或演示 – 可将修复提示反馈给渲染器，或直接跳转到演讲者外壳进行排练。
主要组件（如仓库所述）
scripts/humanize_ppt.py– CLI 入口点。接收源 Markdown、输出文件夹、标题、渲染器选择、风格标志等。slide_plan.json– 机器可读的计划，列出每页幻灯片、其 AST 状态、媒体槽位和任何风格选择。presenter-shell.html– 与任何渲染文稿兼容的轻量级 HTML 演讲者外壳；显示幻灯片、计时器、演讲者笔记和导航。qa_report.md/fix_prompt.md– 人类可读的诊断信息和向下游渲染器提出修复问题的精确提示。
下游技能生态系统（仓库列为完整流程所需）
| 技能 | 渲染内容 | 仓库 |
|---|---|---|
guizang-ppt-skill |
中文原生 PPT（杂志 / 瑞士风格） | https://github.com/op7418/guizang-ppt-skill |
frontend-slides |
英文 HTML 幻灯片文稿（视口安全） | https://github.com/zarazhangrui/frontend-slides |
beautiful-html-templates |
英文多模板 HTML 文稿 | https://github.com/zarazhangrui/beautiful-html-templates |
ppt-master |
完全可编辑的 .pptx（DrawingML、笔记、过渡效果） |
https://github.com/hugohe3/ppt-master |
remotion-video-production |
每页解释性 MP4 视频 | (Remotion 生态系统) |
baoyu-image-gen |
本地 Codex‑CLI 图像生成（无需 API 密钥） | https://github.com/JimLiu/baoyu-skills/tree/main/skills/baoyu-image-gen |
快速入门示例（来自 README）
# 为代理安装技能
npx skills add LearnPrompt/humanize-ppt -g
# 向代理发出一条指令完成整个流程
"用 humanize-ppt 把这份材料做成中文演讲 PPT：先出 AST 大纲和每页意图，
按大纲调 guizang-ppt-skill 原生渲染，配图用 baoyu-image-gen、视频用 remotion，
渲染完跑一遍演讲体检告诉我哪几页只能看不能讲，最后出演讲模式。"
代理将：
- 调用
humanize_ppt.py→ 生成guizang-production-prompt.md。 - 调用
guizang-ppt-skill→ 获得精美的 HTML/PPTX 文稿。 - 运行
baoyu-image-gen和 Remotion 生成媒体资产。 - 运行 Humanize 的 QA 步骤 → 收到问题幻灯片列表。
- 可选地，使用生成的修复提示重新运行渲染器。
- 打开
presenter-shell.html进行排练。
你将获得
- AST 驱动的幻灯片计划（
slide_plan.json）。 - 渲染器特定的简要说明（
*-production-prompt.md）。 - 可选的风格画廊 HTML（用于选择封面风格）。
- 媒体资产（真实图像、SVG 图表、MP4 视频）放置在你指定的路径中。
- QA 报告（
qa_report.md）：精准定位“只能看不能讲”的幻灯片。 - 可编辑的原生 PPTX（使用
ppt-master时）或可直接演示的 HTML 文稿。 - 即用型排练演讲者外壳。
许可证
MIT – 可自由使用、修改，并集成到其他 AI 代理工具链中。
总结
Humanize PPT 不是视觉模板库；它是让 AI 生成的幻灯片文稿 可讲 的 故事编排层。通过将 内容规划（AST） 与 视觉渲染 分离，并提供自动“演示健康检查”，它使 LLM 驱动的代理能够生成既美观又适合现场演讲的文稿。
相关
- 项目
- 项目
- 项目
- 项目
- 项目