LearnPrompt /humanize-ppt

AST-based outline director for human-centered AI presentation workflows.

★ 992⑂ 80👁 22⑃ 10● 2▤ 9
PythonNOASSERTIONCreated 2026-05-14learnprompt.github.io/humanize-ppt/
Download: Humanize PPT v1.1.2 · outline 门产物计入 run marker + shim 退出码修复Humanize-1.1.2 ↓1.1.22026-07-19
+0
Daily
992
stars
80
forks
22
watchers
10
prs
2
issues
9
releases

README

🌐 中文 · English



 Humanize PPT

 「模板库能把一个概念铺成十几页好看的 HTML;可你要站着讲完的,是能推着观众一页页往前走的那条线。」






为演讲而生的 PPT 系统。 好看的模板满大街都是,缺的是把它讲出来的那条线。Humanize 干的是模板库不管的活:先用 AST(观众状态转移)把资料编成一条线,每翻一页都让观众多懂一点;该上画面的页,配真图、SVG 图表、Remotion 视频;渲染完再跑演讲体检,把「只能看、不能讲」的页挑出来。最终可以是保留 HTML 视觉的演讲模式,也可以是带 speaker notes、逐元素可编辑的原生 PPTX。整套 deck 仍由下游原生渲染——它把每页画好看,Humanize 让它能上台讲。

30 秒装上 · 一句话用起来 · 看效果 · 它解决什么 · 演讲体检 · 视觉增强 · 风格画廊 · 英文路径 · AST 理论



---

 30 秒装上

让你的 Agent(Codex / Claude Code / Hermes 等)装上 Humanize PPT —— 最简单的是直接把 GitHub 链接发给它:

text
请安装 Humanize PPT Skill:https://github.com/LearnPrompt/humanize-ppt


或者用 npx 一行:

bash
npx skills add LearnPrompt/humanize-ppt -g


Claude Code 用户也可以走 plugin marketplace(自动更新):

text
/plugin marketplace add LearnPrompt/humanize-ppt
/plugin install humanize-ppt


跑通全流程,建议把这套下游 skill 一起装上(Humanize 出大纲和决定,它们负责渲染和出素材):

| Skill | 干什么 | 来源 |
|---|---|---|
| guizang-ppt-skill | 中文 deck 原生渲染(杂志风 / 瑞士风) | op7418/guizang-ppt-skill |
| frontend-slides | 英文 deck 原生渲染(viewport-safe HTML) | zarazhangrui/frontend-slides |
| beautiful-html-templates | 英文 deck 多模板渲染 | zarazhangrui/beautiful-html-templates |
| ppt-master | 原生可编辑 PPTX(DrawingML、notes、转场、raw .pptx template fill) | hugohe3/ppt-master |
| remotion-video-production | 逐页说明视频(真 mp4),统筹整个视频生产 | Remotion 系(见下方搭配) |
| baoyu-image-gen | 配图,走本地 Codex CLI(无需 API key) | JimLiu/baoyu-skills |

Remotion 怎么搭配(一点实战经验):默认用 remotion-video-production 统筹流程,写代码时搭 remotion-best-practices 防不稳定写法(乱用 CSS / Tailwind animation、资源路径错误这类坑);字幕、图表、3D、批量模板、自动渲染管线这种复杂工程再补 remotion-video-toolkit。

一句话给 Agent:「把 humanize-ppt 和要用的下游 skill(HTML 路线选 guizang/frontend-slides/beautiful-html-templates;原生 PowerPoint 选 ppt-master)装上;配图再加 baoyu-image-gen,视频再加 Remotion。」

 一句话用起来

装好之后,一条话把全流程跑完,复制发给 Agent:

text
用 humanize-ppt 把这份材料做成中文演讲 PPT:先出 AST 大纲和每页意图,
按大纲调 guizang-ppt-skill 原生渲染,配图用 baoyu-image-gen、视频用 remotion,
渲染完跑一遍演讲体检告诉我哪几页只能看不能讲,最后出演讲模式。


英文把「中文 + guizang-ppt-skill」换成「英文 + frontend-slides 或 beautiful-html-templates」即可。CLI 参数、分阶段控制、回灌命令这些都收在下方 进阶用法,新手不用看。

要的是 PowerPoint 里逐元素可编辑的原生 .pptx,改成:「用 humanize-ppt 先定 AST,再调 ppt-master 原生渲染,最后把 PPTX 回灌演讲体检。」Humanize 会生成 ppt-master-production-prompt.md,PPT Master 仍保留自己的强制确认门和原生导出流程。

 看效果

 v1.1:PPT Master 原生可编辑,中文和英文走同一条正式路径

| 中文 Showcase · Memphis Pop | English Showcase · Risograph Zine |
|---|---|
|  |  |
| 下载中文 PPTX · 查看源材料 | Download English PPTX · View source |


▲ 两份真实的 PPT Master 原生导出使用相同 5 页语义契约、相同设计确认门和相同演讲体检标准;中文采用 Memphis Pop,英文采用 Risograph Zine,证明同一条原生路径可以做出真正不同的视觉语言。文字、形状、关系图、speaker notes 与转场都保留在 PowerPoint 里。英文路线从 v1.0 起已经是 full support,v1.1 新增的是 PPT Master 原生可编辑 PPTX 路径,不是重新补一条英文路径。查看双语验证记录。


 风格画廊:出大纲前,下游真渲 4 张封面让你挑


  
  
  
  



▲ 同一份《AI 工具更新,不只是功能清单》的 4 张封面,guizang-ppt-skill 真渲——墨水经典 / 牛皮纸 / 靛蓝瓷(Style A)+ 瑞士克莱因蓝(Style B)。Humanize 出 spec/command,封面归下游渲。


 视觉增强:配图、视频都是真产出,会动


  
  



▲ 左:hero 配图,baoyu-image-gen 走本地 Codex CLI 真出图(gpt-image,无需 API key,仰拍人物叠在产品背景上)。右:逐页说明视频,真 Remotion 渲染的 mp4(这里转成 GIF 所以你能看到它动)。逐槽记录见 产出记录。



  
  



▲ 放进 PPT 里长这样:配图作整页封面、大号非衬

Latest release

Humanize PPT v1.1.2 · outline 门产物计入 run marker + shim 退出码修复 v1.1.2 2026-07-19
第二轮 review 闭环版本,源于 Open Design 社区插件 PR(nexu-io/open-design5655)的复审意见,双侧同步为 v1.1.2(插件侧 commit f5565f50)。

修复 / Fixes

- outline 预览流程不再被 --out 守卫拦截:--preview-outline 写出的 outline-preview.md 和 --confirm-outline 写出的 preview-confirmed.json 现在计入 HUMANIZE_OUT_MARKERS,官方文档里 preview → confirm → brief 三步同目录的流程不再需要 --force。报错文案与文档同步列出全部四个 marker。The outline-gate artifacts now count as Humanize run markers, so the documented preview → confirm → brief flow on one --out no longer requires --force.
- v3/v4/v5 兼容入口退出码修复:三个兼容 shim 改为 sys.exit(main()),校验失败正确返回退出码 2(此前吞掉返回值恒为 0,脚本化调用会误判成功)。The v3/v4/v5 compatibil

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON