[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80086":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":34,"readmeContent":35,"aiSummary":36,"trendingCount":16,"starSnapshotCount":16,"syncStatus":37,"lastSyncTime":38,"discoverSource":39},80086,"humanize-ppt","LearnPrompt\u002Fhumanize-ppt","LearnPrompt","AST-based outline director for human-centered AI presentation workflows.","https:\u002F\u002Flearnprompt.github.io\u002Fhumanize-ppt\u002F",null,"Python",159,27,9,1,0,7,46,95,32,87.84,"Other",false,"main",true,[27,28,29,30,31,32,33],"ai-workflow","ast","html-slides","humanizer","ppt","presentation","skill","2026-06-12 04:01:26","\u003Cdiv align=\"center\">\n\n# Humanize PPT\n\n## 面向 Agent 的 PPT 工作流导演\n\n**先把资料变成人愿意听的 AST 大纲，再交给下游 PPT Skill 做风格探索、页面生成、演讲模式和部署。**\n\n[在线预览](https:\u002F\u002Flearnprompt.github.io\u002Fhumanize-ppt\u002F) · [Release](https:\u002F\u002Fgithub.com\u002FLearnPrompt\u002Fhumanize-ppt\u002Freleases) · [MIT License](LICENSE)\n\n[English](README.en.md) · [AST理论](docs\u002FAST-theory.md) · [OPC工作流](docs\u002FOPC-workflow.md)\n\n\u003C\u002Fdiv>\n\n---\n\n## 效果展示\n\nHumanize PPT 不直接抢模板库的工作。它负责把资料整理成清晰的 AST 大纲，再把生产任务路由给适合的 PPT Skill。当前稳定样例包含中文 `guizang-ppt-skill` 路径和英文 `beautiful-html-templates \u002F frontend-slides` 路径。\n\n| 中文 guizang-ppt-skill 稳定样例 | English beautiful-html-templates \u002F frontend-slides 样例 |\n| --- | --- |\n| [![中文 guizang 稳定样例](docs\u002Fshowcase\u002Fhermes-agent-mastery\u002Fpresenter\u002Fpresenter-screenshot.png)](https:\u002F\u002Flearnprompt.github.io\u002Fhumanize-ppt\u002Fshowcase\u002Fhermes-agent-mastery\u002Fpresenter\u002F) | [![English Neo-Grid 样例](docs\u002Fshowcase\u002Fhermes-agent-mastery\u002Fen\u002Fpresenter\u002Fpresenter-screenshot.png)](https:\u002F\u002Flearnprompt.github.io\u002Fhumanize-ppt\u002Fshowcase\u002Fhermes-agent-mastery\u002Fen\u002Fpresenter\u002F) |\n| 打开[中文演讲模式](https:\u002F\u002Flearnprompt.github.io\u002Fhumanize-ppt\u002Fshowcase\u002Fhermes-agent-mastery\u002Fpresenter\u002F)或[中文 PPT](https:\u002F\u002Flearnprompt.github.io\u002Fhumanize-ppt\u002Fshowcase\u002Fhermes-agent-mastery\u002Fppt\u002F) | 打开[English presenter](https:\u002F\u002Flearnprompt.github.io\u002Fhumanize-ppt\u002Fshowcase\u002Fhermes-agent-mastery\u002Fen\u002Fpresenter\u002F)或[English deck](https:\u002F\u002Flearnprompt.github.io\u002Fhumanize-ppt\u002Fshowcase\u002Fhermes-agent-mastery\u002Fen\u002Fppt\u002F) |\n\n也可以查看已经发布的 [Skill 分享 PPT](https:\u002F\u002Flearnprompt.github.io\u002Fhumanize-ppt\u002Fshowcase\u002Fskill-share\u002F)。\n\n## 30 秒开始：让 Agent 安装并使用\n\n如果你正在使用 Codex、Claude Code、Hermes 或其他支持 Skill 的 Agent，把这段话发给它：\n\n```text\n请安装并使用 Humanize PPT Skill：\nhttps:\u002F\u002Fgithub.com\u002FLearnPrompt\u002Fhumanize-ppt\n\n我要做一份 PPT。请先用 Humanize PPT 把资料整理成 AST 大纲，\n再根据语言和场景选择下游 PPT Skill。\n请确认 humanize-ppt、guizang-ppt-skill、beautiful-html-templates 和 frontend-slides 都可用。\n中文内容优先走 guizang-ppt-skill 稳定成稿；\n英文内容先用 beautiful-html-templates \u002F frontend-slides 给我至少 5 个风格候选，等我选定后再生成完整 deck。\n如果需要视频或动态素材，请确认 Remotion 相关能力可用。\n最后请补 presenter \u002F export \u002F QA 修复与调优，并把输出路径告诉我。\n```\n\n如果你的 Agent 需要明确安装命令，可以让它执行：\n\n```bash\nnpx skills add https:\u002F\u002Fgithub.com\u002FLearnPrompt\u002Fhumanize-ppt.git -g -y\n```\n\n## 怎么跟 Agent 交流\n\n你不需要一开始就写 CLI 参数。更自然的方式是按阶段给 Agent 下任务：\n\n```text\n我有一份关于「AI 工具更新」的资料，请用 Humanize PPT 先生成 PPT 大纲和风格预览。\n目标观众是产品团队，重点不是功能清单，而是让他们理解这些工具会改变工作流。\n```\n\n```text\n我选第 2 个风格。请继续生成完整 PPT，并补演讲模式。\n如果需要素材，请先告诉我哪些页适合做 GPT 图片、SVG 图或 Remotion 短视频。\n```\n\n```text\n请做 QA 修复\u002F调优：检查标题是否重复、素材文字是否裁切、页面是否太空、视频是否能播放。\n把问题列出来，能修的直接修，最后给我本地路径和可上线路径。\n```\n\n## CLI 复现方式\n\n如果你想绕过 Agent、直接在本地复现，可以运行：\n\n```bash\npython3 scripts\u002Fhumanize_ppt.py \\\n  --source examples\u002F01-ai-tool-update\u002Fsource.md \\\n  --out .humanize-ppt-runs\u002Fai-tool-update-preview \\\n  --title \"AI 工具更新，不只是功能清单\" \\\n  --style-mode preview-first\n```\n\n查看结果：\n\n```bash\nopen .humanize-ppt-runs\u002Fai-tool-update-preview\u002Foutputs\u002Fbeautiful\u002Fpreviews\u002Findex.html\nopen .humanize-ppt-runs\u002Fai-tool-update-preview\u002Foutputs\u002Fqa\u002Fqa_report.md\n```\n\n如果已经选中一个 Beautiful 模板，可以继续生成完整 deck，并补齐 presenter\u002Fexport：\n\n```bash\npython3 scripts\u002Fhumanize_ppt.py \\\n  --source examples\u002F01-ai-tool-update\u002Fsource.md \\\n  --out .humanize-ppt-runs\u002Fai-tool-update-complete \\\n  --title \"AI 工具更新，不只是功能清单\" \\\n  --selected-template \u003Cslug> \\\n  --presenter-adapter \\\n  --export-adapter\n```\n\n## 能力\n\n- **生成 AST 大纲**：把资料转成观众、状态转移、页面意图和讲述节奏。\n- **路由下游 Skill**：根据语言和风格需求，把任务交给 guizang-ppt-skill、beautiful-html-templates、frontend-slides、presenter\u002Fexport 等路径。\n- **先预览再成稿**：英文路径默认先出至少 5 个风格候选，选中后再生成完整 deck。\n- **补齐交付闭环**：生成 presenter、导出包、QA 修复\u002F调优记录和可上线静态路径。\n\n## 适合 \u002F 不适合\n\n适合：\n\n- 你有资料、主题或大纲，但还缺一个可讲、可渲染、可 QA 调优的 PPT 大纲和成品路径。\n- 你希望中文 PPT 默认走稳定 guizang-ppt-skill 成稿路径。\n- 你希望英文 PPT 先做多风格探索，再选择一个方向继续生产。\n- 你希望把资料交给 Agent 生成大纲、演讲模式和稳定复现的中英文 PPT 路径。\n\n不适合：\n\n- 你只想找一个单页模板库。\n- 你希望它直接替代所有 HTML PPT \u002F Remotion \u002F 图片生成 Skill。\n- 你还没有明确主题、观众或交付场景。\n\n## 工作流路径\n\n中文默认路径已经固定为：`Humanize PPT → guizang-ppt-skill → material QA 修复\u002F调优 → presenter → static deploy`。当内容是中文且没有显式要求多风格探索时，优先把 guizang-ppt-skill 当作稳定成稿路径；成稿后再补素材 QA 调优、演讲模式和部署包。\n\n英文默认路径已经固定为：`Humanize PPT → beautiful-html-templates \u002F frontend-slides → style selection → full deck → presenter\u002Fdeploy`。英文路径不直接跳到单一成稿风格；先基于主题生成至少 5 个可见候选，选中后再走完整 deck、演讲模式和部署。\n\nHumanize PPT 当前重点是稳定“资料 → AST 大纲 → 风格预览\u002F完整 deck → presenter\u002Fexport → QA 修复\u002F调优”的工作流。视频或动态素材可以作为页面材料进入流程；需要时请让 Agent 先确认 Remotion 相关能力已经安装并可运行。\n\n## 为什么是 AST\n\nHumanize PPT 用 AST 理论把资料拆成：\n\n- **Audience**：观众是谁，知道什么，抗拒什么；\n- **State**：观众看之前是什么状态，看完以后应该变成什么状态；\n- **Transfer**：每一页如何推动这次状态转移。\n\n核心判断：\n\n> PPT 不只是信息容器，而是观众状态改变器。\n\n## 无依赖 smoke 验证\n\n如果本机没有 pytest，也可以先跑标准库 smoke check：\n\n```bash\npython3 scripts\u002Fsmoke_check.py\n```\n\n它会使用稳定入口跑一条不依赖外部模板库的最小链路，并检查这些关键文件：\n\n```text\ndeck_brief.md\nast_outline.md\nslide_plan.json\nrouter_plan.json\nrun_manifest.json\noutputs\u002Fqa\u002Fqa_report.md\n```\n\n完整说明见：[docs\u002Fsmoke-test.md](docs\u002Fsmoke-test.md)。\n\n## 输出结构\n\n一次运行会生成：\n\n```text\nout\u002F\n  deck_brief.md\n  ast_outline.md\n  slide_plan.json\n  speaker_intent.md\n  asset_manifest.md\n  video_slots.json\n  style_brief.md\n  renderer_registry.json\n  router_plan.json\n  run_manifest.json\n  commands\u002F\n    *.md\n  outputs\u002F\n    beautiful\u002F\n    guizang\u002F\n    presenter\u002F\n    export\u002F\n    qa\u002F\n```\n\n根据是否选择模板、是否启用 presenter\u002Fexport，部分输出目录可能为空或标记为待处理。\n\n## 当前能力边界\n\n- 推荐入口：`scripts\u002Fhumanize_ppt.py`\n- 历史版本说明：`docs\u002Fversions\u002F`\n- 版本计划与审查：`docs\u002Fplans\u002F`\n- 脱敏样例：`examples\u002F`\n\n## Reference\n\nHumanize PPT 的设计参考了这些项目和操作规章：\n\n- [op7418\u002Fguizang-ppt-skill](https:\u002F\u002Fgithub.com\u002Fop7418\u002Fguizang-ppt-skill)：中文稳定成稿、Swiss 风格约束、素材 QA。\n- [zarazhangrui\u002Fbeautiful-html-templates](https:\u002F\u002Fgithub.com\u002Fzarazhangrui\u002Fbeautiful-html-templates)：英文路径的多风格候选和 selected-template full deck。\n- [zarazhangrui\u002Ffrontend-slides](https:\u002F\u002Fgithub.com\u002Fzarazhangrui\u002Ffrontend-slides)：英文 slide workflow、viewport-safe HTML deck、PPTX\u002F发布方向。\n- [huggingface\u002Fsmolagents](https:\u002F\u002Fgithub.com\u002Fhuggingface\u002Fsmolagents)：code-first Agent 工作流参考，帮助定义“Agent 读契约、执行工具、写回结果”的协作方式。\n- [AST 理论](docs\u002FAST-theory.md)、[OPC 工作流](docs\u002FOPC-workflow.md)：Humanize PPT 自己的大纲方法、路由规则和执行边界。\n- [Guizang material QA](references\u002Fguizang-material-qa.md)、[Guizang presenter deploy](references\u002Fguizang-presenter-deploy.md)、[English style gallery](docs\u002Fversions\u002Fv0.6.3-english-style-gallery.md)：当前中文和英文稳定路径的操作规章。\n\n## License\n\nMIT\n","Humanize PPT 是一个基于抽象语法树（AST）的演示文稿工作流导演工具，旨在优化以人为中心的人工智能演示流程。其核心功能是将原始资料转换为清晰的 AST 大纲，并根据语言和应用场景选择合适的下游 PPT Skill 进行风格探索、页面生成及演讲模式配置等任务。项目使用 Python 编写，支持中文 `guizang-ppt-skill` 和英文 `beautiful-html-templates \u002F frontend-slides` 两种路径，适用于需要快速制作高质量演示文稿且注重内容组织逻辑性的场景，如企业内部培训、产品发布会等。通过与支持 Skill 的 Agent 配合使用，用户可以更高效地完成从大纲构建到最终输出的全过程。",2,"2026-06-11 03:59:12","CREATED_QUERY"]